@developerz.ai/aitm 0.0.0

package/dist/mcp/mcp-client.js

@@ -0,0 +1,123 @@
+// Connects to every MCP server declared in `mcpServers` (config) and exposes the
+// union of their tools to subagents. The Vercel AI SDK's @ai-sdk/mcp client gives
+// us tool-conversion; we wire transport per entry and merge the tool maps.
+//
+// docs/vendor/ai-sdk/chunk-15.md §"Initializing an MCP Client"
+// docs/mcp.md
+//
+// Lifecycle: connectAll() at run start, toolsForRole() during agent build, close() on exit
+// (success / blocked / SIGINT). Failures on individual servers are logged + skipped — a
+// broken MCP server should not block the whole run.
+import { experimental_createMCPClient } from '@ai-sdk/mcp';
+import { Experimental_StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';
+export class McpClientManager {
+    init;
+    createClient;
+    servers = [];
+    constructor(init) {
+        this.init = init;
+        this.createClient = init.createClient ?? experimental_createMCPClient;
+    }
+    async connectAll() {
+        for (const [name, server] of Object.entries(this.init.servers)) {
+            // Track the client outside the try so a failure during tools() can still
+            // close the spawned process / socket instead of leaking it.
+            let client;
+            try {
+                const transport = transportKind(server);
+                client = await this.createClient(buildClientConfig(name, server));
+                const tools = (await client.tools());
+                this.servers.push({ name, transport, client, tools });
+            }
+            catch (err) {
+                if (client) {
+                    try {
+                        await client.close();
+                    }
+                    catch (closeErr) {
+                        this.init.logger?.warn('mcp server cleanup failed', {
+                            name,
+                            error: errorMessage(closeErr),
+                        });
+                    }
+                }
+                this.init.logger?.warn('mcp server connect failed', {
+                    name,
+                    error: errorMessage(err),
+                });
+            }
+        }
+    }
+    toolsForRole(role) {
+        const allowed = this.init.roleAllowlist?.[role];
+        const merged = {};
+        const owner = new Map();
+        for (const s of this.servers) {
+            if (allowed !== undefined && !allowed.includes(s.name))
+                continue;
+            for (const [toolName, tool] of Object.entries(s.tools)) {
+                const previous = owner.get(toolName);
+                if (previous !== undefined) {
+                    this.init.logger?.warn('duplicate mcp tool name', {
+                        tool: toolName,
+                        server: s.name,
+                        existingServer: previous,
+                    });
+                    continue;
+                }
+                merged[toolName] = tool;
+                owner.set(toolName, s.name);
+            }
+        }
+        return merged;
+    }
+    async close() {
+        const toClose = this.servers;
+        this.servers = [];
+        await Promise.all(toClose.map(async (s) => {
+            try {
+                await s.client.close();
+            }
+            catch (err) {
+                this.init.logger?.warn('mcp server close failed', {
+                    name: s.name,
+                    error: errorMessage(err),
+                });
+            }
+        }));
+    }
+    connected() {
+        return this.servers.map((s) => ({
+            name: s.name,
+            toolCount: Object.keys(s.tools).length,
+            transport: s.transport,
+        }));
+    }
+}
+function transportKind(server) {
+    if ('url' in server)
+        return server.type;
+    return 'stdio';
+}
+function buildClientConfig(name, server) {
+    if ('url' in server) {
+        const transport = server.headers
+            ? { type: server.type, url: server.url, headers: server.headers }
+            : { type: server.type, url: server.url };
+        return { transport, clientName: clientNameFor(name) };
+    }
+    const stdio = new Experimental_StdioMCPTransport({
+        command: server.command,
+        ...(server.args ? { args: server.args } : {}),
+        ...(server.env ? { env: server.env } : {}),
+        ...(server.cwd ? { cwd: server.cwd } : {}),
+    });
+    return { transport: stdio, clientName: clientNameFor(name) };
+}
+function clientNameFor(name) {
+    return `aitm-${name}`;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,2EAA2E;AAC3E,EAAE;AACF,+DAA+D;AAC/D,cAAc;AACd,EAAE;AACF,2FAA2F;AAC3F,wFAAwF;AACxF,oDAAoD;AAEpD,OAAO,EAAE,4BAA4B,EAAwC,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AA4BvE,MAAM,OAAO,gBAAgB;IAIE;IAHZ,YAAY,CAAkB;IACvC,OAAO,GAAsB,EAAE,CAAC;IAExC,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,4BAA4B,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,yEAAyE;YACzE,4DAA4D;YAC5D,IAAI,MAA6B,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;gBACxC,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBAClE,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAY,CAAC;gBAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvB,CAAC;oBAAC,OAAO,QAAQ,EAAE,CAAC;wBAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE;4BAClD,IAAI;4BACJ,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;yBAC9B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE;oBAClD,IAAI;oBACJ,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAU;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YACjE,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE;wBAChD,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,CAAC,CAAC,IAAI;wBACd,cAAc,EAAE,QAAQ;qBACzB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE;oBAChD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;YACtC,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAiB;IACtC,IAAI,KAAK,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAiB;IACxD,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,SAAS,GAAiC,MAAM,CAAC,OAAO;YAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;YACjE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;QAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,8BAA8B,CAAC;QAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/mcp/schema.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export declare const McpStdioServerSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"stdio">>;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type McpStdioServer = z.infer<typeof McpStdioServerSchema>;
+export declare const McpSseServerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type McpSseServer = z.infer<typeof McpSseServerSchema>;
+export declare const McpHttpServerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type McpHttpServer = z.infer<typeof McpHttpServerSchema>;
+export declare const McpServerSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"stdio">>;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>]>;
+export type McpServer = z.infer<typeof McpServerSchema>;
+export declare const McpServersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodLiteral<"stdio">>;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>]>>;
+export type McpServers = z.infer<typeof McpServersSchema>;

