@cogenta/agents 0.1.0

package/dist/privacy/redact-text.js

@@ -0,0 +1,26 @@
+/**
+ * Order matters: a credit card number's digit groups must be checked before
+ * the looser phone pattern would otherwise swallow it. Pattern-based, not
+ * ML-based — deterministic and dependency-free (R9), matching "liste
+ * explicite des champs" in spirit: an explicit, auditable set of shapes,
+ * not a black box.
+ */
+const PATTERNS = [
+    { kind: 'credit_card', regex: /\b\d{4}[ -]?\d{4}[ -]?\d{4}[ -]?\d{1,7}\b/g },
+    { kind: 'email', regex: /[\w.+-]+@[\w-]+\.[a-zA-Z]{2,}/g },
+    { kind: 'ip_address', regex: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g },
+    { kind: 'phone', regex: /\+?\d[\d\s().-]{7,}\d/g },
+];
+/** Replaces every recognised PII shape with `[REDACTED:kind]`, in one pass per pattern kind, and reports what it found. */
+export function redactText(text) {
+    let result = text;
+    const matches = [];
+    for (const { kind, regex } of PATTERNS) {
+        result = result.replace(regex, (match, offset) => {
+            matches.push({ kind, value: match, index: offset });
+            return `[REDACTED:${kind}]`;
+        });
+    }
+    return { text: result, matches };
+}
+//# sourceMappingURL=redact-text.js.map

package/dist/privacy/redact-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-text.js","sourceRoot":"","sources":["../../src/privacy/redact-text.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,QAAQ,GAA0B;IACtC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,4CAA4C,EAAE;IAC5E,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE;IAC1D,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,8BAA8B,EAAE;IAC7D,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE;CACnD,CAAA;AAED,2HAA2H;AAC3H,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,MAAM,OAAO,GAAe,EAAE,CAAA;IAE9B,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAa,EAAE,MAAc,EAAE,EAAE;YAC/D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YACnD,OAAO,aAAa,IAAI,GAAG,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC"}

package/dist/privacy/types.d.ts

