@vauban-org/agent-sdk 1.0.0 → 1.3.0

package/dist/events/schemas/brain.skill.extracted.v1.d.ts

@@ -4,12 +4,12 @@ export declare const BrainSkillExtractedV1: z.ZodObject<{
     agentSource: z.ZodString;
     confidence: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    skillId: string;
-    agentSource: string;
     confidence: number;
-}, {
-    skillId: string;
     agentSource: string;
+    skillId: string;
+}, {
     confidence: number;
+    agentSource: string;
+    skillId: string;
 }>;
 //# sourceMappingURL=brain.skill.extracted.v1.d.ts.map

package/dist/events/schemas/cc.cost.anomaly_detected.v1.d.ts

@@ -5,13 +5,13 @@ export declare const CcCostAnomalyDetectedV1: z.ZodObject<{
     actual: z.ZodNumber;
     period: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    expected: number;
     agent: string;
+    expected: number;
     actual: number;
     period: string;
 }, {
-    expected: number;
     agent: string;
+    expected: number;
     actual: number;
     period: string;
 }>;

package/dist/events/schemas/cc.cost.recorded.v1.d.ts

@@ -6,16 +6,16 @@ export declare const CcCostRecordedV1: z.ZodObject<{
     model: z.ZodString;
     tenantId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    costUsd: number;
     agent: string;
-    tokens: number;
     model: string;
+    costUsd: number;
+    tokens: number;
     tenantId?: string | undefined;
 }, {
-    costUsd: number;
     agent: string;
-    tokens: number;
     model: string;
+    costUsd: number;
+    tokens: number;
     tenantId?: string | undefined;
 }>;
 //# sourceMappingURL=cc.cost.recorded.v1.d.ts.map

package/dist/events/schemas/citadel.sprint.analyzed.v1.d.ts

@@ -26,29 +26,29 @@ export declare const CitadelSprintAnalyzedV1: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     timestamp: string;
     schemaVersion: string;
-    overallSeverity: "error" | "info" | "critical" | "warning";
-    sprintId: string;
-    healthScore: number;
     insights: {
         type: string;
         description: string;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
     }[];
+    sprintId: string;
+    healthScore: number;
+    overallSeverity: "error" | "info" | "critical" | "warning";
     blockers: string[];
     recommendations: string[];
 }, {
     timestamp: string;
     schemaVersion: string;
-    overallSeverity: "error" | "info" | "critical" | "warning";
-    sprintId: string;
-    healthScore: number;
     insights: {
         type: string;
         description: string;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
     }[];
+    sprintId: string;
+    healthScore: number;
+    overallSeverity: "error" | "info" | "critical" | "warning";
     blockers: string[];
     recommendations: string[];
 }>;

package/dist/events/schemas/citadel.sprint.closed.v1.d.ts

@@ -4,12 +4,12 @@ export declare const CitadelSprintClosedV1: z.ZodObject<{
     completed: z.ZodNumber;
     carryOver: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    sprintId: string;
     completed: number;
+    sprintId: string;
     carryOver: number;
 }, {
-    sprintId: string;
     completed: number;
+    sprintId: string;
     carryOver: number;
 }>;
 //# sourceMappingURL=citadel.sprint.closed.v1.d.ts.map

package/dist/events/schemas/forge.inbox.reply_classified.v1.d.ts

@@ -11,23 +11,23 @@ export declare const ForgeInboxReplyClassifiedV1: z.ZodObject<{
     schemaVersion: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "INTERESTED" | "NOT_INTERESTED" | "BOUNCE" | "SPAM" | "OTHER";
+    priority: "HIGH" | "MEDIUM" | "LOW";
     timestamp: string;
     schemaVersion: string;
-    uid: string;
+    signal: string;
     from: string;
     subject: string;
-    priority: "HIGH" | "MEDIUM" | "LOW";
-    signal: string;
+    uid: string;
     nextAction: string;
 }, {
     type: "INTERESTED" | "NOT_INTERESTED" | "BOUNCE" | "SPAM" | "OTHER";
+    priority: "HIGH" | "MEDIUM" | "LOW";
     timestamp: string;
     schemaVersion: string;
-    uid: string;
+    signal: string;
     from: string;
     subject: string;
-    priority: "HIGH" | "MEDIUM" | "LOW";
-    signal: string;
+    uid: string;
     nextAction: string;
 }>;
 //# sourceMappingURL=forge.inbox.reply_classified.v1.d.ts.map

package/dist/events/schemas/forge.lead.qualified.v1.d.ts

@@ -5,11 +5,11 @@ export declare const ForgeLeadQualifiedV1: z.ZodObject<{
     source: z.ZodEnum<["inbound", "outbound", "referral"]>;
 }, "strict", z.ZodTypeAny, {
     source: "inbound" | "outbound" | "referral";
-    leadId: string;
     score: number;
+    leadId: string;
 }, {
     source: "inbound" | "outbound" | "referral";
-    leadId: string;
     score: number;
+    leadId: string;
 }>;
 //# sourceMappingURL=forge.lead.qualified.v1.d.ts.map

