@dcyfr/ai 1.0.4 → 2.1.0

package/dist/ai/agents/index.d.ts

@@ -3,7 +3,12 @@
  *
  * @module @dcyfr/ai/agents
  */
-export type { AgentCategory, AgentTier, AgentModel, AgentPermissionMode, AgentQualityGate, AgentProactiveTrigger, AgentSkill, AgentManifest, AgentHooks, Agent, LoadedAgent, AgentExecutionContext, AgentExecutionResult, AgentViolation, AgentRoutingRule, AgentRoutingResult, AgentRegistryConfig, AgentLoaderConfig, AgentRouterConfig, } from './types';
+export type { AgentCategory, AgentTier, AgentModel, AgentPermissionMode, AgentQualityGate, AgentProactiveTrigger, AgentSkill, AgentManifest, AgentHooks, Agent, LoadedAgent, AgentExecutionContext, AgentExecutionResult, AgentViolation, AgentRoutingRule, AgentRoutingResult, AgentRegistryConfig, AgentLoaderConfig, AgentRouterConfig, PersonalityTrait, PersonalityTraits, SituationalTone, IntentSignal, ProactiveGuidance, AgentPersona, } from './types';
+export { personalityTraitSchema, personalityTraitsSchema, situationalToneSchema, intentSignalSchema, proactiveGuidanceSchema, agentPersonaIdentitySchema, agentPersonaVoiceSchema, agentPersonaSchema, validatePersona, safeValidatePersona, } from './schema';
+export { resolvePersona } from './persona-resolver';
+export type { BrandVoice, BrandVoiceTraits, ResolvedPersona } from './persona-resolver';
+export { generatePersonaInstructions } from './instruction-template';
+export type { PersonaInstructionSegments } from './instruction-template';
 export { AgentLoader, AgentLoadError, AgentValidationError, getGlobalAgentLoader, resetGlobalAgentLoader, } from './agent-loader';
 export { AgentRegistry, getGlobalAgentRegistry, resetGlobalAgentRegistry, } from './agent-registry';
 export { AgentRouter, getGlobalAgentRouter, resetGlobalAgentRouter, } from './agent-router';

package/dist/ai/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAEjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/ai/agents/index.js

@@ -3,10 +3,16 @@
  *
  * @module @dcyfr/ai/agents
  */
+// Agent Persona validation exports
+export { personalityTraitSchema, personalityTraitsSchema, situationalToneSchema, intentSignalSchema, proactiveGuidanceSchema, agentPersonaIdentitySchema, agentPersonaVoiceSchema, agentPersonaSchema, validatePersona, safeValidatePersona, } from './schema.js';
+// Agent Persona resolution exports
+export { resolvePersona } from './persona-resolver.js';
+// Instruction template exports
+export { generatePersonaInstructions } from './instruction-template.js';
 // Agent Loader exports
-export { AgentLoader, AgentLoadError, AgentValidationError, getGlobalAgentLoader, resetGlobalAgentLoader, } from './agent-loader';
+export { AgentLoader, AgentLoadError, AgentValidationError, getGlobalAgentLoader, resetGlobalAgentLoader, } from './agent-loader.js';
 // Agent Registry exports
-export { AgentRegistry, getGlobalAgentRegistry, resetGlobalAgentRegistry, } from './agent-registry';
+export { AgentRegistry, getGlobalAgentRegistry, resetGlobalAgentRegistry, } from './agent-registry.js';
 // Agent Router exports
