opensquid 0.5.395

package/dist/models/strategies/api_anthropic.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `api + anthropic` strategy: direct provider HTTP API call via the
+ * official Anthropic SDK using the user's API key.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * passed through to the SDK; opensquid treats it as opaque. If the user
+ * leaves `cfg.model` unset, we throw — the source code never picks a
+ * default vendor model.
+ *
+ * Auth: API key resolved via `SecretResolver` (env / .env / op /
+ * keychain — pluggable, see `src/secrets/`). The strategy reads
+ * `env:ANTHROPIC_API_KEY` by default; the URI is a stable contract with
+ * users — DO NOT bake the env var name into a vendor-coupled module.
+ *
+ * Rate-limit retry: exponential backoff (1s, 2s, 4s) on HTTP 429, max 3
+ * retries, then propagate the underlying error. The Anthropic SDK throws
+ * structured `APIError` instances with a `.status` field; we read that
+ * to decide whether to retry. Other error classes fall through to the
+ * caller untouched.
+ *
+ * Lazy load: `@anthropic-ai/sdk` is an OPTIONAL peer dep. Same rationale
+ * as subscription_sdk.ts — startup pays nothing when the package isn't
+ * installed; first `.call()` throws a useful pointer if it's missing.
+ *
+ * Test seam (`opts.sdkModule`): injects a stub Anthropic constructor so
+ * tests can simulate happy path + 429 retry + missing-key without hitting
+ * the network.
+ *
+ * Imports from: ../types.js, ../../secrets/types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { SecretResolver } from '../../secrets/types.js';
+import type { ModelAliasConfig, ModelStrategy } from '../types.js';
+export interface AnthropicTextBlock {
+    type: 'text';
+    text: string;
+}
+export interface AnthropicMessageBlock {
+    type: string;
+    text?: string;
+}
+export interface AnthropicMessageResponse {
+    content: AnthropicMessageBlock[];
+}
+export interface AnthropicClient {
+    messages: {
+        create: (req: {
+            model: string;
+            max_tokens: number;
+            messages: {
+                role: 'user';
+                content: string;
+            }[];
+        }) => Promise<AnthropicMessageResponse>;
+    };
+}
+export interface AnthropicSdkModule {
+    default: new (opts: {
+        apiKey: string;
+    }) => AnthropicClient;
+}
+export interface ApiAnthropicOptions {
+    /** Test seam: inject a stub Anthropic constructor module. */
+    sdkModule?: AnthropicSdkModule;
+}
+export declare function apiAnthropicStrategy(cfg: ModelAliasConfig, secrets: SecretResolver, opts?: ApiAnthropicOptions): ModelStrategy;
+//# sourceMappingURL=api_anthropic.d.ts.map

package/dist/models/strategies/api_anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_anthropic.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/api_anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAcnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,GAAG,EAAE;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,EAAE,CAAC;SAC/C,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,eAAe,CAAC;CAC5D;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AA+BD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B,aAAa,CAqCf"}

package/dist/models/strategies/api_anthropic.js