@@ -0,0 +1,23 @@
+export type PiiKind = 'email' | 'phone' | 'credit_card' | 'ip_address';
+export interface PiiMatch {
+    readonly kind: PiiKind;
+    readonly value: string;
+    /** Offset in the text as it stood right before this match's own pattern pass — not stable across the whole `redactText` call once earlier passes have already replaced text. */
+    readonly index: number;
+}
+export interface RedactionResult {
+    readonly text: string;
+    readonly matches: readonly PiiMatch[];
+}
+/**
+ * "Redaction des données personnelles avant envoi au modèle, avec mode
+ * « rien ne sort »." `enabled: true` makes any provider not named in
+ * `localProviderNames` an error, not a fallback — a run configured this way
+ * must genuinely be unable to leak, not merely be discouraged from it.
+ */
+export interface NoDataLeavesPolicy {
+    readonly enabled: boolean;
+    /** Provider names treated as never leaving this machine (e.g. a locally-hosted client's `.name`). */
+    readonly localProviderNames: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/privacy/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,YAAY,CAAA;AAEtE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gLAAgL;IAChL,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,qGAAqG;IACrG,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/C"}

package/dist/privacy/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/privacy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/privacy/types.ts"],"names":[],"mappings":""}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,57 @@
+import type { ChatRequest, ChatResponse, ProviderClient } from './types.js';
+type AnthropicContentBlock = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly type: 'tool_result';
+    readonly tool_use_id: string;
+    readonly content: string;
+};
+interface AnthropicMessage {
+    readonly role: 'user' | 'assistant';
+    readonly content: string | readonly AnthropicContentBlock[];
+}
+export interface AnthropicRequestBody {
+    readonly model: string;
+    readonly max_tokens: number;
+    readonly system?: string;
+    readonly messages: readonly AnthropicMessage[];
+    readonly tools?: readonly {
+        readonly name: string;
+        readonly description: string;
+        readonly input_schema: Readonly<Record<string, unknown>>;
+    }[];
+    readonly temperature?: number;
+}
+interface AnthropicResponseBody {
+    readonly content: readonly AnthropicContentBlock[];
+    readonly stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use';
+    readonly usage: {
+        readonly input_tokens: number;
+        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. */
+export declare function parseAnthropicResponse(body: AnthropicResponseBody): ChatResponse;
+export interface AnthropicClientConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    /** Overridable for tests — never for anything else. */
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+/**
+ * The API key is injected here, at the runtime boundary, from
+ * `COGENTA_ANTHROPIC_API_KEY` (or wherever the caller sources it) — never
+ * placed in a prompt or tool input (rule R7).
+ */
+export declare function createAnthropicClient(config: AnthropicClientConfig): ProviderClient;
+export {};
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +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"}

package/dist/providers/anthropic.js

@@ -0,0 +1,130 @@
+import { CogentaError } from '@cogenta/core';
+const API_VERSION = '2023-06-01';
+const DEFAULT_BASE_URL = 'https://api.anthropic.com/v1/messages';
+const STOP_REASON = {
+    end_turn: 'end_turn',
+    max_tokens: 'max_tokens',
+    stop_sequence: 'stop_sequence',
+    tool_use: 'tool_use',
+};
+function toAnthropicMessage(message) {
+    if (message.role === 'tool') {
+        if (message.toolCallId === undefined) {
+            throw new CogentaError({
+                code: 'PROVIDER_RESPONSE_INVALID',
+                message: 'A tool-role message is missing its toolCallId.',
+                hint: "Set toolCallId to the id the model's tool_use call carried.",
+            });
+        }
+        return {
+            role: 'user',
+            content: [
+                { type: 'tool_result', tool_use_id: message.toolCallId, content: message.content ?? '' },
+            ],
+        };
+    }
+    const role = message.role === 'assistant' ? 'assistant' : 'user';
+    const blocks = [];
+    if (message.content !== undefined)
+        blocks.push({ type: 'text', text: message.content });
+    for (const call of message.toolCalls ?? []) {
+        blocks.push({ type: 'tool_use', id: call.id, name: 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.
+    if (blocks.length === 1 && blocks[0]?.type === 'text') {
+        return { role, content: blocks[0].text };
+    }
+    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) {
+    return {
+        model: request.model,
+        max_tokens: request.maxTokens,
+        ...(request.system === undefined ? {} : { system: request.system }),
+        messages: request.messages.map(toAnthropicMessage),
+        ...(request.tools === undefined
+            ? {}
+            : {
+                tools: request.tools.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    input_schema: tool.inputSchema,
+                })),
+            }),
+        ...(request.temperature === undefined ? {} : { temperature: request.temperature }),
+    };
+}
+/** Pure — no network. */
+export function parseAnthropicResponse(body) {
+    const textParts = [];
+    const toolCalls = [];
+    for (const block of body.content) {
+        if (block.type === 'text')
+            textParts.push(block.text);
+        else if (block.type === 'tool_use') {
+            toolCalls.push({
+                id: block.id,
+                name: block.name,
+                input: (block.input ?? {}),
+            });
+        }
+    }
+    return {
+        content: textParts.length === 0 ? null : textParts.join(''),
+        toolCalls,
+        stopReason: STOP_REASON[body.stop_reason],
+        usage: { inputTokens: body.usage.input_tokens, outputTokens: body.usage.output_tokens },
+    };
+}
+/**
+ * The API key is injected here, at the runtime boundary, from
+ * `COGENTA_ANTHROPIC_API_KEY` (or wherever the caller sources it) — never
+ * placed in a prompt or tool input (rule R7).
+ */
+export function createAnthropicClient(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    const url = config.baseUrl ?? DEFAULT_BASE_URL;
+    return {
+        name: 'anthropic',
+        model: config.model,
+        async chat(request, options) {
+            const response = await doFetch(url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'x-api-key': config.apiKey,
+                    'anthropic-version': API_VERSION,
+                },
+                body: JSON.stringify(buildAnthropicRequest(request)),
+                ...(options?.signal === undefined ? {} : { signal: options.signal }),
+            }).catch((cause) => {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: 'The request to Anthropic could not be sent.',
+                    hint: 'Check network connectivity and COGENTA_ANTHROPIC_API_KEY.',
+                    cause,
+                });
+            });
+            if (response.status === 429) {
+                throw new CogentaError({
+                    code: 'PROVIDER_RATE_LIMITED',
+                    message: 'Anthropic rate-limited this request.',
+                    hint: 'Retry with backoff, or lower callsPerHour for this agent.',
+                });
+            }
+            if (!response.ok) {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: `Anthropic returned status ${response.status}.`,
+                    hint: 'Check the request and COGENTA_ANTHROPIC_API_KEY.',
+                    details: { status: response.status },
+                });
+            }
+            const body = (await response.json());
+            return parseAnthropicResponse(body);
+        },
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

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

package/dist/providers/google.d.ts

