ada-agent 0.2.0 → 0.3.0

package/src/server/config.ts

@@ -1,65 +1,65 @@
-// Backend configuration: provider upstreams, keys, client-key auth, port.
-// Everything is env-driven. The backend is the only place provider keys live.
-
-import { getCredential } from "./credentials.ts";
-import type { ProviderName } from "../shared/types.ts";
-
-export interface ProviderDef {
-  baseURL: string; // OpenAI-compatible base (…/v1) — every provider is proxied as-is
-  keyEnv: string; // env var holding this provider's key ("" = keyless, e.g. local Ollama)
-}
-
-export const PROVIDERS: Record<ProviderName, ProviderDef> = {
-  openai: { baseURL: "https://api.openai.com/v1", keyEnv: "OPENAI_API_KEY" },
-  anthropic: { baseURL: "https://api.anthropic.com/v1", keyEnv: "ANTHROPIC_API_KEY" },
-  google: { baseURL: "https://generativelanguage.googleapis.com/v1beta/openai", keyEnv: "GEMINI_API_KEY" },
-  mistral: { baseURL: "https://api.mistral.ai/v1", keyEnv: "MISTRAL_API_KEY" },
-  openrouter: { baseURL: "https://openrouter.ai/api/v1", keyEnv: "OPENROUTER_API_KEY" },
-  groq: { baseURL: "https://api.groq.com/openai/v1", keyEnv: "GROQ_API_KEY" },
-  deepseek: { baseURL: "https://api.deepseek.com", keyEnv: "DEEPSEEK_API_KEY" },
-  together: { baseURL: "https://api.together.xyz/v1", keyEnv: "TOGETHER_API_KEY" },
-  xai: { baseURL: "https://api.x.ai/v1", keyEnv: "XAI_API_KEY" },
-  dashscope: {
-    baseURL: process.env.DASHSCOPE_BASE_URL ?? "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
-    keyEnv: "DASHSCOPE_API_KEY",
-  },
-  // GitHub Copilot — OpenAI-compatible chat endpoint. COPILOT_API_KEY must be a Copilot *bearer*
-  // token (exchanged from a GitHub OAuth token at /copilot_internal/v2/token — that exchange is not
-  // implemented here; it needs a Copilot subscription). Required headers are added in the adapter.
-  copilot: { baseURL: process.env.COPILOT_BASE_URL ?? "https://api.githubcopilot.com", keyEnv: "COPILOT_API_KEY" },
-  // Cloudflare Workers AI / AI Gateway — OpenAI-compatible. Workers AI: set CLOUDFLARE_ACCOUNT_ID +
-  // CLOUDFLARE_API_TOKEN (default URL). AI Gateway: point CLOUDFLARE_BASE_URL at the gateway URL.
-  // Model ids are `@cf/<vendor>/<model>` (e.g. @cf/moonshotai/kimi-k2.7-code) — sent through as-is.
-  cloudflare: {
-    baseURL: process.env.CLOUDFLARE_BASE_URL ?? `https://api.cloudflare.com/client/v4/accounts/${process.env.CLOUDFLARE_ACCOUNT_ID ?? ""}/ai/v1`,
-    keyEnv: "CLOUDFLARE_API_TOKEN",
-  },
-  ollama: { baseURL: process.env.OLLAMA_BASE_URL ?? "http://localhost:11434/v1", keyEnv: "" },
-};
-
-export const PORT = Number(process.env.ADA_PORT) || 8787;
-
-/** The ada client keys allowed to use this backend. null = auth disabled (dev mode). */
-export function clientKeys(): string[] | null {
-  const v = process.env.ADA_CLIENT_KEYS;
-  if (!v) return null;
-  return v.split(",").map((s) => s.trim()).filter(Boolean);
-}
-
-/** The upstream provider key: env var first, then a stored credential (API key or OAuth token). */
-export function providerKey(p: ProviderName): string | undefined {
-  const env = PROVIDERS[p].keyEnv;
-  if (env && process.env[env]) return process.env[env];
-  const cred = getCredential(p);
-  if (cred) return cred.type === "oauth" ? cred.access : cred.key;
-  return undefined; // keyless provider (Ollama) or unconfigured
-}
-
-/** A provider is usable if it's keyless, its key env var is set, or a credential is stored. */
-export function isConfigured(p: ProviderName): boolean {
-  return PROVIDERS[p].keyEnv === "" || !!process.env[PROVIDERS[p].keyEnv] || !!getCredential(p);
-}
-
-export function configuredProviders(): ProviderName[] {
-  return (Object.keys(PROVIDERS) as ProviderName[]).filter(isConfigured);
-}
+// Backend configuration: provider upstreams, keys, client-key auth, port.
+// Everything is env-driven. The backend is the only place provider keys live.
+
+import { getCredential } from "./credentials.ts";
+import type { ProviderName } from "../shared/types.ts";
+
+export interface ProviderDef {
+  baseURL: string; // OpenAI-compatible base (…/v1) — every provider is proxied as-is
+  keyEnv: string; // env var holding this provider's key ("" = keyless, e.g. local Ollama)
+}
+
+export const PROVIDERS: Record<ProviderName, ProviderDef> = {
+  openai: { baseURL: "https://api.openai.com/v1", keyEnv: "OPENAI_API_KEY" },
+  anthropic: { baseURL: "https://api.anthropic.com/v1", keyEnv: "ANTHROPIC_API_KEY" },
+  google: { baseURL: "https://generativelanguage.googleapis.com/v1beta/openai", keyEnv: "GEMINI_API_KEY" },
+  mistral: { baseURL: "https://api.mistral.ai/v1", keyEnv: "MISTRAL_API_KEY" },
+  openrouter: { baseURL: "https://openrouter.ai/api/v1", keyEnv: "OPENROUTER_API_KEY" },
+  groq: { baseURL: "https://api.groq.com/openai/v1", keyEnv: "GROQ_API_KEY" },
+  deepseek: { baseURL: "https://api.deepseek.com", keyEnv: "DEEPSEEK_API_KEY" },
+  together: { baseURL: "https://api.together.xyz/v1", keyEnv: "TOGETHER_API_KEY" },
+  xai: { baseURL: "https://api.x.ai/v1", keyEnv: "XAI_API_KEY" },
+  dashscope: {
+    baseURL: process.env.DASHSCOPE_BASE_URL ?? "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+    keyEnv: "DASHSCOPE_API_KEY",
+  },
+  // GitHub Copilot — OpenAI-compatible chat endpoint. COPILOT_API_KEY must be a Copilot *bearer*
+  // token (exchanged from a GitHub OAuth token at /copilot_internal/v2/token — that exchange is not
+  // implemented here; it needs a Copilot subscription). Required headers are added in the adapter.
+  copilot: { baseURL: process.env.COPILOT_BASE_URL ?? "https://api.githubcopilot.com", keyEnv: "COPILOT_API_KEY" },
+  // Cloudflare Workers AI / AI Gateway — OpenAI-compatible. Workers AI: set CLOUDFLARE_ACCOUNT_ID +
+  // CLOUDFLARE_API_TOKEN (default URL). AI Gateway: point CLOUDFLARE_BASE_URL at the gateway URL.
+  // Model ids are `@cf/<vendor>/<model>` (e.g. @cf/moonshotai/kimi-k2.7-code) — sent through as-is.
+  cloudflare: {
+    baseURL: process.env.CLOUDFLARE_BASE_URL ?? `https://api.cloudflare.com/client/v4/accounts/${process.env.CLOUDFLARE_ACCOUNT_ID ?? ""}/ai/v1`,
+    keyEnv: "CLOUDFLARE_API_TOKEN",
+  },
+  ollama: { baseURL: process.env.OLLAMA_BASE_URL ?? "http://localhost:11434/v1", keyEnv: "" },
+};
+
+export const PORT = Number(process.env.ADA_PORT) || 8787;
+
+/** The ada client keys allowed to use this backend. null = auth disabled (dev mode). */
+export function clientKeys(): string[] | null {
+  const v = process.env.ADA_CLIENT_KEYS;
+  if (!v) return null;
+  return v.split(",").map((s) => s.trim()).filter(Boolean);
+}
+
+/** The upstream provider key: env var first, then a stored credential (API key or OAuth token). */
+export function providerKey(p: ProviderName): string | undefined {
+  const env = PROVIDERS[p].keyEnv;
+  if (env && process.env[env]) return process.env[env];
+  const cred = getCredential(p);
+  if (cred) return cred.type === "oauth" ? cred.access : cred.key;
+  return undefined; // keyless provider (Ollama) or unconfigured
+}
+
+/** A provider is usable if it's keyless, its key env var is set, or a credential is stored. */
+export function isConfigured(p: ProviderName): boolean {
+  return PROVIDERS[p].keyEnv === "" || !!process.env[PROVIDERS[p].keyEnv] || !!getCredential(p);
+}
+
+export function configuredProviders(): ProviderName[] {
+  return (Object.keys(PROVIDERS) as ProviderName[]).filter(isConfigured);
+}

