@itaila/archetype 0.3.30

package/dist/core/entity-helpers.d.ts

@@ -0,0 +1,47 @@
+import type { ParsedAction } from '../types.js';
+import type { EntityRegistry } from './entity-registry.js';
+/**
+ * Parse a camelCase action name into verb + entityName.
+ *
+ * 'createThread'  → { verb: 'create', entityName: 'thread' }
+ * 'updateFf'      → { verb: 'update', entityName: 'ff' }
+ * 'saveMemory'    → { verb: 'save', entityName: 'memory' }
+ * 'deleteExecNote' → { verb: 'delete', entityName: 'execNote' }
+ * 'random'        → null
+ */
+export declare function parseActionName(name: string): {
+    verb: string;
+    entityName: string;
+} | null;
+/**
+ * Human-readable label for an action, using entity metadata from the registry.
+ *
+ * 'createThread' + registry → "Add Thread"
+ * 'deleteFf'    + registry → "Delete Forcing Function"
+ *
+ * Falls back to capitalize(entityName) if the entity isn't in the registry.
+ */
+export declare function actionLabel(actionName: string, registry: EntityRegistry): string;
+/**
+ * Extract a display title from an action's params using the entity's displayField.
+ *
+ * For create actions: uses displayField to find the title in params.
+ * For update actions: summarizes as "field: value" (or full updates object).
+ * For delete actions: uses reason if present, falls back to id.
+ *
+ * Returns empty string if nothing meaningful can be extracted.
+ */
+export declare function getActionDisplayTitle(action: ParsedAction, registry: EntityRegistry, maxLength?: number): string;
+/**
+ * Check if an action targets a specific entity.
+ *
+ * isEntityAction('createThread', 'thread') → true
+ * isEntityAction('updateFf', 'thread')     → false
+ */
+export declare function isEntityAction(actionName: string, entityName: string): boolean;
+/** The operations an entity actually supports (operations > createOnly > all). */
+export declare function allowedOperations(config: {
+    createOnly?: boolean;
+    operations?: ReadonlyArray<'create' | 'update' | 'delete'>;
+}): ReadonlyArray<'create' | 'update' | 'delete'>;
+//# sourceMappingURL=entity-helpers.d.ts.map

package/dist/core/entity-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-helpers.d.ts","sourceRoot":"","sources":["../../src/core/entity-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAI1D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIzF;AAWD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAShF;AAID;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,SAAS,SAAK,GACb,MAAM,CA4CR;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAI9E;AAYD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;CAAE,GAAG,aAAa,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAI7K"}

package/dist/core/entity-helpers.js

