@cogenta/agents 0.2.1 → 0.4.0

package/dist/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gMAAgM;AAChM,eAAO,MAAM,0BAA0B,YACrC,MAAM,EACN,aAAa,EACb,KAAK,EACL,YAAY,EACZ,OAAO,EACP,OAAO,CACC,CAAA;AACV,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iJAAiJ;IACjJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;IAC1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;IACpD,MAAM,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACvE,2EAA2E;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC"}

package/dist/prompts/types.js

@@ -0,0 +1,24 @@
+/**
+ * Fiche 45 — Prompt Settings, the shared template library every utility
+ * prompt in `@cogenta/agents` reads from. Same "real but local" tier as
+ * `agents/store.ts`/`skills/library.ts` (R1): a file on disk, no external
+ * service, no new dependency.
+ *
+ * A `PromptTemplate` is deliberately **not** a `SkillMetadata`/`AgentSkill`:
+ * a skill is a whole piece of context an agent loads ("how this site wants
+ * content written"); a prompt template is the single instruction line one
+ * specific tool call sends the model, with `{{placeholder}}` slots the tool
+ * fills in at call time (see `render.ts`). Different shape, different
+ * lifecycle, so a different store rather than overloading one interface for
+ * both.
+ */
+/** Suggested vocabulary for the admin's category picker. The field itself stays a plain string — an open list, not a closed taxonomy (fiche 45 §3 task 1: "texte/traduction/agent/image/…"). */
+export const PROMPT_TEMPLATE_CATEGORIES = [
+    'text',
+    'translation',
+    'seo',
+    'moderation',
+    'agent',
+    'image',
+];
+//# sourceMappingURL=types.js.map

package/dist/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gMAAgM;AAChM,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM;IACN,aAAa;IACb,KAAK;IACL,YAAY;IACZ,OAAO;IACP,OAAO;CACC,CAAA"}

package/dist/providers/anthropic.d.ts

@@ -2,6 +2,13 @@ import type { ChatRequest, ChatResponse, ProviderClient } from './types.js';
 type AnthropicContentBlock = {
     readonly type: 'text';
     readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly source: {
+        readonly type: 'base64';
+        readonly media_type: string;
+        readonly data: string;
+    };
 } | {
     readonly type: 'tool_use';
     readonly id: string;
@@ -36,16 +43,27 @@ interface AnthropicResponseBody {
         readonly output_tokens: number;
     };
 }
-/** Pure — no network. The whole reason this is separate from `createAnthropicClient` is to unit-test the mapping without a live call. */
-export declare function buildAnthropicRequest(request: ChatRequest): AnthropicRequestBody;
+/**
+ * Pure — no network. The whole reason this is separate from
+ * `createAnthropicClient` is to unit-test the mapping without a live call.
+ * `fallbackMaxTokens` is the client's own resolved `maxOutputTokens` (the
+ * admin's per-provider value, or the built-in floor) — applied only when
+ * `request.maxTokens` itself is absent, never overriding an explicit
+ * per-call value.
+ */
+export declare function buildAnthropicRequest(request: ChatRequest, fallbackMaxTokens?: number): AnthropicRequestBody;
 /** Pure — no network. */