package/dist/mcp/schema.js

@@ -0,0 +1,39 @@
+// MCP *client* config — aitm consumes external MCP servers as additional tool surfaces
+// for subagents. aitm is NOT exposed as an MCP server (banned by CLAUDE.md §"Out of scope").
+//
+// Shape mirrors Claude Code's `mcpServers` config — three transports, same keys.
+// Refs:
+//   https://code.claude.com/docs/en/mcp                    (Claude Code reference)
+//   https://modelcontextprotocol.io/                       (spec)
+//   docs/vendor/ai-sdk/chunk-15.md §"Model Context Protocol" (Vercel AI SDK client)
+//
+// Transports:
+//   stdio — local binary launched as a child process. Default when `type` omitted.
+//   sse   — HTTP server-sent events. URL + optional headers.
+//   http  — Streamable HTTP transport. URL + optional headers. Preferred for production.
+import { z } from 'zod';
+export const McpStdioServerSchema = z.object({
+    type: z.literal('stdio').optional(),
+    command: z.string(),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    // Working directory for the spawned process. Defaults to repo root.
+    cwd: z.string().optional(),
+});
+export const McpSseServerSchema = z.object({
+    type: z.literal('sse'),
+    url: z.string().url(),
+    headers: z.record(z.string(), z.string()).optional(),
+});
+export const McpHttpServerSchema = z.object({
+    type: z.literal('http'),
+    url: z.string().url(),
+    headers: z.record(z.string(), z.string()).optional(),
+});
+export const McpServerSchema = z.union([
+    McpStdioServerSchema,
+    McpSseServerSchema,
+    McpHttpServerSchema,
+]);
+export const McpServersSchema = z.record(z.string(), McpServerSchema);
+//# sourceMappingURL=schema.js.map

package/dist/mcp/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/mcp/schema.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,6FAA6F;AAC7F,EAAE;AACF,iFAAiF;AACjF,QAAQ;AACR,mFAAmF;AACnF,kEAAkE;AAClE,oFAAoF;AACpF,EAAE;AACF,cAAc;AACd,mFAAmF;AACnF,6DAA6D;AAC7D,yFAAyF;AAEzF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,oEAAoE;IACpE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC"}

package/dist/openrouter/client.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const OpenRouterModelSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    context_length: z.ZodNumber;
+    pricing: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodString>;
+        completion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type OpenRouterModel = z.infer<typeof OpenRouterModelSchema>;
+export declare const OpenRouterModelsResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        context_length: z.ZodNumber;
+        pricing: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodString>;
+            completion: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export declare class OpenRouterClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    listModels(): Promise<OpenRouterModel[]>;
+}

package/dist/openrouter/client.js