@@ -0,0 +1,122 @@
+// ─── Action Name Parsing ────────────────────────────────────────────────────
+/**
+ * Parse a camelCase action name into verb + entityName.
+ *
+ * 'createThread'  → { verb: 'create', entityName: 'thread' }
+ * 'updateFf'      → { verb: 'update', entityName: 'ff' }
+ * 'saveMemory'    → { verb: 'save', entityName: 'memory' }
+ * 'deleteExecNote' → { verb: 'delete', entityName: 'execNote' }
+ * 'random'        → null
+ */
+export function parseActionName(name) {
+    const m = name.match(/^(create|update|delete|save)([A-Z]\w*)$/);
+    if (!m)
+        return null;
+    return { verb: m[1], entityName: m[2].charAt(0).toLowerCase() + m[2].slice(1) };
+}
+// ─── Action Label ───────────────────────────────────────────────────────────
+const VERB_LABELS = {
+    create: 'Add',
+    save: 'Add',
+    update: 'Update',
+    delete: 'Delete',
+};
+/**
+ * Human-readable label for an action, using entity metadata from the registry.
+ *
+ * 'createThread' + registry → "Add Thread"
+ * 'deleteFf'    + registry → "Delete Forcing Function"
+ *
+ * Falls back to capitalize(entityName) if the entity isn't in the registry.
+ */
+export function actionLabel(actionName, registry) {
+    const parsed = parseActionName(actionName);
+    if (!parsed)
+        return actionName;
+    const verbLabel = VERB_LABELS[parsed.verb] ?? capitalize(parsed.verb);
+    const entity = registry.getEntityForAction(actionName);
+    const entityLabel = entity?.label ?? capitalize(parsed.entityName);
+    return `${verbLabel} ${entityLabel}`;
+}
+// ─── Display Title ──────────────────────────────────────────────────────────
+/**
+ * Extract a display title from an action's params using the entity's displayField.
+ *
+ * For create actions: uses displayField to find the title in params.
+ * For update actions: summarizes as "field: value" (or full updates object).
+ * For delete actions: uses reason if present, falls back to id.
+ *
+ * Returns empty string if nothing meaningful can be extracted.
+ */
+export function getActionDisplayTitle(action, registry, maxLength = 60) {
+    const parsed = parseActionName(action.name);
+    if (!parsed)
+        return '';
+    const entity = registry.getEntityForAction(action.name);
+    const p = action.params;
+    if (parsed.verb === 'create' || parsed.verb === 'save') {
+        // Try displayField first
+        if (entity?.displayField && p[entity.displayField] != null) {
+            return truncate(String(p[entity.displayField]), maxLength);
+        }
+        // Fallback: try common field names
+        for (const field of ['title', 'text', 'what', 'content', 'name']) {
+            if (p[field] != null)
+                return truncate(String(p[field]), maxLength);
+        }
+        return '';
+    }
+    if (parsed.verb === 'update') {
+        // {id, field, value} shape (legacy pattern)
+        if (p.field != null && p.value != null) {
+            return truncate(`${p.field}: ${String(p.value)}`, maxLength);
+        }
+        // {id, updates: {...}} shape (archetype pattern)
+        if (p.updates != null && typeof p.updates === 'object') {
+            const updates = p.updates;
+            const keys = Object.keys(updates);
+            if (keys.length === 1) {
+                return truncate(`${keys[0]}: ${String(updates[keys[0]])}`, maxLength);
+            }
+            if (keys.length > 1) {
+                return truncate(`${keys.join(', ')}`, maxLength);
+            }
+        }
+        return '';
+    }
+    if (parsed.verb === 'delete') {
+        if (p.reason != null)
+            return truncate(String(p.reason), maxLength);
+        return '';
+    }
+    return '';
+}
+// ─── Entity Check ───────────────────────────────────────────────────────────
+/**
+ * Check if an action targets a specific entity.
+ *
+ * isEntityAction('createThread', 'thread') → true
+ * isEntityAction('updateFf', 'thread')     → false
+ */
+export function isEntityAction(actionName, entityName) {
+    const parsed = parseActionName(actionName);
+    if (!parsed)
+        return false;
+    return parsed.entityName === entityName;
+}
+// ─── Internals ──────────────────────────────────────────────────────────────
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max) + '…' : s;
+}
+/** The operations an entity actually supports (operations > createOnly > all). */
+export function allowedOperations(config) {
+    if (config.operations && config.operations.length > 0)
+        return config.operations;
+    if (config.createOnly)
+        return ['create'];
+    return ['create', 'update', 'delete'];
+}
+//# sourceMappingURL=entity-helpers.js.map

package/dist/core/entity-helpers.js.map

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

package/dist/core/entity-registry.d.ts