-export declare function parseAnthropicResponse(body: AnthropicResponseBody): ChatResponse;
+export declare function parseAnthropicResponse(body: AnthropicResponseBody, decodeToolName?: (wire: string) => string): ChatResponse;
 export interface AnthropicClientConfig {
     readonly apiKey: string;
     readonly model: string;
     /** Overridable for tests — never for anything else. */
     readonly baseUrl?: string;
     readonly fetchImpl?: typeof fetch;
+    /** See `ProviderClient.maxOutputTokens`/`requestTimeoutMs`/`maxCorrectionAttempts`. */
+    readonly maxOutputTokens?: number;
+    readonly requestTimeoutMs?: number;
+    readonly maxCorrectionAttempts?: number;
 }
 /**
  * The API key is injected here, at the runtime boundary, from

package/dist/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACZ,cAAc,EAGf,MAAM,YAAY,CAAA;AAKnB,KAAK,qBAAqB,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5F,UAAU,gBAAgB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE,CAAA;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KACzD,EAAE,CAAA;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAClD,QAAQ,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAAA;IAC9E,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CAClF;AAwCD,yIAAyI;AACzI,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,CAiBhF;AAED,yBAAyB;AACzB,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,YAAY,CAmBhF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CA8CnF"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/providers/anthropic.js

@@ -1,4 +1,8 @@
 import { CogentaError } from '@cogenta/core';
+import { textOnlyContent } from './content-parts.js';
+import { FALLBACK_MAX_OUTPUT_TOKENS } from './defaults.js';
+import { DEFAULT_PROVIDER_REQUEST_TIMEOUT_MS, requestSignalWithTimeout } from './request-signal.js';
+import { createToolNameDecoder, encodeToolName } from './tool-names.js';
 const API_VERSION = '2023-06-01';
 const DEFAULT_BASE_URL = 'https://api.anthropic.com/v1/messages';
 const STOP_REASON = {
@@ -19,16 +23,36 @@ function toAnthropicMessage(message) {
         return {
             role: 'user',
             content: [
-                { type: 'tool_result', tool_use_id: message.toolCallId, content: message.content ?? '' },
+                {
+                    type: 'tool_result',
+                    tool_use_id: message.toolCallId,
+                    content: textOnlyContent(message.content) ?? '',
+                },
             ],
         };
     }
     const role = message.role === 'assistant' ? 'assistant' : 'user';
     const blocks = [];
-    if (message.content !== undefined)
+    if (typeof message.content === 'string') {
         blocks.push({ type: 'text', text: message.content });
+    }
+    else if (message.content !== undefined) {
+        for (const part of message.content) {
+            blocks.push(part.type === 'text'
+                ? { type: 'text', text: part.text }
+                : {
+                    type: 'image',
+                    source: { type: 'base64', media_type: part.mediaType, data: part.data },
+                });
+        }
+    }
     for (const call of message.toolCalls ?? []) {
-        blocks.push({ type: 'tool_use', id: call.id, name: call.name, input: call.input });
+        blocks.push({
+            type: 'tool_use',
+            id: call.id,
+            name: encodeToolName(call.name),
+            input: call.input,
+        });
     }
     // A plain string is equivalent to a single text block and reads better in
     // request logs — only messages that carry tool content need the array form.
@@ -37,18 +61,25 @@ function toAnthropicMessage(message) {
     }
     return { role, content: blocks };
 }
-/** Pure — no network. The whole reason this is separate from `createAnthropicClient` is to unit-test the mapping without a live call. */
-export function buildAnthropicRequest(request) {
+/**
+ * Pure — no network. The whole reason this is separate from
+ * `createAnthropicClient` is to unit-test the mapping without a live call.
+ * `fallbackMaxTokens` is the client's own resolved `maxOutputTokens` (the
+ * admin's per-provider value, or the built-in floor) — applied only when
+ * `request.maxTokens` itself is absent, never overriding an explicit
+ * per-call value.
+ */
+export function buildAnthropicRequest(request, fallbackMaxTokens = FALLBACK_MAX_OUTPUT_TOKENS) {
     return {
         model: request.model,
-        max_tokens: request.maxTokens,
+        max_tokens: request.maxTokens ?? fallbackMaxTokens,
         ...(request.system === undefined ? {} : { system: request.system }),
         messages: request.messages.map(toAnthropicMessage),
         ...(request.tools === undefined
             ? {}
             : {
                 tools: request.tools.map((tool) => ({
-                    name: tool.name,
+                    name: encodeToolName(tool.name),
                     description: tool.description,
                     input_schema: tool.inputSchema,
                 })),
@@ -57,7 +88,7 @@ export function buildAnthropicRequest(request) {
     };
 }
 /** Pure — no network. */
-export function parseAnthropicResponse(body) {
+export function parseAnthropicResponse(body, decodeToolName = (wire) => wire) {
     const textParts = [];
     const toolCalls = [];
     for (const block of body.content) {
@@ -66,7 +97,7 @@ export function parseAnthropicResponse(body) {
         else if (block.type === 'tool_use') {
             toolCalls.push({
                 id: block.id,
-                name: block.name,
+                name: decodeToolName(block.name),
                 input: (block.input ?? {}),
             });
         }
@@ -86,10 +117,19 @@ export function parseAnthropicResponse(body) {
 export function createAnthropicClient(config) {
     const doFetch = config.fetchImpl ?? fetch;
     const url = config.baseUrl ?? DEFAULT_BASE_URL;
+    const maxOutputTokens = config.maxOutputTokens ?? FALLBACK_MAX_OUTPUT_TOKENS;
+    const requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_PROVIDER_REQUEST_TIMEOUT_MS;
     return {
         name: 'anthropic',
         model: config.model,
+        supportsVision: true,
+        maxOutputTokens,
+        requestTimeoutMs,
+        ...(config.maxCorrectionAttempts === undefined
+            ? {}
+            : { maxCorrectionAttempts: config.maxCorrectionAttempts }),
         async chat(request, options) {
+            const signal = requestSignalWithTimeout(options?.signal, requestTimeoutMs);
             const response = await doFetch(url, {
                 method: 'POST',
                 headers: {
@@ -97,9 +137,17 @@ export function createAnthropicClient(config) {
                     'x-api-key': config.apiKey,
                     'anthropic-version': API_VERSION,
                 },
-                body: JSON.stringify(buildAnthropicRequest(request)),
-                ...(options?.signal === undefined ? {} : { signal: options.signal }),
+                body: JSON.stringify(buildAnthropicRequest(request, maxOutputTokens)),
+                signal,
             }).catch((cause) => {
+                if (signal.aborted && options?.signal?.aborted !== true) {
+                    throw new CogentaError({
+                        code: 'PROVIDER_REQUEST_FAILED',
+                        message: 'Anthropic did not answer in time.',
+                        hint: 'The vendor may be slow or unreachable right now; retry, or check its status page.',
+                        cause,
+                    });
+                }
                 throw new CogentaError({
                     code: 'PROVIDER_REQUEST_FAILED',
                     message: 'The request to Anthropic could not be sent.',
@@ -123,7 +171,7 @@ export function createAnthropicClient(config) {
                 });
             }
             const body = (await response.json());
-            return parseAnthropicResponse(body);
+            return parseAnthropicResponse(body, createToolNameDecoder(request));
         },
     };
 }

package/dist/providers/anthropic.js.map

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

package/dist/providers/catalog.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Fiche 56 — the catalog of LLM providers this build knows how to talk to,
+ * as pure data. `registry.ts`'s `createProviderRegistry` is the only reader
+ * that matters functionally: an entry with `wireFormat: 'openai-compatible'`
+ * reuses `createOpenAiClient` completely unmodified, only pointed at a
+ * different `defaultBaseUrl` — this is the "zero new network code" the fiche
+ * asks for. OpenRouter, DeepSeek, Qwen (DashScope's compatible mode) and GLM
+ * (Zhipu/Z.ai) all speak the OpenAI Chat Completions wire format at their own
+ * URL; Anthropic and Google keep their own native adapters (different wire
+ * formats), listed here only so the admin's catalog screen has one list to
+ * render rather than three built-ins plus four extras.
+ *
+ * `knownModels` is a curated starting point for the admin's model picker,
+ * not an exhaustive or authoritative list — every vendor adds and retires
+ * models on its own schedule, and this list will drift the moment it is
+ * written (verified against each vendor's docs as of 2026-08, the ids most
+ * likely to still resolve at read time). The "custom model" text field
+ * (`ProviderConfigInput.model` — already free text before this fiche) is
+ * what actually lets an operator use anything a vendor ships tomorrow
+ * without a code change here.
+ */
+export type ProviderWireFormat = 'openai-compatible' | 'anthropic' | 'google';
+export interface ProviderCatalogEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly wireFormat: ProviderWireFormat;
+    /**
+     * The full chat-completions URL this vendor's endpoint answers at — this
+     * codebase's `baseUrl` is always a complete URL, never a prefix a client
+     * appends to (see `openai.ts`'s own `DEFAULT_BASE_URL`). Present on every
+     * entry, including the native Anthropic/Google ones, purely as
+     * admin-facing documentation of where a request actually goes; only the
+     * `openai-compatible` entries feed it to `createOpenAiClient` when an
+     * operator has not overridden `baseUrl` themselves.
+     */
+    readonly defaultBaseUrl: string;
+    readonly knownModels: readonly string[];
+}
+export declare const KNOWN_PROVIDER_CATALOG: readonly ProviderCatalogEntry[];
+export declare function findProviderCatalogEntry(id: string): ProviderCatalogEntry | undefined;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/providers/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/providers/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,oBAAoB,EA2DjE,CAAA;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAErF"}

package/dist/providers/catalog.js

@@ -0,0 +1,85 @@
+/**
+ * Fiche 56 — the catalog of LLM providers this build knows how to talk to,
+ * as pure data. `registry.ts`'s `createProviderRegistry` is the only reader
+ * that matters functionally: an entry with `wireFormat: 'openai-compatible'`
+ * reuses `createOpenAiClient` completely unmodified, only pointed at a
+ * different `defaultBaseUrl` — this is the "zero new network code" the fiche
+ * asks for. OpenRouter, DeepSeek, Qwen (DashScope's compatible mode) and GLM
+ * (Zhipu/Z.ai) all speak the OpenAI Chat Completions wire format at their own
+ * URL; Anthropic and Google keep their own native adapters (different wire
+ * formats), listed here only so the admin's catalog screen has one list to
+ * render rather than three built-ins plus four extras.
+ *
+ * `knownModels` is a curated starting point for the admin's model picker,
+ * not an exhaustive or authoritative list — every vendor adds and retires
+ * models on its own schedule, and this list will drift the moment it is
+ * written (verified against each vendor's docs as of 2026-08, the ids most
+ * likely to still resolve at read time). The "custom model" text field
+ * (`ProviderConfigInput.model` — already free text before this fiche) is
+ * what actually lets an operator use anything a vendor ships tomorrow
+ * without a code change here.
+ */
+export const KNOWN_PROVIDER_CATALOG = [
+    {
+        id: 'anthropic',
+        label: 'Anthropic',
+        wireFormat: 'anthropic',
+        defaultBaseUrl: 'https://api.anthropic.com/v1/messages',
+        knownModels: ['claude-opus-5', 'claude-sonnet-5', 'claude-haiku-4-5'],
+    },
+    {
+        id: 'openai',
+        label: 'OpenAI',
+        wireFormat: 'openai-compatible',
+        defaultBaseUrl: 'https://api.openai.com/v1/chat/completions',
+        knownModels: ['gpt-5.2-chat-latest', 'gpt-5', 'gpt-5-mini'],
+    },
+    {
+        id: 'google',
+        label: 'Google',
+        wireFormat: 'google',
+        defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta/models',
+        knownModels: ['gemini-3.1-pro', 'gemini-3.7-flash', 'gemini-2.5-flash-lite'],
+    },
+    // The four below are what fiche 56 actually adds: no new adapter, only a
+    // catalog entry pointing `openai-compatible` at a different vendor.
+    {
+        id: 'openrouter',
+        label: 'OpenRouter',
+        wireFormat: 'openai-compatible',
+        defaultBaseUrl: 'https://openrouter.ai/api/v1/chat/completions',
+        knownModels: [
+            'openai/gpt-5.2-chat-latest',
+            'anthropic/claude-sonnet-5',
+            'google/gemini-3.1-pro',
+        ],
+    },
+    {
+        id: 'deepseek',
+        label: 'DeepSeek',
+        wireFormat: 'openai-compatible',
+        defaultBaseUrl: 'https://api.deepseek.com/chat/completions',
+        knownModels: ['deepseek-v4-pro', 'deepseek-v4-flash'],
+    },
+    {
+        id: 'qwen',
+        label: 'Qwen (DashScope)',
+        wireFormat: 'openai-compatible',
+        // The international (Singapore) region — the one DashScope's own docs
+        // lead with. An operator on the China or US region overrides `baseUrl`
+        // from the admin form, the same way any custom endpoint does.
+        defaultBaseUrl: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions',
+        knownModels: ['qwen3-max', 'qwen-plus', 'qwen-turbo'],
+    },
+    {
+        id: 'glm',
+        label: 'GLM (Zhipu / Z.ai)',
+        wireFormat: 'openai-compatible',
+        defaultBaseUrl: 'https://api.z.ai/api/openai/v1/chat/completions',
+        knownModels: ['glm-4.7', 'glm-4.6', 'glm-4.5-flash'],
+    },
+];
+export function findProviderCatalogEntry(id) {
+    return KNOWN_PROVIDER_CATALOG.find((entry) => entry.id === id);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/providers/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/providers/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAqBH,MAAM,CAAC,MAAM,sBAAsB,GAAoC;IACrE;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,WAAW;QACvB,cAAc,EAAE,uCAAuC;QACvD,WAAW,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;KACtE;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,mBAAmB;QAC/B,cAAc,EAAE,4CAA4C;QAC5D,WAAW,EAAE,CAAC,qBAAqB,EAAE,OAAO,EAAE,YAAY,CAAC;KAC5D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,QAAQ;QACpB,cAAc,EAAE,yDAAyD;QACzE,WAAW,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,CAAC;KAC7E;IACD,yEAAyE;IACzE,oEAAoE;IACpE;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,mBAAmB;QAC/B,cAAc,EAAE,+CAA+C;QAC/D,WAAW,EAAE;YACX,4BAA4B;YAC5B,2BAA2B;YAC3B,uBAAuB;SACxB;KACF;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,mBAAmB;QAC/B,cAAc,EAAE,2CAA2C;QAC3D,WAAW,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;KACtD;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE,mBAAmB;QAC/B,sEAAsE;QACtE,uEAAuE;QACvE,8DAA8D;QAC9D,cAAc,EAAE,yEAAyE;QACzF,WAAW,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC;KACtD;IACD;QACE,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,mBAAmB;QAC/B,cAAc,EAAE,iDAAiD;QACjE,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC;KACrD;CACF,CAAA;AAED,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChE,CAAC"}

package/dist/providers/content-parts.d.ts

@@ -0,0 +1,12 @@
+import type { ChatContentPart } from './types.js';
+/**
+ * Extracts the text of a message's `content`, dropping any image parts —
+ * used wherever a vendor's wire format only ever accepts a string (tool
+ * results, function responses). Every existing caller passes a plain
+ * string here already, so this is the identity function for them; an
+ * array of `ChatContentPart` (not something the runtime produces for a
+ * `tool`-role message today) degrades to its text parts joined together
+ * rather than failing to compile or throwing.
+ */
+export declare function textOnlyContent(content: string | readonly ChatContentPart[] | undefined): string | undefined;
+//# sourceMappingURL=content-parts.d.ts.map

package/dist/providers/content-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parts.d.ts","sourceRoot":"","sources":["../../src/providers/content-parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,GAAG,SAAS,GACvD,MAAM,GAAG,SAAS,CAMpB"}

package/dist/providers/content-parts.js

@@ -0,0 +1,18 @@
+/**
+ * Extracts the text of a message's `content`, dropping any image parts —
+ * used wherever a vendor's wire format only ever accepts a string (tool
+ * results, function responses). Every existing caller passes a plain
+ * string here already, so this is the identity function for them; an
+ * array of `ChatContentPart` (not something the runtime produces for a
+ * `tool`-role message today) degrades to its text parts joined together
+ * rather than failing to compile or throwing.
+ */
+export function textOnlyContent(content) {
+    if (content === undefined || typeof content === 'string')
+        return content;
+    return content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join('');
+}
+//# sourceMappingURL=content-parts.js.map

package/dist/providers/content-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parts.js","sourceRoot":"","sources":["../../src/providers/content-parts.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAwD;IAExD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAA;IACxE,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC"}

package/dist/providers/defaults.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in fallbacks, used only when an admin has not set the matching
+ * per-provider value from `/admin/providers`
+ * (`ProviderConfigStore`'s `maxOutputTokens`/`requestTimeoutMs`/
+ * `maxCorrectionAttempts`) — never picked over an admin's own choice, since
+ * only the admin knows which model they configured and what it actually
+ * needs. `8000`/`3` match the values a real, reproduced failure against a
+ * reasoning-tier model (DeepSeek's `deepseek-v4-flash`) already forced this
+ * codebase to converge on independently in more than one call site before
+ * this file existed — kept here as the one shared floor instead of staying
+ * duplicated per adapter.
+ */
+export declare const FALLBACK_MAX_OUTPUT_TOKENS = 8000;
+export declare const FALLBACK_MAX_CORRECTION_ATTEMPTS = 3;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/providers/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/providers/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAA;AAC9C,eAAO,MAAM,gCAAgC,IAAI,CAAA"}

package/dist/providers/defaults.js

@@ -0,0 +1,15 @@
+/**
+ * Built-in fallbacks, used only when an admin has not set the matching
+ * per-provider value from `/admin/providers`
+ * (`ProviderConfigStore`'s `maxOutputTokens`/`requestTimeoutMs`/
+ * `maxCorrectionAttempts`) — never picked over an admin's own choice, since
+ * only the admin knows which model they configured and what it actually
+ * needs. `8000`/`3` match the values a real, reproduced failure against a
+ * reasoning-tier model (DeepSeek's `deepseek-v4-flash`) already forced this
+ * codebase to converge on independently in more than one call site before
+ * this file existed — kept here as the one shared floor instead of staying
+ * duplicated per adapter.
+ */
+export const FALLBACK_MAX_OUTPUT_TOKENS = 8000;
+export const FALLBACK_MAX_CORRECTION_ATTEMPTS = 3;
+//# sourceMappingURL=defaults.js.map

package/dist/providers/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/providers/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAA;AAC9C,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAA"}

package/dist/providers/google.d.ts

@@ -1,6 +1,11 @@
 import type { ChatRequest, ChatResponse, ProviderClient } from './types.js';
 type GooglePart = {
     readonly text: string;
+} | {
+    readonly inlineData: {
+        readonly mimeType: string;
+        readonly data: string;
+    };
 } | {
     readonly functionCall: {
         readonly name: string;
@@ -47,15 +52,23 @@ interface GoogleResponseBody {
         readonly candidatesTokenCount: number;
     };
 }
+/**
+ * Pure — no network. `fallbackMaxTokens` is the client's own resolved
+ * `maxOutputTokens` (the admin's per-provider value, or the built-in floor)
+ * — applied only when `request.maxTokens` itself is absent.
+ */
+export declare function buildGoogleRequest(request: ChatRequest, fallbackMaxTokens?: number): GoogleRequestBody;
 /** Pure — no network. */
-export declare function buildGoogleRequest(request: ChatRequest): GoogleRequestBody;
-/** Pure — no network. */
-export declare function parseGoogleResponse(body: GoogleResponseBody): ChatResponse;
+export declare function parseGoogleResponse(body: GoogleResponseBody, decodeToolName?: (wire: string) => string): ChatResponse;
 export interface GoogleClientConfig {
     readonly apiKey: string;
     readonly model: string;
     readonly baseUrl?: string;
     readonly fetchImpl?: typeof fetch;
+    /** See `ProviderClient.maxOutputTokens`/`requestTimeoutMs`/`maxCorrectionAttempts`. */
+    readonly maxOutputTokens?: number;
+    readonly requestTimeoutMs?: number;
+    readonly maxCorrectionAttempts?: number;
 }
 /** API key injected at the runtime boundary — never in a prompt or tool input (rule R7). */
 export declare function createGoogleClient(config: GoogleClientConfig): ProviderClient;

package/dist/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACZ,cAAc,EAGf,MAAM,YAAY,CAAA;AAInB,KAAK,UAAU,GACX;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IACE,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KACjD,CAAA;CACF,GACD;IACE,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KACrD,CAAA;CACF,CAAA;AAEL,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,QAAQ,CAAC,oBAAoB,EAAE,SAAS;YACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;YACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;YAC5B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;SACvD,EAAE,CAAA;KACJ,EAAE,CAAA;IACH,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;QAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAC9B,CAAA;CACF;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS;QAC5B,QAAQ,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;SAAE,CAAA;QAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;KACjF,EAAE,CAAA;IACH,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;QACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;KACtC,CAAA;CACF;AA0CD,yBAAyB;AACzB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,CAwB1E;AAED,yBAAyB;AACzB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAkC1E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CA2C7E"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"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"}