@vauban-org/agent-sdk 0.17.4 → 1.2.0

package/dist/events/schemas/vauban.vault.analyzed.v1.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export declare const VaubanVaultAnalyzedV1: z.ZodObject<{
+    vaultId: z.ZodString;
+    tvlUsd: z.ZodNumber;
+    anomalies: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
+        metric: z.ZodString;
+        current: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        expected: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        expected: string | number;
+        type: string;
+        description: string;
+        severity: "error" | "info" | "critical" | "warning";
+        metric: string;
+        current: string | number;
+    }, {
+        expected: string | number;
+        type: string;
+        description: string;
+        severity: "error" | "info" | "critical" | "warning";
+        metric: string;
+        current: string | number;
+    }>, "many">;
+    overallSeverity: z.ZodEnum<["info", "warning", "error", "critical"]>;
+    timestamp: z.ZodString;
+    schemaVersion: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    timestamp: string;
+    schemaVersion: string;
+    vaultId: string;
+    overallSeverity: "error" | "info" | "critical" | "warning";
+    tvlUsd: number;
+    anomalies: {
+        expected: string | number;
+        type: string;
+        description: string;
+        severity: "error" | "info" | "critical" | "warning";
+        metric: string;
+        current: string | number;
+    }[];
+}, {
+    timestamp: string;
+    schemaVersion: string;
+    vaultId: string;
+    overallSeverity: "error" | "info" | "critical" | "warning";
+    tvlUsd: number;
+    anomalies: {
+        expected: string | number;
+        type: string;
+        description: string;
+        severity: "error" | "info" | "critical" | "warning";
+        metric: string;
+        current: string | number;
+    }[];
+}>;
+//# sourceMappingURL=vauban.vault.analyzed.v1.d.ts.map

package/dist/events/schemas/vauban.vault.analyzed.v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vauban.vault.analyzed.v1.d.ts","sourceRoot":"","sources":["../../../src/events/schemas/vauban.vault.analyzed.v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC"}

package/dist/events/schemas/vauban.vault.analyzed.v1.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export const VaubanVaultAnalyzedV1 = z
+    .object({
+    vaultId: z.string(),
+    tvlUsd: z.number(),
+    anomalies: z.array(z.object({
+        type: z.string(),
+        severity: z.enum(["info", "warning", "error", "critical"]),
+        metric: z.string(),
+        current: z.union([z.string(), z.number()]),
+        expected: z.union([z.string(), z.number()]),
+        description: z.string(),
+    })),
+    overallSeverity: z.enum(["info", "warning", "error", "critical"]),
+    timestamp: z.string(),
+    schemaVersion: z.string(),
+})
+    .strict();
+//# sourceMappingURL=vauban.vault.analyzed.v1.js.map

package/dist/events/schemas/vauban.vault.analyzed.v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vauban.vault.analyzed.v1.js","sourceRoot":"","sources":["../../../src/events/schemas/vauban.vault.analyzed.v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC,CACH;IACD,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/events/schemas/vauban.vault.compounded.v1.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export declare const VaubanVaultCompoundedV1: z.ZodObject<{
+    vaultId: z.ZodString;
+    compoundedAt: z.ZodString;
+    rewardsUsd: z.ZodNumber;
+    caller: z.ZodString;
+    txHash: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: string;
+    vaultId: string;
+    compoundedAt: string;
+    rewardsUsd: number;
+    caller: string;
+    txHash?: string | undefined;
+}, {
+    schemaVersion: string;
+    vaultId: string;
+    compoundedAt: string;
+    rewardsUsd: number;
+    caller: string;
+    txHash?: string | undefined;
+}>;
+//# sourceMappingURL=vauban.vault.compounded.v1.d.ts.map

package/dist/events/schemas/vauban.vault.compounded.v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vauban.vault.compounded.v1.d.ts","sourceRoot":"","sources":["../../../src/events/schemas/vauban.vault.compounded.v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC"}

package/dist/events/schemas/vauban.vault.compounded.v1.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export const VaubanVaultCompoundedV1 = z
+    .object({
+    vaultId: z.string(),
+    compoundedAt: z.string(),
+    rewardsUsd: z.number(),
+    caller: z.string(),
+    txHash: z.string().optional(),
+    schemaVersion: z.string(),
+})
+    .strict();
+//# sourceMappingURL=vauban.vault.compounded.v1.js.map