@@ -0,0 +1,47 @@
+import type { ActionDefinition, ContextInputDefinition } from '../types.js';
+import type { EntityDefinitionResult } from './entities.js';
+export interface EntityRegistryEntry {
+    name: string;
+    label: string;
+    displayField?: string;
+    actions: Record<string, ActionDefinition>;
+    contextInput: ContextInputDefinition;
+}
+export interface EntityRegistry {
+    /** All actions from all entities, merged */
+    actions: Record<string, ActionDefinition>;
+    /** All context inputs from all entities, keyed by entity name */
+    contextInputs: Record<string, ContextInputDefinition>;
+    /** Lookup: action name → entity metadata */
+    getEntityForAction(actionName: string): {
+        name: string;
+        label: string;
+        displayField?: string;
+    } | null;
+    /** All registered entity names */
+    entityNames: string[];
+    /** All registered entities (full metadata) */
+    entities: EntityRegistryEntry[];
+}
+/**
+ * Combine multiple defineEntity() results into a single registry.
+ *
+ * Provides the connective tissue between defineEntity() outputs and
+ * action helpers — merged actions, context inputs, and action→entity lookup.
+ *
+ * Example:
+ * ```typescript
+ * const registry = buildEntityRegistry(
+ *   { name: 'thread', ...threadEntity },
+ *   { name: 'ff', ...ffEntity },
+ *   { name: 'cue', ...cueEntity },
+ * )
+ *
+ * registry.getEntityForAction('updateThread')
+ * // → { name: 'thread', label: 'Thread', displayField: 'title' }
+ * ```
+ */
+export declare function buildEntityRegistry(...entries: Array<{
+    name: string;
+} & EntityDefinitionResult>): EntityRegistry;
+//# sourceMappingURL=entity-registry.d.ts.map

package/dist/core/entity-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-registry.d.ts","sourceRoot":"","sources":["../../src/core/entity-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAI3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,YAAY,EAAE,sBAAsB,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACrD,4CAA4C;IAC5C,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACrG,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,8CAA8C;IAC9C,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,CAAC,GAC3D,cAAc,CAqChB"}

package/dist/core/entity-registry.js

@@ -0,0 +1,54 @@
+/**
+ * Combine multiple defineEntity() results into a single registry.
+ *
+ * Provides the connective tissue between defineEntity() outputs and
+ * action helpers — merged actions, context inputs, and action→entity lookup.
+ *
+ * Example:
+ * ```typescript
+ * const registry = buildEntityRegistry(
+ *   { name: 'thread', ...threadEntity },
+ *   { name: 'ff', ...ffEntity },
+ *   { name: 'cue', ...cueEntity },
+ * )
+ *
+ * registry.getEntityForAction('updateThread')
+ * // → { name: 'thread', label: 'Thread', displayField: 'title' }
+ * ```
+ */
+export function buildEntityRegistry(...entries) {
+    const allActions = {};
+    const allContextInputs = {};
+    const actionToEntity = new Map();
+    const registryEntries = [];
+    for (const entry of entries) {
+        const registryEntry = {
+            name: entry.name,
+            label: entry.label,
+            displayField: entry.displayField,
+            actions: entry.actions,
+            contextInput: entry.contextInput,
+        };
+        registryEntries.push(registryEntry);
+        // Merge actions
+        for (const [actionName, actionDef] of Object.entries(entry.actions)) {
+            allActions[actionName] = actionDef;
+            actionToEntity.set(actionName, registryEntry);
+        }
+        // Merge context inputs
+        allContextInputs[entry.name] = entry.contextInput;
+    }
+    return {
+        actions: allActions,
+        contextInputs: allContextInputs,
+        entityNames: registryEntries.map(e => e.name),
+        entities: registryEntries,
+        getEntityForAction(actionName) {
+            const entry = actionToEntity.get(actionName);
+            if (!entry)
+                return null;
+            return { name: entry.name, label: entry.label, displayField: entry.displayField };
+        },
+    };
+}
+//# sourceMappingURL=entity-registry.js.map

package/dist/core/entity-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-registry.js","sourceRoot":"","sources":["../../src/core/entity-registry.ts"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAG,OAAyD;IAE5D,MAAM,UAAU,GAAqC,EAAE,CAAA;IACvD,MAAM,gBAAgB,GAA2C,EAAE,CAAA;IACnE,MAAM,cAAc,GAAG,IAAI,GAAG,EAA+B,CAAA;IAC7D,MAAM,eAAe,GAA0B,EAAE,CAAA;IAEjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAwB;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAA;QACD,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAEnC,gBAAgB;QAChB,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;YAClC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QAC/C,CAAC;QAED,uBAAuB;QACvB,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,YAAY,CAAA;IACnD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,aAAa,EAAE,gBAAgB;QAC/B,WAAW,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,eAAe;QACzB,kBAAkB,CAAC,UAAkB;YACnC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAC5C,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAA;YACvB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAA;QACnF,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/core/eq.d.ts