@@ -0,0 +1,99 @@
+/**
+ * `api + anthropic` strategy: direct provider HTTP API call via the
+ * official Anthropic SDK using the user's API key.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * passed through to the SDK; opensquid treats it as opaque. If the user
+ * leaves `cfg.model` unset, we throw — the source code never picks a
+ * default vendor model.
+ *
+ * Auth: API key resolved via `SecretResolver` (env / .env / op /
+ * keychain — pluggable, see `src/secrets/`). The strategy reads
+ * `env:ANTHROPIC_API_KEY` by default; the URI is a stable contract with
+ * users — DO NOT bake the env var name into a vendor-coupled module.
+ *
+ * Rate-limit retry: exponential backoff (1s, 2s, 4s) on HTTP 429, max 3
+ * retries, then propagate the underlying error. The Anthropic SDK throws
+ * structured `APIError` instances with a `.status` field; we read that
+ * to decide whether to retry. Other error classes fall through to the
+ * caller untouched.
+ *
+ * Lazy load: `@anthropic-ai/sdk` is an OPTIONAL peer dep. Same rationale
+ * as subscription_sdk.ts — startup pays nothing when the package isn't
+ * installed; first `.call()` throws a useful pointer if it's missing.
+ *
+ * Test seam (`opts.sdkModule`): injects a stub Anthropic constructor so
+ * tests can simulate happy path + 429 retry + missing-key without hitting
+ * the network.
+ *
+ * Imports from: ../types.js, ../../secrets/types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+const DEFAULT_MAX_TOKENS = 1024;
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+async function loadSdk() {
+    const moduleName = '@anthropic-ai/sdk';
+    try {
+        const mod = (await import(/* @vite-ignore */ moduleName));
+        return mod;
+    }
+    catch (e) {
+        throw new Error(`api/anthropic strategy: failed to load "${moduleName}". ` +
+            `Install it (\`pnpm add ${moduleName}\`) or pick a different mode. ` +
+            `Cause: ${String(e)}`);
+    }
+}
+function isRateLimitError(e) {
+    // Anthropic SDK throws `APIError` with a `.status` numeric field; some
+    // wrappers stash the same value at `.response.status` or carry a
+    // `retry-after` header. Read defensively — the SDK surface can shift.
+    if (typeof e !== 'object' || e === null)
+        return false;
+    const obj = e;
+    if (obj.status === 429)
+        return true;
+    if (obj.response?.status === 429)
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function apiAnthropicStrategy(cfg, secrets, opts = {}) {
+    return {
+        async call(prompt) {
+            const apiKey = await secrets.resolve('env:ANTHROPIC_API_KEY');
+            if (!apiKey) {
+                throw new Error('ANTHROPIC_API_KEY not configured (api/anthropic strategy)');
+            }
+            if (!cfg.model) {
+                throw new Error('api/anthropic strategy: `model` is required in alias config');
+            }
+            const sdkModule = opts.sdkModule ?? (await loadSdk());
+            const client = new sdkModule.default({ apiKey });
+            let lastErr;
+            for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt += 1) {
+                try {
+                    const res = await client.messages.create({
+                        model: cfg.model,
+                        max_tokens: DEFAULT_MAX_TOKENS,
+                        messages: [{ role: 'user', content: prompt }],
+                    });
+                    const textBlock = res.content.find((c) => c.type === 'text' && typeof c.text === 'string');
+                    return textBlock?.text ?? '';
+                }
+                catch (e) {
+                    lastErr = e;
+                    if (!isRateLimitError(e) || attempt === RETRY_DELAYS_MS.length) {
+                        throw e;
+                    }
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 0);
+                }
+            }
+            // Unreachable — the loop either returns or throws.
+            throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+        },
+    };
+}
+//# sourceMappingURL=api_anthropic.js.map

package/dist/models/strategies/api_anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_anthropic.js","sourceRoot":"","sources":["../../../src/models/strategies/api_anthropic.ts"],"names":[],"mappings":"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"}