package/src/server/providers/openai-compat.ts

@@ -1,78 +1,78 @@
-// OpenAI-compatible adapter. Covers every provider that speaks the OpenAI Chat
-// Completions format: OpenAI, Mistral, Groq, DeepSeek, xAI, OpenRouter, Together, Ollama,
-// and Gemini (via Google's OpenAI-compatible endpoint). Because the client also speaks
-// that format, this adapter just swaps in the upstream base URL + key and streams the
-// response straight back — no translation needed.
-
-import type { ProviderName } from "../../shared/types.ts";
-import { PROVIDERS, providerKey } from "../config.ts";
-import { SSE_HEADERS } from "../sse.ts";
-import type { Adapter, ChatRequest } from "./adapter.ts";
-
-function authHeaders(provider: ProviderName): Record<string, string> {
-  const key = providerKey(provider);
-  const base: Record<string, string> = key ? { authorization: `Bearer ${key}` } : {};
-  // GitHub Copilot's endpoint requires these editor-identification headers.
-  if (provider === "copilot") return { ...base, "Copilot-Integration-Id": "vscode-chat", "Editor-Version": "ada/0.0.1", "Editor-Plugin-Version": "ada/0.0.1" };
-  return base;
-}
-
-export const openAICompatAdapter: Adapter = {
-  async chat({ provider, body, res }: ChatRequest): Promise<void> {
-    const def = PROVIDERS[provider];
-    // Strip a leading "<provider>/" the router used only to disambiguate (copilot/groq/together) — the
-    // endpoint wants the bare id. (Cloudflare's "@cf/…" ids aren't "cloudflare/…", so they pass through.)
-    const prefix = `${provider}/`;
-    const outBody = typeof body.model === "string" && body.model.startsWith(prefix) ? { ...body, model: body.model.slice(prefix.length) } : body;
-    let upstream: Awaited<ReturnType<typeof fetch>>;
-    try {
-      upstream = await fetch(`${def.baseURL}/chat/completions`, {
-        method: "POST",
-        headers: { "content-type": "application/json", ...authHeaders(provider) },
-        body: JSON.stringify(outBody),
-      });
-    } catch (e) {
-      res.writeHead(502, { "content-type": "application/json" });
-      res.end(
-        JSON.stringify({
-          error: { message: `could not reach ${provider} upstream at ${def.baseURL}: ${e instanceof Error ? e.message : String(e)}` },
-        }),
-      );
-      return;
-    }
-
-    if (!upstream.ok || !upstream.body) {
-      const text = await upstream.text().catch(() => "");
-      res.writeHead(upstream.status || 502, { "content-type": "application/json" });
-      res.end(text || JSON.stringify({ error: { message: `upstream error ${upstream.status}` } }));
-      return;
-    }
-
-    if (body.stream) {
-      res.writeHead(200, SSE_HEADERS);
-      const reader = upstream.body.getReader();
-      for (;;) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        if (value) res.write(Buffer.from(value));
-      }
-      res.end();
-    } else {
-      const text = await upstream.text();
-      res.writeHead(upstream.status, { "content-type": upstream.headers.get("content-type") ?? "application/json" });
-      res.end(text);
-    }
-  },
-
-  async listModels(provider: ProviderName): Promise<string[]> {
-    const def = PROVIDERS[provider];
-    try {
-      const r = await fetch(`${def.baseURL}/models`, { headers: authHeaders(provider) });
-      if (!r.ok) return [];
-      const j = (await r.json()) as { data?: Array<{ id?: unknown }> };
-      return (j.data ?? []).map((m) => m.id).filter((x): x is string => typeof x === "string");
-    } catch {
-      return [];
-    }
-  },
-};
+// OpenAI-compatible adapter. Covers every provider that speaks the OpenAI Chat
+// Completions format: OpenAI, Mistral, Groq, DeepSeek, xAI, OpenRouter, Together, Ollama,
+// and Gemini (via Google's OpenAI-compatible endpoint). Because the client also speaks
+// that format, this adapter just swaps in the upstream base URL + key and streams the
+// response straight back — no translation needed.
+
+import type { ProviderName } from "../../shared/types.ts";
+import { PROVIDERS, providerKey } from "../config.ts";
+import { SSE_HEADERS } from "../sse.ts";
+import type { Adapter, ChatRequest } from "./adapter.ts";
+
+function authHeaders(provider: ProviderName): Record<string, string> {
+  const key = providerKey(provider);
+  const base: Record<string, string> = key ? { authorization: `Bearer ${key}` } : {};
+  // GitHub Copilot's endpoint requires these editor-identification headers.
+  if (provider === "copilot") return { ...base, "Copilot-Integration-Id": "vscode-chat", "Editor-Version": "ada/0.0.1", "Editor-Plugin-Version": "ada/0.0.1" };
+  return base;
+}
+
+export const openAICompatAdapter: Adapter = {
+  async chat({ provider, body, res }: ChatRequest): Promise<void> {
+    const def = PROVIDERS[provider];
+    // Strip a leading "<provider>/" the router used only to disambiguate (copilot/groq/together) — the
+    // endpoint wants the bare id. (Cloudflare's "@cf/…" ids aren't "cloudflare/…", so they pass through.)
+    const prefix = `${provider}/`;
+    const outBody = typeof body.model === "string" && body.model.startsWith(prefix) ? { ...body, model: body.model.slice(prefix.length) } : body;
+    let upstream: Awaited<ReturnType<typeof fetch>>;
+    try {
+      upstream = await fetch(`${def.baseURL}/chat/completions`, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...authHeaders(provider) },
+        body: JSON.stringify(outBody),
+      });
+    } catch (e) {
+      res.writeHead(502, { "content-type": "application/json" });
+      res.end(
+        JSON.stringify({
+          error: { message: `could not reach ${provider} upstream at ${def.baseURL}: ${e instanceof Error ? e.message : String(e)}` },
+        }),
+      );
+      return;
+    }
+
+    if (!upstream.ok || !upstream.body) {
+      const text = await upstream.text().catch(() => "");
+      res.writeHead(upstream.status || 502, { "content-type": "application/json" });
+      res.end(text || JSON.stringify({ error: { message: `upstream error ${upstream.status}` } }));
+      return;
+    }
+
+    if (body.stream) {
+      res.writeHead(200, SSE_HEADERS);
+      const reader = upstream.body.getReader();
+      for (;;) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        if (value) res.write(Buffer.from(value));
+      }
+      res.end();
+    } else {
+      const text = await upstream.text();
+      res.writeHead(upstream.status, { "content-type": upstream.headers.get("content-type") ?? "application/json" });
+      res.end(text);
+    }
+  },
+
+  async listModels(provider: ProviderName): Promise<string[]> {
+    const def = PROVIDERS[provider];
+    try {
+      const r = await fetch(`${def.baseURL}/models`, { headers: authHeaders(provider) });
+      if (!r.ok) return [];
+      const j = (await r.json()) as { data?: Array<{ id?: unknown }> };
+      return (j.data ?? []).map((m) => m.id).filter((x): x is string => typeof x === "string");
+    } catch {
+      return [];
+    }
+  },
+};