package/dist/events/schemas/vauban.vault.compounded.v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vauban.vault.compounded.v1.js","sourceRoot":"","sources":["../../../src/events/schemas/vauban.vault.compounded.v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/identity/agent-persona.d.ts

@@ -0,0 +1,73 @@
+/**
+ * AgentPersona — load, save, and resolve a per-agent persona.
+ *
+ * Pipeline:
+ *   1. Resolve persona for agent X
+ *   2. base = DEFAULT_PERSONA
+ *   3. brain = loadFromBrain(X) (Tier 3 semantic memory query)
+ *   4. local = loadFromFile(`.cc/persona.yaml`) — optional
+ *   5. effective = merge(base, brain, local)
+ *
+ * Brain entries use category `agent-persona`, tags `["persona", agentId]`.
+ * The latest entry per agent wins (Brain query returns entries sorted by
+ * recency).
+ *
+ * @see ./persona-schema.ts
+ * @public
+ */
+import type { SemanticMemoryPort } from "../ports/brain.js";
+import { type AgentPersona } from "./persona-schema.js";
+export declare const PERSONA_BRAIN_CATEGORY = "agent-persona";
+/** Tags used to query/archive a persona for a given agent. */
+export declare function personaTags(agentId: string): string[];
+/**
+ * Save (archive) a persona for an agent in Brain Tier 3 (semantic).
+ *
+ * The persona is serialized as JSON in the `content` field — keep this
+ * structured so future queries can parse it deterministically. Tags include
+ * the agent id so per-agent retrieval is precise.
+ *
+ * Returns the archived entry id, or null when the brain port returns null
+ * (e.g. replay mode, no brain configured).
+ */
+export declare function savePersonaToBrain(brain: SemanticMemoryPort, agentId: string, persona: AgentPersona): Promise<string | null>;
+/**
+ * Query Brain for the latest persona for an agent.
+ *
+ * Returns the parsed persona or `null` if no entry is found (or if the
+ * latest entry's content does not parse).
+ */
+export declare function loadPersonaFromBrain(brain: SemanticMemoryPort, agentId: string): Promise<AgentPersona | null>;
+/**
+ * Load a persona from a YAML file. Returns null if the file is missing or
+ * the content does not validate. Throws only on filesystem errors other
+ * than ENOENT.
+ */
+export declare function loadPersonaFromFile(path: string): Promise<AgentPersona | null>;
+/**
+ * Persist a persona to a YAML file (overwrites). Validates first.
+ */
+export declare function savePersonaToFile(path: string, persona: AgentPersona): Promise<void>;
+export interface ResolvePersonaOptions {
+    agentId: string;
+    brain?: SemanticMemoryPort;
+    localPath?: string;
+}
+export interface ResolvedPersona {
+    effective: AgentPersona;
+    /** Layers actually applied, in order (latest wins). */
+    layers: Array<"defaults" | "brain" | "local">;
+}
+/**
+ * Resolve the effective persona for an agent.
+ *
+ * Composition order (each layer overrides the previous):
+ *   1. DEFAULT_PERSONA
+ *   2. Brain entry (Tier 3 semantic, optional)
+ *   3. Local `.cc/persona.yaml` (optional)
+ *
+ * The returned `layers` array documents which sources contributed, useful
+ * for diagnostics (e.g. `cc persona show --explain`).
+ */
+export declare function resolvePersona(opts: ResolvePersonaOptions): Promise<ResolvedPersona>;
+//# sourceMappingURL=agent-persona.d.ts.map

package/dist/identity/agent-persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-persona.d.ts","sourceRoot":"","sources":["../../src/identity/agent-persona.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAEtD,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAID;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAeD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyB9B;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAiB9B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf;AAID,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,YAAY,CAAC;IACxB,uDAAuD;IACvD,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/dist/identity/agent-persona.js