package/dist/models/strategies/api_openai.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `api + openai` strategy: direct provider HTTP API call via the official
+ * OpenAI SDK using the user's API key.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * passed through to the SDK; opensquid treats it as opaque. If the user
+ * leaves `cfg.model` unset, we throw — the source code never picks a
+ * default.
+ *
+ * Auth: API key resolved via `SecretResolver`. Default URI is
+ * `env:OPENAI_API_KEY`.
+ *
+ * Rate-limit retry: same shape as api_anthropic.ts — exponential backoff
+ * (1s, 2s, 4s) on HTTP 429, max 3 retries.
+ *
+ * Lazy load: `openai` is an OPTIONAL peer dep.
+ *
+ * Test seam (`opts.sdkModule`): injects a stub OpenAI constructor module.
+ *
+ * Imports from: ../types.js, ../../secrets/types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { SecretResolver } from '../../secrets/types.js';
+import type { ModelAliasConfig, ModelStrategy } from '../types.js';
+export interface OpenAIChatChoice {
+    message?: {
+        content?: string | null;
+    };
+}
+export interface OpenAIChatResponse {
+    choices: OpenAIChatChoice[];
+}
+export interface OpenAIClient {
+    chat: {
+        completions: {
+            create: (req: {
+                model: string;
+                messages: {
+                    role: 'user';
+                    content: string;
+                }[];
+            }) => Promise<OpenAIChatResponse>;
+        };
+    };
+}
+export interface OpenAISdkModule {
+    default: new (opts: {
+        apiKey: string;
+    }) => OpenAIClient;
+}
+export interface ApiOpenAIOptions {
+    /** Test seam: inject a stub OpenAI constructor module. */
+    sdkModule?: OpenAISdkModule;
+}
+export declare function apiOpenAIStrategy(cfg: ModelAliasConfig, secrets: SecretResolver, opts?: ApiOpenAIOptions): ModelStrategy;
+//# sourceMappingURL=api_openai.d.ts.map

package/dist/models/strategies/api_openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_openai.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/api_openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASnE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,GAAG,EAAE;gBACZ,KAAK,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAC;aAC/C,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;SACnC,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AA4BD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,gBAAqB,GAC1B,aAAa,CAgCf"}

package/dist/models/strategies/api_openai.js

@@ -0,0 +1,83 @@
+/**
+ * `api + openai` strategy: direct provider HTTP API call via the official
+ * OpenAI SDK using the user's API key.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * passed through to the SDK; opensquid treats it as opaque. If the user
+ * leaves `cfg.model` unset, we throw — the source code never picks a
+ * default.
+ *
+ * Auth: API key resolved via `SecretResolver`. Default URI is
+ * `env:OPENAI_API_KEY`.
+ *
+ * Rate-limit retry: same shape as api_anthropic.ts — exponential backoff
+ * (1s, 2s, 4s) on HTTP 429, max 3 retries.
+ *
+ * Lazy load: `openai` is an OPTIONAL peer dep.
+ *
+ * Test seam (`opts.sdkModule`): injects a stub OpenAI constructor module.
+ *
+ * Imports from: ../types.js, ../../secrets/types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+async function loadSdk() {
+    const moduleName = 'openai';
+    try {
+        const mod = (await import(/* @vite-ignore */ moduleName));
+        return mod;
+    }
+    catch (e) {
+        throw new Error(`api/openai strategy: failed to load "${moduleName}". ` +
+            `Install it (\`pnpm add ${moduleName}\`) or pick a different mode. ` +
+            `Cause: ${String(e)}`);
+    }
+}
+function isRateLimitError(e) {
+    if (typeof e !== 'object' || e === null)
+        return false;
+    const obj = e;
+    if (obj.status === 429)
+        return true;
+    if (obj.response?.status === 429)
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function apiOpenAIStrategy(cfg, secrets, opts = {}) {
+    return {
+        async call(prompt) {
+            const apiKey = await secrets.resolve('env:OPENAI_API_KEY');
+            if (!apiKey) {
+                throw new Error('OPENAI_API_KEY not configured (api/openai strategy)');
+            }
+            if (!cfg.model) {
+                throw new Error('api/openai strategy: `model` is required in alias config');
+            }
+            const sdkModule = opts.sdkModule ?? (await loadSdk());
+            const client = new sdkModule.default({ apiKey });
+            let lastErr;
+            for (let attempt = 0; attempt <= RETRY_DELAYS_MS.length; attempt += 1) {
+                try {
+                    const res = await client.chat.completions.create({
+                        model: cfg.model,
+                        messages: [{ role: 'user', content: prompt }],
+                    });
+                    return res.choices[0]?.message?.content ?? '';
+                }
+                catch (e) {
+                    lastErr = e;
+                    if (!isRateLimitError(e) || attempt === RETRY_DELAYS_MS.length) {
+                        throw e;
+                    }
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 0);
+                }
+            }
+            throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+        },
+    };
+}
+//# sourceMappingURL=api_openai.js.map

