codai-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dragos Catalin Vladulescu (codai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# codai-sdk
+
+[![npm version](https://img.shields.io/npm/v/codai-sdk.svg)](https://www.npmjs.com/package/codai-sdk)
+[![license](https://img.shields.io/npm/l/codai-sdk.svg)](./LICENSE)
+
+Official TypeScript SDK for the [codai](https://codai.ro) AI gateway — a single
+OpenAI-compatible endpoint with smart routing, sessions, server-side agents,
+streaming, embeddings, audio, and feedback.
+
+- **Zero dependencies** — uses the platform `fetch`.
+- Works in **Node 18+** and modern edge runtimes.
+- **OpenAI-compatible** chat surface with codai extensions.
+- Fully typed.
+
+```bash
+npm install codai-sdk
+# or
+pnpm add codai-sdk
+```
+
+> You need a codai API key. Get one at **[codai.ro](https://codai.ro)**.
+
+## Quickstart
+
+```ts
+import { Codai } from 'codai-sdk';
+
+const codai = new Codai({ apiKey: process.env.CODAI_API_KEY! });
+
+const res = await codai.chat({
+  messages: [{ role: 'user', content: 'Explain async iterators in one line.' }],
+});
+
+console.log(res.content);
+console.log(res.routedTo); // which upstream model actually served
+```
+
+## Streaming
+
+```ts
+for await (const delta of codai.chatStream({
+  messages: [{ role: 'user', content: 'Write a haiku about TypeScript.' }],
+})) {
+  process.stdout.write(delta);
+}
+```
+
+## Server-side agent
+
+Run a plan-and-execute loop on the gateway — the heavy lifting (planning, tool
+use, iteration) happens server-side; your client stays thin.
+
+```ts
+const run = await codai.agents.run({
+  task: 'Summarize the key points of the provided text.',
+  context: '…your input…',
+});
+
+console.log(run.result);
+```
+
+## Feedback
+
+```ts
+const res = await codai.chat({ messages: [{ role: 'user', content: 'hi' }] });
+if (res.requestId) {
+  await codai.feedback(res.requestId, 1); // 1 = 👍, -1 = 👎
+}
+```
+
+## Embeddings
+
+```ts
+const { embeddings } = await codai.embeddings({ input: ['hello', 'world'] });
+```
+
+## Audio
+
+```ts
+// Speech-to-text
+const text = await codai.audio.transcribe({ file: audioBytes, filename: 'clip.webm' });
+
+// Text-to-speech
+const wav = await codai.audio.speech({ input: 'Hello from codai.' });
+```
+
+## List models
+
+```ts
+const models = await codai.models();
+```
+
+## Configuration
+
+```ts
+const codai = new Codai({
+  apiKey: process.env.CODAI_API_KEY!,
+  baseUrl: 'https://ai.codai.ro', // default
+  sessionId: 'my-project', // enables session memory + stickiness
+  timeoutMs: 120_000,
+  maxRetries: 2,
+});
+```
+
+## codai extensions
+
+The chat surface is OpenAI-compatible, with a few opt-in extensions:
+
+| Option            | Description                                                             |
+| ----------------- | ----------------------------------------------------------------------- |
+| `sessionId`       | Stable conversation id — enables session memory and routing stickiness. |
+| `agentMode`       | Plan-and-execute agent mode (Pro+).                                     |
+| `compact: "auto"` | Server-side context compaction.                                         |
+| `bestOf`          | Best-of-N sampling override (`0` disables, `3` forces).                 |
+
+## Migrating from the OpenAI SDK
+
+The chat payload is OpenAI-shaped, so migration is mostly swapping the client:
+
+```ts
+// before: openai.chat.completions.create({ model, messages })
+// after:
+const res = await codai.chat({ messages });
+```
+
+## Error handling
+
+```ts
+import { Codai, CodaiError } from 'codai-sdk';
+
+try {
+  await codai.chat({ messages: [{ role: 'user', content: 'hi' }] });
+} catch (err) {
+  if (err instanceof CodaiError) {
+    console.error(err.status, err.message, err.body);
+  }
+}
+```
+
+## License
+
+[MIT](./LICENSE) © codai

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+/**
+ * codai-sdk — official TypeScript client for the codai AI gateway.
+ *
+ * Full-surface client:
+ *   - chat(): OpenAI-compatible completions with codai extensions
+ *     (session, agent mode, compaction, best-of)
+ *   - chatStream(): SSE streaming with an async-iterator interface
+ *   - agents.run(): server-side agent loop (POST /v1/agents/run)
+ *   - feedback(): thumbs rating on a completed request
+ *   - models(): list models available to the key
+ *
+ * Zero dependencies; works in Node 18+ (global fetch) and modern edge
+ * runtimes. Memory tools (memory_recall / memory_remember) and skills
+ * (use_skill) are GATEWAY-NATIVE — the model invokes them server-side;
+ * nothing to call from the SDK beyond enabling a session.
+ */
+interface CodaiClientOptions {
+    apiKey: string;
+    /** Defaults to https://ai.codai.ro */
+    baseUrl?: string;
+    /** Stable conversation/session id — enables session memory + stickiness. */
+    sessionId?: string;
+    /** Default request timeout (ms). Default 120_000. */
+    timeoutMs?: number;
+    /** Retries on 429/5xx with exponential backoff. Default 2. */
+    maxRetries?: number;
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | Array<Record<string, unknown>>;
+    tool_call_id?: string;
+    name?: string;
+}
+interface ChatOptions {
+    model?: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    tools?: Array<Record<string, unknown>>;
+    /** codai extension: plan-and-execute agent mode (Pro+). */
+    agentMode?: boolean;
+    /** codai extension: server-side context compaction ('auto'). */
+    compact?: 'auto';
+    /** codai extension: best-of-N override (0 disables, 3 forces). */
+    bestOf?: 0 | 3;
+    /** Attribution id recorded on tool calls (agent fleets). */
+    agentId?: string;
+    /** Per-call session override. */
+    sessionId?: string;
+    signal?: AbortSignal;
+}
+interface ChatResult {
+    /** Assistant message content (first choice). */
+    content: string;
+    /** Raw OpenAI-shaped response. */
+    raw: Record<string, unknown>;
+    /** Request id — pass to feedback(). */
+    requestId: string | null;
+    /** Which upstream model actually served (x-codai-routed-to). */
+    routedTo: string | null;
+    /** Verification status for verified-execution responses ('passed'|'refined'|…), if present. */
+    execVerify: string | null;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+    } | null;
+}
+interface AgentRunOptions {
+    task: string;
+    context?: string;
+    system?: string;
+    model?: string;
+    signal?: AbortSignal;
+}
+interface AgentRunResult {
+    result: string;
+    model: string;
+    eventId: string | null;
+    usage: Record<string, unknown> | null;
+}
+type EphemeralScope = 'realtime' | 'audio' | 'embeddings';
+interface EphemeralToken {
+    token: string;
+    expiresAt: string;
+    scope: EphemeralScope;
+}
+interface TranscriptionOptions {
+    /** Audio file contents. */
+    file: Blob | Uint8Array | ArrayBuffer;
+    /** Filename hint (extension drives format detection). Default audio.webm */
+    filename?: string;
+    model?: string;
+    signal?: AbortSignal;
+}
+interface SpeechOptions {
+    input: string;
+    model?: string;
+    voice?: string;
+    signal?: AbortSignal;
+}
+interface EmbeddingsOptions {
+    input: string | string[];
+    model?: string;
+    dimensions?: number;
+    signal?: AbortSignal;
+}
+declare class CodaiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+declare class Codai {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly sessionId?;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    constructor(opts: CodaiClientOptions);
+    chat(opts: ChatOptions): Promise<ChatResult>;
+    /** Streaming chat: async-iterate text deltas; `final` resolves afterwards. */
+    chatStream(opts: ChatOptions): AsyncGenerator<string, void, undefined>;
+    readonly agents: {
+        run: (opts: AgentRunOptions) => Promise<AgentRunResult>;
+    };
+    /** Rate a completed request: +1 (helpful) or -1 (not helpful). */
+    feedback(requestId: string, rating: 1 | -1, comment?: string): Promise<void>;
+    models(): Promise<Array<{
+        id: string;
+    }>>;
+    /**
+     * Mint a short-lived scoped token (60–3600s) for browser/webview clients.
+     * The token authenticates only its scope's surface; chat is not mintable.
+     */
+    mintToken(scope: EphemeralScope, ttlSeconds?: number): Promise<EphemeralToken>;
+    embeddings(opts: EmbeddingsOptions): Promise<{
+        embeddings: number[][];
+        raw: unknown;
+    }>;
+    readonly audio: {
+        /** Speech-to-text (multipart upload, max 25 MB). Returns the transcript. */
+        transcribe: (opts: TranscriptionOptions) => Promise<string>;
+        /** Text-to-speech. Returns the audio bytes (default mp3). */
+        speech: (opts: SpeechOptions) => Promise<ArrayBuffer>;
+    };
+    private chatBody;
+    private chatHeaders;
+    private request;
+}
+
+export { type AgentRunOptions, type AgentRunResult, type ChatMessage, type ChatOptions, type ChatResult, Codai, type CodaiClientOptions, CodaiError, type EmbeddingsOptions, type EphemeralScope, type EphemeralToken, type SpeechOptions, type TranscriptionOptions, Codai as default };

package/dist/index.js

@@ -0,0 +1,248 @@
+// src/index.ts
+var CodaiError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "CodaiError";
+  }
+  status;
+  body;
+};
+var RETRYABLE = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var Codai = class {
+  apiKey;
+  baseUrl;
+  sessionId;
+  timeoutMs;
+  maxRetries;
+  constructor(opts) {
+    if (!opts.apiKey) throw new Error("Codai: apiKey is required");
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? "https://ai.codai.ro").replace(/\/$/, "");
+    this.sessionId = opts.sessionId;
+    this.timeoutMs = opts.timeoutMs ?? 12e4;
+    this.maxRetries = opts.maxRetries ?? 2;
+  }
+  // ---------------------------------------------------------------- chat
+  async chat(opts) {
+    const res = await this.request("/v1/chat/completions", this.chatBody(opts, false), {
+      signal: opts.signal,
+      headers: this.chatHeaders(opts)
+    });
+    const raw = await res.json();
+    const choices = raw.choices;
+    const usage = raw.usage;
+    return {
+      content: String(choices?.[0]?.message?.content ?? ""),
+      raw,
+      requestId: res.headers.get("x-request-id"),
+      routedTo: res.headers.get("x-codai-routed-to"),
+      execVerify: res.headers.get("x-codai-exec-verify"),
+      usage: usage ? {
+        promptTokens: usage.prompt_tokens ?? 0,
+        completionTokens: usage.completion_tokens ?? 0
+      } : null
+    };
+  }
+  /** Streaming chat: async-iterate text deltas; `final` resolves afterwards. */
+  async *chatStream(opts) {
+    const res = await this.request("/v1/chat/completions", this.chatBody(opts, true), {
+      signal: opts.signal,
+      headers: this.chatHeaders(opts)
+    });
+    const reader = res.body?.getReader();
+    if (!reader) throw new CodaiError("no response body", res.status, null);
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const frames = buffer.split("\n\n");
+      buffer = frames.pop() ?? "";
+      for (const frame of frames) {
+        for (const line of frame.split("\n")) {
+          if (!line.startsWith("data:")) continue;
+          const data = line.slice(5).trim();
+          if (data === "[DONE]") return;
+          try {
+            const chunk = JSON.parse(data);
+            const delta = chunk.choices?.[0]?.delta?.content;
+            if (delta) yield delta;
+          } catch {
+          }
+        }
+      }
+    }
+  }
+  // -------------------------------------------------------------- agents
+  agents = {
+    run: async (opts) => {
+      const res = await this.request(
+        "/v1/agents/run",
+        {
+          task: opts.task,
+          ...opts.context ? { context: opts.context } : {},
+          ...opts.system ? { system: opts.system } : {},
+          ...opts.model ? { model: opts.model } : {}
+        },
+        { signal: opts.signal }
+      );
+      const body = await res.json();
+      return {
+        result: String(body.result ?? ""),
+        model: String(body.model ?? ""),
+        eventId: body.event_id ?? null,
+        usage: body.usage ?? null
+      };
+    }
+  };
+  // ------------------------------------------------------------ feedback
+  /** Rate a completed request: +1 (helpful) or -1 (not helpful). */
+  async feedback(requestId, rating, comment) {
+    await this.request("/v1/feedback", {
+      event_id: requestId,
+      rating,
+      ...comment ? { comment } : {}
+    });
+  }
+  // -------------------------------------------------------------- models
+  async models() {
+    const res = await this.request("/v1/models", null, { method: "GET" });
+    const body = await res.json();
+    return body.data ?? [];
+  }
+  // -------------------------------------------------------------- tokens
+  /**
+   * Mint a short-lived scoped token (60–3600s) for browser/webview clients.
+   * The token authenticates only its scope's surface; chat is not mintable.
+   */
+  async mintToken(scope, ttlSeconds) {
+    const res = await this.request("/v1/tokens", {
+      scope,
+      ...ttlSeconds !== void 0 ? { ttl_seconds: ttlSeconds } : {}
+    });
+    const body = await res.json();
+    return { token: body.token, expiresAt: body.expires_at, scope: body.scope };
+  }
+  // ---------------------------------------------------------- embeddings
+  async embeddings(opts) {
+    const res = await this.request(
+      "/v1/embeddings",
+      {
+        model: opts.model ?? "codai-embed",
+        input: opts.input,
+        ...opts.dimensions !== void 0 ? { dimensions: opts.dimensions } : {}
+      },
+      { signal: opts.signal }
+    );
+    const body = await res.json();
+    return { embeddings: (body.data ?? []).map((d) => d.embedding), raw: body };
+  }
+  // --------------------------------------------------------------- audio
+  audio = {
+    /** Speech-to-text (multipart upload, max 25 MB). Returns the transcript. */
+    transcribe: async (opts) => {
+      const form = new FormData();
+      const blob = opts.file instanceof Blob ? opts.file : new Blob([opts.file]);
+      form.append("file", blob, opts.filename ?? "audio.webm");
+      form.append("model", opts.model ?? "codai-transcribe");
+      const res = await fetch(`${this.baseUrl}/v1/audio/transcriptions`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${this.apiKey}` },
+        body: form,
+        signal: opts.signal ?? AbortSignal.timeout(this.timeoutMs)
+      });
+      if (!res.ok) {
+        let errBody = null;
+        try {
+          errBody = await res.json();
+        } catch {
+        }
+        throw new CodaiError(`codai /v1/audio/transcriptions \u2192 ${res.status}`, res.status, errBody);
+      }
+      const body = await res.json();
+      return body.text ?? "";
+    },
+    /** Text-to-speech. Returns the audio bytes (default mp3). */
+    speech: async (opts) => {
+      const res = await this.request(
+        "/v1/audio/speech",
+        {
+          model: opts.model ?? "codai-tts",
+          input: opts.input,
+          voice: opts.voice ?? "alloy"
+        },
+        { signal: opts.signal }
+      );
+      return res.arrayBuffer();
+    }
+  };
+  // ------------------------------------------------------------ internal
+  chatBody(opts, stream) {
+    return {
+      model: opts.model ?? "codai",
+      messages: opts.messages,
+      stream,
+      ...opts.temperature !== void 0 ? { temperature: opts.temperature } : {},
+      ...opts.maxTokens !== void 0 ? { max_tokens: opts.maxTokens } : {},
+      ...opts.tools ? { tools: opts.tools } : {}
+    };
+  }
+  chatHeaders(opts) {
+    const h = {};
+    const session = opts.sessionId ?? this.sessionId;
+    if (session) h["x-codai-session-id"] = session;
+    if (opts.agentMode) h["x-codai-mode"] = "agent";
+    if (opts.compact) h["x-codai-compact"] = opts.compact;
+    if (opts.bestOf !== void 0) h["x-codai-best-of"] = String(opts.bestOf);
+    if (opts.agentId) h["x-codai-agent-id"] = opts.agentId;
+    return h;
+  }
+  async request(path, body, init = {}) {
+    const url = `${this.baseUrl}${path}`;
+    let lastErr;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const res = await fetch(url, {
+          method: init.method ?? "POST",
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            ...body !== null ? { "Content-Type": "application/json" } : {},
+            ...init.headers
+          },
+          ...body !== null ? { body: JSON.stringify(body) } : {},
+          signal: init.signal ?? AbortSignal.timeout(this.timeoutMs)
+        });
+        if (res.ok) return res;
+        if (RETRYABLE.has(res.status) && attempt < this.maxRetries) {
+          await sleep(500 * 2 ** attempt + Math.random() * 250);
+          continue;
+        }
+        let errBody = null;
+        try {
+          errBody = await res.json();
+        } catch {
+        }
+        throw new CodaiError(`codai ${path} \u2192 ${res.status}`, res.status, errBody);
+      } catch (err) {
+        if (err instanceof CodaiError) throw err;
+        lastErr = err;
+        if (attempt < this.maxRetries) {
+          await sleep(500 * 2 ** attempt);
+          continue;
+        }
+      }
+    }
+    throw new CodaiError(`codai ${path} failed after retries: ${String(lastErr)}`, 0, null);
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var index_default = Codai;
+
+export { Codai, CodaiError, index_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * codai-sdk — official TypeScript client for the codai AI gateway.\n *\n * Full-surface client:\n *   - chat(): OpenAI-compatible completions with codai extensions\n *     (session, agent mode, compaction, best-of)\n *   - chatStream(): SSE streaming with an async-iterator interface\n *   - agents.run(): server-side agent loop (POST /v1/agents/run)\n *   - feedback(): thumbs rating on a completed request\n *   - models(): list models available to the key\n *\n * Zero dependencies; works in Node 18+ (global fetch) and modern edge\n * runtimes. Memory tools (memory_recall / memory_remember) and skills\n * (use_skill) are GATEWAY-NATIVE — the model invokes them server-side;\n * nothing to call from the SDK beyond enabling a session.\n */\n\nexport interface CodaiClientOptions {\n  apiKey: string;\n  /** Defaults to https://ai.codai.ro */\n  baseUrl?: string;\n  /** Stable conversation/session id — enables session memory + stickiness. */\n  sessionId?: string;\n  /** Default request timeout (ms). Default 120_000. */\n  timeoutMs?: number;\n  /** Retries on 429/5xx with exponential backoff. Default 2. */\n  maxRetries?: number;\n}\n\nexport interface ChatMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool';\n  content: string | Array<Record<string, unknown>>;\n  tool_call_id?: string;\n  name?: string;\n}\n\nexport interface ChatOptions {\n  model?: string;\n  messages: ChatMessage[];\n  temperature?: number;\n  maxTokens?: number;\n  tools?: Array<Record<string, unknown>>;\n  /** codai extension: plan-and-execute agent mode (Pro+). */\n  agentMode?: boolean;\n  /** codai extension: server-side context compaction ('auto'). */\n  compact?: 'auto';\n  /** codai extension: best-of-N override (0 disables, 3 forces). */\n  bestOf?: 0 | 3;\n  /** Attribution id recorded on tool calls (agent fleets). */\n  agentId?: string;\n  /** Per-call session override. */\n  sessionId?: string;\n  signal?: AbortSignal;\n}\n\nexport interface ChatResult {\n  /** Assistant message content (first choice). */\n  content: string;\n  /** Raw OpenAI-shaped response. */\n  raw: Record<string, unknown>;\n  /** Request id — pass to feedback(). */\n  requestId: string | null;\n  /** Which upstream model actually served (x-codai-routed-to). */\n  routedTo: string | null;\n  /** Verification status for verified-execution responses ('passed'|'refined'|…), if present. */\n  execVerify: string | null;\n  usage: { promptTokens: number; completionTokens: number } | null;\n}\n\nexport interface AgentRunOptions {\n  task: string;\n  context?: string;\n  system?: string;\n  model?: string;\n  signal?: AbortSignal;\n}\n\nexport interface AgentRunResult {\n  result: string;\n  model: string;\n  eventId: string | null;\n  usage: Record<string, unknown> | null;\n}\n\nexport type EphemeralScope = 'realtime' | 'audio' | 'embeddings';\n\nexport interface EphemeralToken {\n  token: string;\n  expiresAt: string;\n  scope: EphemeralScope;\n}\n\nexport interface TranscriptionOptions {\n  /** Audio file contents. */\n  file: Blob | Uint8Array | ArrayBuffer;\n  /** Filename hint (extension drives format detection). Default audio.webm */\n  filename?: string;\n  model?: string;\n  signal?: AbortSignal;\n}\n\nexport interface SpeechOptions {\n  input: string;\n  model?: string;\n  voice?: string;\n  signal?: AbortSignal;\n}\n\nexport interface EmbeddingsOptions {\n  input: string | string[];\n  model?: string;\n  dimensions?: number;\n  signal?: AbortSignal;\n}\n\nexport class CodaiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly body: unknown,\n  ) {\n    super(message);\n    this.name = 'CodaiError';\n  }\n}\n\nconst RETRYABLE = new Set([429, 500, 502, 503, 504]);\n\nexport class Codai {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly sessionId?: string;\n  private readonly timeoutMs: number;\n  private readonly maxRetries: number;\n\n  constructor(opts: CodaiClientOptions) {\n    if (!opts.apiKey) throw new Error('Codai: apiKey is required');\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://ai.codai.ro').replace(/\\/$/, '');\n    this.sessionId = opts.sessionId;\n    this.timeoutMs = opts.timeoutMs ?? 120_000;\n    this.maxRetries = opts.maxRetries ?? 2;\n  }\n\n  // ---------------------------------------------------------------- chat\n  async chat(opts: ChatOptions): Promise<ChatResult> {\n    const res = await this.request('/v1/chat/completions', this.chatBody(opts, false), {\n      signal: opts.signal,\n      headers: this.chatHeaders(opts),\n    });\n    const raw = (await res.json()) as Record<string, unknown>;\n    const choices = raw.choices as Array<{ message?: { content?: string } }> | undefined;\n    const usage = raw.usage as { prompt_tokens?: number; completion_tokens?: number } | undefined;\n    return {\n      content: String(choices?.[0]?.message?.content ?? ''),\n      raw,\n      requestId: res.headers.get('x-request-id'),\n      routedTo: res.headers.get('x-codai-routed-to'),\n      execVerify: res.headers.get('x-codai-exec-verify'),\n      usage: usage\n        ? {\n            promptTokens: usage.prompt_tokens ?? 0,\n            completionTokens: usage.completion_tokens ?? 0,\n          }\n        : null,\n    };\n  }\n\n  /** Streaming chat: async-iterate text deltas; `final` resolves afterwards. */\n  async *chatStream(opts: ChatOptions): AsyncGenerator<string, void, undefined> {\n    const res = await this.request('/v1/chat/completions', this.chatBody(opts, true), {\n      signal: opts.signal,\n      headers: this.chatHeaders(opts),\n    });\n    const reader = res.body?.getReader();\n    if (!reader) throw new CodaiError('no response body', res.status, null);\n    const decoder = new TextDecoder();\n    let buffer = '';\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n      // SSE frames are \\n\\n separated; keep the trailing partial in buffer.\n      const frames = buffer.split('\\n\\n');\n      buffer = frames.pop() ?? '';\n      for (const frame of frames) {\n        for (const line of frame.split('\\n')) {\n          if (!line.startsWith('data:')) continue;\n          const data = line.slice(5).trim();\n          if (data === '[DONE]') return;\n          try {\n            const chunk = JSON.parse(data) as {\n              choices?: Array<{ delta?: { content?: string } }>;\n            };\n            const delta = chunk.choices?.[0]?.delta?.content;\n            if (delta) yield delta;\n          } catch {\n            /* keep-alives / comments */\n          }\n        }\n      }\n    }\n  }\n\n  // -------------------------------------------------------------- agents\n  readonly agents = {\n    run: async (opts: AgentRunOptions): Promise<AgentRunResult> => {\n      const res = await this.request(\n        '/v1/agents/run',\n        {\n          task: opts.task,\n          ...(opts.context ? { context: opts.context } : {}),\n          ...(opts.system ? { system: opts.system } : {}),\n          ...(opts.model ? { model: opts.model } : {}),\n        },\n        { signal: opts.signal },\n      );\n      const body = (await res.json()) as Record<string, unknown>;\n      return {\n        result: String(body.result ?? ''),\n        model: String(body.model ?? ''),\n        eventId: (body.event_id as string) ?? null,\n        usage: (body.usage as Record<string, unknown>) ?? null,\n      };\n    },\n  };\n\n  // ------------------------------------------------------------ feedback\n  /** Rate a completed request: +1 (helpful) or -1 (not helpful). */\n  async feedback(requestId: string, rating: 1 | -1, comment?: string): Promise<void> {\n    await this.request('/v1/feedback', {\n      event_id: requestId,\n      rating,\n      ...(comment ? { comment } : {}),\n    });\n  }\n\n  // -------------------------------------------------------------- models\n  async models(): Promise<Array<{ id: string }>> {\n    const res = await this.request('/v1/models', null, { method: 'GET' });\n    const body = (await res.json()) as { data?: Array<{ id: string }> };\n    return body.data ?? [];\n  }\n\n  // -------------------------------------------------------------- tokens\n  /**\n   * Mint a short-lived scoped token (60–3600s) for browser/webview clients.\n   * The token authenticates only its scope's surface; chat is not mintable.\n   */\n  async mintToken(scope: EphemeralScope, ttlSeconds?: number): Promise<EphemeralToken> {\n    const res = await this.request('/v1/tokens', {\n      scope,\n      ...(ttlSeconds !== undefined ? { ttl_seconds: ttlSeconds } : {}),\n    });\n    const body = (await res.json()) as {\n      token: string;\n      expires_at: string;\n      scope: EphemeralScope;\n    };\n    return { token: body.token, expiresAt: body.expires_at, scope: body.scope };\n  }\n\n  // ---------------------------------------------------------- embeddings\n  async embeddings(opts: EmbeddingsOptions): Promise<{ embeddings: number[][]; raw: unknown }> {\n    const res = await this.request(\n      '/v1/embeddings',\n      {\n        model: opts.model ?? 'codai-embed',\n        input: opts.input,\n        ...(opts.dimensions !== undefined ? { dimensions: opts.dimensions } : {}),\n      },\n      { signal: opts.signal },\n    );\n    const body = (await res.json()) as { data?: Array<{ embedding: number[] }> };\n    return { embeddings: (body.data ?? []).map((d) => d.embedding), raw: body };\n  }\n\n  // --------------------------------------------------------------- audio\n  readonly audio = {\n    /** Speech-to-text (multipart upload, max 25 MB). Returns the transcript. */\n    transcribe: async (opts: TranscriptionOptions): Promise<string> => {\n      const form = new FormData();\n      const blob = opts.file instanceof Blob ? opts.file : new Blob([opts.file as BlobPart]);\n      form.append('file', blob, opts.filename ?? 'audio.webm');\n      form.append('model', opts.model ?? 'codai-transcribe');\n      const res = await fetch(`${this.baseUrl}/v1/audio/transcriptions`, {\n        method: 'POST',\n        headers: { Authorization: `Bearer ${this.apiKey}` },\n        body: form,\n        signal: opts.signal ?? AbortSignal.timeout(this.timeoutMs),\n      });\n      if (!res.ok) {\n        let errBody: unknown = null;\n        try {\n          errBody = await res.json();\n        } catch {\n          /* non-JSON */\n        }\n        throw new CodaiError(`codai /v1/audio/transcriptions → ${res.status}`, res.status, errBody);\n      }\n      const body = (await res.json()) as { text?: string };\n      return body.text ?? '';\n    },\n\n    /** Text-to-speech. Returns the audio bytes (default mp3). */\n    speech: async (opts: SpeechOptions): Promise<ArrayBuffer> => {\n      const res = await this.request(\n        '/v1/audio/speech',\n        {\n          model: opts.model ?? 'codai-tts',\n          input: opts.input,\n          voice: opts.voice ?? 'alloy',\n        },\n        { signal: opts.signal },\n      );\n      return res.arrayBuffer();\n    },\n  };\n\n  // ------------------------------------------------------------ internal\n  private chatBody(opts: ChatOptions, stream: boolean): Record<string, unknown> {\n    return {\n      model: opts.model ?? 'codai',\n      messages: opts.messages,\n      stream,\n      ...(opts.temperature !== undefined ? { temperature: opts.temperature } : {}),\n      ...(opts.maxTokens !== undefined ? { max_tokens: opts.maxTokens } : {}),\n      ...(opts.tools ? { tools: opts.tools } : {}),\n    };\n  }\n\n  private chatHeaders(opts: ChatOptions): Record<string, string> {\n    const h: Record<string, string> = {};\n    const session = opts.sessionId ?? this.sessionId;\n    if (session) h['x-codai-session-id'] = session;\n    if (opts.agentMode) h['x-codai-mode'] = 'agent';\n    if (opts.compact) h['x-codai-compact'] = opts.compact;\n    if (opts.bestOf !== undefined) h['x-codai-best-of'] = String(opts.bestOf);\n    if (opts.agentId) h['x-codai-agent-id'] = opts.agentId;\n    return h;\n  }\n\n  private async request(\n    path: string,\n    body: unknown,\n    init: { signal?: AbortSignal; headers?: Record<string, string>; method?: string } = {},\n  ): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    let lastErr: unknown;\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      try {\n        const res = await fetch(url, {\n          method: init.method ?? 'POST',\n          headers: {\n            Authorization: `Bearer ${this.apiKey}`,\n            ...(body !== null ? { 'Content-Type': 'application/json' } : {}),\n            ...init.headers,\n          },\n          ...(body !== null ? { body: JSON.stringify(body) } : {}),\n          signal: init.signal ?? AbortSignal.timeout(this.timeoutMs),\n        });\n        if (res.ok) return res;\n        if (RETRYABLE.has(res.status) && attempt < this.maxRetries) {\n          await sleep(500 * 2 ** attempt + Math.random() * 250);\n          continue;\n        }\n        let errBody: unknown = null;\n        try {\n          errBody = await res.json();\n        } catch {\n          /* non-JSON error */\n        }\n        throw new CodaiError(`codai ${path} → ${res.status}`, res.status, errBody);\n      } catch (err) {\n        if (err instanceof CodaiError) throw err;\n        lastErr = err;\n        if (attempt < this.maxRetries) {\n          await sleep(500 * 2 ** attempt);\n          continue;\n        }\n      }\n    }\n    throw new CodaiError(`codai ${path} failed after retries: ${String(lastErr)}`, 0, null);\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\nexport default Codai;\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "codai-sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the codai AI gateway - chat, streaming, agents, feedback, models.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "provenance": true
+  },
+  "keywords": [
+    "codai",
+    "ai",
+    "llm",
+    "openai-compatible",
+    "gateway",
+    "agents"
+  ],
+  "homepage": "https://codai.ro",
+  "bugs": "https://github.com/dragoscv/codai-sdk/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dragoscv/codai-sdk.git"
+  },
+  "scripts": {
+    "lint": "echo 'lint runs in the codai monorepo'",
+    "typecheck": "tsc --noEmit",
+    "build": "tsup",
+    "test": "vitest run",
+    "clean": "rm -rf .turbo dist"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.7"
+  }
+}