@@ -0,0 +1,13 @@
+import type { EQConfig, PromptMode } from '../types.js';
+/**
+ * Build EQ (emotional intelligence) instructions from config.
+ * These are thinking-nudges, not hard rules.
+ *
+ * DESIGN PRINCIPLE — Scenario-first, not directive-first.
+ * Describe what a great expert does in this situation. Don't tell the AI
+ * what to do — it's the expert. Paint the scenario and explain the intent.
+ * Prescriptive directives ("do X", "don't Y", "limit to Z") cap the AI's
+ * judgment. Scenario-first framing lets it bring its full capability.
+ */
+export declare function buildEQBlock(eq: EQConfig | undefined, promptMode?: PromptMode): string;
+//# sourceMappingURL=eq.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eq.d.ts","sourceRoot":"","sources":["../../src/core/eq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,GAAE,UAA2B,GAAG,MAAM,CA4CtG"}

package/dist/core/eq.js

@@ -0,0 +1,41 @@
+/**
+ * Build EQ (emotional intelligence) instructions from config.
+ * These are thinking-nudges, not hard rules.
+ *
+ * DESIGN PRINCIPLE — Scenario-first, not directive-first.
+ * Describe what a great expert does in this situation. Don't tell the AI
+ * what to do — it's the expert. Paint the scenario and explain the intent.
+ * Prescriptive directives ("do X", "don't Y", "limit to Z") cap the AI's
+ * judgment. Scenario-first framing lets it bring its full capability.
+ */
+export function buildEQBlock(eq, promptMode = 'conversation') {
+    if (!eq)
+        return '';
+    const nudges = [];
+    if (eq.frequencyRule) {
+        nudges.push('Continuity: trust what already landed and look for the next layer underneath. ' +
+            'Repeat only when urgency or a likely mistake makes it the responsible move.');
+    }
+    if (eq.autonomyRespect && promptMode === 'conversation') {
+        nudges.push("Autonomy: when someone is processing or thinking aloud, the most valuable thing an expert can do " +
+            "is often to help them think — reflecting back what they're hearing, naming the pattern, finding the question " +
+            "underneath the question. Unsolicited advice lands best when it's earned and specific. " +
+            "That said, when something important is being missed, a trusted expert says it directly.");
+    }
+    if (eq.qualitativeFirst) {
+        nudges.push('Lead with judgment and meaning. Use data to sharpen the point, not to replace it.');
+    }
+    if (eq.coherence) {
+        nudges.push("Coherence: keep trust with the person and with the thread of the work. " +
+            "If your view evolves, make the shift legible instead of silently contradicting yourself.");
+    }
+    if (eq.expertJudgment) {
+        nudges.push("Expert judgment: your recommendations carry real weight. Apply the professional standard a thoughtful " +
+            "expert in your domain would. When a responsible expert would need more information before advising, get it " +
+            "instead of filling critical gaps with assumptions.");
+    }
+    if (nudges.length === 0)
+        return '';
+    return nudges.join('\n');
+}
+//# sourceMappingURL=eq.js.map

package/dist/core/eq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eq.js","sourceRoot":"","sources":["../../src/core/eq.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,EAAwB,EAAE,aAAyB,cAAc;IAC5F,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAA;IAElB,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CACT,gFAAgF;YAChF,6EAA6E,CAC9E,CAAA;IACH,CAAC;IAED,IAAI,EAAE,CAAC,eAAe,IAAI,UAAU,KAAK,cAAc,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CACT,mGAAmG;YACnG,+GAA+G;YAC/G,wFAAwF;YACxF,yFAAyF,CAC1F,CAAA;IACH,CAAC;IAED,IAAI,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CACT,mFAAmF,CACpF,CAAA;IACH,CAAC;IAED,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CACT,yEAAyE;YACzE,0FAA0F,CAC3F,CAAA;IACH,CAAC;IAED,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CACT,wGAAwG;YACxG,6GAA6G;YAC7G,oDAAoD,CACrD,CAAA;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/dist/core/focus-context.d.ts