package/dist/models/strategies/api_openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_openai.js","sourceRoot":"","sources":["../../../src/models/strategies/api_openai.ts"],"names":[],"mappings":"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"}

package/dist/models/strategies/local_ollama.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `local + ollama` strategy: HTTP POST to a local (or remote) Ollama
+ * endpoint's `/api/generate` text-completion route.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * (an Ollama tag like `qwen2.5-coder:7b` or whatever the user has
+ * pulled); opensquid treats it as opaque. We throw if `cfg.model` is
+ * unset rather than picking a default — the source code never names a
+ * concrete tag.
+ *
+ * Endpoint: `cfg.endpoint ?? 'http://localhost:11434'`. The default
+ * matches Ollama's bind address out of the box; users running it on a
+ * remote host or a non-default port set `endpoint` in the alias config.
+ *
+ * Related file: `src/rag/ollama_client.ts` exposes `ollamaEmbed` against
+ * the `/api/embed` route. That client is for the RAG embedder; this
+ * strategy is for text generation against `/api/generate`. The request
+ * + response shapes are different — we intentionally do NOT share the
+ * function. Updates to one MUST NOT silently change the other.
+ *
+ * `stream: false` is Phase-1 simplicity. Streaming is a follow-up — the
+ * model-strategy contract returns one string, so streaming would
+ * require either accumulating server-side (defeats streaming) or
+ * extending the strategy surface (Phase 2).
+ *
+ * Test seam: tests pass `opts.fetch` to inject a stub `fetch`. Default
+ * uses the global `fetch`.
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { ModelAliasConfig, ModelStrategy } from '../types.js';
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface LocalOllamaOptions {
+    /** Test seam: inject a stub fetch to avoid hitting the network. */
+    fetch?: FetchLike;
+}
+export declare function localOllamaStrategy(cfg: ModelAliasConfig, opts?: LocalOllamaOptions): ModelStrategy;
+export {};
+//# sourceMappingURL=local_ollama.d.ts.map

package/dist/models/strategies/local_ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_ollama.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/local_ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAMD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAyBf"}

package/dist/models/strategies/local_ollama.js