-export { AgentRouter, getGlobalAgentRouter, resetGlobalAgentRouter, } from './agent-router';
+export { AgentRouter, getGlobalAgentRouter, resetGlobalAgentRouter, } from './agent-router.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgCH,mCAAmC;AACnC,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,+BAA+B;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/ai/agents/instruction-template.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Instruction Template Generator
+ *
+ * Produces natural language instruction segments from a resolved persona,
+ * suitable for injection into agent markdown instruction bodies.
+ *
+ * The generated sections describe:
+ * - Agent identity and archetype
+ * - Communication style (voice attributes + personality trait descriptions)
+ * - Situational tone adaptations
+ * - Anti-patterns to avoid
+ *
+ * @module @dcyfr/ai/agents/instruction-template
+ * @version 1.0.0
+ */
+import type { ResolvedPersona } from './persona-resolver';
+/**
+ * Generated instruction segments.
+ * Each section is optional — only rendered when the resolved persona
+ * has relevant data.
+ */
+export interface PersonaInstructionSegments {
+    /** "## Agent Identity" section markdown */
+    identity?: string;
+    /** "## How You Communicate" section markdown */
+    communicationStyle?: string;
+    /** "## Situational Adaptation" section markdown */
+    situationalAdaptation?: string;
+    /** "## You Never" section markdown */
+    antiPatterns?: string;
+    /** All sections combined as a single markdown block */
+    combined: string;
+}
+/**
+ * Generate persona instruction segments from a resolved persona.
+ *
+ * All sections are optional — if the resolved persona lacks data for a section
+ * (e.g., no situational tones), that section is omitted from the output.
+ * The `combined` field always contains whatever sections were rendered.
+ *
+ * @param persona - Resolved persona from `resolvePersona()`
+ * @returns Object containing individual sections + combined markdown
+ */
+export declare function generatePersonaInstructions(persona: ResolvedPersona): PersonaInstructionSegments;
+//# sourceMappingURL=instruction-template.d.ts.map

package/dist/ai/agents/instruction-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-template.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/instruction-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8ID;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,0BAA0B,CAsB5B"}

package/dist/ai/agents/instruction-template.js

