@cogenta/agents 0.2.1 → 0.5.0

package/dist/prompts/store.js

@@ -0,0 +1,153 @@
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { CogentaError } from '@cogenta/core';
+/**
+ * One JSON file per template under `options.dir` — the same "real but
+ * local" tier `agents/store.ts` and (pre-L24) `skills/library.ts` already
+ * use (R1). Unlike `AgentSkillStore` (which persists a portable `SKILL.md`
+ * because a skill is meant to travel between agents), a prompt template has
+ * no portable format anyone else defines — it is Cogenta-specific data with
+ * a `category`/`builtin` this store owns outright, so plain JSON is the
+ * honest choice rather than inventing a frontmatter format nobody else reads.
+ */
+const FILE_SUFFIX = '.json';
+/** Every Unicode combining mark — what NFKD decomposition splits an accented letter into. */
+const COMBINING_DIACRITICS = /\p{Mn}/gu;
+function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(COMBINING_DIACRITICS, '')
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '');
+    return slug.length > 0 ? slug : 'prompt';
+}
+function templateUnknown(id) {
+    return new CogentaError({
+        code: 'PROMPT_TEMPLATE_UNKNOWN',
+        message: `No prompt template with id "${id}".`,
+        hint: 'Check the id against `list()`, or create it first.',
+    });
+}
+export function createFilePromptTemplateStore(options) {
+    const now = options.now ?? (() => new Date());
+    const ready = mkdir(options.dir, { recursive: true });
+    function fileFor(id) {
+        return join(options.dir, `${id}${FILE_SUFFIX}`);
+    }
+    async function readRecord(id) {
+        let raw;
+        try {
+            raw = await readFile(fileFor(id), 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw new CogentaError({
+                code: 'INTERNAL',
+                message: `Could not read prompt template "${id}".`,
+                hint: 'The file may be corrupted; consider removing it.',
+                cause: error,
+            });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'INTERNAL',
+                message: `Could not parse prompt template "${id}".`,
+                hint: 'The file is not valid JSON; consider removing it.',
+                cause: error,
+            });
+        }
+        return parsed;
+    }
+    async function writeRecord(record) {
+        await writeFile(fileFor(record.id), JSON.stringify(record, null, 2), 'utf8');
+        return record;
+    }
+    return {
+        async list() {
+            await ready;
+            const entries = await readdir(options.dir, { withFileTypes: true }).catch(() => []);
+            const templates = [];
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.endsWith(FILE_SUFFIX))
+                    continue;
+                const id = entry.name.slice(0, -FILE_SUFFIX.length);
+                try {
+                    const record = await readRecord(id);
+                    if (record !== null)
+                        templates.push(record);
+                }
+                catch {
+                    // A corrupted file is not a template this store can serve — skip
+                    // it rather than fail the whole listing (same posture as the
+                    // agent-skill and marketplace file stores).
+                }
+            }
+            return templates.sort((a, b) => a.name.localeCompare(b.name));
+        },
+        async get(id) {
+            await ready;
+            const record = await readRecord(id);
+            return record ?? undefined;
+        },
+        async create(input, builtin = false) {
+            await ready;
+            const id = slugify(input.name);
+            const existing = await readRecord(id);
+            if (existing !== null) {
+                throw new CogentaError({
+                    code: 'PROMPT_TEMPLATE_DUPLICATE',
+                    message: `A prompt template named "${input.name}" already exists.`,
+                    hint: 'Choose a different name, or edit the existing template instead.',
+                });
+            }
+            const at = now().toISOString();
+            return writeRecord({
+                id,
+                name: input.name,
+                description: input.description,
+                category: input.category,
+                template: input.template,
+                builtin,
+                createdAt: at,
+                updatedAt: at,
+            });
+        },
+        async update(id, patch) {
+            await ready;
+            const existing = await readRecord(id);
+            if (existing === null)
+                throw templateUnknown(id);
+            return writeRecord({
+                id,
+                name: patch.name ?? existing.name,
+                description: patch.description ?? existing.description,
+                category: patch.category ?? existing.category,
+                template: patch.template ?? existing.template,
+                builtin: existing.builtin,
+                createdAt: existing.createdAt,
+                updatedAt: now().toISOString(),
+            });
+        },
+        async remove(id) {
+            await ready;
+            const existing = await readRecord(id);
+            if (existing === null)
+                throw templateUnknown(id);
+            if (existing.builtin) {
+                throw new CogentaError({
+                    code: 'PROMPT_TEMPLATE_BUILTIN_UNDELETABLE',
+                    message: `"${existing.name}" is a built-in prompt template and cannot be removed.`,
+                    hint: 'Edit its text instead — a builtin can always be edited, only never deleted.',
+                });
+            }
+            await rm(fileFor(id), { force: true });
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/prompts/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/prompts/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAQ5C;;;;;;;;GAQG;AAEH,MAAM,WAAW,GAAG,OAAO,CAAA;AAE3B,6FAA6F;AAC7F,MAAM,oBAAoB,GAAG,UAAU,CAAA;AAEvC,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,EAAU;IACjC,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,+BAA+B,EAAE,IAAI;QAC9C,IAAI,EAAE,oDAAoD;KAC3D,CAAC,CAAA;AACJ,CAAC;AAkBD,MAAM,UAAU,6BAA6B,CAC3C,OAAuC;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAS,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAErD,SAAS,OAAO,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,EAAU;QAClC,IAAI,GAAW,CAAA;QACf,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YACnE,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,mCAAmC,EAAE,IAAI;gBAClD,IAAI,EAAE,kDAAkD;gBACxD,KAAK,EAAE,KAAK;aACb,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,MAAoB,CAAA;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,oCAAoC,EAAE,IAAI;gBACnD,IAAI,EAAE,mDAAmD;gBACzD,KAAK,EAAE,KAAK;aACb,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,UAAU,WAAW,CAAC,MAAoB;QAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAC5E,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,KAAK,CAAA;YACX,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YACnF,MAAM,SAAS,GAAqB,EAAE,CAAA;YACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;oBAAE,SAAQ;gBAClE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;gBACnD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAA;oBACnC,IAAI,MAAM,KAAK,IAAI;wBAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,iEAAiE;oBACjE,6DAA6D;oBAC7D,4CAA4C;gBAC9C,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/D,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,EAAE;YACV,MAAM,KAAK,CAAA;YACX,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAA;YACnC,OAAO,MAAM,IAAI,SAAS,CAAA;QAC5B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;YACjC,MAAM,KAAK,CAAA;YACX,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC9B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAA;YACrC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,4BAA4B,KAAK,CAAC,IAAI,mBAAmB;oBAClE,IAAI,EAAE,iEAAiE;iBACxE,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;YAC9B,OAAO,WAAW,CAAC;gBACjB,EAAE;gBACF,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO;gBACP,SAAS,EAAE,EAAE;gBACb,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAA0B;YACzC,MAAM,KAAK,CAAA;YACX,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAA;YACrC,IAAI,QAAQ,KAAK,IAAI;gBAAE,MAAM,eAAe,CAAC,EAAE,CAAC,CAAA;YAChD,OAAO,WAAW,CAAC;gBACjB,EAAE;gBACF,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;gBACjC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;gBACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;gBAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;gBAC7C,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;aAC/B,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,MAAM,KAAK,CAAA;YACX,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAA;YACrC,IAAI,QAAQ,KAAK,IAAI;gBAAE,MAAM,eAAe,CAAC,EAAE,CAAC,CAAA;YAChD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,qCAAqC;oBAC3C,OAAO,EAAE,IAAI,QAAQ,CAAC,IAAI,wDAAwD;oBAClF,IAAI,EAAE,6EAA6E;iBACpF,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/prompts/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 declare const PROMPT_TEMPLATE_CATEGORIES: readonly ['text', 'translation', 'seo', 'moderation', 'agent', 'image'];
+export type PromptTemplateCategory = (typeof PROMPT_TEMPLATE_CATEGORIES)[number];
+export interface PromptTemplate {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    /** Free text — see `PROMPT_TEMPLATE_CATEGORIES` for the suggested vocabulary, not an enforced one. */
+    readonly category: string;
+    /** The instruction text a tool sends the model, with `{{field}}` placeholders the caller resolves — see `render.ts`'s `renderPromptTemplate`. */
+    readonly template: string;
+    readonly builtin: boolean;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface PromptTemplateInput {
+    readonly name: string;
+    readonly description: string;
+    readonly category: string;
+    readonly template: string;
+}
+export type PromptTemplatePatch = Partial<PromptTemplateInput>;
+/**
+ * Same contract shape as `AgentSkillStore` (`skills/library.ts`) — list/get/
+ * create/update/remove — deliberately, so the two stores share one test
+ * suite pattern (fiche 45 §5's own criterion) even though what they store
+ * differs.
+ */
+export interface PromptTemplateStore {
+    list(): Promise<readonly PromptTemplate[]>;
+    get(id: string): Promise<PromptTemplate | undefined>;
+    create(input: PromptTemplateInput, builtin?: boolean): Promise<PromptTemplate>;
+    update(id: string, patch: PromptTemplatePatch): Promise<PromptTemplate>;
+    /** Refuses to remove a builtin (`PROMPT_TEMPLATE_BUILTIN_UNDELETABLE`). */
+    remove(id: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -1,7 +1,15 @@
+import type { ProviderTuningDefaults } from './defaults.js';
 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 +44,31 @@ 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 site-wide default) — applied only when
+ * `request.maxTokens` itself is absent, never overriding an explicit
+ * per-call value. Required, not defaulted: the one caller that matters
+ * (`createAnthropicClient`'s own `chat()`) always has a concrete number by
+ * the time it calls this; a test wanting a specific budget passes its own.
+ */
+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` — the admin's per-provider override, absent meaning "use `defaults`". */
+    readonly maxOutputTokens?: number;
+    readonly requestTimeoutMs?: number;
+    readonly maxCorrectionAttempts?: number;
+    /** The site-wide floor (`resolveProviderTuningDefaults`, `assistant.*` site settings) — always required, never a built-in constant. */
+    readonly defaults: ProviderTuningDefaults;
 }
 /**
  * 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,7 @@
 import { CogentaError } from '@cogenta/core';
+import { textOnlyContent } from './content-parts.js';
+import { 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 +22,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 +60,27 @@ 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 site-wide default) — applied only when
+ * `request.maxTokens` itself is absent, never overriding an explicit
+ * per-call value. Required, not defaulted: the one caller that matters
+ * (`createAnthropicClient`'s own `chat()`) always has a concrete number by
+ * the time it calls this; a test wanting a specific budget passes its own.
+ */
+export function buildAnthropicRequest(request, fallbackMaxTokens) {
     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 +89,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 +98,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 +118,18 @@ export function parseAnthropicResponse(body) {
 export function createAnthropicClient(config) {
     const doFetch = config.fetchImpl ?? fetch;
     const url = config.baseUrl ?? DEFAULT_BASE_URL;
+    const maxOutputTokens = config.maxOutputTokens ?? config.defaults.maxOutputTokens;
+    const requestTimeoutMs = config.requestTimeoutMs ?? config.defaults.requestTimeoutMs;
+    const maxCorrectionAttempts = config.maxCorrectionAttempts ?? config.defaults.maxCorrectionAttempts;
     return {
         name: 'anthropic',
         model: config.model,
+        supportsVision: true,
+        maxOutputTokens,
+        requestTimeoutMs,
+        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"}