@@ -0,0 +1,60 @@
+/**
+ * `local + ollama` strategy: HTTP POST to a local (or remote) Ollama
+ * endpoint's `/api/generate` text-completion route.
+ *
+ * Model neutrality (per `feedback_stop_haiku_drift`): NO vendor model
+ * identifier appears in this file. `cfg.model` is the user-supplied id
+ * (an Ollama tag like `qwen2.5-coder:7b` or whatever the user has
+ * pulled); opensquid treats it as opaque. We throw if `cfg.model` is
+ * unset rather than picking a default — the source code never names a
+ * concrete tag.
+ *
+ * Endpoint: `cfg.endpoint ?? 'http://localhost:11434'`. The default
+ * matches Ollama's bind address out of the box; users running it on a
+ * remote host or a non-default port set `endpoint` in the alias config.
+ *
+ * Related file: `src/rag/ollama_client.ts` exposes `ollamaEmbed` against
+ * the `/api/embed` route. That client is for the RAG embedder; this
+ * strategy is for text generation against `/api/generate`. The request
+ * + response shapes are different — we intentionally do NOT share the
+ * function. Updates to one MUST NOT silently change the other.
+ *
+ * `stream: false` is Phase-1 simplicity. Streaming is a follow-up — the
+ * model-strategy contract returns one string, so streaming would
+ * require either accumulating server-side (defeats streaming) or
+ * extending the strategy surface (Phase 2).
+ *
+ * Test seam: tests pass `opts.fetch` to inject a stub `fetch`. Default
+ * uses the global `fetch`.
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+const DEFAULT_ENDPOINT = 'http://localhost:11434';
+export function localOllamaStrategy(cfg, opts = {}) {
+    const endpoint = cfg.endpoint ?? DEFAULT_ENDPOINT;
+    const doFetch = opts.fetch ?? ((input, init) => fetch(input, init));
+    return {
+        async call(prompt) {
+            if (!cfg.model) {
+                throw new Error('local/ollama strategy: `model` is required in alias config');
+            }
+            const res = await doFetch(`${endpoint}/api/generate`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    model: cfg.model,
+                    prompt,
+                    stream: false,
+                }),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                throw new Error(`Ollama ${res.status}: ${body}`);
+            }
+            const data = (await res.json());
+            return data.response;
+        },
+    };
+}
+//# sourceMappingURL=local_ollama.js.map

package/dist/models/strategies/local_ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_ollama.js","sourceRoot":"","sources":["../../../src/models/strategies/local_ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAalD,MAAM,UAAU,mBAAmB,CACjC,GAAqB,EACrB,OAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IAClD,MAAM,OAAO,GAAc,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/E,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAc;YACvB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,QAAQ,eAAe,EAAE;gBACpD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,MAAM;oBACN,MAAM,EAAE,KAAK;iBACd,CAAC;aACH,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;YAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/models/strategies/mcp.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `mcp` strategy: delegate the LLM call to a tool on an external MCP
+ * server. Used when the user wants opensquid to route through a
+ * specialised MCP host (e.g. a routing layer in front of multiple
+ * providers, or a tool that wraps a proprietary endpoint).
+ *
+ * Model neutrality: this file branches on opaque user-supplied strings
+ * (`cfg.server`, `cfg.tool`). The MCP server's own internals decide
+ * which model handles the call — opensquid stays out of that decision.
+ *
+ * Fail-fast at factory time: `cfg.server` + `cfg.tool` are required.
+ * Throwing during `resolveStrategy` (rather than at first `.call()`)
+ * means misconfigured `models.yaml` surfaces during pack load, not
+ * mid-task. This matches the runtime-failure-handling policy
+ * (`project_opensquid_runtime_failure_handling`): validate early.
+ *
+ * Lifecycle:
+ *   For Phase 1 we do connect-per-call: each `.call()` spins up a
+ *   fresh Client + StdioClientTransport, runs `callTool`, then closes.
+ *   Wasteful but simple; connection pooling is deferred. The MCP SDK
+ *   has its own keep-alive semantics inside the Client, but pooling
+ *   across strategy invocations needs a session-scoped cache the
+ *   strategy doesn't currently own.
+ *
+ * Lazy load: `@modelcontextprotocol/sdk` is already a regular dep
+ * (used by the opensquid MCP server itself), so import is just lazy
+ * for startup-cost hygiene — not for optional-install.
+ *
+ * Test seam: tests inject a stub Client + Transport pair via
+ * `opts.client` (factory returning a stub).
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { ModelAliasConfig, ModelStrategy } from '../types.js';
+export interface McpToolResultContent {
+    type: string;
+    text?: string;
+}
+export interface McpToolResult {
+    content?: McpToolResultContent[];
+}
+export interface McpClientLike {
+    connect: (transport: unknown) => Promise<void>;
+    callTool: (req: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }) => Promise<McpToolResult>;
+    close: () => Promise<void>;
+}
+/**
+ * Build a (client, transport) pair for one connect/call/close cycle.
+ * Returning a pair (rather than just a client) lets the factory own
+ * transport construction — stubs don't need to mock StdioClientTransport.
+ */
+export type McpClientFactory = (cfg: ModelAliasConfig) => Promise<{
+    client: McpClientLike;
+    transport: unknown;
+}>;
+export interface McpStrategyOptions {
+    /** Test seam: inject a client+transport factory bypassing the SDK import. */
+    clientFactory?: McpClientFactory;
+}
+export declare function mcpStrategy(cfg: ModelAliasConfig, opts?: McpStrategyOptions): ModelStrategy;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/models/strategies/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAChG,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AA0BD,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,GAAE,kBAAuB,GAAG,aAAa,CAoC/F"}