@@ -0,0 +1,63 @@
+import type { ChatRequest, ChatResponse, ProviderClient } from './types.js';
+type GooglePart = {
+    readonly text: string;
+} | {
+    readonly functionCall: {
+        readonly name: string;
+        readonly args: Readonly<Record<string, unknown>>;
+    };
+} | {
+    readonly functionResponse: {
+        readonly name: string;
+        readonly response: Readonly<Record<string, unknown>>;
+    };
+};
+interface GoogleContent {
+    readonly role: 'user' | 'model';
+    readonly parts: readonly GooglePart[];
+}
+export interface GoogleRequestBody {
+    readonly contents: readonly GoogleContent[];
+    readonly systemInstruction?: {
+        readonly parts: readonly [{
+            readonly text: string;
+        }];
+    };
+    readonly tools?: readonly {
+        readonly functionDeclarations: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly parameters: Readonly<Record<string, unknown>>;
+        }[];
+    }[];
+    readonly generationConfig: {
+        readonly maxOutputTokens: number;
+        readonly temperature?: number;
+    };
+}
+interface GoogleResponseBody {
+    readonly candidates: readonly {
+        readonly content: {
+            readonly parts: readonly GooglePart[];
+        };
+        readonly finishReason: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
+    }[];
+    readonly usageMetadata: {
+        readonly promptTokenCount: number;
+        readonly candidatesTokenCount: number;
+    };
+}
+/** Pure — no network. */
+export declare function buildGoogleRequest(request: ChatRequest): GoogleRequestBody;
+/** Pure — no network. */
+export declare function parseGoogleResponse(body: GoogleResponseBody): ChatResponse;
+export interface GoogleClientConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+/** API key injected at the runtime boundary — never in a prompt or tool input (rule R7). */
+export declare function createGoogleClient(config: GoogleClientConfig): ProviderClient;
+export {};
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +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"}

package/dist/providers/google.js

@@ -0,0 +1,144 @@
+import { CogentaError } from '@cogenta/core';
+const DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta/models';
+const STOP_REASON = {
+    STOP: 'end_turn',
+    MAX_TOKENS: 'max_tokens',
+    SAFETY: 'stop_sequence',
+    RECITATION: 'stop_sequence',
+    OTHER: 'stop_sequence',
+};
+/**
+ * Gemini has no `tool` role and no call-id concept at all — a function
+ * result is a `functionResponse` part inside a `user`-role turn, matched to
+ * its call by `name` alone. `toolCallId` still has to be threaded through the
+ * normalized shape (other vendors need it), so this adapter uses `toolName`
+ * when present and falls back to treating `toolCallId` as the name.
+ */
+function toGoogleContent(message) {
+    if (message.role === 'tool') {
+        const name = message.toolName ?? message.toolCallId;
+        if (name === undefined) {
+            throw new CogentaError({
+                code: 'PROVIDER_RESPONSE_INVALID',
+                message: 'A tool-role message is missing both toolName and toolCallId.',
+                hint: 'Gemini identifies a function result by name — set toolName.',
+            });
+        }
+        return {
+            role: 'user',
+            parts: [{ functionResponse: { name, response: { result: message.content ?? '' } } }],
+        };
+    }
+    const role = message.role === 'assistant' ? 'model' : 'user';
+    const parts = [];
+    if (message.content !== undefined)
+        parts.push({ text: message.content });
+    for (const call of message.toolCalls ?? []) {
+        parts.push({ functionCall: { name: call.name, args: call.input } });
+    }
+    return { role, parts };
+}
+/** Pure — no network. */
+export function buildGoogleRequest(request) {
+    return {
+        contents: request.messages.map(toGoogleContent),
+        ...(request.system === undefined
+            ? {}
+            : { systemInstruction: { parts: [{ text: request.system }] } }),
+        ...(request.tools === undefined
+            ? {}
+            : {
+                tools: [
+                    {
+                        functionDeclarations: request.tools.map((tool) => ({
+                            name: tool.name,
+                            description: tool.description,
+                            parameters: tool.inputSchema,
+                        })),
+                    },
+                ],
+            }),
+        generationConfig: {
+            maxOutputTokens: request.maxTokens,
+            ...(request.temperature === undefined ? {} : { temperature: request.temperature }),
+        },
+    };
+}
+/** Pure — no network. */
+export function parseGoogleResponse(body) {
+    const candidate = body.candidates[0];
+    if (candidate === undefined) {
+        throw new CogentaError({
+            code: 'PROVIDER_RESPONSE_INVALID',
+            message: 'Google returned no candidates.',
+            hint: 'Retry the request; this is not something the caller can fix by itself.',
+        });
+    }
+    const textParts = [];
+    const toolCalls = [];
+    for (const part of candidate.content.parts) {
+        if ('text' in part)
+            textParts.push(part.text);
+        else if ('functionCall' in part) {
+            // Synthesised, not vendor-issued: Gemini never hands back a call id,
+            // so the name is the closest stable handle the rest of the runtime has.
+            toolCalls.push({
+                id: part.functionCall.name,
+                name: part.functionCall.name,
+                input: part.functionCall.args,
+            });
+        }
+    }
+    return {
+        content: textParts.length === 0 ? null : textParts.join(''),
+        toolCalls,
+        stopReason: STOP_REASON[candidate.finishReason],
+        usage: {
+            inputTokens: body.usageMetadata.promptTokenCount,
+            outputTokens: body.usageMetadata.candidatesTokenCount,
+        },
+    };
+}
+/** API key injected at the runtime boundary — never in a prompt or tool input (rule R7). */
+export function createGoogleClient(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    const base = config.baseUrl ?? DEFAULT_BASE_URL;
+    const url = `${base}/${config.model}:generateContent?key=${config.apiKey}`;
+    return {
+        name: 'google',
+        model: config.model,
+        async chat(request, options) {
+            const response = await doFetch(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(buildGoogleRequest(request)),
+                ...(options?.signal === undefined ? {} : { signal: options.signal }),
+            }).catch((cause) => {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: 'The request to Google could not be sent.',
+                    hint: 'Check network connectivity and COGENTA_GOOGLE_API_KEY.',
+                    cause,
+                });
+            });
+            if (response.status === 429) {
+                throw new CogentaError({
+                    code: 'PROVIDER_RATE_LIMITED',
+                    message: 'Google rate-limited this request.',
+                    hint: 'Retry with backoff, or lower callsPerHour for this agent.',
+                });
+            }
+            if (!response.ok) {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: `Google returned status ${response.status}.`,
+                    hint: 'Check the request and COGENTA_GOOGLE_API_KEY.',
+                    details: { status: response.status },
+                });
+            }
+            const body = (await response.json());
+            return parseGoogleResponse(body);
+        },
+    };
+}
+//# sourceMappingURL=google.js.map