@@ -0,0 +1,197 @@
+/**
+ * Instruction Template Generator
+ *
+ * Produces natural language instruction segments from a resolved persona,
+ * suitable for injection into agent markdown instruction bodies.
+ *
+ * The generated sections describe:
+ * - Agent identity and archetype
+ * - Communication style (voice attributes + personality trait descriptions)
+ * - Situational tone adaptations
+ * - Anti-patterns to avoid
+ *
+ * @module @dcyfr/ai/agents/instruction-template
+ * @version 1.0.0
+ */
+/**
+ * Map of trait name → human-readable low/high descriptions used when
+ * generating natural language descriptions from numeric trait values.
+ */
+const TRAIT_DESCRIPTIONS = {
+    warmth: {
+        low: 'professional and measured in warmth',
+        mid: 'warm and collaborative',
+        high: 'exceptionally warm and supportive',
+    },
+    formality: {
+        low: 'approachable and conversational (low formality)',
+        mid: 'professionally approachable',
+        high: 'formal and structured',
+    },
+    humor: {
+        low: 'focused and earnest — minimal humor',
+        mid: 'occasionally uses well-timed humor',
+        high: 'often light-hearted with frequent humor',
+    },
+    directness: {
+        low: 'exploratory and open-ended',
+        mid: 'clear and direct',
+        high: 'extremely direct and concise — front-loads key information',
+    },
+    technicality: {
+        low: 'accessible, uses plain language',
+        mid: 'technically proficient',
+        high: 'highly technical and precise — assumes expert knowledge',
+    },
+    empathy: {
+        low: 'task-focused with minimal emotional acknowledgment',
+        mid: 'empathetic and understanding',
+        high: 'highly empathetic — always acknowledges emotional context first',
+    },
+};
+/**
+ * Classify a 0-1 trait value into a low/mid/high band
+ */
+function traitBand(value) {
+    if (value < 0.4)
+        return 'low';
+    if (value < 0.7)
+        return 'mid';
+    return 'high';
+}
+/**
+ * Generate natural language description for a set of personality traits
+ */
+function describeTraits(traits) {
+    const lines = [];
+    for (const [trait, value] of Object.entries(traits)) {
+        if (typeof value !== 'number')
+            continue;
+        const desc = TRAIT_DESCRIPTIONS[trait];
+        if (desc) {
+            lines.push(`- **${capitalize(trait)}**: ${desc[traitBand(value)]} (${value.toFixed(1)})`);
+        }
+        else {
+            lines.push(`- **${capitalize(trait)}**: ${value.toFixed(1)}`);
+        }
+    }
+    return lines.join('\n');
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Generate identity section from persona
+ */
+function generateIdentitySection(persona) {
+    if (!persona.displayName && !persona.identity)
+        return undefined;
+    const lines = ['## Agent Identity', ''];
+    if (persona.displayName) {
+        lines.push(`**Name:** ${persona.displayName}`);
+    }
+    if (persona.identity) {
+        lines.push('');
+        lines.push(persona.identity);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate communication style section from persona
+ */
+function generateCommunicationSection(persona) {
+    const hasAttributes = persona.voiceAttributes.length > 0;
+    const hasTraits = Object.keys(persona.personalityTraits).length > 0;
+    if (!hasAttributes && !hasTraits)
+        return undefined;
+    const lines = ['## How You Communicate', ''];
+    if (hasAttributes) {
+        lines.push('Your voice is:');
+        for (const attr of persona.voiceAttributes) {
+            lines.push(`- ${attr}`);
+        }
+    }
+    if (hasTraits) {
+        if (hasAttributes)
+            lines.push('');
+        lines.push('Your personality calibration:');
+        lines.push(describeTraits(persona.personalityTraits));
+    }
+    if (persona.perspective) {
+        lines.push('');
+        lines.push(`**Perspective:** ${perspectiveLabel(persona.perspective)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate situational adaptation section from persona
+ */
+function generateSituationalSection(persona) {
+    if (persona.situationalTones.length === 0)
+        return undefined;
+    const lines = ['## Situational Adaptation', ''];
+    lines.push('Adjust your approach based on context:');
+    lines.push('');
+    for (const tone of persona.situationalTones) {
+        const label = tone.situation.replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+        lines.push(`**${label}:** ${tone.guidance}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate anti-patterns section from persona
+ */
+function generateAntiPatternsSection(persona) {
+    if (persona.antiPatterns.length === 0)
+        return undefined;
+    const lines = ['## You Never', ''];
+    for (const pattern of persona.antiPatterns) {
+        lines.push(`- ${pattern}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate persona instruction segments from a resolved persona.
+ *
+ * All sections are optional — if the resolved persona lacks data for a section
+ * (e.g., no situational tones), that section is omitted from the output.
+ * The `combined` field always contains whatever sections were rendered.
+ *
+ * @param persona - Resolved persona from `resolvePersona()`
+ * @returns Object containing individual sections + combined markdown
+ */
+export function generatePersonaInstructions(persona) {
+    const sections = [];
+    const identitySection = generateIdentitySection(persona);
+    if (identitySection)
+        sections.push(identitySection);
+    const communicationSection = generateCommunicationSection(persona);
+    if (communicationSection)
+        sections.push(communicationSection);
+    const situationalSection = generateSituationalSection(persona);
+    if (situationalSection)
+        sections.push(situationalSection);
+    const antiPatternsSection = generateAntiPatternsSection(persona);
+    if (antiPatternsSection)
+        sections.push(antiPatternsSection);
+    return {
+        identity: identitySection,
+        communicationStyle: communicationSection,
+        situationalAdaptation: situationalSection,
+        antiPatterns: antiPatternsSection,
+        combined: sections.join('\n\n'),
+    };
+}
+/**
+ * Convert perspective enum value to a human-readable description
+ */
+function perspectiveLabel(perspective) {
+    const labels = {
+        'first-person-singular': 'First-person singular ("I/my")',
+        'first-person-plural': 'First-person plural ("we/our")',
+        'second-person': 'Second-person ("you/your")',
+        'third-person': 'Third-person ("they/their")',
+    };
+    return labels[perspective] ?? perspective;
+}
+//# sourceMappingURL=instruction-template.js.map

package/dist/ai/agents/instruction-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-template.js","sourceRoot":"","sources":["../../../packages/ai/agents/instruction-template.ts"],"names":[],"mappings":"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"}

package/dist/ai/agents/persona-resolver.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Persona Resolver
+ *
+ * Merges canonical brand voice defaults with per-agent persona overrides to
+ * produce a fully resolved persona for any agent. Agents that declare
+ * `inheritsBrandVoice: false` receive only their own declared fields.
+ *
+ * @module @dcyfr/ai/agents/persona-resolver
+ * @version 1.0.0
+ */
+import type { AgentPersona, SituationalTone } from './types';
+/**
+ * Brand voice personality traits (from DCYFR_CONTEXT.json brand_voice block)
+ */
+export interface BrandVoiceTraits {
+    warmth?: number;
+    formality?: number;
+    humor?: number;
+    directness?: number;
+    technicality?: number;
+    empathy?: number;
+    [key: string]: number | undefined;
+}
+/**
+ * Minimal brand voice shape needed for persona resolution.
+ * Maps to the structure of DCYFR_CONTEXT.json `brand_voice`.
+ */
+export interface BrandVoice {
+    identity?: {
+        name?: string;
+        tagline?: string;
+        archetype?: string;
+        description?: string;
+    };
+    core_voice?: {
+        attributes?: string[];
+        personality_traits?: BrandVoiceTraits;
+        perspective?: string;
+    };
+    anti_patterns?: string[];
+    tone_spectrum?: {
+        default?: string;
+        situational?: Record<string, {
+            tone: string;
+        }>;
+    };
+}
+/**
+ * Resolved persona — the merge product of brand voice + agent overrides.
+ * All fields are fully concrete (no nullables from inheritance uncertainty).
+ */
+export interface ResolvedPersona {
+    /** Display name for the agent (from agent persona or brand name) */
+    displayName?: string;
+    /** Identity statement */
+    identity?: string;
+    /** Voice attributes (merged or agent-only) */
+    voiceAttributes: string[];
+    /** Resolved personality traits (agent overrides win) */
+    personalityTraits: BrandVoiceTraits;
+    /** Perspective string */
+    perspective?: string;
+    /** Situational tones (brand + agent combined) */
+    situationalTones: SituationalTone[];
+    /** Anti-patterns (brand + agent combined, deduplicated) */
+    antiPatterns: string[];
+    /** Whether brand voice was inherited */
+    inheritsBrandVoice: boolean;
+}
+/**
+ * Resolve an agent's effective persona by merging brand voice defaults with
+ * the agent's declared persona overrides.
+ *
+ * Merge rules:
+ * - `personalityTraits`: agent overrides individual trait values; unset traits
+ *   fall back to brand defaults.
+ * - `voiceAttributes`: brand attributes + agent-specific attributes concatenated.
+ * - `antiPatterns`: brand anti-patterns + agent anti-patterns, deduplicated.
+ * - `situationalTones`: brand tones + agent-specific tones. Agent tones for the
+ *   same `situation` key do NOT replace brand tones — both are surfaced since
+ *   they may carry different `traitAdjustments` / `guidance`.
+ * - `inheritsBrandVoice: false`: brand merging is skipped entirely; only agent
+ *   declared fields are included.
+ *
+ * @param brandVoice - Brand voice block from DCYFR_CONTEXT.json (may be partial)
+ * @param agentPersona - Per-agent persona from manifest (optional)
+ * @returns Fully resolved persona ready for instruction template generation
+ */
+export declare function resolvePersona(brandVoice: BrandVoice | undefined, agentPersona?: AgentPersona): ResolvedPersona;
+//# sourceMappingURL=persona-resolver.d.ts.map

package/dist/ai/agents/persona-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-resolver.d.ts","sourceRoot":"","sources":["../../../packages/ai/agents/persona-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAqB,eAAe,EAAE,MAAM,SAAS,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wDAAwD;IACxD,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,YAAY,CAAC,EAAE,YAAY,GAC1B,eAAe,CA6CjB"}

package/dist/ai/agents/persona-resolver.js

@@ -0,0 +1,121 @@
+/**
+ * Persona Resolver
+ *
+ * Merges canonical brand voice defaults with per-agent persona overrides to
+ * produce a fully resolved persona for any agent. Agents that declare
+ * `inheritsBrandVoice: false` receive only their own declared fields.
+ *
+ * @module @dcyfr/ai/agents/persona-resolver
+ * @version 1.0.0
+ */
+/**
+ * Resolve an agent's effective persona by merging brand voice defaults with
+ * the agent's declared persona overrides.
+ *
+ * Merge rules:
+ * - `personalityTraits`: agent overrides individual trait values; unset traits
+ *   fall back to brand defaults.
+ * - `voiceAttributes`: brand attributes + agent-specific attributes concatenated.
+ * - `antiPatterns`: brand anti-patterns + agent anti-patterns, deduplicated.
+ * - `situationalTones`: brand tones + agent-specific tones. Agent tones for the
+ *   same `situation` key do NOT replace brand tones — both are surfaced since
+ *   they may carry different `traitAdjustments` / `guidance`.
+ * - `inheritsBrandVoice: false`: brand merging is skipped entirely; only agent
+ *   declared fields are included.
+ *
+ * @param brandVoice - Brand voice block from DCYFR_CONTEXT.json (may be partial)
+ * @param agentPersona - Per-agent persona from manifest (optional)
+ * @returns Fully resolved persona ready for instruction template generation
+ */
+export function resolvePersona(brandVoice, agentPersona) {
+    const inherit = agentPersona?.inheritsBrandVoice !== false;
+    if (!inherit) {
+        // Agent opted out of brand inheritance — use agent-only fields
+        return {
+            displayName: agentPersona?.identity?.name,
+            identity: agentPersona?.identity?.description,
+            voiceAttributes: agentPersona?.voice?.attributes ?? [],
+            personalityTraits: flattenTraits(agentPersona?.voice?.personalityTraits),
+            perspective: agentPersona?.voice?.perspective,
+            situationalTones: agentPersona?.situationalTones ?? [],
+            antiPatterns: agentPersona?.antiPatterns ?? [],
+            inheritsBrandVoice: false,
+        };
+    }
+    // Brand defaults
+    const brandTraits = brandVoice?.core_voice?.personality_traits ?? {};
+    const brandAttributes = brandVoice?.core_voice?.attributes ?? [];
+    const brandAntiPatterns = brandVoice?.anti_patterns ?? [];
+    const brandTones = buildBrandTones(brandVoice?.tone_spectrum?.situational);
+    // Agent overrides
+    const agentTraits = flattenTraits(agentPersona?.voice?.personalityTraits);
+    const agentAttributes = agentPersona?.voice?.attributes ?? [];
+    const agentAntiPatterns = agentPersona?.antiPatterns ?? [];
+    const agentTones = agentPersona?.situationalTones ?? [];
+    // Merge
+    const mergedTraits = { ...brandTraits, ...agentTraits };
+    const mergedAttributes = deduplicate([...brandAttributes, ...agentAttributes]);
+    const mergedAntiPatterns = deduplicate([...brandAntiPatterns, ...agentAntiPatterns]);
+    const mergedTones = mergeTones(brandTones, agentTones);
+    return {
+        displayName: agentPersona?.identity?.name ?? brandVoice?.identity?.name,
+        identity: agentPersona?.identity?.description ?? brandVoice?.identity?.description,
+        voiceAttributes: mergedAttributes,
+        personalityTraits: mergedTraits,
+        perspective: agentPersona?.voice?.perspective ?? brandVoice?.core_voice?.perspective,
+        situationalTones: mergedTones,
+        antiPatterns: mergedAntiPatterns,
+        inheritsBrandVoice: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract a flat Record<string, number> from the typed PersonalityTraits object
+ */
+function flattenTraits(traits) {
+    if (!traits)
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(traits)) {
+        if (typeof value === 'number') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Convert brand voice situational tone map into SituationalTone[] for merging
+ */
+function buildBrandTones(situational) {
+    if (!situational)
+        return [];
+    return Object.entries(situational).map(([situation, data]) => ({
+        situation,
+        traitAdjustments: {},
+        guidance: data.tone,
+    }));
+}
+/**
+ * Merge brand tones with agent tones. Agent tones for the same situation key
+ * override the brand tone entry (agent is more specific).
+ */
+function mergeTones(brandTones, agentTones) {
+    const toneMap = new Map();
+    for (const tone of brandTones) {
+        toneMap.set(tone.situation, tone);
+    }
+    // Agent tones override brand tones for the same situation
+    for (const tone of agentTones) {
+        toneMap.set(tone.situation, tone);
+    }
+    return Array.from(toneMap.values());
+}
+/**
+ * Deduplicate an array of strings preserving order
+ */
+function deduplicate(arr) {
+    return [...new Set(arr)];
+}
+//# sourceMappingURL=persona-resolver.js.map

package/dist/ai/agents/persona-resolver.js.map

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