package/dist/models/strategies/mcp.js

@@ -0,0 +1,86 @@
+/**
+ * `mcp` strategy: delegate the LLM call to a tool on an external MCP
+ * server. Used when the user wants opensquid to route through a
+ * specialised MCP host (e.g. a routing layer in front of multiple
+ * providers, or a tool that wraps a proprietary endpoint).
+ *
+ * Model neutrality: this file branches on opaque user-supplied strings
+ * (`cfg.server`, `cfg.tool`). The MCP server's own internals decide
+ * which model handles the call — opensquid stays out of that decision.
+ *
+ * Fail-fast at factory time: `cfg.server` + `cfg.tool` are required.
+ * Throwing during `resolveStrategy` (rather than at first `.call()`)
+ * means misconfigured `models.yaml` surfaces during pack load, not
+ * mid-task. This matches the runtime-failure-handling policy
+ * (`project_opensquid_runtime_failure_handling`): validate early.
+ *
+ * Lifecycle:
+ *   For Phase 1 we do connect-per-call: each `.call()` spins up a
+ *   fresh Client + StdioClientTransport, runs `callTool`, then closes.
+ *   Wasteful but simple; connection pooling is deferred. The MCP SDK
+ *   has its own keep-alive semantics inside the Client, but pooling
+ *   across strategy invocations needs a session-scoped cache the
+ *   strategy doesn't currently own.
+ *
+ * Lazy load: `@modelcontextprotocol/sdk` is already a regular dep
+ * (used by the opensquid MCP server itself), so import is just lazy
+ * for startup-cost hygiene — not for optional-install.
+ *
+ * Test seam: tests inject a stub Client + Transport pair via
+ * `opts.client` (factory returning a stub).
+ *
+ * Imports from: ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+async function defaultClientFactory(cfg) {
+    // Lazy import — startup cost stays off the fast path.
+    const { Client } = (await import('@modelcontextprotocol/sdk/client/index.js'));
+    const { StdioClientTransport } = (await import('@modelcontextprotocol/sdk/client/stdio.js'));
+    const client = new Client({ name: 'opensquid', version: '0.5.0' }, { capabilities: {} });
+    // cfg.server is treated as a command (binary or path). URL-form
+    // (SSE/HTTP) requires a different transport — Phase 2 will branch
+    // on the shape; for now stdio is the only supported wire.
+    const transport = new StdioClientTransport({
+        command: cfg.server ?? '',
+        args: cfg.args ?? [],
+    });
+    return { client, transport };
+}
+export function mcpStrategy(cfg, opts = {}) {
+    // Fail-fast at factory time so misconfigured models.yaml surfaces during
+    // pack load, not mid-task.
+    if (!cfg.server) {
+        throw new Error('mcp strategy: `server` is required in alias config');
+    }
+    if (!cfg.tool) {
+        throw new Error('mcp strategy: `tool` is required in alias config');
+    }
+    const toolName = cfg.tool;
+    const factory = opts.clientFactory ?? defaultClientFactory;
+    return {
+        async call(prompt) {
+            const { client, transport } = await factory(cfg);
+            await client.connect(transport);
+            try {
+                const result = await client.callTool({
+                    name: toolName,
+                    arguments: { prompt },
+                });
+                const first = result.content?.[0];
+                if (first?.type === 'text' && typeof first.text === 'string') {
+                    return first.text;
+                }
+                return '';
+            }
+            finally {
+                // Always close — connect-per-call leaks otherwise. Errors during
+                // close are swallowed (we've already either returned or are about
+                // to rethrow the callTool error; close failure is secondary).
+                await client.close().catch(() => {
+                    // intentionally swallowed
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/models/strategies/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/models/strategies/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAiCH,KAAK,UAAU,oBAAoB,CACjC,GAAqB;IAErB,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAK5E,CAAC;IACF,MAAM,EAAE,oBAAoB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAE1F,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACzF,gEAAgE;IAChE,kEAAkE;IAClE,0DAA0D;IAC1D,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;QACzB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAqB,EAAE,OAA2B,EAAE;IAC9E,yEAAyE;IACzE,2BAA2B;IAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,oBAAoB,CAAC;IAE3D,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAc;YACvB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;oBACnC,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,EAAE,MAAM,EAAE;iBACtB,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7D,OAAO,KAAK,CAAC,IAAI,CAAC;gBACpB,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;oBAAS,CAAC;gBACT,iEAAiE;gBACjE,kEAAkE;gBAClE,8DAA8D;gBAC9D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC9B,0BAA0B;gBAC5B,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/models/strategies/subscription_cli.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `subscription + cli` strategy: spawn the user's host binary, pipe the
+ * prompt via stdin, capture stdout. The only Phase-1 concrete strategy.
+ *
+ * Model neutrality contract (per `project_opensquid_model_neutral_subagent_primitive`
+ * and the model-name-drift feedback memory): NO vendor identity lives in
+ * this file. `cfg.cli` is the binary name/path supplied by the user's
+ * `models.yaml`; opensquid treats it as an opaque string. The audit-grep
+ * defined in the task spec must return empty against this file.
+ *
+ * Lifecycle:
+ *   1. spawn(cli, args) with stdio: ['pipe', 'pipe', 'pipe']
+ *   2. setTimeout(timeoutMs ?? 30_000) — on fire, SIGTERM the child + reject
+ *   3. write the prompt to stdin and end it (signals EOF to the binary)
+ *   4. accumulate stdout / stderr
+ *   5. on close: clearTimeout; exit 0 → resolve stdout.trim(); else reject
+ *      with stderr-tagged message
+ *
+ * Phase-1 limitation — stdin/stdout deadlock for >64KB prompts:
+ *   Node's pipe stdio uses OS pipe buffers (~64KB on Linux/macOS). For a
+ *   very large prompt, `proc.stdin.write(prompt)` can fill the kernel buffer
+ *   before the child has read enough, and the child may concurrently fill
+ *   its stdout buffer waiting for us to drain — classic mutual-deadlock.
+ *   Phase 1 documents this limit; Phase 2 (cross-cutting LLM track) adds a
+ *   temp-file fallback for prompts above the threshold. Do NOT add a stdin
+ *   `drain` handler here without the temp-file path landing — partial
+ *   mitigations have hidden failure modes.
+ *
+ * Exit-code contract:
+ *   - exit 0   → resolve(stdout.trim())
+ *   - exit ≠ 0 → reject(Error(`exit ${code}: ${stderr.trim()}`))
+ *   - spawn error (ENOENT etc.) → reject via `proc.on('error')`
+ *   - timeout  → SIGTERM + reject(Error('timeout after Xms'))
+ *
+ * Imports from: node:child_process, ../types.js.
+ * Imported by: models/dispatcher.ts.
+ */
+import type { ModelAliasConfig, ModelStrategy } from '../types.js';
+/**
+ * Typed timeout rejection so callers classify by TYPE, never by message text
+ * (T-AUDIT-SPAWN-FIX — the spawn ledger counts `timeout` vs `error` outcomes).
+ * Message stays byte-identical to the historical `timeout after Xms` string.
+ */
+export declare class CliTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare function subscriptionCliStrategy(cfg: ModelAliasConfig): ModelStrategy;
+//# sourceMappingURL=subscription_cli.d.ts.map

package/dist/models/strategies/subscription_cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription_cli.d.ts","sourceRoot":"","sources":["../../../src/models/strategies/subscription_cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,SAAS,EAAE,MAAM;CAI9B;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CA2E5E"}