@@ -0,0 +1,19 @@
+import type { ContextInputDefinition } from '../types.js';
+export interface FocusWorkItem {
+    artifactName?: string;
+    primaryGoal: string;
+    goodOutcome?: string;
+    constraints?: readonly string[];
+    mandatoryOutputs?: readonly string[];
+    followUpAssignment?: string;
+}
+export interface FocusContextInputLabels {
+    workItem?: string;
+    sourceContext?: string;
+    workHistory?: string;
+    files?: string;
+    environment?: string;
+}
+export declare function buildFocusContextInputs(labels?: FocusContextInputLabels): Record<string, ContextInputDefinition>;
+export declare function renderFocusWorkItem(input: FocusWorkItem): string;
+//# sourceMappingURL=focus-context.d.ts.map

package/dist/core/focus-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-context.d.ts","sourceRoot":"","sources":["../../src/core/focus-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,uBAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CA4BpH;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUhE"}

package/dist/core/focus-context.js

@@ -0,0 +1,46 @@
+export function buildFocusContextInputs(labels = {}) {
+    return {
+        workItem: {
+            label: labels.workItem ?? 'WORK ITEM',
+            intent: 'Persona-authored future operating context for this focus turn: expert judgment lens, work/product spine, success picture, and manageable reasoning decomposition. It is layered on source truth, visible conversation, durable files, and tool outcomes; it does not replace them or another expert\'s ownership.',
+            format: 'block',
+        },
+        sourceContext: {
+            label: labels.sourceContext ?? 'SOURCE CONTEXT',
+            intent: 'Exact compact contents of small source-truth files that define success for the current work. Use this as durable grounding when planning, making tradeoffs, handing off work, and judging completeness; use readFile when relevant source truth is absent, too large, or stale.',
+            format: 'block',
+        },
+        workHistory: {
+            label: labels.workHistory ?? 'WORK HISTORY',
+            intent: 'Chronological private work continuity: self-notes, this persona\'s action outcomes, and world changes not already visible in chat.',
+            format: 'list',
+        },
+        files: {
+            label: labels.files ?? 'FILES',
+            intent: 'Factual workspace tree with size signals. Files are durable artifacts; WORK ITEM is private operating context layered on top of source truth and durable files. Use the relevant read/list/search action when contents matter.',
+            format: 'list',
+        },
+        environment: {
+            label: labels.environment ?? 'ENVIRONMENT',
+            intent: 'Factual runtime and workspace constraints. Use these facts when choosing tools, paths, dependencies, build strategy, or verification steps.',
+            format: 'list',
+        },
+    };
+}
+export function renderFocusWorkItem(input) {
+    return [
+        input.artifactName ? `Artifact: ${input.artifactName}` : null,
+        `Primary goal: ${input.primaryGoal}`,
+        input.goodOutcome ? `What good looks like: ${input.goodOutcome}` : null,
+        renderList('Hard constraints:', input.constraints),
+        renderList('Mandatory outputs:', input.mandatoryOutputs),
+        input.followUpAssignment ? 'Follow-up assignment:' : null,
+        input.followUpAssignment ? `- ${input.followUpAssignment}` : null,
+    ].filter(Boolean).join('\n');
+}
+function renderList(label, items) {
+    if (!items || items.length === 0)
+        return null;
+    return [label, ...items.map(item => `- ${item}`)].join('\n');
+}
+//# sourceMappingURL=focus-context.js.map

