@cogenta/agents 0.1.0

package/dist/skills/frontmatter.js

@@ -0,0 +1,46 @@
+import { CogentaError } from '@cogenta/core';
+const REQUIRED_FIELDS = ['name', 'version', 'description'];
+/**
+ * Deliberately not a YAML parser (R9: no new dependency for three flat
+ * string fields) — `---\nkey: value\n---\nbody`, one `key: value` per line,
+ * nothing nested.
+ */
+export function parseSkillFile(path, raw) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(raw);
+    if (match === null) {
+        throw new CogentaError({
+            code: 'SKILL_DEFINITION_INVALID',
+            message: `"${path}" has no --- frontmatter block.`,
+            hint: 'Start the file with --- \\n name: ... \\n version: ... \\n description: ... \\n ---',
+        });
+    }
+    const [, frontmatter = '', body = ''] = match;
+    const fields = {};
+    for (const line of frontmatter.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        const separatorIndex = line.indexOf(':');
+        if (separatorIndex === -1)
+            continue;
+        const key = line.slice(0, separatorIndex).trim();
+        const value = line.slice(separatorIndex + 1).trim();
+        fields[key] = value;
+    }
+    const missing = REQUIRED_FIELDS.filter((field) => fields[field] === undefined);
+    if (missing.length > 0) {
+        throw new CogentaError({
+            code: 'SKILL_DEFINITION_INVALID',
+            message: `"${path}" is missing required frontmatter field(s): ${missing.join(', ')}.`,
+            hint: 'A skill needs name, version and description in its frontmatter.',
+        });
+    }
+    return {
+        metadata: {
+            name: fields.name,
+            version: fields.version,
+            description: fields.description,
+        },
+        instructions: body.trim(),
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/skills/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAU,CAAA;AAEnE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,GAAW;IAEX,MAAM,KAAK,GAAG,6CAA6C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,iCAAiC;YAClD,IAAI,EAAE,qFAAqF;SAC5F,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,EAAE,WAAW,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAA;IAE7C,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAQ;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,cAAc,KAAK,CAAC,CAAC;YAAE,SAAQ;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAA;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACrF,IAAI,EAAE,iEAAiE;SACxE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAiB;YACjC,WAAW,EAAE,MAAM,CAAC,WAAqB;SAC1C;QACD,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE;KAC1B,CAAA;AACH,CAAC"}

package/dist/skills/types.d.ts

@@ -0,0 +1,19 @@
+export interface SkillMetadata {
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+}
+/** A skill's instructions text plus the names of the resource files sitting alongside it — the resources themselves are read by the caller, on demand, only for the files it actually needs. */
+export interface Skill extends SkillMetadata {
+    readonly instructions: string;
+    readonly dir: string;
+    readonly resources: readonly string[];
+}
+export interface SkillStore {
+    list(): Promise<readonly SkillMetadata[]>;
+    /** Reads one skill's instructions in full — the "on demand" half of "chargé à la demande" (never done for every skill up front). */
+    load(name: string): Promise<Skill>;
+    /** Copies a skill folder from `sourceDir` into the store, under its own declared name. */
+    install(sourceDir: string): Promise<SkillMetadata>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,gMAAgM;AAChM,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;IACzC,oIAAoI;IACpI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAClC,0FAA0F;IAC1F,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACnD"}

package/dist/skills/types.js

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

package/dist/skills/types.js.map

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

package/dist/skin/generate.d.ts

@@ -0,0 +1,22 @@
+import { type SkinTokens } from '@cogenta/render';
+import type { ProviderClient } from '../providers/types.js';
+export interface GenerateSkinOptions {
+    readonly client: ProviderClient;
+    readonly model: string;
+    /** Free text: sector, mood, audience, optional brand colours. */
+    readonly description: string;
+    readonly blueprintLabel: string;
+    /** "trois tentatives" by default. */
+    readonly maxAttempts?: number;
+}
+export type GenerateSkinResult = {
+    readonly ok: true;
+    readonly tokens: SkinTokens;
+    readonly attempts: number;
+} | {
+    readonly ok: false;
+    readonly attempts: number;
+    readonly reason: string;
+};
+export declare function generateSkin(options: GenerateSkinOptions): Promise<GenerateSkinResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/skin/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/skin/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,UAAU,EAIhB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAkE3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAmD9E,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyC5F"}

package/dist/skin/generate.js

@@ -0,0 +1,144 @@
+import { CogentaError, isCogentaError } from '@cogenta/core';
+import { CONTRAST_PAIRS, DENSITIES, TOKEN_GROUPS, TOKEN_SPECS, validateSkin, } from '@cogenta/render';
+/**
+ * L9 task 7 (`create-cogenta`) / task 9 (`cogenta skin generate`): "L'IA ne
+ * produit pas de CSS. Elle remplit le schéma de tokens du contrat D."
+ * Generation, validation and the three-attempt correction loop — validation
+ * itself is not reimplemented here: `validateSkin` (`@cogenta/render`)
+ * already does hard-refusal contrast/scale/completeness/motion checks with
+ * actionable `hint`s on every `CogentaError` it throws, written (its own
+ * source comment says so) for exactly this — "the author is a model, which
+ * can only correct what the message actually measures." This module's only
+ * job is to turn that hint into the next attempt's correction prompt.
+ *
+ * Lives in `@cogenta/agents` rather than `@cogenta/render` or
+ * `create-cogenta`: the retry-on-model-feedback loop is an AI-orchestration
+ * concern (this package's own domain — providers, retry, structured
+ * generation), not a rendering concern, and both `create-cogenta` (the
+ * installer) and `@cogenta/cli` (`cogenta skin generate`, task 9) need to
+ * call it without either depending on the other. `@cogenta/render` owns
+ * contract D and stays the single source of truth this validates against.
+ */
+const KIND_HINT = {
+    color: 'a hex, rgb() or hsl() colour, fully opaque if it is ever used as a background',
+    length: 'a CSS length with a unit, e.g. "0.25rem" or "16px"',
+    duration: 'a CSS duration with a unit, e.g. "200ms"',
+    ratio: 'a number greater than 1',
+    text: 'a short string (a font stack, an easing keyword, a CSS box-shadow value)',
+    boolean: 'true or false',
+    density: `one of: ${DENSITIES.join(', ')}`,
+};
+/**
+ * Describes contract D's token schema by reading the same `TOKEN_SPECS`/
+ * `CONTRAST_PAIRS` that `validateSkin` checks against, rather than a
+ * hand-duplicated copy of the shape — the prompt and the validator cannot
+ * drift apart.
+ */
+function describeTokenSchema() {
+    const byGroup = new Map();
+    for (const spec of TOKEN_SPECS) {
+        const list = byGroup.get(spec.group) ?? [];
+        list.push(`"${spec.name}": ${KIND_HINT[spec.kind] ?? 'a string'}`);
+        byGroup.set(spec.group, list);
+    }
+    const groups = TOKEN_GROUPS.map((group) => `  "${group}": { ${(byGroup.get(group) ?? []).join(', ')} }`);
+    const contrastLines = CONTRAST_PAIRS.map((pair) => `color.${pair.foreground} on color.${pair.background} must reach WCAG 2.2 AA contrast for ${pair.size} text`);
+    return [
+        'Return a single JSON object with exactly these top-level keys, and no others:',
+        '{',
+        groups.join(',\n'),
+        '}',
+        '',
+        'Hard requirements, checked automatically before this skin is accepted:',
+        ...contrastLines.map((line) => `- ${line}`),
+        '- font.scale must be greater than 1, so each step of the type scale is strictly larger than the one before it.',
+        '- motion.reduced must be true.',
+        '- Every key listed above must be present, with no extra key added.',
+    ].join('\n');
+}
+const DEFAULT_MAX_ATTEMPTS = 3;
+const MAX_TOKENS = 2000;
+function buildPrompt(options, correction) {
+    const lines = [
+        'You are configuring the visual design tokens of a Cogenta CMS site.',
+        'You do not write CSS or markup — only the JSON data below.',
+        `Site type: ${options.blueprintLabel}.`,
+        `Description from the site owner: ${options.description}`,
+        '',
+        describeTokenSchema(),
+        '',
+        'Reply with ONLY the JSON object. No prose, no markdown code fence, no explanation.',
+    ];
+    if (correction !== undefined) {
+        lines.push('', `Your previous attempt was rejected: ${correction}`, 'Fix it and reply again with ONLY the corrected JSON object.');
+    }
+    return lines.join('\n');
+}
+function notJson(reason) {
+    return new CogentaError({
+        code: 'SKIN_GENERATION_RESPONSE_NOT_JSON',
+        message: `The model's response was not a single JSON object: ${reason}.`,
+        hint: 'Reply with ONLY a JSON object matching the requested token schema — no prose, no markdown fence.',
+    });
+}
+function extractJson(content) {
+    if (content === null)
+        throw notJson('the response was empty');
+    const trimmed = content.trim();
+    const start = trimmed.indexOf('{');
+    const end = trimmed.lastIndexOf('}');
+    if (start === -1 || end === -1 || end < start)
+        throw notJson('no JSON object was found');
+    try {
+        return JSON.parse(trimmed.slice(start, end + 1));
+    }
+    catch (error) {
+        throw notJson(error instanceof Error ? error.message : String(error));
+    }
+}
+function correctionFor(error) {
+    return error.hint === undefined ? error.message : `${error.message} ${error.hint}`;
+}
+export async function generateSkin(options) {
+    const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    let correction;
+    let lastReason = 'no attempt was made';
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        let content;
+        try {
+            const response = await options.client.chat({
+                model: options.model,
+                messages: [{ role: 'user', content: buildPrompt(options, correction) }],
+                maxTokens: MAX_TOKENS,
+            });
+            content = response.content;
+        }
+        catch (error) {
+            lastReason = `model call failed: ${error instanceof Error ? error.message : String(error)}`;
+            correction = lastReason;
+            continue;
+        }
+        let candidate;
+        try {
+            candidate = extractJson(content);
+        }
+        catch {
+            lastReason = 'the model did not return a JSON object';
+            correction =
+                'Your previous response was not a single JSON object. Reply with ONLY the JSON object — no prose, no markdown fence.';
+            continue;
+        }
+        try {
+            const tokens = validateSkin(candidate);
+            return { ok: true, tokens, attempts: attempt };
+        }
+        catch (error) {
+            if (!isCogentaError(error))
+                throw error;
+            lastReason = error.message;
+            correction = correctionFor(error);
+        }
+    }
+    return { ok: false, attempts: maxAttempts, reason: lastReason };
+}
+//# sourceMappingURL=generate.js.map

package/dist/skin/generate.js.map

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

package/dist/subagents/run-subagent.d.ts

@@ -0,0 +1,10 @@
+import type { RunAgentLoopInput, RunResult } from '../runtime/types.js';
+/**
+ * Runs a sub-agent's own loop with its own manifest, budget and kill switch
+ * (all already isolated per call, since `runAgentLoop` never shares state
+ * across invocations) and turns a thrown failure into data instead of an
+ * exception, so a sub-agent's crash cannot pollute — or stop — its parent's
+ * own run.
+ */
+export declare function runSubagent(input: RunAgentLoopInput): Promise<RunResult>;
+//# sourceMappingURL=run-subagent.d.ts.map

package/dist/subagents/run-subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-subagent.d.ts","sourceRoot":"","sources":["../../src/subagents/run-subagent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEvE;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAa9E"}

package/dist/subagents/run-subagent.js

@@ -0,0 +1,24 @@
+import { runAgentLoop } from '../runtime/loop.js';
+/**
+ * Runs a sub-agent's own loop with its own manifest, budget and kill switch
+ * (all already isolated per call, since `runAgentLoop` never shares state
+ * across invocations) and turns a thrown failure into data instead of an
+ * exception, so a sub-agent's crash cannot pollute — or stop — its parent's
+ * own run.
+ */
+export async function runSubagent(input) {
+    try {
+        return await runAgentLoop(input);
+    }
+    catch (error) {
+        return {
+            messages: input.messages,
+            steps: [],
+            finalText: null,
+            stopReason: 'errored',
+            usage: { inputTokens: 0, outputTokens: 0 },
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=run-subagent.js.map

package/dist/subagents/run-subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-subagent.js","sourceRoot":"","sources":["../../src/subagents/run-subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAwB;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;YAC1C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/subagents/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The one slice of `defineAgent` (Contract C) task 11 actually needs: enough
+ * to check `subagent.tools ⊆ parent.tools` before anything runs. The rest of
+ * an agent's declaration (identity, model, skills, autonomy, budget, memory,
+ * triggers) belongs to later tasks and is deliberately not modelled here.
+ */
+export interface AgentToolsDeclaration {
+    readonly name: string;
+    readonly tools: readonly string[];
+    /** Names of other declarations in the same set this agent may delegate to. */
+    readonly subagents?: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/subagents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC"}

package/dist/subagents/types.js

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

package/dist/subagents/types.js.map

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

package/dist/subagents/validate.d.ts

@@ -0,0 +1,8 @@
+import type { AgentToolsDeclaration } from './types.js';
+/**
+ * `subagent.tools ⊆ parent.tools`, checked once for the whole declared set —
+ * at load time, never at call time (the lot's own wording: an invalid
+ * declaration must stop the agent from loading at all, not fail mid-run).
+ */
+export declare function validateSubagentTools(agents: readonly AgentToolsDeclaration[]): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/subagents/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/subagents/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CA0BpF"}

package/dist/subagents/validate.js

@@ -0,0 +1,32 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * `subagent.tools ⊆ parent.tools`, checked once for the whole declared set —
+ * at load time, never at call time (the lot's own wording: an invalid
+ * declaration must stop the agent from loading at all, not fail mid-run).
+ */
+export function validateSubagentTools(agents) {
+    const byName = new Map(agents.map((agent) => [agent.name, agent]));
+    for (const agent of agents) {
+        for (const subagentName of agent.subagents ?? []) {
+            const subagent = byName.get(subagentName);
+            if (subagent === undefined) {
+                throw new CogentaError({
+                    code: 'AGENT_SUBAGENT_UNKNOWN',
+                    message: `"${agent.name}" declares sub-agent "${subagentName}", which is not in this agent set.`,
+                    hint: 'Declare the sub-agent alongside its parent before validating, or remove it from `subagents`.',
+                });
+            }
+            const parentTools = new Set(agent.tools);
+            const excess = subagent.tools.filter((tool) => !parentTools.has(tool));
+            if (excess.length > 0) {
+                throw new CogentaError({
+                    code: 'AGENT_SUBAGENT_TOOLS_NOT_SUBSET',
+                    message: `Sub-agent "${subagentName}" has tools not granted to its parent "${agent.name}": ${excess.join(', ')}.`,
+                    hint: 'A sub-agent can never see more than its parent — grant the tool to the parent too, or remove it from the sub-agent.',
+                    details: { parent: agent.name, subagent: subagentName, excess },
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/subagents/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/subagents/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwC;IAC5E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAElE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,yBAAyB,YAAY,oCAAoC;oBAChG,IAAI,EAAE,8FAA8F;iBACrG,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YACtE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,iCAAiC;oBACvC,OAAO,EAAE,cAAc,YAAY,0CAA0C,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACjH,IAAI,EAAE,qHAAqH;oBAC3H,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE;iBAChE,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/core/agent-delegate.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { ProviderClient } from '../../providers/types.js';
+import type { ExecutableTool } from '../../runtime/types.js';
+import type { ToolDefinition } from '../types.js';
+export interface AgentDelegateToolOptions {
+    /** For messages only — which sub-agent this instance delegates to. */
+    readonly subagentName: string;
+    readonly client: ProviderClient;
+    /** The sub-agent's own manifest — built (elsewhere) from its own `tools`, already checked to be a subset of the parent's via `validateSubagentTools`. */
+    readonly tools: readonly ExecutableTool[];
+    readonly system?: string;
+    readonly maxTokens: number;
+    readonly maxSteps?: number;
+}
+declare const AgentDelegateInputSchema: z.ZodObject<{
+    task: z.ZodString;
+}, z.core.$strip>;
+export type AgentDelegateInput = z.infer<typeof AgentDelegateInputSchema>;
+declare const AgentDelegateOutputSchema: z.ZodObject<{
+    finalText: z.ZodNullable<z.ZodString>;
+    stopReason: z.ZodString;
+}, z.core.$strip>;
+export type AgentDelegateOutput = z.infer<typeof AgentDelegateOutputSchema>;
+/**
+ * `agent.delegate` — hands one task to a sub-agent's own `runAgentLoop` run,
+ * with its own manifest and budget (both fixed at construction, one instance
+ * per delegating agent, same pattern as `http.fetch`'s per-agent domain
+ * list). `runSubagent` (task 11) is what keeps a sub-agent's crash from
+ * propagating: this tool's `execute` never throws for that reason, only for
+ * an input/output schema mismatch, which is the manifest's job to catch.
+ */
+export declare function createAgentDelegateTool(options: AgentDelegateToolOptions): ToolDefinition<AgentDelegateInput, AgentDelegateOutput>;
+export {};
+//# sourceMappingURL=agent-delegate.d.ts.map

package/dist/tools/core/agent-delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delegate.d.ts","sourceRoot":"","sources":["../../../src/tools/core/agent-delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,yJAAyJ;IACzJ,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,QAAA,MAAM,wBAAwB;;iBAAiC,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,QAAA,MAAM,yBAAyB;;;iBAG7B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAwBzD"}

package/dist/tools/core/agent-delegate.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { runSubagent } from '../../subagents/run-subagent.js';
+import { defineTool } from '../define.js';
+const AgentDelegateInputSchema = z.object({ task: z.string() });
+const AgentDelegateOutputSchema = z.object({
+    finalText: z.string().nullable(),
+    stopReason: z.string(),
+});
+/**
+ * `agent.delegate` — hands one task to a sub-agent's own `runAgentLoop` run,
+ * with its own manifest and budget (both fixed at construction, one instance
+ * per delegating agent, same pattern as `http.fetch`'s per-agent domain
+ * list). `runSubagent` (task 11) is what keeps a sub-agent's crash from
+ * propagating: this tool's `execute` never throws for that reason, only for
+ * an input/output schema mismatch, which is the manifest's job to catch.
+ */
+export function createAgentDelegateTool(options) {
+    return defineTool({
+        name: 'agent.delegate',
+        version: '1.0.0',
+        description: `Delegate one task to the "${options.subagentName}" sub-agent.`,
+        input: AgentDelegateInputSchema,
+        output: AgentDelegateOutputSchema,
+        permissions: ['agent.delegate'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'high',
+        async execute(input) {
+            const result = await runSubagent({
+                client: options.client,
+                messages: [{ role: 'user', content: input.task }],
+                tools: options.tools,
+                maxTokens: options.maxTokens,
+                ...(options.system === undefined ? {} : { system: options.system }),
+                ...(options.maxSteps === undefined ? {} : { maxSteps: options.maxSteps }),
+            });
+            return { finalText: result.finalText, stopReason: result.stopReason };
+        },
+    });
+}
+//# sourceMappingURL=agent-delegate.js.map

package/dist/tools/core/agent-delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delegate.js","sourceRoot":"","sources":["../../../src/tools/core/agent-delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAczC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAG/D,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAA;AAGF;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAiC;IAEjC,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,6BAA6B,OAAO,CAAC,YAAY,cAAc;QAC5E,KAAK,EAAE,wBAAwB;QAC/B,MAAM,EAAE,yBAAyB;QACjC,WAAW,EAAE,CAAC,gBAAgB,CAAC;QAC/B,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBACjD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;aAC1E,CAAC,CAAA;YAEF,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAA;QACvE,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/core/content.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types.js';
+/**
+ * The narrow slice of `@cogenta/api`'s `ContentService` these tools actually
+ * call — declared locally rather than imported so `@cogenta/agents` does not
+ * pull in `@cogenta/api`'s full dependency graph (GraphQL, WebAuthn) just to
+ * describe four method signatures. A real `ContentService` instance already
+ * satisfies this structurally; wiring one in is the runtime assembly's job
+ * (where `defineAgent` configs become live tool instances), not this
+ * module's.
+ */
+export interface ContentAccessContext {
+    readonly actor: {
+        readonly id: string | null;
+        readonly roles: readonly string[];
+    };
+}
+export interface ContentReadOptions {
+    readonly state: 'published' | 'working';
+    readonly depth: number;
+}
+export interface ContentServiceLike {
+    read(context: ContentAccessContext, collection: string, id: string, options: ContentReadOptions): Promise<Record<string, unknown>>;
+    create(context: ContentAccessContext, collection: string, input: {
+        readonly values: Readonly<Record<string, unknown>>;
+        readonly locale?: string;
+    }, options: ContentReadOptions): Promise<Record<string, unknown>>;
+    update(context: ContentAccessContext, collection: string, id: string, input: {
+        readonly values: Readonly<Record<string, unknown>>;
+    }, options: ContentReadOptions): Promise<Record<string, unknown>>;
+    publish(context: ContentAccessContext, collection: string, id: string, input: {
+        readonly publishedBy?: string | null;
+    }, options: ContentReadOptions): Promise<Record<string, unknown>>;
+    remove(context: ContentAccessContext, collection: string, id: string): Promise<void>;
+}
+declare const ReadInputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+    state: z.ZodOptional<z.ZodEnum<{
+        published: "published";
+        working: "working";
+    }>>;
+}, z.core.$strip>;
+type ReadInput = z.infer<typeof ReadInputSchema>;
+/**
+ * `content.read` — the service is the actual permission gate (it calls
+ * `PermissionLayer.assert` internally against the collection's own
+ * `read`/`publish` roles); this tool only shapes the call and never
+ * second-guesses what the service decides.
+ */
+export declare function createContentReadTool(service: ContentServiceLike): ToolDefinition<ReadInput, Record<string, unknown>>;
+declare const WriteDraftInputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+    values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type WriteDraftInput = z.infer<typeof WriteDraftInputSchema>;
+/**
+ * `content.write_draft` — creates a new working entry when `id` is absent,
+ * updates the existing one otherwise. Never touches the published state;
+ * that is `content.publish`'s job alone, matching `ContentService` keeping
+ * `create`/`update` and `publish` as distinct operations.
+ */
+export declare function createContentWriteDraftTool(service: ContentServiceLike): ToolDefinition<WriteDraftInput, Record<string, unknown>>;
+declare const PublishInputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+type PublishInput = z.infer<typeof PublishInputSchema>;
+export declare function createContentPublishTool(service: ContentServiceLike): ToolDefinition<PublishInput, Record<string, unknown>>;
+declare const DeleteInputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+type DeleteInput = z.infer<typeof DeleteInputSchema>;
+export declare function createContentDeleteTool(service: ContentServiceLike): ToolDefinition<DeleteInput, {
+    ok: boolean;
+}>;
+export {};
+//# sourceMappingURL=content.d.ts.map

package/dist/tools/core/content.d.ts.map

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