package/dist/providers/google.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,56 @@
+import type { ChatRequest, ChatResponse, ProviderClient } from './types.js';
+interface OpenAiToolCall {
+    readonly id: string;
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+interface OpenAiMessage {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    readonly content: string | null;
+    readonly tool_calls?: readonly OpenAiToolCall[];
+    readonly tool_call_id?: string;
+}
+export interface OpenAiRequestBody {
+    readonly model: string;
+    readonly max_tokens: number;
+    readonly messages: readonly OpenAiMessage[];
+    readonly tools?: readonly {
+        readonly type: 'function';
+        readonly function: {
+            readonly name: string;
+            readonly description: string;
+            readonly parameters: Readonly<Record<string, unknown>>;
+        };
+    }[];
+    readonly temperature?: number;
+}
+interface OpenAiResponseBody {
+    readonly choices: readonly {
+        readonly message: {
+            readonly content: string | null;
+            readonly tool_calls?: readonly OpenAiToolCall[];
+        };
+        readonly finish_reason: 'stop' | 'tool_calls' | 'length' | 'content_filter';
+    }[];
+    readonly usage: {
+        readonly prompt_tokens: number;
+        readonly completion_tokens: number;
+    };
+}
+/** Pure — no network. */
+export declare function buildOpenAiRequest(request: ChatRequest): OpenAiRequestBody;
+/** Pure — no network. */
+export declare function parseOpenAiResponse(body: OpenAiResponseBody): ChatResponse;
+export interface OpenAiClientConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+/** API key injected at the runtime boundary — never in a prompt or tool input (rule R7). */
+export declare function createOpenAiClient(config: OpenAiClientConfig): ProviderClient;
+export {};
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACZ,cAAc,EAGf,MAAM,YAAY,CAAA;AAInB,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CACzE;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;QACzB,QAAQ,CAAC,QAAQ,EAAE;YACjB,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,CAAA;KACF,EAAE,CAAA;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,OAAO,EAAE;YAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;YAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;SAChD,CAAA;QACD,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,gBAAgB,CAAA;KAC5E,EAAE,CAAA;IACH,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAA;CACvF;AAqCD,yBAAyB;AACzB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,CAyB1E;AAED,yBAAyB;AACzB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAsB1E;AAkBD,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,CA6C7E"}