@itaila/archetype 0.3.30

package/dist/core/identity.js

@@ -0,0 +1,54 @@
+const DEFAULT_KEYSTONE = 'What is the single most impactful thing you could say right now?';
+const DEFAULT_RELATIONAL_PREAMBLE = 'You are an expert with a real person in front of you.';
+/**
+ * Build the identity paragraph of the system prompt from persona config.
+ * This is the opening paragraph that sets expertise, relationship, and north star.
+ *
+ * DESIGN PRINCIPLE — Scenario-first, not directive-first.
+ * Identity stays neutral: who this expert is, what they weave together,
+ * and what they serve. Mode-specific presence/keystone hooks are layered
+ * separately so operational turns do not inherit conversation assumptions.
+ */
+export function buildIdentityBlock(identity) {
+    const { name, expertise, relationship, northStar, scopeBoundary } = identity;
+    const expertiseStr = joinNatural(expertise);
+    // If the persona's name already contains the expertise word (e.g.
+    // name="Coding Agent", expertise=["coding"]), restating "you bring deep
+    // expertise in coding" is redundant and reads like coaching a mediocre
+    // employee. Skip the expertise clause in that case — the name carries it.
+    const nameNorm = name.toLowerCase();
+    const expertiseAlreadyInName = expertise.some((e) => nameNorm.includes(e.toLowerCase()));
+    const lines = [];
+    if (expertiseAlreadyInName || expertise.length === 0) {
+        lines.push(`You are ${name} — a ${relationship}.`);
+    }
+    else {
+        lines.push(`You are ${name} — a ${relationship}. ` +
+            `You bring deep expertise in ${expertiseStr}.`);
+    }
+    lines.push(`Your north star is ${northStar}.`);
+    if (scopeBoundary) {
+        lines.push(scopeBoundary);
+    }
+    return lines.join('\n');
+}
+export function buildConversationKeystone(identity, relationalPreamble) {
+    const effectiveRelationalPreamble = relationalPreamble === undefined
+        ? DEFAULT_RELATIONAL_PREAMBLE
+        : relationalPreamble;
+    if (effectiveRelationalPreamble === false)
+        return '';
+    const keystoneStr = identity.keystone ?? DEFAULT_KEYSTONE;
+    return `${effectiveRelationalPreamble} ${keystoneStr}`;
+}
+/** Join array items naturally: "a, b, and c" */
+function joinNatural(items) {
+    if (items.length === 0)
+        return '';
+    if (items.length === 1)
+        return items[0];
+    if (items.length === 2)
+        return `${items[0]} and ${items[1]}`;
+    return `${items.slice(0, -1).join(', ')}, and ${items[items.length - 1]}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/core/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GACpB,kEAAkE,CAAA;AACpE,MAAM,2BAA2B,GAC/B,uDAAuD,CAAA;AAEzD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAA;IAC5E,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;IAE3C,kEAAkE;IAClE,wEAAwE;IACxE,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IACnC,MAAM,sBAAsB,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAExF,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,sBAAsB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,QAAQ,YAAY,GAAG,CAAC,CAAA;IACpD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,WAAW,IAAI,QAAQ,YAAY,IAAI;YACvC,+BAA+B,YAAY,GAAG,CAC/C,CAAA;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,SAAS,GAAG,CAAC,CAAA;IAC9C,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAyB,EACzB,kBAAmC;IAEnC,MAAM,2BAA2B,GAAG,kBAAkB,KAAK,SAAS;QAClE,CAAC,CAAC,2BAA2B;QAC7B,CAAC,CAAC,kBAAkB,CAAA;IACtB,IAAI,2BAA2B,KAAK,KAAK;QAAE,OAAO,EAAE,CAAA;IAEpD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,IAAI,gBAAgB,CAAA;IACzD,OAAO,GAAG,2BAA2B,IAAI,WAAW,EAAE,CAAA;AACxD,CAAC;AAED,gDAAgD;AAChD,SAAS,WAAW,CAAC,KAAe;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5D,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAA;AAC3E,CAAC"}

package/dist/core/knowledge.d.ts

@@ -0,0 +1,10 @@
+import type { KnowledgeDocument } from '../types.js';
+export interface KnowledgeBlockOptions {
+    budget?: number;
+    maxDocuments?: number;
+    label?: string;
+    purpose?: string;
+}
+export declare function selectKnowledgeForPrompt(documents: KnowledgeDocument[], options?: KnowledgeBlockOptions): string[];
+export declare function buildKnowledgeBlock(documents: KnowledgeDocument[], options?: KnowledgeBlockOptions): string;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/core/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/core/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAKpD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAgBV;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAWR"}

package/dist/core/knowledge.js

@@ -0,0 +1,40 @@
+const DEFAULT_BUDGET = 6000;
+const DEFAULT_MAX_DOCUMENTS = 12;
+export function selectKnowledgeForPrompt(documents, options) {
+    const budget = options?.budget ?? DEFAULT_BUDGET;
+    const maxDocuments = options?.maxDocuments ?? DEFAULT_MAX_DOCUMENTS;
+    const selected = documents.slice(0, maxDocuments);
+    const result = [];
+    let charCount = 0;
+    for (const doc of selected) {
+        const block = formatKnowledgeDocument(doc);
+        if (charCount + block.length > budget)
+            continue;
+        result.push(block);
+        charCount += block.length;
+    }
+    return result;
+}
+export function buildKnowledgeBlock(documents, options) {
+    const label = options?.label ?? 'KNOWLEDGE';
+    const selected = selectKnowledgeForPrompt(documents, options);
+    if (selected.length === 0)
+        return '';
+    const purpose = options?.purpose?.trim();
+    const purposeLine = purpose
+        ? `Use this shared knowledge for ${purpose}.`
+        : 'Use this shared knowledge as grounded reference. Prefer claims supported here over improvised specifics.';
+    return `--- ${label} (durable shared reference) ---\n${purposeLine} If it is silent, ambiguous, or provisional, say less and frame uncertainty rather than inventing specifics.\n${selected.join('\n\n')}`;
+}
+function formatKnowledgeDocument(document) {
+    const titleParts = [document.title.trim()];
+    if (document.id)
+        titleParts.push(`id:${document.id}`);
+    if (document.status)
+        titleParts.push(`status:${document.status}`);
+    if (document.tags?.length)
+        titleParts.push(`tags:${document.tags.join(', ')}`);
+    const body = (document.summary?.trim() || document.content.trim()).trim();
+    return `[${titleParts.join(' | ')}]\n${body}`;
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/core/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/core/knowledge.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,IAAI,CAAA;AAC3B,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAShC,MAAM,UAAU,wBAAwB,CACtC,SAA8B,EAC9B,OAA+B;IAE/B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,cAAc,CAAA;IAChD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,qBAAqB,CAAA;IACnE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;IAEjD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM;YAAE,SAAQ;QAC/C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClB,SAAS,IAAI,KAAK,CAAC,MAAM,CAAA;IAC3B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA8B,EAC9B,OAA+B;IAE/B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,WAAW,CAAA;IAC3C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEpC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACxC,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,iCAAiC,OAAO,GAAG;QAC7C,CAAC,CAAC,0GAA0G,CAAA;IAE9G,OAAO,OAAO,KAAK,oCAAoC,WAAW,iHAAiH,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;AAC5M,CAAC;AAED,SAAS,uBAAuB,CAAC,QAA2B;IAC1D,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1C,IAAI,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;IACrD,IAAI,QAAQ,CAAC,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACjE,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAE9E,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACzE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;AAC/C,CAAC"}

package/dist/core/memory-actions.d.ts

@@ -0,0 +1,38 @@
+import type { ActionDefinition, EntityConfig } from '../types.js';
+/**
+ * Build the category description string for the saveMemory action schema.
+ * When custom categories are defined, lists them with descriptions.
+ */
+export declare function buildCategoryDescription(categories?: Record<string, string>): string;
+/**
+ * Built-in legacy memory actions.
+ * Archetype's foundation path is CRUD-native memory entities.
+ * These named actions remain available for older integrations that still
+ * expose memory as named actions instead of entities.
+ */
+export declare const MEMORY_ACTIONS: Record<string, ActionDefinition>;
+/**
+ * Build memory actions with custom category descriptions.
+ * Returns the default MEMORY_ACTIONS when no custom categories are defined.
+ */
+export declare function buildMemoryActions(categories?: Record<string, string>): Record<string, ActionDefinition>;
+/** Action names that are built-in memory actions (for auto-handling in managed mode) */
+export declare const MEMORY_ACTION_NAMES: Set<string>;
+export declare const CRAFT_MEMORY_ACTIONS: Record<string, ActionDefinition>;
+/**
+ * Build craft memory actions with custom category descriptions.
+ */
+export declare function buildCraftMemoryActions(categories?: Record<string, string>): Record<string, ActionDefinition>;
+/** Action names that are built-in craft memory actions */
+export declare const CRAFT_MEMORY_ACTION_NAMES: Set<string>;
+/**
+ * Build a memory entity config for the generic CRUD system.
+ * Memory is registered as an internal entity when memory is enabled so
+ * durable memory mutations flow through CRUD.
+ */
+export declare function buildMemoryEntityConfig(categories?: Record<string, string>): EntityConfig;
+/**
+ * Build a craft memory entity config for the generic CRUD system.
+ */
+export declare function buildCraftMemoryEntityConfig(categories?: Record<string, string>): EntityConfig;
+//# sourceMappingURL=memory-actions.d.ts.map

package/dist/core/memory-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-actions.d.ts","sourceRoot":"","sources":["../../src/core/memory-actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAIjE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQpF;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA+B3D,CAAA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAkBxG;AAED,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,aAAuC,CAAA;AAgBvE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA+BjE,CAAA;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAkB7G;AAED,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,aAA6C,CAAA;AAInF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAazF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAa9F"}

package/dist/core/memory-actions.js

@@ -0,0 +1,181 @@
+import { z } from 'zod';
+const DEFAULT_CATEGORIES = 'approach | commitment | pattern | context | preference | values | general';
+/**
+ * Build the category description string for the saveMemory action schema.
+ * When custom categories are defined, lists them with descriptions.
+ */
+export function buildCategoryDescription(categories) {
+    if (!categories || Object.keys(categories).length === 0) {
+        return `Category: ${DEFAULT_CATEGORIES}`;
+    }
+    const entries = Object.entries(categories)
+        .map(([name, desc]) => `${name} (${desc})`)
+        .join(' | ');
+    return `Category: ${entries}`;
+}
+/**
+ * Built-in legacy memory actions.
+ * Archetype's foundation path is CRUD-native memory entities.
+ * These named actions remain available for older integrations that still
+ * expose memory as named actions instead of entities.
+ */
+export const MEMORY_ACTIONS = {
+    saveMemory: {
+        description: 'Save a new durable insight about the user that you want to remember across future conversations.',
+        schema: z.object({
+            content: z.string().describe('The insight to remember — single concise sentence'),
+            category: z.string().describe(`Category: ${DEFAULT_CATEGORIES}`),
+            source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this memory comes from. Use "user" when they explicitly said it, "inferred" when you noticed a pattern, "suggested" when this is an agent-proposed idea not clearly adopted yet.'),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Time horizon: "durable" for reliable truths, "tentative" for still-forming patterns, "temporary" for situation-bound facts.'),
+            contextHint: z.string().optional().describe('Optional: a very short situational frame when needed to keep the memory interpretable later. Not a transcript.'),
+        }),
+        confidence: 'low',
+    },
+    updateMemory: {
+        description: 'Update an existing memory by ID when information has changed or evolved. Reference the (id:xxx) from the MEMORY section.',
+        schema: z.object({
+            id: z.string().describe('The memory ID to update (from the MEMORY section)'),
+            content: z.string().optional().describe('The updated content'),
+            category: z.string().optional().describe(`Category: ${DEFAULT_CATEGORIES}`),
+            source: z.enum(['user', 'inferred', 'suggested']).optional(),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional(),
+            contextHint: z.string().optional(),
+        }),
+        confidence: 'low',
+    },
+    deleteMemory: {
+        description: 'Delete a memory that is no longer accurate or relevant. Reference the (id:xxx) from the MEMORY section.',
+        schema: z.object({
+            id: z.string().describe('The memory ID to delete (from the MEMORY section)'),
+        }),
+        confidence: 'low',
+    },
+};
+/**
+ * Build memory actions with custom category descriptions.
+ * Returns the default MEMORY_ACTIONS when no custom categories are defined.
+ */
+export function buildMemoryActions(categories) {
+    if (!categories || Object.keys(categories).length === 0) {
+        return MEMORY_ACTIONS;
+    }
+    return {
+        ...MEMORY_ACTIONS,
+        saveMemory: {
+            ...MEMORY_ACTIONS.saveMemory,
+            schema: z.object({
+                content: z.string().describe('The insight to remember — single concise sentence'),
+                category: z.string().describe(buildCategoryDescription(categories)),
+                source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this memory comes from.'),
+                stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Optional: how strongly this memory should shape future judgment.'),
+                contextHint: z.string().optional().describe('Optional: compact situational frame when the memory needs context to stay interpretable later.'),
+            }),
+        },
+    };
+}
+/** Action names that are built-in memory actions (for auto-handling in managed mode) */
+export const MEMORY_ACTION_NAMES = new Set(Object.keys(MEMORY_ACTIONS));
+// ─── Craft Memory Actions ───────────────────────────────────────────────────
+const DEFAULT_CRAFT_CATEGORIES = 'approach | timing | pattern | insight | general';
+function buildCraftCategoryDescription(categories) {
+    if (!categories || Object.keys(categories).length === 0) {
+        return `Category: ${DEFAULT_CRAFT_CATEGORIES}`;
+    }
+    const entries = Object.entries(categories)
+        .map(([name, desc]) => `${name} (${desc})`)
+        .join(' | ');
+    return `Category: ${entries}`;
+}
+export const CRAFT_MEMORY_ACTIONS = {
+    saveCraftMemory: {
+        description: 'Save a professional growth observation — something you learned about your own craft that would make you better across all future conversations.',
+        schema: z.object({
+            content: z.string().describe('The craft observation — a concise, transferable insight'),
+            category: z.string().describe(`Category: ${DEFAULT_CRAFT_CATEGORIES}`),
+            source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this craft observation came from. Usually "inferred".'),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Time horizon: "durable" for reliable practice-level patterns, "tentative" for still-forming observations, "temporary" for observations tied to a specific moment or phase.'),
+            contextHint: z.string().optional().describe('Optional: very short situational frame when needed to keep the observation honest.'),
+        }),
+        confidence: 'low',
+    },
+    updateCraftMemory: {
+        description: 'Update an existing craft memory by ID when the observation has evolved or sharpened. Reference the (id:xxx) from the CRAFT MEMORY section.',
+        schema: z.object({
+            id: z.string().describe('The craft memory ID to update'),
+            content: z.string().optional().describe('The updated observation'),
+            category: z.string().optional().describe(`Category: ${DEFAULT_CRAFT_CATEGORIES}`),
+            source: z.enum(['user', 'inferred', 'suggested']).optional(),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional(),
+            contextHint: z.string().optional(),
+        }),
+        confidence: 'low',
+    },
+    deleteCraftMemory: {
+        description: 'Delete a craft memory that turned out to be situational noise, not a real pattern. Reference the (id:xxx) from the CRAFT MEMORY section.',
+        schema: z.object({
+            id: z.string().describe('The craft memory ID to delete'),
+        }),
+        confidence: 'low',
+    },
+};
+/**
+ * Build craft memory actions with custom category descriptions.
+ */
+export function buildCraftMemoryActions(categories) {
+    if (!categories || Object.keys(categories).length === 0) {
+        return CRAFT_MEMORY_ACTIONS;
+    }
+    return {
+        ...CRAFT_MEMORY_ACTIONS,
+        saveCraftMemory: {
+            ...CRAFT_MEMORY_ACTIONS.saveCraftMemory,
+            schema: z.object({
+                content: z.string().describe('The craft observation — a concise, transferable insight'),
+                category: z.string().describe(buildCraftCategoryDescription(categories)),
+                source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this craft observation came from.'),
+                stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Optional: how strongly this observation should shape your practice.'),
+                contextHint: z.string().optional().describe('Optional: compact situational frame when needed.'),
+            }),
+        },
+    };
+}
+/** Action names that are built-in craft memory actions */
+export const CRAFT_MEMORY_ACTION_NAMES = new Set(Object.keys(CRAFT_MEMORY_ACTIONS));
+// ─── Entity schemas for memory CRUD ────────────────────────────────────────
+/**
+ * Build a memory entity config for the generic CRUD system.
+ * Memory is registered as an internal entity when memory is enabled so
+ * durable memory mutations flow through CRUD.
+ */
+export function buildMemoryEntityConfig(categories) {
+    return {
+        schema: z.object({
+            content: z.string().describe('The insight to remember — single concise sentence'),
+            category: z.string().describe(buildCategoryDescription(categories)),
+            source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this memory came from.'),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Optional: how strongly this memory should shape future judgment.'),
+            contextHint: z.string().optional().describe('Optional: a compact situational frame when the memory needs context to stay interpretable later.'),
+        }),
+        label: 'Memory',
+        displayField: 'content',
+        description: 'Durable insights about the user worth remembering across future conversations',
+    };
+}
+/**
+ * Build a craft memory entity config for the generic CRUD system.
+ */
+export function buildCraftMemoryEntityConfig(categories) {
+    return {
+        schema: z.object({
+            content: z.string().describe('The craft observation — a concise, transferable insight'),
+            category: z.string().describe(buildCraftCategoryDescription(categories)),
+            source: z.enum(['user', 'inferred', 'suggested']).optional().describe('Optional: where this craft observation came from.'),
+            stability: z.enum(['durable', 'tentative', 'temporary']).optional().describe('Optional: how strongly this observation should shape your practice.'),
+            contextHint: z.string().optional().describe('Optional: compact situational frame when needed.'),
+        }),
+        label: 'Craft Memory',
+        displayField: 'content',
+        description: 'Professional growth observations about your own craft — transferable across all users',
+    };
+}
+//# sourceMappingURL=memory-actions.js.map

package/dist/core/memory-actions.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,35 @@
+import type { Memory } from '../types.js';
+export interface MemoryBlockOptions {
+    budget?: number;
+    maxEntries?: number;
+    label?: string;
+    /** When true, include memory IDs in the prompt for AI-driven update/delete */
+    includeIds?: boolean;
+    /** Priority strategy: 'pinned-first' (default) splits pinned/unpinned then sorts by recency;
+     *  'recent-first' sorts all memories by recency regardless of pinned status. */
+    prioritize?: 'pinned-first' | 'recent-first';
+}
+/**
+ * Load memories for prompt injection, respecting budget and prioritization.
+ * Respects character budget and entry limit.
+ *
+ * Prioritization strategies:
+ * - 'pinned-first' (default): pinned memories first, then unpinned; each group sorted by createdAt desc.
+ * - 'recent-first': all memories sorted by createdAt desc regardless of pinned status.
+ */
+export declare function selectMemoriesForPrompt(memories: Memory[], options?: MemoryBlockOptions): string[];
+/**
+ * Format selected memories into a prompt section.
+ */
+export declare function buildMemoryBlock(memories: Memory[], options?: MemoryBlockOptions): string;
+/**
+ * Infer the best category for a memory text based on keyword matching.
+ * Returns 'general' if no strong signal.
+ *
+ * When `customKeywords` is provided, uses those for keyword matching.
+ * When `categoryNames` is provided (from MemoryConfig.categories),
+ * does simple name matching against the text as a lightweight fallback
+ * after keyword matching.
+ */
+export declare function inferMemoryCategory(text: string, customKeywords?: Record<string, string[]>, categoryNames?: string[]): string;
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKzC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;oFACgF;IAChF,UAAU,CAAC,EAAE,cAAc,GAAG,cAAc,CAAA;CAC7C;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,EAAE,CAiCV;AAqDD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAMR;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACzC,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,CA4BR"}

package/dist/core/memory.js

@@ -0,0 +1,168 @@
+const DEFAULT_BUDGET = 8000;
+const DEFAULT_MAX_ENTRIES = 200;
+/**
+ * Load memories for prompt injection, respecting budget and prioritization.
+ * Respects character budget and entry limit.
+ *
+ * Prioritization strategies:
+ * - 'pinned-first' (default): pinned memories first, then unpinned; each group sorted by createdAt desc.
+ * - 'recent-first': all memories sorted by createdAt desc regardless of pinned status.
+ */
+export function selectMemoriesForPrompt(memories, options) {
+    const budget = options?.budget ?? DEFAULT_BUDGET;
+    const maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const includeIds = options?.includeIds ?? false;
+    const strategy = options?.prioritize ?? 'pinned-first';
+    let sorted;
+    if (strategy === 'recent-first') {
+        sorted = [...memories].sort(byCreatedAtDesc);
+    }
+    else {
+        // pinned-first: split, then sort by salience inside each group
+        const pinned = memories.filter(m => m.pinned).sort(byMemorySalience);
+        const unpinned = memories.filter(m => !m.pinned).sort(byMemorySalience);
+        sorted = [...pinned, ...unpinned];
+    }
+    sorted = sorted.slice(0, maxEntries);
+    const result = [];
+    let charCount = 0;
+    for (const mem of sorted) {
+        const idPart = includeIds ? ` (id:${mem.id})` : '';
+        const metadata = buildMemoryMetadataLabel(mem);
+        const contextPart = mem.contextHint?.trim() ? ` (context: ${mem.contextHint.trim()})` : '';
+        const line = `[${mem.category}${metadata}]${idPart} ${mem.content}${contextPart}`;
+        if (charCount + line.length > budget)
+            break;
+        result.push(line);
+        charCount += line.length;
+    }
+    return result;
+}
+/** Sort by createdAt descending (most recent first). Memories without createdAt sort last. */
+function byCreatedAtDesc(a, b) {
+    if (!a.createdAt && !b.createdAt)
+        return 0;
+    if (!a.createdAt)
+        return 1;
+    if (!b.createdAt)
+        return -1;
+    return b.createdAt.localeCompare(a.createdAt);
+}
+function byMemorySalience(a, b) {
+    const stabilityDiff = stabilityRank(b.stability) - stabilityRank(a.stability);
+    if (stabilityDiff !== 0)
+        return stabilityDiff;
+    const sourceDiff = sourceRank(b.source) - sourceRank(a.source);
+    if (sourceDiff !== 0)
+        return sourceDiff;
+    return byCreatedAtDesc(a, b);
+}
+function stabilityRank(stability) {
+    switch (stability) {
+        case 'durable':
+            return 3;
+        case 'tentative':
+            return 2;
+        case 'temporary':
+            return 1;
+        default:
+            return 2;
+    }
+}
+function sourceRank(source) {
+    switch (source) {
+        case 'user':
+            return 3;
+        case 'inferred':
+            return 2;
+        case 'suggested':
+            return 1;
+        default:
+            return 2;
+    }
+}
+function buildMemoryMetadataLabel(memory) {
+    const parts = [];
+    if (memory.source)
+        parts.push(`source:${memory.source}`);
+    if (memory.stability)
+        parts.push(`stability:${memory.stability}`);
+    return parts.length > 0 ? ` | ${parts.join(' | ')}` : '';
+}
+/**
+ * Format selected memories into a prompt section.
+ */
+export function buildMemoryBlock(memories, options) {
+    const label = options?.label ?? 'MEMORY';
+    const selected = selectMemoriesForPrompt(memories, options);
+    if (selected.length === 0)
+        return '';
+    return `--- ${label} (what you've learned about this person) ---\nYour accumulated understanding from working with them.\n${selected.join('\n')}`;
+}
+// ─── Category inference ──────────────────────────────────────────────────────
+const DEFAULT_CATEGORY_KEYWORDS = {
+    approach: [
+        'responds well to', 'resists', 'shuts down when', 'push harder', 'pull back',
+        'framing that works', 'approach that works', 'landed well', 'style that works',
+        'softer', 'direct pushback',
+    ],
+    commitment: [
+        "said he'd", 'committed to', 'this week', 'promised to', 'going to confront',
+        'will stop', "next time i'll", 'i need to stop', "i'll",
+    ],
+    pattern: [
+        'across threads', 'keeps showing up', 'systemic', 'multiple', 'recurring across',
+        'pattern spanning', 'cross-cutting', 'connected to',
+    ],
+    context: [
+        'optimizing for', 'trade-off', 'current bet', 'strategic frame', 'north star',
+        'what matters most', 'key assumption', 'thesis',
+    ],
+    preference: [
+        'prefers', 'likes to', 'works best when', 'communication style', 'wants to be',
+        'rather than', 'comfortable with', 'hates when', 'pet peeve', 'processing style',
+        'think out loud', 'needs space',
+    ],
+    values: [
+        'believes in', 'cares about', 'matters more than', 'integrity', 'transparency',
+        'proud of', 'stands for', 'deeply values', 'non-negotiable', 'kind of leader',
+        'kind of company',
+    ],
+};
+/**
+ * Infer the best category for a memory text based on keyword matching.
+ * Returns 'general' if no strong signal.
+ *
+ * When `customKeywords` is provided, uses those for keyword matching.
+ * When `categoryNames` is provided (from MemoryConfig.categories),
+ * does simple name matching against the text as a lightweight fallback
+ * after keyword matching.
+ */
+export function inferMemoryCategory(text, customKeywords, categoryNames) {
+    const keywords = customKeywords ?? DEFAULT_CATEGORY_KEYWORDS;
+    const lower = text.toLowerCase();
+    let best = 'general';
+    let bestScore = 0;
+    for (const [category, kws] of Object.entries(keywords)) {
+        let score = 0;
+        for (const kw of kws) {
+            if (lower.includes(kw))
+                score++;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            best = category;
+        }
+    }
+    // If keyword matching found nothing and we have domain categories,
+    // try simple name matching as a fallback
+    if (best === 'general' && categoryNames && categoryNames.length > 0) {
+        for (const name of categoryNames) {
+            if (lower.includes(name.toLowerCase())) {
+                return name;
+            }
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

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

package/dist/core/peer-actions.d.ts

@@ -0,0 +1,15 @@
+import type { ActionDefinition, PeerConfig } from '../types.js';
+/** Action name for the built-in peer consultation action */
+export declare const PEER_ACTION_NAME = "consultPeer";
+/**
+ * Build the consultPeer action definition from the declared peer config.
+ * Auto-registered when peers are configured on withStorage() — same pattern as
+ * memory CRUD entities when memory is enabled.
+ *
+ * The description is generated from peer identities so the persona knows
+ * who it can consult and what each peer offers.
+ */
+export declare function buildPeerAction(peers: Record<string, PeerConfig>): Record<string, ActionDefinition>;
+/** Set of built-in peer action names (for auto-handling in managed mode) */
+export declare const PEER_ACTION_NAMES: Set<string>;
+//# sourceMappingURL=peer-actions.d.ts.map

package/dist/core/peer-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-actions.d.ts","sourceRoot":"","sources":["../../src/core/peer-actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE/D,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAmBnG;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,aAA8B,CAAA"}

package/dist/core/peer-actions.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** Action name for the built-in peer consultation action */
+export const PEER_ACTION_NAME = 'consultPeer';
+/**
+ * Build the consultPeer action definition from the declared peer config.
+ * Auto-registered when peers are configured on withStorage() — same pattern as
+ * memory CRUD entities when memory is enabled.
+ *
+ * The description is generated from peer identities so the persona knows
+ * who it can consult and what each peer offers.
+ */
+export function buildPeerAction(peers) {
+    const peerNames = Object.keys(peers);
+    const peerDescriptions = peerNames
+        .map(name => {
+        const expertise = peers[name].expertise;
+        return expertise ? `${name} (${expertise})` : name;
+    })
+        .join(', ');
+    return {
+        [PEER_ACTION_NAME]: {
+            description: `Consult a peer for information or expertise you need to handle the current situation well. Available peers: ${peerDescriptions}. Be specific about what you need — the peer sees your query and curates a response.`,
+            schema: z.object({
+                peer: z.string().describe(`Which peer to consult: ${peerNames.join(' | ')}`),
+                query: z.string().describe('What you need from them — be specific about topics, senders, timeframes, or data types'),
+            }),
+            confidence: 'low', // consulting is always safe — no side effects
+        },
+    };
+}
+/** Set of built-in peer action names (for auto-handling in managed mode) */
+export const PEER_ACTION_NAMES = new Set([PEER_ACTION_NAME]);
+//# sourceMappingURL=peer-actions.js.map

package/dist/core/peer-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-actions.js","sourceRoot":"","sources":["../../src/core/peer-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAA;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiC;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,gBAAgB,GAAG,SAAS;SAC/B,GAAG,CAAC,IAAI,CAAC,EAAE;QACV,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAA;QACvC,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO;QACL,CAAC,gBAAgB,CAAC,EAAE;YAClB,WAAW,EAAE,+GAA+G,gBAAgB,sFAAsF;YAClO,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;aACrH,CAAC;YACF,UAAU,EAAE,KAAK,EAAE,8CAA8C;SAClE;KACF,CAAA;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAA"}