package/src/server/providers/registry.ts

@@ -1,32 +1,32 @@
-// Provider → adapter map. This table is the whole routing story at a glance:
-// who shares the OpenAI-compatible adapter, and who has a dedicated one.
-//
-// Adding support is obvious from here:
-//   - new model on an existing provider      → nothing to change
-//   - new OpenAI-compatible provider          → add it in config.ts + a line below
-//   - new provider with a divergent format    → write an adapter, map it below
-
-import type { ProviderName } from "../../shared/types.ts";
-import type { Adapter } from "./adapter.ts";
-import { anthropicAdapter } from "./anthropic.ts";
-import { openAICompatAdapter } from "./openai-compat.ts";
-
-const ADAPTERS: Record<ProviderName, Adapter> = {
-  anthropic: anthropicAdapter, // native: Anthropic Messages API
-  openai: openAICompatAdapter,
-  google: openAICompatAdapter, // via Google's OpenAI-compatible endpoint
-  mistral: openAICompatAdapter,
-  openrouter: openAICompatAdapter,
-  groq: openAICompatAdapter,
-  deepseek: openAICompatAdapter,
-  together: openAICompatAdapter,
-  xai: openAICompatAdapter,
-  dashscope: openAICompatAdapter, // Alibaba Qwen via DashScope's OpenAI-compatible endpoint
-  copilot: openAICompatAdapter, // GitHub Copilot's OpenAI-compatible endpoint (+ custom headers in the adapter)
-  cloudflare: openAICompatAdapter, // Cloudflare Workers AI / AI Gateway (OpenAI-compatible)
-  ollama: openAICompatAdapter,
-};
-
-export function adapterFor(provider: ProviderName): Adapter {
-  return ADAPTERS[provider];
-}
+// Provider → adapter map. This table is the whole routing story at a glance:
+// who shares the OpenAI-compatible adapter, and who has a dedicated one.
+//
+// Adding support is obvious from here:
+//   - new model on an existing provider      → nothing to change
+//   - new OpenAI-compatible provider          → add it in config.ts + a line below
+//   - new provider with a divergent format    → write an adapter, map it below
+
+import type { ProviderName } from "../../shared/types.ts";
+import type { Adapter } from "./adapter.ts";
+import { anthropicAdapter } from "./anthropic.ts";
+import { openAICompatAdapter } from "./openai-compat.ts";
+
+const ADAPTERS: Record<ProviderName, Adapter> = {
+  anthropic: anthropicAdapter, // native: Anthropic Messages API
+  openai: openAICompatAdapter,
+  google: openAICompatAdapter, // via Google's OpenAI-compatible endpoint
+  mistral: openAICompatAdapter,
+  openrouter: openAICompatAdapter,
+  groq: openAICompatAdapter,
+  deepseek: openAICompatAdapter,
+  together: openAICompatAdapter,
+  xai: openAICompatAdapter,
+  dashscope: openAICompatAdapter, // Alibaba Qwen via DashScope's OpenAI-compatible endpoint
+  copilot: openAICompatAdapter, // GitHub Copilot's OpenAI-compatible endpoint (+ custom headers in the adapter)
+  cloudflare: openAICompatAdapter, // Cloudflare Workers AI / AI Gateway (OpenAI-compatible)
+  ollama: openAICompatAdapter,
+};
+
+export function adapterFor(provider: ProviderName): Adapter {
+  return ADAPTERS[provider];
+}