@@ -0,0 +1,165 @@
+/**
+ * AgentPersona — load, save, and resolve a per-agent persona.
+ *
+ * Pipeline:
+ *   1. Resolve persona for agent X
+ *   2. base = DEFAULT_PERSONA
+ *   3. brain = loadFromBrain(X) (Tier 3 semantic memory query)
+ *   4. local = loadFromFile(`.cc/persona.yaml`) — optional
+ *   5. effective = merge(base, brain, local)
+ *
+ * Brain entries use category `agent-persona`, tags `["persona", agentId]`.
+ * The latest entry per agent wins (Brain query returns entries sorted by
+ * recency).
+ *
+ * @see ./persona-schema.ts
+ * @public
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { DEFAULT_PERSONA, mergePersona, PersonaSchema, validatePersona, } from "./persona-schema.js";
+export const PERSONA_BRAIN_CATEGORY = "agent-persona";
+/** Tags used to query/archive a persona for a given agent. */
+export function personaTags(agentId) {
+    return ["persona", agentId];
+}
+// ─── Brain layer ────────────────────────────────────────────────────────────
+/**
+ * Save (archive) a persona for an agent in Brain Tier 3 (semantic).
+ *
+ * The persona is serialized as JSON in the `content` field — keep this
+ * structured so future queries can parse it deterministically. Tags include
+ * the agent id so per-agent retrieval is precise.
+ *
+ * Returns the archived entry id, or null when the brain port returns null
+ * (e.g. replay mode, no brain configured).
+ */
+export async function savePersonaToBrain(brain, agentId, persona) {
+    validatePersona(persona);
+    // Wrap the JSON body with a discoverable header line — FTS-backed Brain
+    // backends use the query string as a keyword filter, so the content MUST
+    // contain the literal "persona" + agent id for `query("persona ...")` hits.
+    const content = `persona for agent ${agentId}\n${JSON.stringify(persona)}`;
+    const entry = await brain.archive({
+        content,
+        content_type: "persona",
+        category: PERSONA_BRAIN_CATEGORY,
+        tags: personaTags(agentId),
+        metadata: { agent_id: agentId, schema_version: 1 },
+    });
+    return entry?.id ?? null;
+}
+/**
+ * Extract the JSON body from a persona Brain entry (strips the header line).
+ * Returns null if the content doesn't follow the wrapper format.
+ */
+function extractPersonaJson(content) {
+    const nl = content.indexOf("\n");
+    if (nl === -1) {
+        // Backward-compat: legacy entries stored raw JSON.
+        return content;
+    }
+    return content.slice(nl + 1);
+}
+/**
+ * Query Brain for the latest persona for an agent.
+ *
+ * Returns the parsed persona or `null` if no entry is found (or if the
+ * latest entry's content does not parse).
+ */
+export async function loadPersonaFromBrain(brain, agentId) {
+    const results = await brain.query("persona", {
+        category: PERSONA_BRAIN_CATEGORY,
+        tags: personaTags(agentId),
+        limit: 5,
+    });
+    if (results.length === 0)
+        return null;
+    // Prefer the most recent entry by created_at if available.
+    const sorted = [...results].sort((a, b) => {
+        const ta = a.created_at ? Date.parse(a.created_at) : 0;
+        const tb = b.created_at ? Date.parse(b.created_at) : 0;
+        return tb - ta;
+    });
+    for (const entry of sorted) {
+        const json = extractPersonaJson(entry.content);
+        if (!json)
+            continue;
+        try {
+            const parsed = JSON.parse(json);
+            const validated = PersonaSchema.safeParse(parsed);
+            if (validated.success)
+                return validated.data;
+        }
+        catch {
+            // skip malformed entry, try next
+        }
+    }
+    return null;
+}
+// ─── File layer ─────────────────────────────────────────────────────────────
+/**
+ * Load a persona from a YAML file. Returns null if the file is missing or
+ * the content does not validate. Throws only on filesystem errors other
+ * than ENOENT.
+ */
+export async function loadPersonaFromFile(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf-8");
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        return null;
+    }
+    const result = PersonaSchema.safeParse(parsed);
+    return result.success ? result.data : null;
+}
+/**
+ * Persist a persona to a YAML file (overwrites). Validates first.
+ */
+export async function savePersonaToFile(path, persona) {
+    const validated = validatePersona(persona);
+    const yaml = stringifyYaml(validated, { indent: 2 });
+    await writeFile(path, yaml, "utf-8");
+}
+/**
+ * Resolve the effective persona for an agent.
+ *
+ * Composition order (each layer overrides the previous):
+ *   1. DEFAULT_PERSONA
+ *   2. Brain entry (Tier 3 semantic, optional)
+ *   3. Local `.cc/persona.yaml` (optional)
+ *
+ * The returned `layers` array documents which sources contributed, useful
+ * for diagnostics (e.g. `cc persona show --explain`).
+ */
+export async function resolvePersona(opts) {
+    const layers = ["defaults"];
+    let effective = DEFAULT_PERSONA;
+    if (opts.brain) {
+        const fromBrain = await loadPersonaFromBrain(opts.brain, opts.agentId);
+        if (fromBrain) {
+            effective = mergePersona(effective, fromBrain);
+            layers.push("brain");
+        }
+    }
+    if (opts.localPath) {
+        const fromFile = await loadPersonaFromFile(opts.localPath);
+        if (fromFile) {
+            effective = mergePersona(effective, fromFile);
+            layers.push("local");
+        }
+    }
+    return { effective, layers };
+}
+//# sourceMappingURL=agent-persona.js.map