package/dist/core/focus-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-context.js","sourceRoot":"","sources":["../../src/core/focus-context.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,uBAAuB,CAAC,SAAkC,EAAE;IAC1E,OAAO;QACL,QAAQ,EAAE;YACR,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,WAAW;YACrC,MAAM,EAAE,mTAAmT;YAC3T,MAAM,EAAE,OAAO;SAChB;QACD,aAAa,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,aAAa,IAAI,gBAAgB;YAC/C,MAAM,EAAE,iRAAiR;YACzR,MAAM,EAAE,OAAO;SAChB;QACD,WAAW,EAAE;YACX,KAAK,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc;YAC3C,MAAM,EAAE,oIAAoI;YAC5I,MAAM,EAAE,MAAM;SACf;QACD,KAAK,EAAE;YACL,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO;YAC9B,MAAM,EAAE,gOAAgO;YACxO,MAAM,EAAE,MAAM;SACf;QACD,WAAW,EAAE;YACX,KAAK,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa;YAC1C,MAAM,EAAE,6IAA6I;YACrJ,MAAM,EAAE,MAAM;SACf;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,OAAO;QACL,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI;QAC7D,iBAAiB,KAAK,CAAC,WAAW,EAAE;QACpC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QACvE,UAAU,CAAC,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC;QAClD,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC,gBAAgB,CAAC;QACxD,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI;QACzD,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI;KAClE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAyB;IAC1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7C,OAAO,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9D,CAAC"}

package/dist/core/focus-mode-actions.d.ts

@@ -0,0 +1,23 @@
+import type { ActionDefinition, ParsedAction } from '../types.js';
+export declare const ENTER_FOCUS_MODE_ACTION_NAME = "enterFocusMode";
+export declare const UPDATE_FOCUS_WORK_ITEM_ACTION_NAME = "updateFocusWorkItem";
+export declare const RETURN_TO_SESSION_ACTION_NAME = "returnToSession";
+export declare const enterFocusModeAction: ActionDefinition;
+export declare const updateFocusWorkItemAction: ActionDefinition;
+export declare const returnToSessionAction: ActionDefinition;
+export declare const FOCUS_MODE_ACTIONS: Record<typeof ENTER_FOCUS_MODE_ACTION_NAME | typeof UPDATE_FOCUS_WORK_ITEM_ACTION_NAME | typeof RETURN_TO_SESSION_ACTION_NAME, ActionDefinition>;
+export declare function buildFocusActionSets<const TActions extends Record<string, ActionDefinition>>(actions: TActions): {
+    conversation: TActions & {
+        enterFocusMode: ActionDefinition;
+    };
+    focus: TActions & {
+        returnToSession: ActionDefinition;
+    };
+};
+export declare function isEnterFocusModeAction(action: Pick<ParsedAction, 'name'>): boolean;
+export declare function isUpdateFocusWorkItemAction(action: Pick<ParsedAction, 'name'>): boolean;
+export declare function isReturnToSessionAction(action: Pick<ParsedAction, 'name'>): boolean;
+export declare function enterFocusModeOutcomeNote(action: Pick<ParsedAction, 'params'>): string;
+export declare function updateFocusWorkItemOutcomeNote(action: Pick<ParsedAction, 'params'>): string;
+export declare function returnToSessionOutcomeNote(action: Pick<ParsedAction, 'params'>): string;
+//# sourceMappingURL=focus-mode-actions.d.ts.map

package/dist/core/focus-mode-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-mode-actions.d.ts","sourceRoot":"","sources":["../../src/core/focus-mode-actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEjE,eAAO,MAAM,4BAA4B,mBAAmB,CAAA;AAC5D,eAAO,MAAM,kCAAkC,wBAAwB,CAAA;AACvE,eAAO,MAAM,6BAA6B,oBAAoB,CAAA;AAE9D,eAAO,MAAM,oBAAoB,EAAE,gBAOlC,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAOvC,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,gBASnC,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CACrC,OAAO,4BAA4B,GAAG,OAAO,kCAAkC,GAAG,OAAO,6BAA6B,EACtH,gBAAgB,CAKjB,CAAA;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC1F,OAAO,EAAE,QAAQ,GAChB;IACD,YAAY,EAAE,QAAQ,GAAG;QAAE,cAAc,EAAE,gBAAgB,CAAA;KAAE,CAAA;IAC7D,KAAK,EAAE,QAAQ,GAAG;QAAE,eAAe,EAAE,gBAAgB,CAAA;KAAE,CAAA;CACxD,CAYA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAElF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,CAItF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,CAG3F;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,CAQvF"}