package/src/server/router.ts

@@ -1,33 +1,33 @@
-// Map a model id (and optional explicit provider) to a provider.
-// Order matters: explicit wins; then the shape of the id (namespaced / local); then base-name prefixes.
-
-import type { ProviderName } from "../shared/types.ts";
-import { PROVIDERS } from "./config.ts";
-
-export function route(model: string, explicit?: string): ProviderName {
-  if (explicit && explicit in PROVIDERS) return explicit as ProviderName;
-
-  const m = model.toLowerCase();
-
-  // "vendor/model" → OpenRouter's namespacing convention. Checked before base-name prefixes
-  // so e.g. "mistralai/…" routes to OpenRouter, not the Mistral API.
-  // Prefixed ids that must beat the OpenRouter "/" rule below:
-  if (m.startsWith("@cf/")) return "cloudflare"; // Cloudflare Workers AI model ids
-  if (m.startsWith("copilot/")) return "copilot";
-  // `groq/…` / `together/…` disambiguate shared model names (llama-3.3, gemma2…) that no prefix can.
-  if (m.startsWith("groq/")) return "groq";
-  if (m.startsWith("together/")) return "together";
-  if (m.includes("/")) return "openrouter";
-  // "model:tag" → a local Ollama model (e.g. gemma4:latest).
-  if (m.includes(":")) return "ollama";
-
-  if (/^(gpt|o1|o3|o4|chatgpt|text-|davinci)/.test(m)) return "openai";
-  if (m.startsWith("claude")) return "anthropic";
-  if (m.startsWith("gemini") || m.startsWith("gemma")) return "google";
-  if (/^(mistral|codestral|magistral|ministral|devstral|pixtral|open-mi)/.test(m)) return "mistral";
-  if (m.startsWith("grok")) return "xai";
-  if (m.startsWith("deepseek")) return "deepseek";
-  if (m.startsWith("qwen") || m.startsWith("qwq")) return "dashscope";
-
-  return "openrouter"; // default: one key, every model
-}
+// Map a model id (and optional explicit provider) to a provider.
+// Order matters: explicit wins; then the shape of the id (namespaced / local); then base-name prefixes.
+
+import type { ProviderName } from "../shared/types.ts";
+import { PROVIDERS } from "./config.ts";
+
+export function route(model: string, explicit?: string): ProviderName {
+  if (explicit && explicit in PROVIDERS) return explicit as ProviderName;
+
+  const m = model.toLowerCase();
+
+  // "vendor/model" → OpenRouter's namespacing convention. Checked before base-name prefixes
+  // so e.g. "mistralai/…" routes to OpenRouter, not the Mistral API.
+  // Prefixed ids that must beat the OpenRouter "/" rule below:
+  if (m.startsWith("@cf/")) return "cloudflare"; // Cloudflare Workers AI model ids
+  if (m.startsWith("copilot/")) return "copilot";
+  // `groq/…` / `together/…` disambiguate shared model names (llama-3.3, gemma2…) that no prefix can.
+  if (m.startsWith("groq/")) return "groq";
+  if (m.startsWith("together/")) return "together";
+  if (m.includes("/")) return "openrouter";
+  // "model:tag" → a local Ollama model (e.g. gemma4:latest).
+  if (m.includes(":")) return "ollama";
+
+  if (/^(gpt|o1|o3|o4|chatgpt|text-|davinci)/.test(m)) return "openai";
+  if (m.startsWith("claude")) return "anthropic";
+  if (m.startsWith("gemini") || m.startsWith("gemma")) return "google";
+  if (/^(mistral|codestral|magistral|ministral|devstral|pixtral|open-mi)/.test(m)) return "mistral";
+  if (m.startsWith("grok")) return "xai";
+  if (m.startsWith("deepseek")) return "deepseek";
+  if (m.startsWith("qwen") || m.startsWith("qwq")) return "dashscope";
+
+  return "openrouter"; // default: one key, every model
+}

package/src/shared/types.ts

@@ -1,21 +1,21 @@
-// Types shared between the ada client and backend.
-
-export type ProviderName =
-  | "openai"
-  | "anthropic"
-  | "google"
-  | "mistral"
-  | "openrouter"
-  | "groq"
-  | "deepseek"
-  | "together"
-  | "xai"
-  | "dashscope"
-  | "copilot"
-  | "cloudflare"
-  | "ollama";
-
-export interface ModelInfo {
-  id: string;
-  provider: ProviderName;
-}
+// Types shared between the ada client and backend.
+
+export type ProviderName =
+  | "openai"
+  | "anthropic"
+  | "google"
+  | "mistral"
+  | "openrouter"
+  | "groq"
+  | "deepseek"
+  | "together"
+  | "xai"
+  | "dashscope"
+  | "copilot"
+  | "cloudflare"
+  | "ollama";
+
+export interface ModelInfo {
+  id: string;
+  provider: ProviderName;
+}