package/dist/identity/agent-persona.js.map

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

package/dist/identity/persona-prompt.d.ts

@@ -0,0 +1,25 @@
+/**
+ * buildPersonaPromptBlock — converts an AgentPersona into a system-prompt block.
+ *
+ * The output is a compact, model-neutral instruction block that can be prepended
+ * to any system prompt. It is intentionally terse — LLMs handle short, directive
+ * blocks better than verbose persona descriptions.
+ *
+ * Format contract:
+ *   - Starts with a blank line so callers can safely concatenate to an existing
+ *     system prompt with `${base}\n${buildPersonaPromptBlock(persona)}`.
+ *   - Empty fields are omitted — the function never emits empty bullet points.
+ *   - The block is bounded by `--- persona ---` / `--- end persona ---` markers
+ *     for easy parsing / stripping in tests and audits.
+ *
+ * @public
+ */
+import type { AgentPersona } from "./persona-schema.js";
+/**
+ * Build a system-prompt instruction block from a resolved `AgentPersona`.
+ *
+ * Returns an empty string if the persona has no actionable fields, so
+ * callers can unconditionally concatenate without emitting noise.
+ */
+export declare function buildPersonaPromptBlock(persona: AgentPersona): string;
+//# sourceMappingURL=persona-prompt.d.ts.map

package/dist/identity/persona-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-prompt.d.ts","sourceRoot":"","sources":["../../src/identity/persona-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA0DrE"}

package/dist/identity/persona-prompt.js

@@ -0,0 +1,71 @@
+/**
+ * buildPersonaPromptBlock — converts an AgentPersona into a system-prompt block.
+ *
+ * The output is a compact, model-neutral instruction block that can be prepended
+ * to any system prompt. It is intentionally terse — LLMs handle short, directive
+ * blocks better than verbose persona descriptions.
+ *
+ * Format contract:
+ *   - Starts with a blank line so callers can safely concatenate to an existing
+ *     system prompt with `${base}\n${buildPersonaPromptBlock(persona)}`.
+ *   - Empty fields are omitted — the function never emits empty bullet points.
+ *   - The block is bounded by `--- persona ---` / `--- end persona ---` markers
+ *     for easy parsing / stripping in tests and audits.
+ *
+ * @public
+ */
+/**
+ * Build a system-prompt instruction block from a resolved `AgentPersona`.
+ *
+ * Returns an empty string if the persona has no actionable fields, so
+ * callers can unconditionally concatenate without emitting noise.
+ */
+export function buildPersonaPromptBlock(persona) {
+    const lines = [];
+    const { identity, traits, domain_expertise, communication } = persona;
+    if (identity?.name) {
+        lines.push(`You are ${identity.name}.`);
+    }
+    if (identity?.role) {
+        lines.push(`Role: ${identity.role}.`);
+    }
+    const styleLines = [];
+    if (identity?.tone)
+        styleLines.push(identity.tone);
+    if (identity?.formality)
+        styleLines.push(identity.formality);
+    if (styleLines.length) {
+        lines.push(`Communication style: ${styleLines.join(", ")}.`);
+    }
+    if (identity?.language && identity.language !== "en") {
+        lines.push(`Respond in ${identity.language}.`);
+    }
+    if (traits && traits.length > 0) {
+        lines.push(`Traits: ${traits.join(", ")}.`);
+    }
+    if (domain_expertise && domain_expertise.length > 0) {
+        lines.push(`Domain expertise: ${domain_expertise.join(", ")}.`);
+    }
+    if (communication?.max_response_length) {
+        lines.push(`Keep responses under ${communication.max_response_length} characters.`);
+    }
+    if (communication?.explain_reasoning === "always") {
+        lines.push("Always explain your reasoning step by step.");
+    }
+    else if (communication?.explain_reasoning === "never") {
+        lines.push("Do not explain your reasoning. Emit results only.");
+    }
+    if (communication?.acknowledgment_style === "none") {
+        lines.push('Do not acknowledge the task. Skip preamble like "Sure," or "I will".');
+    }
+    else if (communication?.acknowledgment_style === "minimal") {
+        lines.push("Skip task acknowledgment preamble. Go directly to output.");
+    }
+    if (communication?.use_analogies === false) {
+        lines.push("Do not use analogies.");
+    }
+    if (lines.length === 0)
+        return "";
+    return `\n--- persona ---\n${lines.join("\n")}\n--- end persona ---`;
+}
+//# sourceMappingURL=persona-prompt.js.map