@@ -0,0 +1,40 @@
+// Thin OpenRouter API client. Only the endpoints we actually need:
+//   GET /api/v1/models — model catalog including context length / pricing.
+// docs/auth.md §"LLM provider", docs/runtime.md (web fetch, not Bun.fetch).
+import { z } from 'zod';
+export const OpenRouterModelSchema = z
+    .object({
+    id: z.string(),
+    name: z.string().optional(),
+    context_length: z.number().int().positive(),
+    pricing: z
+        .object({
+        prompt: z.string().optional(),
+        completion: z.string().optional(),
+    })
+        .optional(),
+})
+    .passthrough();
+export const OpenRouterModelsResponseSchema = z.object({
+    data: z.array(OpenRouterModelSchema),
+});
+export class OpenRouterClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = 'https://openrouter.ai/api/v1') {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async listModels() {
+        const res = await fetch(`${this.baseUrl}/models`, {
+            headers: { Authorization: `Bearer ${this.apiKey}` },
+        });
+        if (!res.ok) {
+            const excerpt = (await res.text()).slice(0, 500);
+            throw new Error(`OpenRouter /models failed: ${res.status} ${res.statusText} — ${excerpt}`);
+        }
+        const json = await res.json();
+        return OpenRouterModelsResponseSchema.parse(json).data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/openrouter/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/openrouter/client.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,2EAA2E;AAC3E,4EAA4E;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,MAAc,EACd,UAAkB,8BAA8B;QADhD,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAyC;IAChE,CAAC;IAEJ,KAAK,CAAC,UAAU;QACd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,EAAE;YAChD,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;SACpD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,IAAI,GAAY,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACvC,OAAO,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;CACF"}

package/dist/openrouter/model-limits.d.ts

@@ -0,0 +1,21 @@
+import type { OpenRouterClient } from './client.ts';
+export type ModelLimits = {
+    modelId: string;
+    contextLength: number;
+};
+export type ModelLimitsLookup = {
+    forModel(modelId: string): Promise<ModelLimits>;
+    preload(): Promise<void>;
+};
+export declare class ModelNotFound extends Error {
+    readonly modelId: string;
+    readonly name = "ModelNotFound";
+    constructor(modelId: string);
+}
+export declare class ModelLimitsRegistry implements ModelLimitsLookup {
+    private readonly client;
+    private cache;
+    constructor(client: OpenRouterClient);
+    forModel(modelId: string): Promise<ModelLimits>;
+    preload(): Promise<void>;
+}

package/dist/openrouter/model-limits.js

@@ -0,0 +1,39 @@
+// Exposes per-model limits (context window, pricing hints) used by the Compactor.
+// Cached per-run after first fetch — model catalog changes slowly.
+// docs/auth.md, src/compaction/compactor.ts
+export class ModelNotFound extends Error {
+    modelId;
+    name = 'ModelNotFound';
+    constructor(modelId) {
+        super(`Model not found in OpenRouter catalog: ${modelId}`);
+        this.modelId = modelId;
+    }
+}
+export class ModelLimitsRegistry {
+    client;
+    cache;
+    constructor(client) {
+        this.client = client;
+    }
+    async forModel(modelId) {
+        if (!this.cache) {
+            await this.preload();
+        }
+        const hit = this.cache?.get(modelId);
+        if (!hit) {
+            throw new ModelNotFound(modelId);
+        }
+        return hit;
+    }
+    async preload() {
+        if (this.cache)
+            return;
+        const models = await this.client.listModels();
+        const next = new Map();
+        for (const m of models) {
+            next.set(m.id, { modelId: m.id, contextLength: m.context_length });
+        }
+        this.cache = next;
+    }
+}
+//# sourceMappingURL=model-limits.js.map

package/dist/openrouter/model-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-limits.js","sourceRoot":"","sources":["../../src/openrouter/model-limits.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,mEAAmE;AACnE,4CAA4C;AAgB5C,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEV;IADV,IAAI,GAAG,eAAe,CAAC;IACzC,YAA4B,OAAe;QACzC,KAAK,CAAC,0CAA0C,OAAO,EAAE,CAAC,CAAC;QADjC,YAAO,GAAP,OAAO,CAAQ;IAE3C,CAAC;CACF;AAED,MAAM,OAAO,mBAAmB;IAGD;IAFrB,KAAK,CAAuC;IAEpD,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEzD,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF"}

package/dist/openrouter/server-tools.d.ts

@@ -0,0 +1,35 @@
+export type WebSearchEngine = 'auto' | 'native' | 'exa' | 'firecrawl' | 'parallel';
+export type WebSearchOptions = {
+    engine?: WebSearchEngine;
+    max_results?: number;
+    max_total_results?: number;
+    search_context_size?: 'low' | 'medium' | 'high';
+    allowed_domains?: string[];
+    excluded_domains?: string[];
+    user_location?: {
+        type: 'approximate';
+        city?: string;
+        country?: string;
+    };
+};
+export type WebFetchOptions = {
+    engine?: 'auto' | 'openrouter' | 'exa' | 'firecrawl' | 'native';
+    max_uses?: number;
+    max_content_tokens?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+};
+export type ServerToolPayload = {
+    type: 'openrouter:web_search';
+    parameters?: WebSearchOptions;
+} | {
+    type: 'openrouter:web_fetch';
+    parameters?: WebFetchOptions;
+};
+export declare function webSearchTool(options?: WebSearchOptions): ServerToolPayload;
+export declare function webFetchServerTool(options?: WebFetchOptions): ServerToolPayload;
+export declare function providerOptionsWithServerTools(tools: ReadonlyArray<ServerToolPayload>): {
+    openrouter: {
+        tools: ServerToolPayload[];
+    };
+};

package/dist/openrouter/server-tools.js

@@ -0,0 +1,25 @@
+// OpenRouter server tools — model-decides tools executed on OpenRouter's side.
+// These are NOT Vercel AI SDK function tools; they ride in `providerOptions.openrouter`
+// (or equivalent extraBody) so OpenRouter sees them in the request `tools[]` array verbatim.
+//
+// Refs:
+//   https://openrouter.ai/docs/guides/features/server-tools/web-search
+//   https://openrouter.ai/docs/guides/features/server-tools/web-fetch
+//
+// Web search → citations land as annotations[].url_citation on the assistant message,
+// plus usage.server_tool_use.web_search_requests for cost accounting. No round-trip.
+// Web fetch → standard tool_call round-trip with { url, title, content, status, retrieved_at }.
+export function webSearchTool(options = {}) {
+    return { type: 'openrouter:web_search', parameters: options };
+}
+// Renamed from webFetchTool — the canonical webFetchTool is now the local variant in
+// src/tools/web-fetch.ts. This one is the explicit "delegate to OpenRouter" opt-in.
+export function webFetchServerTool(options = {}) {
+    return { type: 'openrouter:web_fetch', parameters: options };
+}
+// Build the providerOptions.openrouter fragment to be merged into an AI SDK call.
+// Usage at the model handle layer (src/credentials/credentials.ts) — see Credentials.modelFor.
+export function providerOptionsWithServerTools(tools) {
+    return { openrouter: { tools: [...tools] } };
+}
+//# sourceMappingURL=server-tools.js.map

package/dist/openrouter/server-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tools.js","sourceRoot":"","sources":["../../src/openrouter/server-tools.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wFAAwF;AACxF,6FAA6F;AAC7F,EAAE;AACF,QAAQ;AACR,uEAAuE;AACvE,sEAAsE;AACtE,EAAE;AACF,sFAAsF;AACtF,qFAAqF;AACrF,gGAAgG;AA0BhG,MAAM,UAAU,aAAa,CAAC,UAA4B,EAAE;IAC1D,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAED,qFAAqF;AACrF,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,UAA2B,EAAE;IAC9D,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,kFAAkF;AAClF,+FAA+F;AAC/F,MAAM,UAAU,8BAA8B,CAAC,KAAuC;IAGpF,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC;AAC/C,CAAC"}

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,60 @@
+import { ToolLoopAgent } from 'ai';
+import type { AgentConfig } from '../agent-config/agent-config-detector.ts';
+import type { CreatePrInput } from '../github/github-client.ts';
+import type { PullRequest, ReviewThread } from '../github/schema.ts';
+import type { PrGroup } from '../state/schema.ts';
+import type { PlannerTools } from '../subagents/planner.ts';
+import type { ReviewerTools } from '../subagents/reviewer.ts';
+import type { WorkerDelivery, WorkerTools } from '../subagents/worker.ts';
+import { type ModelProvider, makePlannerTool, makeReviewerTool, makeWorkerTool } from './subagent-tools.ts';
+export type GhClient = {
+    createPr(input: CreatePrInput): Promise<PullRequest>;
+};
+export type RunCmdOptions = {
+    cwd?: string;
+};
+export type RunCmdResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+};
+export type RunCmd = (file: string, args: readonly string[], options?: RunCmdOptions) => Promise<RunCmdResult>;
+export declare const defaultRunCmd: RunCmd;
+export declare const ORCHESTRATOR_ROLE_PREFIX: string;
+export type OrchestratorInit = {
+    credentials: ModelProvider;
+    agentConfig: AgentConfig;
+    rollingContext: string;
+    maxSessions: number | null;
+    github: GhClient;
+    runCmd?: RunCmd;
+};
+export type OrchestratorBuildContext = {
+    plannerTools: PlannerTools;
+    workerTools: WorkerTools;
+    reviewerTools: ReviewerTools;
+    worktreePath: string;
+    baseBranch: string;
+    group: PrGroup;
+    pr: number;
+    threads: ReviewThread[];
+};
+export type OrchestratorTools = {
+    planner: ReturnType<typeof makePlannerTool>;
+    worker: ReturnType<typeof makeWorkerTool>;
+    reviewer: ReturnType<typeof makeReviewerTool>;
+};
+export declare const DEFAULT_MAX_STEPS = 50;
+export declare function resolveMaxSteps(maxSessions: number | null): number;
+export declare class Orchestrator {
+    private readonly init;
+    constructor(init: OrchestratorInit);
+    build(context: OrchestratorBuildContext): ToolLoopAgent<never, OrchestratorTools>;
+    buildSystemPrompt(): string;
+    finalizeCommit(group: PrGroup, delivery: WorkerDelivery, worktreePath: string): Promise<string>;
+    openPr(group: PrGroup, delivery: WorkerDelivery, baseBranch: string): Promise<PullRequest>;
+    private refineCommitMessage;
+    private buildCommitPrompt;
+    private composePr;
+    private buildPrPrompt;
+}