package/dist/core/focus-mode-actions.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+export const ENTER_FOCUS_MODE_ACTION_NAME = 'enterFocusMode';
+export const UPDATE_FOCUS_WORK_ITEM_ACTION_NAME = 'updateFocusWorkItem';
+export const RETURN_TO_SESSION_ACTION_NAME = 'returnToSession';
+export const enterFocusModeAction = {
+    description: 'Enter focus mode for this persona\'s ongoing work. When entering focus mode, you have an opportunity to write a work item for your future self. This is your future operating context: it follows future focus prompts as your own expert anchor, layered on top of source truth, visible conversation, durable files, and tool outcomes. It can describe the expert judgment lens to hold, the work or product spine, what excellent success feels like, and the manageable parts you expect your future self to reason through. It is private operating context for this persona, not a handoff that replaces another expert\'s ownership of method, sequencing, tools, or implementation approach. The focused work context begins on the next turn.',
+    confidence: 'low',
+    schema: z.object({
+        workItem: z.string().min(1).optional(),
+    }),
+};
+export const updateFocusWorkItemAction = {
+    description: 'Update the focus work item for this persona\'s future self. The work item is editable private operating context: replace it when your expert judgment lens, work spine, success picture, or reasoning decomposition has changed. The runtime carries the updated work item into future focus prompts; this is not a quality check, approval step, or substitute source of truth.',
+    confidence: 'low',
+    schema: z.object({
+        workItem: z.string().min(1),
+    }),
+};
+export const returnToSessionAction = {
+    description: 'Return from private focus work to the visible session flow. Use this when the persona is ready to make its handoff, result, question, or blocked state visible to the session. This is a routing/visibility action, not a quality check: it does not approve or reject the work.',
+    confidence: 'low',
+    schema: z.object({
+        message: z.string().min(1),
+        to: z.string().min(1).optional(),
+        state: z.enum(['ready', 'blocked', 'failed']).optional(),
+    }),
+};
+export const FOCUS_MODE_ACTIONS = {
+    [ENTER_FOCUS_MODE_ACTION_NAME]: enterFocusModeAction,
+    [UPDATE_FOCUS_WORK_ITEM_ACTION_NAME]: updateFocusWorkItemAction,
+    [RETURN_TO_SESSION_ACTION_NAME]: returnToSessionAction,
+};
+export function buildFocusActionSets(actions) {
+    return {
+        conversation: {
+            enterFocusMode: enterFocusModeAction,
+            ...actions,
+        },
+        focus: {
+            ...actions,
+            updateFocusWorkItem: updateFocusWorkItemAction,
+            returnToSession: returnToSessionAction,
+        },
+    };
+}
+export function isEnterFocusModeAction(action) {
+    return action.name === ENTER_FOCUS_MODE_ACTION_NAME;
+}
+export function isUpdateFocusWorkItemAction(action) {
+    return action.name === UPDATE_FOCUS_WORK_ITEM_ACTION_NAME;
+}
+export function isReturnToSessionAction(action) {
+    return action.name === RETURN_TO_SESSION_ACTION_NAME;
+}
+export function enterFocusModeOutcomeNote(action) {
+    const workItem = typeof action.params.workItem === 'string' ? action.params.workItem.trim() : '';
+    if (workItem)
+        return 'focus mode entered with a persona-authored work item.';
+    return 'focus mode entered.';
+}
+export function updateFocusWorkItemOutcomeNote(action) {
+    void action;
+    return 'focus work item updated.';
+}
+export function returnToSessionOutcomeNote(action) {
+    const message = typeof action.params.message === 'string' ? action.params.message.trim() : '';
+    const to = typeof action.params.to === 'string' && action.params.to.trim()
+        ? ` to ${action.params.to.trim()}`
+        : '';
+    return message
+        ? `returnToSession posted visible message${to}: ${message}`
+        : `returnToSession posted visible message${to}.`;
+}
+//# sourceMappingURL=focus-mode-actions.js.map