package/dist/events/schemas/forge.outreach.sent.v1.d.ts

@@ -4,12 +4,12 @@ export declare const ForgeOutreachSentV1: z.ZodObject<{
     channel: z.ZodEnum<["email", "linkedin", "x", "telegram"]>;
     content: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    leadId: string;
-    channel: "email" | "linkedin" | "x" | "telegram";
     content: string;
-}, {
+    channel: "telegram" | "email" | "linkedin" | "x";
     leadId: string;
-    channel: "email" | "linkedin" | "x" | "telegram";
+}, {
     content: string;
+    channel: "telegram" | "email" | "linkedin" | "x";
+    leadId: string;
 }>;
 //# sourceMappingURL=forge.outreach.sent.v1.d.ts.map

package/dist/events/schemas/incident.detected.v1.d.ts

@@ -4,12 +4,12 @@ export declare const IncidentDetectedV1: z.ZodObject<{
     severity: z.ZodEnum<["low", "medium", "high", "critical"]>;
     summary: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    severity: "low" | "medium" | "high" | "critical";
     source: string;
+    severity: "low" | "medium" | "high" | "critical";
     summary: string;
 }, {
-    severity: "low" | "medium" | "high" | "critical";
     source: string;
+    severity: "low" | "medium" | "high" | "critical";
     summary: string;
 }>;
 //# sourceMappingURL=incident.detected.v1.d.ts.map

package/dist/events/schemas/vauban.goal.checked.v1.d.ts

@@ -10,12 +10,12 @@ export declare const VaubanGoalCheckedV1: z.ZodObject<{
     schemaVersion: string;
     goalId: string;
     successRate: number;
-    alertLevel: "critical" | "warning" | "none";
+    alertLevel: "none" | "critical" | "warning";
 }, {
     timestamp: string;
     schemaVersion: string;
     goalId: string;
     successRate: number;
-    alertLevel: "critical" | "warning" | "none";
+    alertLevel: "none" | "critical" | "warning";
 }>;
 //# sourceMappingURL=vauban.goal.checked.v1.d.ts.map

package/dist/events/schemas/vauban.rebalancing.checked.v1.d.ts

@@ -8,13 +8,13 @@ export declare const VaubanRebalancingCheckedV1: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     timestamp: string;
     schemaVersion: string;
-    alertLevel: "critical" | "warning" | "none";
+    alertLevel: "none" | "critical" | "warning";
     portfolioId: string;
     maxDrift: number;
 }, {
     timestamp: string;
     schemaVersion: string;
-    alertLevel: "critical" | "warning" | "none";
+    alertLevel: "none" | "critical" | "warning";
     portfolioId: string;
     maxDrift: number;
 }>;

package/dist/events/schemas/vauban.tax.checked.v1.d.ts

@@ -8,14 +8,14 @@ export declare const VaubanTaxCheckedV1: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     timestamp: string;
     schemaVersion: string;
-    alertLevel: "critical" | "warning" | "none";
     userId: string;
+    alertLevel: "none" | "critical" | "warning";
     rulesTriggered: string[];
 }, {
     timestamp: string;
     schemaVersion: string;
-    alertLevel: "critical" | "warning" | "none";
     userId: string;
+    alertLevel: "none" | "critical" | "warning";
     rulesTriggered: string[];
 }>;
 //# sourceMappingURL=vauban.tax.checked.v1.d.ts.map

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

@@ -10,16 +10,16 @@ export declare const VaubanVaultAnalyzedV1: z.ZodObject<{
         expected: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
         description: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        expected: string | number;
         type: string;
         description: string;
-        expected: string | number;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
         current: string | number;
     }, {
+        expected: string | number;
         type: string;
         description: string;
-        expected: string | number;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
         current: string | number;
@@ -31,29 +31,29 @@ export declare const VaubanVaultAnalyzedV1: z.ZodObject<{
     timestamp: string;
     schemaVersion: string;
     vaultId: string;
+    overallSeverity: "error" | "info" | "critical" | "warning";
     tvlUsd: number;
     anomalies: {
+        expected: string | number;
         type: string;
         description: string;
-        expected: string | number;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
         current: string | number;
     }[];
-    overallSeverity: "error" | "info" | "critical" | "warning";
 }, {
     timestamp: string;
     schemaVersion: string;
     vaultId: string;
+    overallSeverity: "error" | "info" | "critical" | "warning";
     tvlUsd: number;
     anomalies: {
+        expected: string | number;
         type: string;
         description: string;
-        expected: string | number;
         severity: "error" | "info" | "critical" | "warning";
         metric: string;
         current: string | number;
     }[];
-    overallSeverity: "error" | "info" | "critical" | "warning";
 }>;
 //# sourceMappingURL=vauban.vault.analyzed.v1.d.ts.map

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"}