@itaila/archetype 0.3.30

package/dist/persona.js

@@ -0,0 +1,287 @@
+import { chat, createTrace } from './engine/chat.js';
+import { validateCrudActions } from './engine/crud.js';
+import { shouldGreet } from './core/greeting.js';
+import { buildRetrospectPrompt } from './core/prompt-builder.js';
+import { MEMORY_ACTIONS, CRAFT_MEMORY_ACTIONS } from './core/memory-actions.js';
+import { buildGeminiActionOnlySchema } from './providers/gemini.js';
+import { stripActionAnnotations } from './core/actions.js';
+import { auditPrompt } from './audit/prompt-audit.js';
+import { auditConversation } from './audit/conversation-audit.js';
+import { resolvePromptedTurnMode } from './core/prompt-mode.js';
+import { resolveEntities } from './core/effective-config.js';
+import { toPromptedTurnChatInput } from './core/prompted-turn.js';
+import { resolvePersonaConfigBrain } from './brain.js';
+function filterRetrospectEntities(entities) {
+    if (!entities)
+        return undefined;
+    const filtered = Object.fromEntries(Object.entries(entities).filter(([name]) => name === 'memory' || name === 'craftMemory'));
+    return Object.keys(filtered).length > 0 ? filtered : undefined;
+}
+function collectLegacyCrudContractDrift(parsed, label) {
+    if (!parsed.crudActions?.length)
+        return [];
+    return [`${label} used legacy top-level "crudActions" key; use actions[{ "name": "crud", ... }] instead.`];
+}
+function parseRetrospectResponse(text, config) {
+    const trace = createTrace();
+    try {
+        const parsed = JSON.parse(text);
+        trace.parseOk = true;
+        trace.errors.push(...collectLegacyCrudContractDrift(parsed, 'Retrospect response'));
+        // Extract crud actions from the actions array
+        const crudActionsFromActions = [];
+        const rawActions = parsed.actions ?? [];
+        // Also accept legacy top-level crudActions for backward compat
+        if (parsed.crudActions?.length) {
+            crudActionsFromActions.push(...parsed.crudActions);
+        }
+        // When memory is CRUD-native (memory entities present), the crud envelope
+        // is the only honored memory-mutation path — matching the schema. Named
+        // memory actions are NOT valid here; if the model emits one anyway it must
+        // be flagged in the trace as unknown_action, never silently treated as
+        // valid (which would disagree with the executor and hide the deviation).
+        const effectiveEntities = config ? filterRetrospectEntities(resolveEntities(config)) : undefined;
+        const memoryIsCrudNative = Boolean(effectiveEntities && Object.keys(effectiveEntities).length > 0);
+        // Legacy action-path: only honored for personas that opted out of CRUD-native memory.
+        const actions = [];
+        const allActions = memoryIsCrudNative
+            ? {}
+            : (config?.craftMemory?.enabled
+                ? { ...MEMORY_ACTIONS, ...CRAFT_MEMORY_ACTIONS }
+                : MEMORY_ACTIONS);
+        for (const action of rawActions) {
+            if (action.name === 'crud') {
+                const p = action.params;
+                const innerParams = typeof p.params === 'string' ? p.params : (p.params ? JSON.stringify(p.params) : undefined);
+                crudActionsFromActions.push({
+                    operation: p.operation,
+                    entity: p.entity,
+                    id: p.id,
+                    params: innerParams,
+                });
+                continue;
+            }
+            if (!(action.name in allActions)) {
+                trace.actions.push({ name: action.name, params: action.params ?? {}, status: 'unknown_action' });
+                continue;
+            }
+            const parseResult = allActions[action.name].schema.safeParse(action.params ?? {});
+            if (!parseResult.success) {
+                trace.actions.push({ name: action.name, params: action.params, status: 'invalid', error: parseResult.error.message });
+                continue;
+            }
+            actions.push({
+                name: action.name,
+                params: parseResult.data,
+                confidence: allActions[action.name].confidence,
+            });
+            trace.actions.push({ name: action.name, params: parseResult.data, status: 'valid' });
+        }
+        // CRUD-path: validate against entity schemas
+        let crudActions;
+        if (effectiveEntities && crudActionsFromActions.length > 0) {
+            const crudValidation = validateCrudActions(crudActionsFromActions, effectiveEntities);
+            for (const valid of crudValidation.valid) {
+                trace.crudActions.push({ operation: valid.operation, entity: valid.entity, id: valid.id, params: valid.params ?? {}, status: 'valid' });
+            }
+            for (const inv of crudValidation.invalid) {
+                trace.crudActions.push({ operation: inv.action.operation, entity: inv.action.entity, id: inv.action.id, params: inv.action.params ?? {}, status: 'invalid', error: inv.error });
+            }
+            if (crudValidation.invalid.length > 0) {
+                console.warn(`[archetype:retrospect] ${crudValidation.invalid.length} CRUD action(s) failed validation:`, crudValidation.invalid.map(i => `${i.action.operation} ${i.action.entity}: ${i.error}`).join(' | '));
+            }
+            if (crudValidation.valid.length > 0) {
+                crudActions = crudValidation.valid;
+            }
+        }
+        const diagnostics = config?.diagnostics?.enabled && parsed.diagnostics?.length
+            ? parsed.diagnostics.map(d => d.trim()).filter(Boolean)
+            : undefined;
+        return { actions, crudActions, diagnostics, raw: text, trace };
+    }
+    catch {
+        trace.parseOk = false;
+        trace.errors.push('Failed to parse retrospect response as JSON');
+        return { actions: [], raw: text, trace };
+    }
+}
+/**
+ * Build the response schema for retrospective passes.
+ * When memory entities are registered, includes a crud variant in the actions anyOf.
+ * Legacy actions array is kept for backward compat.
+ */
+function buildRetrospectResponseSchema(config, effectiveEntities) {
+    const memoryEntities = filterRetrospectEntities(effectiveEntities);
+    // Memory is CRUD-native: when memory entities are present, the ONLY memory
+    // mutation path the executor can honor is the `crud` action envelope. Offer
+    // exactly that — never the legacy per-entity action names (saveMemory,
+    // updateMemory, saveCraftMemory…). Offering both lets the model pick a
+    // representation the executor then rejects, and a schema that invites an
+    // unhonorable shape is bad context, not something to patch around at runtime.
+    if (memoryEntities && Object.keys(memoryEntities).length > 0) {
+        return buildGeminiActionOnlySchema({}, memoryEntities);
+    }
+    // No memory entities (a persona that opted out of CRUD-native memory): the
+    // legacy named-action interface is the only path that exists for it.
+    const legacyActions = config.craftMemory?.enabled
+        ? { ...MEMORY_ACTIONS, ...CRAFT_MEMORY_ACTIONS }
+        : MEMORY_ACTIONS;
+    return buildGeminiActionOnlySchema(legacyActions);
+}
+/**
+ * PersonaEngine — the main SDK entry point.
+ * Wraps a PersonaConfig and provides the chat interface.
+ */
+export class PersonaEngine {
+    config;
+    constructor(config) {
+        this.config = resolvePersonaConfigBrain(config);
+    }
+    /**
+     * Stateless chat — app manages history + persistence.
+     * Build prompt → call LLM → parse response.
+     */
+    async chat(input) {
+        return chat(this.config, input);
+    }
+    /**
+     * Stateless app-initiated turn — delegates to chat() with the intent
+     * framed as a system section, not a user message.
+     * The message slot gets a neutral directive so the AI understands
+     * this is system-initiated, not user-initiated.
+     */
+    async promptedTurn(input) {
+        const promptMode = resolvePromptedTurnMode(input.promptMode, input.turnKind);
+        const chatInput = {
+            ...toPromptedTurnChatInput(input),
+            promptMode,
+            // crudValidation handled below — not passed to chat() because chat()'s
+            // retry adds input.message to history, and prompted turns should not
+            // fabricate a fresh user utterance.
+        };
+        const result = await this.chat(chatInput);
+        // CRUD validation gate — handled here (not in chat()) to keep retry
+        // history clean: no synthetic user message in retry context.
+        if (input.crudValidation && result.crudActions && result.crudActions.length > 0) {
+            const validationErrors = input.crudValidation(result.crudActions);
+            if (validationErrors && validationErrors.length > 0) {
+                result.trace.errors.push(...validationErrors.map(e => `CRUD validation rejected: ${e}`));
+                const maxRetries = input.crudValidationRetries ?? 1;
+                if (maxRetries > 0) {
+                    const retryGuidance = [
+                        '--- VALIDATION FEEDBACK (internal) ---',
+                        'The previous draft had CRUD validation errors:',
+                        ...validationErrors.map(e => `- ${e}`),
+                        '',
+                        'Regenerate the complete app-initiated turn for the original intent.',
+                        'Do not mention validation, correction, retries, the previous draft, or that you fixed anything in the user-facing message.',
+                    ].join('\n');
+                    return this.promptedTurn({
+                        ...input,
+                        extraSystemSections: [...(input.extraSystemSections ?? []), retryGuidance],
+                        crudValidationRetries: maxRetries - 1,
+                    });
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Stateless retrospective memory pass — infer durable memory updates silently.
+     * Returns memory CRUD actions only; no user-facing message.
+     */
+    async retrospect(input) {
+        const effectiveEntities = filterRetrospectEntities(resolveEntities(this.config));
+        const systemPrompt = buildRetrospectPrompt({
+            config: { ...this.config, entities: effectiveEntities },
+            input: {
+                timezone: input.timezone,
+                promptNow: input.promptNow,
+                userIdentity: input.userIdentity,
+                locale: input.locale,
+                memories: input.memories,
+                knowledgeDocuments: input.knowledgeDocuments,
+                craftMemories: input.craftMemories,
+                context: input.context,
+                directives: input.directives,
+                promptScaffold: input.promptScaffold,
+                extraSystemSections: input.extraSystemSections,
+                workingSet: input.workingSet,
+            },
+            guidelines: input.guidelines,
+            history: input.history,
+        });
+        // Build response schema: CRUD entities for memory when available, legacy actions as fallback
+        const retrospectSchema = buildRetrospectResponseSchema(this.config, effectiveEntities);
+        const cleanHistory = stripActionAnnotations(input.history ?? []);
+        const response = await this.config.provider.chat({
+            systemPrompt,
+            history: cleanHistory,
+            message: 'Run the silent retrospective and return only the memory mutations that should change.',
+            responseSchema: retrospectSchema,
+        });
+        return parseRetrospectResponse(response.text, this.config);
+    }
+    /**
+     * Stateless greeting — build greeting prompt, call LLM, return plain text.
+     * No response schema, no actions — just a warm check-in message.
+     */
+    async greet(input) {
+        const result = await this.promptedTurn({
+            label: 'Greeting',
+            intent: "Generate a warm, natural check-in for a fresh or resumed session. Text like a thoughtful person, not a notification.",
+            turnKind: 'proactive-conversation',
+            timezone: input.timezone,
+            promptNow: input.promptNow,
+            userIdentity: input.userIdentity,
+            locale: input.locale,
+            memories: input.memories,
+            knowledgeDocuments: input.knowledgeDocuments,
+            craftMemories: input.craftMemories,
+            context: input.context,
+            guidelines: input.guidelines,
+            history: input.history,
+        });
+        return { greeting: result.message };
+    }
+    /**
+     * Check if a greeting is appropriate given the last message time.
+     */
+    shouldGreet(lastMessageAt, timezone) {
+        return shouldGreet(lastMessageAt, undefined, timezone);
+    }
+    /** The persona's display name */
+    get name() {
+        return this.config.identity.name;
+    }
+    /** The LLM provider name */
+    get providerName() {
+        return this.config.provider.name;
+    }
+    /**
+     * Audit the persona for keystone principle violations.
+     * Reviews the assembled prompt and optionally the conversation history.
+     * Returns explicit, actionable failure lists for developers/coding agents.
+     */
+    async audit(input) {
+        const promptResult = await auditPrompt({
+            apiKey: input.apiKey,
+            config: this.config,
+            context: input.context,
+            memories: input.memories,
+        });
+        const conversationResult = input.history?.length
+            ? await auditConversation({
+                apiKey: input.apiKey,
+                config: this.config,
+                history: input.history,
+                context: input.context,
+            })
+            : null;
+        return {
+            prompt: promptResult,
+            conversation: conversationResult,
+        };
+    }
+}
+//# sourceMappingURL=persona.js.map

package/dist/persona.js.map

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

package/dist/playbook/defaults.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Built-in playbook defaults — EQ, anti-pattern guards, cold start, memory extraction.
+ * These are battle-tested patterns from the AI Persona Playbook.
+ */
+export declare const OPERATIONAL_REALITY = "Operational reality:\n- This role exists because its judgment matters.\n- Treat structured context, ledgers, entities, queue items, and recent facts as the live source of truth.\n- Treat declared actions, entities, and output fields literally.\n- If information is missing, use the existing action/entity surface honestly rather than inventing hidden systems or actors.\n- Explain the move in message. Change shared state only through declared actions or entities.\n- Prefer honest operational moves over advisory prose when this turn should change shared state, owned work, or the outside world.";
+export declare const CONVERSATION_REALITY = "Conversation reality:\n- You are the domain expert.\n- The information in front of you is usually incomplete. Use the real situation over the most literal reading of every sentence in this prompt.\n- The latest live signal, structured context, durable work items, entities, explicit constraints, and memories are all part of the live situation.\n- When the live conversation contradicts a memory, update or delete the stale memory through the crud action in this turn \u2014 don't wait for a retrospective pass.\n- The visible recipients see your message, not the system's internals.";
+export declare const FOCUS_REALITY = "Focus reality:\n- You are the domain expert.\n- Focus context contains persona-authored operating context, source truth, private work history, and factual workspace state for this turn.\n- Focus turns are private work continuity unless the runtime explicitly returns a completion or handoff to the outer session.";
+export declare const EXPERT_AUTONOMY = "Expert autonomy:\n- Treat yourself and every participant as an expert owner of their field. Share intent, context, constraints, evidence, and what great should feel like; let each expert own method, sequencing, tools, and implementation approach unless those details are real source facts or constraints. Short-lived work items anchor judgment; they do not replace it with a checklist.";
+export declare const APP_INITIATED_TURN_REALITY = "App-initiated turn:\n- This turn was initiated by the app/runtime, not by a fresh inbound message.\n- Use recent conversation for continuity. Do not treat the last user line as a brand-new unanswered message unless the turn intent clearly makes it one.\n- Continue from the real situation instead of restarting.";
+export declare const OUTCOME_NOTES_INSTRUCTION = "Outcome notes:\n- Future turns may see prior messages and structured state, but not every executed action in raw form.\n- When an action result appears in your current prompt, that action already happened. Use the result as current world state; rerun the action only when you need a fresh value or exact contents are no longer carried. Inner narration and action outcomes are one work stream: what you said or intended, compact action narration, then what actually happened. Read them together in order; the outcome is the factual state. Action narration is not a raw action dump; raw parameters are omitted because they can bloat or contaminate continuity and may reference action APIs no longer available.\n- The subject may be the conversation, institution, or world depending on mode.\n- Match your words to your actions. If your message narrates a change (\"I've logged\u2026\", \"I've added\u2026\", \"I've updated\u2026\", \"I've saved\u2026\"), the corresponding action or crud call must also appear in this turn's output. Don't describe actions you aren't taking \u2014 silent narration is how past-tense promises become hallucinations future turns try to reconcile.";
+export declare const ATTACHMENT_CONTINUITY_RULES = "Attachment continuity:\n- This turn includes one or more uploaded images.\n- The raw image may not be available again on future turns.\n- If a compact factual carry-forward note about the image would materially help future reasoning, you may include it in \"attachmentNotes\".\n- Use attachmentNotes for enduring visual facts, not for exhaustive description or speculation.\n- If nothing about the image is likely to matter later, omit attachmentNotes.";
+export declare const MEMORY_ENTITY_RULES = "Memory:\n- Memory is what you've learned about this person that's worth carrying into future conversations \u2014 the durable layer beneath chat history, which gets trimmed.\n- Every stored memory comes from a specific moment. When reading one, check whether the situation that made it true still holds. When writing one, capture the situation that produced it \u2014 a correction saved without its why calcifies into a rule divorced from reality.\n- Update or delete memories that no longer fit the live conversation; don't keep obeying stored rules the user has already overwritten.";
+export declare const MEMORY_METADATA_GUIDANCE = "Memory metadata:\n- source: \"user\" when they said it directly, \"inferred\" when you noticed a pattern, \"suggested\" when it's an agent-proposed idea not clearly adopted yet.\n- stability: \"durable\" for reliable truths, \"tentative\" for still-forming patterns, \"temporary\" for situation-bound facts.\n- contextHint: the situation that produced the memory. For any correction or instruction tied to a moment (illness, travel, a specific week), contextHint is not optional \u2014 without it, the memory becomes a rule divorced from its reason.";
+export declare const RETROSPECTIVE_MEMORY_POLICY = "Retrospective memory policy:\n- This is a silent internal reflection pass. Step back from the last few days of interactions and ask what deserves to remain in the assistant's mind for future conversations.\n- Work from the actual situation: recent behavior, repeated choices, recurring friction, stable habits, durable tradeoff preferences, and what consistently seems to work or fail for them.\n- Keep the memory set sharp. Preserve what would materially improve future judgment, and let go of what now feels situational, noisy, outdated, or overshadowed by better evidence.\n- Each memory you keep loads into every future conversation. Your reasoning improves over time \u2014 ask whether each memory still helps your current judgment, or whether it's an older decision that would now constrain better thinking.\n- Some unusual details may still deserve memory if they meaningfully change how the assistant should think or relate to the user over time.\n- Review memory metadata too: agent-suggested ideas should not quietly harden into user-owned truth, and temporary corrections should not become timeless rules.\n- If nothing meaningful should change, return no memory mutations.";
+export declare const RETROSPECTIVE_OUTPUT_FORMAT = "Output valid JSON. Express every memory change as an entity CRUD item in the \"actions\" array, exactly as the ENTITY CRUD RESPONSE CONTRACT specifies: { \"name\": \"crud\", \"params\": { \"operation\": \"create\"|\"update\"|\"delete\", \"entity\": \"memory\" | \"craftMemory\", \"id\": \"...\", \"params\": \"{ ... }\" } }. Every memory and craftMemory mutation uses that single \"crud\" action \u2014 there are no per-entity memory action names.\n- This pass is silent and non-user-facing.\n- If nothing durable should change, return an empty actions array.";
+export declare const DIAGNOSTICS_CHANNEL = "Diagnostics channel:\nThe \"diagnostics\" field reaches the developer, not the person \u2014 it's for tensions between what the person needs and what your current setup allows.";
+export declare const CRAFT_MEMORY_SECTION_INTRO = "Craft memory \u2014 professional growth:\nThese are observations about your own craft: what works, timing insights, patterns in how interactions unfold. They are scoped to you as a practitioner, not to any individual user. They load into every conversation and inform your professional judgment over time.\nBecause they shape your judgment across every user you work with, each craft memory has outsized influence. Your practice evolves \u2014 these should capture what you've genuinely learned, not lock you into approaches from a point in time when you knew less.";
+export declare const CRAFT_MEMORY_FULLCRUD_RULES = "Craft memory:\n- The craftMemory entity holds transferable observations that sharpen your practice across future users \u2014 patterns that would apply to the next person, not patches for a single moment.";
+export declare const RETROSPECTIVE_CRAFT_POLICY = "Craft memory reflection:\n- Review existing craft memories against what you now know. Update when a prior observation has evolved. Delete when it was situational noise, not a real pattern.\n- Look for new craft-level patterns: approaches that consistently work, timing that matters, common mismatches between what users ask for and what they need.\n- Be especially careful with craft memories that sound like patches or absolute rules born from one incident. Rewrite or drop them unless they truly transfer.\n- Craft memories should be transferable \u2014 useful regardless of which user you're talking to.";
+export declare const ACTION_OUTPUT_FORMAT = "Output contract:\nReturn exactly one raw JSON object and nothing else.\nDo not wrap the response in markdown code fences.\nDo not add any text before or after the JSON.\nRequired top-level keys:\n- \"message\": Your conversational response.\n- \"actions\": Array of { \"name\": \"<actionName>\", \"params\": { ... } }. Use [] if no actions.\n- \"outcomeNotes\": Array of strings describing what your actions changed. Use [] when no actions changed anything.\nOptional top-level keys:\n- \"followUps\": Natural next things the user might realistically tap or say next, written as user utterances.\n- \"diagnostics\": Developer-facing setup tensions.\n- \"attachmentNotes\": Compact factual carry-forward notes about uploaded images when useful.";
+export declare const OPERATIONAL_ACTION_OUTPUT_FORMAT = "Output contract:\nReturn exactly one raw JSON object and nothing else.\nDo not wrap the response in markdown code fences.\nDo not add any text before or after the JSON.\nRequired top-level keys:\n- \"message\": Your written brief for this operational turn.\n- \"actions\": Array of { \"name\": \"<actionName>\", \"params\": { ... } }. Use [] if no actions.\n- \"outcomeNotes\": Array of strings describing what your actions changed in the institution or world. Use [] when no actions changed anything.\nOptional top-level keys:\n- \"diagnostics\": Developer-facing setup tensions. Omit or use [] when nothing to flag.\n- \"attachmentNotes\": Compact factual carry-forward notes about uploaded images when useful. Omit when not needed.\n- Entity mutations still belong inside \"actions\". Do not invent a top-level \"crudActions\" key.";
+export declare const FOCUS_ACTION_OUTPUT_FORMAT = "Output:\nReturn one raw JSON object: { \"message\": \"...\", \"actions\": [...] }. No markdown.\n\"message\" is your private focus note for this turn's work continuity.\n\"actions\" is a list executed in order within this turn. Later actions run after earlier state changes, such as files written earlier in the list, but you choose the whole list before any action outcomes are known. Include a later action when it remains the right next action without seeing those outcomes; when a result could change what you do next, let that result return on the next turn first. Future turns receive factual action outcomes, not raw action payloads. When an action result appears in your current prompt, that action already happened; use it as current world state. Inner narration and action outcomes are one work stream: what you said or intended, compact action narration, then what actually happened. Action narration is not a raw action dump and should not contaminate continuity. The action list may contain one action or many related actions; it is the complete set chosen for this turn.";
+export declare const MOMENTUM = "Momentum:\n- Guide the person toward felt progress. The conversation itself is often where the value lands, not in the structured changes.";
+export declare const COME_BACK_TEST = "Come-back test:\n- Will this make them want to come back and think with me again?";
+//# sourceMappingURL=defaults.d.ts.map

package/dist/playbook/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/playbook/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,ylBAMmG,CAAA;AAEnI,eAAO,MAAM,oBAAoB,4kBAKsC,CAAA;AAEvE,eAAO,MAAM,aAAa,6TAGoG,CAAA;AAE9H,eAAO,MAAM,eAAe,sYACoV,CAAA;AAEhX,eAAO,MAAM,0BAA0B,4TAGmB,CAAA;AAI1D,eAAO,MAAM,yBAAyB,4pCAI2T,CAAA;AAEjW,eAAO,MAAM,2BAA2B,ycAKsC,CAAA;AAI9E,eAAO,MAAM,mBAAmB,6kBAGwG,CAAA;AAExI,eAAO,MAAM,wBAAwB,0iBAGuM,CAAA;AAE5O,eAAO,MAAM,2BAA2B,qqCAO2B,CAAA;AAEnE,eAAO,MAAM,2BAA2B,ojBAE2B,CAAA;AAInE,eAAO,MAAM,mBAAmB,qLACoH,CAAA;AAIpJ,eAAO,MAAM,0BAA0B,0jBAEuN,CAAA;AAE9P,eAAO,MAAM,2BAA2B,iNACiJ,CAAA;AAEzL,eAAO,MAAM,0BAA0B,mmBAIsD,CAAA;AAI7F,eAAO,MAAM,oBAAoB,4uBAW2D,CAAA;AAE5F,eAAO,MAAM,gCAAgC,u0BAWkD,CAAA;AAE/F,eAAO,MAAM,0BAA0B,ikCAG02B,CAAA;AAIj5B,eAAO,MAAM,QAAQ,+IAC2G,CAAA;AAEhI,eAAO,MAAM,cAAc,sFACsC,CAAA"}

package/dist/playbook/defaults.js

@@ -0,0 +1,108 @@
+/**
+ * Built-in playbook defaults — EQ, anti-pattern guards, cold start, memory extraction.
+ * These are battle-tested patterns from the AI Persona Playbook.
+ */
+export const OPERATIONAL_REALITY = `Operational reality:
+- This role exists because its judgment matters.
+- Treat structured context, ledgers, entities, queue items, and recent facts as the live source of truth.
+- Treat declared actions, entities, and output fields literally.
+- If information is missing, use the existing action/entity surface honestly rather than inventing hidden systems or actors.
+- Explain the move in message. Change shared state only through declared actions or entities.
+- Prefer honest operational moves over advisory prose when this turn should change shared state, owned work, or the outside world.`;
+export const CONVERSATION_REALITY = `Conversation reality:
+- You are the domain expert.
+- The information in front of you is usually incomplete. Use the real situation over the most literal reading of every sentence in this prompt.
+- The latest live signal, structured context, durable work items, entities, explicit constraints, and memories are all part of the live situation.
+- When the live conversation contradicts a memory, update or delete the stale memory through the crud action in this turn — don't wait for a retrospective pass.
+- The visible recipients see your message, not the system's internals.`;
+export const FOCUS_REALITY = `Focus reality:
+- You are the domain expert.
+- Focus context contains persona-authored operating context, source truth, private work history, and factual workspace state for this turn.
+- Focus turns are private work continuity unless the runtime explicitly returns a completion or handoff to the outer session.`;
+export const EXPERT_AUTONOMY = `Expert autonomy:
+- Treat yourself and every participant as an expert owner of their field. Share intent, context, constraints, evidence, and what great should feel like; let each expert own method, sequencing, tools, and implementation approach unless those details are real source facts or constraints. Short-lived work items anchor judgment; they do not replace it with a checklist.`;
+export const APP_INITIATED_TURN_REALITY = `App-initiated turn:
+- This turn was initiated by the app/runtime, not by a fresh inbound message.
+- Use recent conversation for continuity. Do not treat the last user line as a brand-new unanswered message unless the turn intent clearly makes it one.
+- Continue from the real situation instead of restarting.`;
+// ─── Outcome notes ─────────────────────────────────────────────────────────
+export const OUTCOME_NOTES_INSTRUCTION = `Outcome notes:
+- Future turns may see prior messages and structured state, but not every executed action in raw form.
+- When an action result appears in your current prompt, that action already happened. Use the result as current world state; rerun the action only when you need a fresh value or exact contents are no longer carried. Inner narration and action outcomes are one work stream: what you said or intended, compact action narration, then what actually happened. Read them together in order; the outcome is the factual state. Action narration is not a raw action dump; raw parameters are omitted because they can bloat or contaminate continuity and may reference action APIs no longer available.
+- The subject may be the conversation, institution, or world depending on mode.
+- Match your words to your actions. If your message narrates a change ("I've logged…", "I've added…", "I've updated…", "I've saved…"), the corresponding action or crud call must also appear in this turn's output. Don't describe actions you aren't taking — silent narration is how past-tense promises become hallucinations future turns try to reconcile.`;
+export const ATTACHMENT_CONTINUITY_RULES = `Attachment continuity:
+- This turn includes one or more uploaded images.
+- The raw image may not be available again on future turns.
+- If a compact factual carry-forward note about the image would materially help future reasoning, you may include it in "attachmentNotes".
+- Use attachmentNotes for enduring visual facts, not for exhaustive description or speculation.
+- If nothing about the image is likely to matter later, omit attachmentNotes.`;
+// ─── Memory rules ───────────────────────────────────────────────────────────
+export const MEMORY_ENTITY_RULES = `Memory:
+- Memory is what you've learned about this person that's worth carrying into future conversations — the durable layer beneath chat history, which gets trimmed.
+- Every stored memory comes from a specific moment. When reading one, check whether the situation that made it true still holds. When writing one, capture the situation that produced it — a correction saved without its why calcifies into a rule divorced from reality.
+- Update or delete memories that no longer fit the live conversation; don't keep obeying stored rules the user has already overwritten.`;
+export const MEMORY_METADATA_GUIDANCE = `Memory metadata:
+- source: "user" when they said it directly, "inferred" when you noticed a pattern, "suggested" when it's an agent-proposed idea not clearly adopted yet.
+- stability: "durable" for reliable truths, "tentative" for still-forming patterns, "temporary" for situation-bound facts.
+- contextHint: the situation that produced the memory. For any correction or instruction tied to a moment (illness, travel, a specific week), contextHint is not optional — without it, the memory becomes a rule divorced from its reason.`;
+export const RETROSPECTIVE_MEMORY_POLICY = `Retrospective memory policy:
+- This is a silent internal reflection pass. Step back from the last few days of interactions and ask what deserves to remain in the assistant's mind for future conversations.
+- Work from the actual situation: recent behavior, repeated choices, recurring friction, stable habits, durable tradeoff preferences, and what consistently seems to work or fail for them.
+- Keep the memory set sharp. Preserve what would materially improve future judgment, and let go of what now feels situational, noisy, outdated, or overshadowed by better evidence.
+- Each memory you keep loads into every future conversation. Your reasoning improves over time — ask whether each memory still helps your current judgment, or whether it's an older decision that would now constrain better thinking.
+- Some unusual details may still deserve memory if they meaningfully change how the assistant should think or relate to the user over time.
+- Review memory metadata too: agent-suggested ideas should not quietly harden into user-owned truth, and temporary corrections should not become timeless rules.
+- If nothing meaningful should change, return no memory mutations.`;
+export const RETROSPECTIVE_OUTPUT_FORMAT = `Output valid JSON. Express every memory change as an entity CRUD item in the "actions" array, exactly as the ENTITY CRUD RESPONSE CONTRACT specifies: { "name": "crud", "params": { "operation": "create"|"update"|"delete", "entity": "memory" | "craftMemory", "id": "...", "params": "{ ... }" } }. Every memory and craftMemory mutation uses that single "crud" action — there are no per-entity memory action names.
+- This pass is silent and non-user-facing.
+- If nothing durable should change, return an empty actions array.`;
+// ─── Diagnostics channel ─────────────────────────────────────────────────────
+export const DIAGNOSTICS_CHANNEL = `Diagnostics channel:
+The "diagnostics" field reaches the developer, not the person — it's for tensions between what the person needs and what your current setup allows.`;
+// ─── Craft memory ───────────────────────────────────────────────────────────
+export const CRAFT_MEMORY_SECTION_INTRO = `Craft memory — professional growth:
+These are observations about your own craft: what works, timing insights, patterns in how interactions unfold. They are scoped to you as a practitioner, not to any individual user. They load into every conversation and inform your professional judgment over time.
+Because they shape your judgment across every user you work with, each craft memory has outsized influence. Your practice evolves — these should capture what you've genuinely learned, not lock you into approaches from a point in time when you knew less.`;
+export const CRAFT_MEMORY_FULLCRUD_RULES = `Craft memory:
+- The craftMemory entity holds transferable observations that sharpen your practice across future users — patterns that would apply to the next person, not patches for a single moment.`;
+export const RETROSPECTIVE_CRAFT_POLICY = `Craft memory reflection:
+- Review existing craft memories against what you now know. Update when a prior observation has evolved. Delete when it was situational noise, not a real pattern.
+- Look for new craft-level patterns: approaches that consistently work, timing that matters, common mismatches between what users ask for and what they need.
+- Be especially careful with craft memories that sound like patches or absolute rules born from one incident. Rewrite or drop them unless they truly transfer.
+- Craft memories should be transferable — useful regardless of which user you're talking to.`;
+// ─── Default actions output format ───────────────────────────────────────────
+export const ACTION_OUTPUT_FORMAT = `Output contract:
+Return exactly one raw JSON object and nothing else.
+Do not wrap the response in markdown code fences.
+Do not add any text before or after the JSON.
+Required top-level keys:
+- "message": Your conversational response.
+- "actions": Array of { "name": "<actionName>", "params": { ... } }. Use [] if no actions.
+- "outcomeNotes": Array of strings describing what your actions changed. Use [] when no actions changed anything.
+Optional top-level keys:
+- "followUps": Natural next things the user might realistically tap or say next, written as user utterances.
+- "diagnostics": Developer-facing setup tensions.
+- "attachmentNotes": Compact factual carry-forward notes about uploaded images when useful.`;
+export const OPERATIONAL_ACTION_OUTPUT_FORMAT = `Output contract:
+Return exactly one raw JSON object and nothing else.
+Do not wrap the response in markdown code fences.
+Do not add any text before or after the JSON.
+Required top-level keys:
+- "message": Your written brief for this operational turn.
+- "actions": Array of { "name": "<actionName>", "params": { ... } }. Use [] if no actions.
+- "outcomeNotes": Array of strings describing what your actions changed in the institution or world. Use [] when no actions changed anything.
+Optional top-level keys:
+- "diagnostics": Developer-facing setup tensions. Omit or use [] when nothing to flag.
+- "attachmentNotes": Compact factual carry-forward notes about uploaded images when useful. Omit when not needed.
+- Entity mutations still belong inside "actions". Do not invent a top-level "crudActions" key.`;
+export const FOCUS_ACTION_OUTPUT_FORMAT = `Output:
+Return one raw JSON object: { "message": "...", "actions": [...] }. No markdown.
+"message" is your private focus note for this turn's work continuity.
+"actions" is a list executed in order within this turn. Later actions run after earlier state changes, such as files written earlier in the list, but you choose the whole list before any action outcomes are known. Include a later action when it remains the right next action without seeing those outcomes; when a result could change what you do next, let that result return on the next turn first. Future turns receive factual action outcomes, not raw action payloads. When an action result appears in your current prompt, that action already happened; use it as current world state. Inner narration and action outcomes are one work stream: what you said or intended, compact action narration, then what actually happened. Action narration is not a raw action dump and should not contaminate continuity. The action list may contain one action or many related actions; it is the complete set chosen for this turn.`;
+// ─── Come-back test ──────────────────────────────────────────────────────────
+export const MOMENTUM = `Momentum:
+- Guide the person toward felt progress. The conversation itself is often where the value lands, not in the structured changes.`;
+export const COME_BACK_TEST = `Come-back test:
+- Will this make them want to come back and think with me again?`;
+//# sourceMappingURL=defaults.js.map

package/dist/playbook/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/playbook/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;mIAMgG,CAAA;AAEnI,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;uEAKmC,CAAA;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAG;;;8HAGiG,CAAA;AAE9H,MAAM,CAAC,MAAM,eAAe,GAAG;gXACiV,CAAA;AAEhX,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;0DAGgB,CAAA;AAE1D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;iWAIwT,CAAA;AAEjW,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;8EAKmC,CAAA;AAE9E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;wIAGqG,CAAA;AAExI,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;4OAGoM,CAAA;AAE5O,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;mEAOwB,CAAA;AAEnE,MAAM,CAAC,MAAM,2BAA2B,GAAG;;mEAEwB,CAAA;AAEnE,gFAAgF;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAG;oJACiH,CAAA;AAEpJ,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG;;8PAEoN,CAAA;AAE9P,MAAM,CAAC,MAAM,2BAA2B,GAAG;yLAC8I,CAAA;AAEzL,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;6FAImD,CAAA;AAE7F,gFAAgF;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;4FAWwD,CAAA;AAE5F,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;;;;;;;;+FAW+C,CAAA;AAE/F,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;i5BAGu2B,CAAA;AAEj5B,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG;gIACwG,CAAA;AAEhI,MAAM,CAAC,MAAM,cAAc,GAAG;iEACmC,CAAA"}