package/dist/identity/persona-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-prompt.js","sourceRoot":"","sources":["../../src/identity/persona-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAEtE,IAAI,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,QAAQ,EAAE,IAAI;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,QAAQ,EAAE,SAAS;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,wBAAwB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,QAAQ,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,aAAa,EAAE,mBAAmB,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CACR,wBAAwB,aAAa,CAAC,mBAAmB,cAAc,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,EAAE,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,aAAa,EAAE,iBAAiB,KAAK,OAAO,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,aAAa,EAAE,oBAAoB,KAAK,MAAM,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CACR,sEAAsE,CACvE,CAAC;IACJ,CAAC;SAAM,IAAI,aAAa,EAAE,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,aAAa,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,OAAO,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC;AACvE,CAAC"}

package/dist/identity/persona-schema.d.ts

@@ -0,0 +1,120 @@
+/**
+ * AgentPersona schema — Sprint CC v3.1 (Livrable E).
+ *
+ * Persona is a structured description of how an agent should communicate:
+ * tone, formality, language, domain expertise, response shape preferences.
+ * Stored in Brain Tier 3 (semantic) per agent + override locally via
+ * `.cc/persona.yaml`.
+ *
+ * The schema is intentionally minimal — additive evolution preferred over
+ * breaking changes. All fields are optional; the resolved persona is the
+ * merge of (1) Brain-stored persona, (2) local overrides, (3) defaults.
+ *
+ * Spec reference:
+ *   - Plan canonical v3.1 §Livrable E
+ *   - ADR-ECO-034 §"AgentPersona via Brain Tier 3 semantic"
+ *
+ * @public
+ */
+import { z } from "zod";
+export declare const PersonaTone: z.ZodEnum<["concise", "detailed", "pedagogical"]>;
+export type PersonaTone = z.infer<typeof PersonaTone>;
+export declare const PersonaFormality: z.ZodEnum<["casual", "formal", "technical"]>;
+export type PersonaFormality = z.infer<typeof PersonaFormality>;
+export declare const PersonaExplainReasoning: z.ZodEnum<["always", "on_error", "never"]>;
+export type PersonaExplainReasoning = z.infer<typeof PersonaExplainReasoning>;
+export declare const PersonaAcknowledgmentStyle: z.ZodEnum<["minimal", "detailed", "none"]>;
+export type PersonaAcknowledgmentStyle = z.infer<typeof PersonaAcknowledgmentStyle>;
+export declare const PersonaSchema: z.ZodObject<{
+    identity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<["concise", "detailed", "pedagogical"]>>;
+        formality: z.ZodOptional<z.ZodEnum<["casual", "formal", "technical"]>>;
+        /** BCP 47 language tag (e.g. "en", "fr-FR"). Free-form on purpose. */
+        language: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name?: string | undefined;
+        role?: string | undefined;
+        tone?: "concise" | "detailed" | "pedagogical" | undefined;
+        formality?: "casual" | "formal" | "technical" | undefined;
+        language?: string | undefined;
+    }, {
+        name?: string | undefined;
+        role?: string | undefined;
+        tone?: "concise" | "detailed" | "pedagogical" | undefined;
+        formality?: "casual" | "formal" | "technical" | undefined;
+        language?: string | undefined;
+    }>>;
+    traits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    domain_expertise: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    communication: z.ZodOptional<z.ZodObject<{
+        max_response_length: z.ZodOptional<z.ZodNumber>;
+        use_analogies: z.ZodOptional<z.ZodBoolean>;
+        explain_reasoning: z.ZodOptional<z.ZodEnum<["always", "on_error", "never"]>>;
+        acknowledgment_style: z.ZodOptional<z.ZodEnum<["minimal", "detailed", "none"]>>;
+    }, "strict", z.ZodTypeAny, {
+        max_response_length?: number | undefined;
+        use_analogies?: boolean | undefined;
+        explain_reasoning?: "always" | "on_error" | "never" | undefined;
+        acknowledgment_style?: "detailed" | "minimal" | "none" | undefined;
+    }, {
+        max_response_length?: number | undefined;
+        use_analogies?: boolean | undefined;
+        explain_reasoning?: "always" | "on_error" | "never" | undefined;
+        acknowledgment_style?: "detailed" | "minimal" | "none" | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    identity?: {
+        name?: string | undefined;
+        role?: string | undefined;
+        tone?: "concise" | "detailed" | "pedagogical" | undefined;
+        formality?: "casual" | "formal" | "technical" | undefined;
+        language?: string | undefined;
+    } | undefined;
+    traits?: string[] | undefined;
+    domain_expertise?: string[] | undefined;
+    communication?: {
+        max_response_length?: number | undefined;
+        use_analogies?: boolean | undefined;
+        explain_reasoning?: "always" | "on_error" | "never" | undefined;
+        acknowledgment_style?: "detailed" | "minimal" | "none" | undefined;
+    } | undefined;
+}, {
+    identity?: {
+        name?: string | undefined;
+        role?: string | undefined;
+        tone?: "concise" | "detailed" | "pedagogical" | undefined;
+        formality?: "casual" | "formal" | "technical" | undefined;
+        language?: string | undefined;
+    } | undefined;
+    traits?: string[] | undefined;
+    domain_expertise?: string[] | undefined;
+    communication?: {
+        max_response_length?: number | undefined;
+        use_analogies?: boolean | undefined;
+        explain_reasoning?: "always" | "on_error" | "never" | undefined;
+        acknowledgment_style?: "detailed" | "minimal" | "none" | undefined;
+    } | undefined;
+}>;
+export type AgentPersona = z.infer<typeof PersonaSchema>;
+export declare const DEFAULT_PERSONA: AgentPersona;
+/**
+ * Deep-merge two personas. `local` wins over `base` field-by-field.
+ *
+ * Arrays (traits, domain_expertise) follow override semantics: a `local` array
+ * REPLACES the `base` array entirely. To extend rather than override, the
+ * caller must concatenate before calling `mergePersona`.
+ *
+ * The merge is total (no Zod validation here — callers should validate
+ * inputs and the result separately). This makes mergePersona suitable for
+ * progressive composition where intermediate values may not yet satisfy
+ * the schema.
+ */
+export declare function mergePersona(base: AgentPersona, local: AgentPersona): AgentPersona;
+/**
+ * Validate a persona object against the schema. Returns the parsed result
+ * (with Zod typing) or throws a typed error.
+ */
+export declare function validatePersona(input: unknown): AgentPersona;
+//# sourceMappingURL=persona-schema.d.ts.map

package/dist/identity/persona-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-schema.d.ts","sourceRoot":"","sources":["../../src/identity/persona-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW,mDAAiD,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB,8CAA4C,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB,4CAA0C,CAAC;AAC/E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,4CAIrC,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAC;AAwBF,eAAO,MAAM,aAAa;;;;;;QAdtB,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB/D,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIzD,eAAO,MAAM,eAAe,EAAE,YAY7B,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,GAClB,YAAY,CAad;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE5D"}