package/dist/core/focus-mode-actions.js.map

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

package/dist/core/greeting.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Determine if a greeting/re-engagement is appropriate based on staleness.
+ * Returns true if: no prior message, >2 hours since last, or new calendar day.
+ */
+export declare function shouldGreet(lastMessageAt: Date | null | undefined, now?: Date, timezone?: string): boolean;
+/**
+ * Build a greeting context hint for the system prompt.
+ */
+export declare function buildGreetingHint(isGreeting: boolean, timezone?: string): string;
+//# sourceMappingURL=greeting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"greeting.d.ts","sourceRoot":"","sources":["../../src/core/greeting.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EACtC,GAAG,CAAC,EAAE,IAAI,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAUT;AAYD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,OAAO,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAYR"}

package/dist/core/greeting.js

@@ -0,0 +1,41 @@
+const STALE_THRESHOLD_MS = 2 * 60 * 60 * 1000; // 2 hours
+/**
+ * Determine if a greeting/re-engagement is appropriate based on staleness.
+ * Returns true if: no prior message, >2 hours since last, or new calendar day.
+ */
+export function shouldGreet(lastMessageAt, now, timezone) {
+    if (!lastMessageAt)
+        return true;
+    const currentTime = now ?? new Date();
+    const elapsed = currentTime.getTime() - lastMessageAt.getTime();
+    if (elapsed >= STALE_THRESHOLD_MS)
+        return true;
+    if (isNewDay(lastMessageAt, currentTime, timezone))
+        return true;
+    return false;
+}
+/**
+ * Check if two dates fall on different calendar days in the given timezone.
+ */
+function isNewDay(a, b, timezone) {
+    const opts = { timeZone: timezone };
+    const dayA = a.toLocaleDateString('en-CA', opts);
+    const dayB = b.toLocaleDateString('en-CA', opts);
+    return dayA !== dayB;
+}
+/**
+ * Build a greeting context hint for the system prompt.
+ */
+export function buildGreetingHint(isGreeting, timezone) {
+    if (!isGreeting)
+        return '';
+    const now = new Date();
+    const timeStr = now.toLocaleTimeString('en-US', {
+        timeZone: timezone,
+        hour: 'numeric',
+        minute: '2-digit',
+    });
+    const dateStr = now.toLocaleDateString('en-CA', { timeZone: timezone });
+    return `This is a fresh session (${dateStr}, ${timeStr}). The context, memories, and history you have paint the current situation.`;
+}
+//# sourceMappingURL=greeting.js.map

package/dist/core/greeting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"greeting.js","sourceRoot":"","sources":["../../src/core/greeting.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,UAAU;AAExD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,aAAsC,EACtC,GAAU,EACV,QAAiB;IAEjB,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAE/B,MAAM,WAAW,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAA;IAE/D,IAAI,OAAO,IAAI,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAC9C,IAAI,QAAQ,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IAE/D,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,CAAO,EAAE,CAAO,EAAE,QAAiB;IACnD,MAAM,IAAI,GAA+B,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;IAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAChD,OAAO,IAAI,KAAK,IAAI,CAAA;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAmB,EACnB,QAAiB;IAEjB,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAA;IAE1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEvE,OAAO,4BAA4B,OAAO,KAAK,OAAO,6EAA6E,CAAA;AACrI,CAAC"}

package/dist/core/identity.d.ts

@@ -0,0 +1,13 @@
+import type { PersonaIdentity } from '../types.js';
+/**
+ * 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 declare function buildIdentityBlock(identity: PersonaIdentity): string;
+export declare function buildConversationKeystone(identity: PersonaIdentity, relationalPreamble?: string | false): string;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA0BpE;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,EACzB,kBAAkB,CAAC,EAAE,MAAM,GAAG,KAAK,GAClC,MAAM,CAQR"}