@itaila/archetype 0.3.30

package/dist/core/actions.js

@@ -0,0 +1,311 @@
+import { zodToDescription } from './crud-prompt.js';
+/**
+ * Extract a compact param signature from a Zod schema for prompt inclusion.
+ * Ensures the model knows exact field names even when params get stringified.
+ * Handles both Zod v3 (shape is function, desc in _def) and v4 (shape is object, desc as property).
+ */
+function summarizeParams(schema) {
+    return `params: ${zodToDescription(schema)}`;
+}
+function buildExampleValue(schema) {
+    const def = schema._def;
+    if (!def)
+        return '<value>';
+    const typeName = typeof def.typeName === 'string'
+        ? def.typeName
+        : typeof def.type === 'string'
+            ? ({
+                string: 'ZodString',
+                number: 'ZodNumber',
+                boolean: 'ZodBoolean',
+                array: 'ZodArray',
+                object: 'ZodObject',
+                optional: 'ZodOptional',
+                nullable: 'ZodNullable',
+                enum: 'ZodEnum',
+                literal: 'ZodLiteral',
+            }[def.type] ?? '')
+            : '';
+    switch (typeName) {
+        case 'ZodString':
+            return '<string>';
+        case 'ZodNumber':
+            return 1;
+        case 'ZodBoolean':
+            return true;
+        case 'ZodLiteral':
+            return def.value;
+        case 'ZodEnum': {
+            const values = def.values ?? def.entries;
+            const arr = Array.isArray(values) ? values : Object.keys(values);
+            return arr[0] ?? '<value>';
+        }
+        case 'ZodOptional':
+        case 'ZodNullable': {
+            const inner = def.innerType;
+            if (inner && typeof inner === 'object' && '_def' in inner) {
+                return buildExampleValue(inner);
+            }
+            return '<value>';
+        }
+        case 'ZodArray': {
+            const item = (def.type && typeof def.type === 'object' ? def.type : null) ?? def.element;
+            if (item && typeof item === 'object' && '_def' in item) {
+                return [buildExampleValue(item)];
+            }
+            return ['<value>'];
+        }
+        case 'ZodObject': {
+            const rawShape = def.shape;
+            const shape = typeof rawShape === 'function' ? rawShape() : rawShape;
+            if (!shape || typeof shape !== 'object')
+                return {};
+            const example = {};
+            for (const [key, value] of Object.entries(shape)) {
+                example[key] = buildExampleValue(value);
+            }
+            return example;
+        }
+        default:
+            return '<value>';
+    }
+}
+function buildExampleAction(actions) {
+    const first = Object.entries(actions)[0];
+    if (!first) {
+        return '{ "name": "<actionName>", "params": { ... } }';
+    }
+    const [name, def] = first;
+    const params = def.exampleParams ?? buildExampleValue(def.schema);
+    return JSON.stringify({ name, params });
+}
+function buildExampleActionFor(name, def) {
+    const params = def.exampleParams ?? buildExampleValue(def.schema);
+    return JSON.stringify({ name, params });
+}
+function summarizeShape(schema) {
+    const def = schema._def;
+    const rawShape = def?.shape;
+    const shape = typeof rawShape === 'function' ? rawShape() : rawShape;
+    if (shape && typeof shape === 'object') {
+        // z.object — list fields, recurse into arrays
+        const fields = Object.entries(shape).map(([key, val]) => {
+            const inner = summarizeInnerType(val);
+            if (inner)
+                return `${key}: ${inner}`;
+            const desc = val.description
+                ?? val._def?.description;
+            return desc ? `${key} (${desc})` : key;
+        });
+        return `{ ${fields.join(', ')} }`;
+    }
+    return '{}';
+}
+function summarizeInnerType(schema) {
+    const def = schema._def;
+    if (!def)
+        return null;
+    // z.array — unwrap to show item shape (Zod v3: _def.type is ZodType, v4: _def.element is ZodType)
+    const rawType = def.type;
+    const itemType = (rawType && typeof rawType === 'object' ? rawType : null) ?? def.element;
+    if (itemType && typeof itemType === 'object' && '_def' in itemType) {
+        const inner = summarizeShape(itemType);
+        if (inner !== '{}')
+            return `[${inner}]`;
+    }
+    return null;
+}
+/**
+ * Build the actions rules section of the system prompt from action definitions.
+ * Each action's description IS a behavioral nudge (per playbook §4).
+ */
+export function buildActionsBlock(actions, promptMode = 'conversation', contractStyle = 'full') {
+    if (!actions || Object.keys(actions).length === 0)
+        return '';
+    const lines = ['--- AVAILABLE ACTIONS ---'];
+    for (const [name, def] of Object.entries(actions)) {
+        if (promptMode === 'focus') {
+            // Focus mode is lean on prose but must still communicate tool
+            // semantics. Showing `- ${name}` alone forces the model to infer
+            // behavior from the name (e.g. runTests was treated as a generic
+            // "run my tests" tool until the model hit its Node-only runtime
+            // contract at turn 5). Include the description so the contract
+            // travels with the name. Params live in the native function-
+            // calling schema; this line carries the behavioral nuance.
+            if (def.description && def.description.trim().length > 0) {
+                lines.push(`- ${name}: ${def.description}`);
+            }
+            else {
+                lines.push(`- ${name}`);
+            }
+            continue;
+        }
+        const confidenceLabel = confidenceToLabel(def.confidence, promptMode);
+        const paramSig = summarizeParams(def.schema);
+        lines.push(`- ${name}`);
+        lines.push(`    ${contractStyle === 'lean' ? 'use' : 'when'}: ${def.description}`);
+        if (paramSig) {
+            lines.push(`    ${paramSig}`);
+        }
+        lines.push(`    example: ${buildExampleActionFor(name, def)}`);
+        if (contractStyle === 'full') {
+            lines.push(promptMode === 'operational'
+                ? `    execution: ${def.confidence} (${confidenceLabel})`
+                : `    confidence: ${def.confidence} (${confidenceLabel})`);
+        }
+    }
+    if (promptMode === 'focus') {
+        const toolNotes = [];
+        toolNotes.push("- Actions are attempts: any file, browser, test, finish, or handoff action can succeed or fail. You choose every action and action parameter before seeing same-turn outcomes. After each turn, the next turn's input includes outcome notes and action results from what actually happened — for example files written, bytes, match counts, exit codes, failed clicks, skipped finish attempts, or carried-forward read results. That continuity is the state of the world; raw action calls are not.");
+        toolNotes.push("- A same-turn visible completion, verification, or handoff message cannot reflect outcomes you have not seen yet. If the message depends on verification actions in this turn, run the verification first, let the outcomes return in the next turn, then decide what to say.");
+        if (hasFileMutationAction(actions) && 'browserOpen' in actions) {
+            toolNotes.push('- Workspace files and live browser pages are separate surfaces: file changes update the workspace; use browserOpen to load or reload those files before browser actions inspect the updated page.');
+        }
+        if (toolNotes.length > 0) {
+            lines.push('');
+            lines.push('How the tools behave here:');
+            lines.push(...toolNotes);
+        }
+        return lines.join('\n');
+    }
+    else {
+        lines.push('');
+        lines.push('--- ACTION RESPONSE CONTRACT ---');
+        lines.push('actions: [{ "name": "<actionName>", "params": { ... } }]');
+        if (contractStyle === 'full') {
+            lines.push('exact keys: name, params');
+        }
+        lines.push(`example item: ${buildExampleAction(actions)}`);
+        lines.push(`valid action names: ${Object.keys(actions).join(', ')}`);
+        lines.push('Action order: actions are attempts that execute in array order within this turn, and any action can succeed or fail. Later actions run after earlier state changes in the surfaces those actions actually changed, such as files written earlier in the list, but you choose the whole array 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. A same-turn visible completion, verification, or handoff message cannot reflect outcomes you have not seen yet.');
+        if (hasFileMutationAction(actions) && 'browserOpen' in actions) {
+            lines.push('Workspace files and live browser pages are separate surfaces: file changes update the workspace; use browserOpen to load or reload those files before browser actions inspect the updated page.');
+        }
+        if (contractStyle === 'full') {
+            lines.push('params may only contain keys declared in that action\'s params signature');
+            lines.push('if an additional action or param key is uncertain, omit it rather than inventing a nearby one');
+            lines.push('');
+            lines.push(promptMode === 'operational' ? 'Execution policy:' : 'Confidence levels:');
+        }
+    }
+    if (contractStyle === 'full') {
+        if (promptMode === 'operational') {
+            lines.push('- low = include the action directly in this turn');
+            lines.push('- medium = include the action directly and mention it in message if clarity helps');
+            lines.push('- high = do not execute it automatically in this turn; explain it in message as a pending move');
+        }
+        else {
+            lines.push('- low = just do it');
+            lines.push('- medium = mention it');
+            lines.push('- high = confirm first');
+        }
+        lines.push('');
+        if (promptMode === 'operational') {
+            lines.push('Only include actions when the live operational turn should actually change state.');
+            lines.push('An action list may contain one action or many related actions; it is the complete set chosen for this turn.');
+        }
+        else {
+            lines.push('Only include actions when warranted — your default is conversation, not action.');
+            lines.push('An action list may contain one action or many related actions; it is the complete set chosen for this turn.');
+        }
+    }
+    return lines.join('\n');
+}
+function hasFileMutationAction(actions) {
+    return ['applyPatch', 'writeFile', 'editFile', 'deleteFile'].some(name => name in actions);
+}
+function confidenceToLabel(confidence, promptMode) {
+    switch (confidence) {
+        case 'low': return 'just do it';
+        case 'medium': return promptMode === 'operational' ? 'mention it in message' : promptMode === 'focus' ? 'use only if clearly warranted' : 'mention it';
+        case 'high': return promptMode === 'operational' ? 'pending move' : promptMode === 'focus' ? 'avoid unless you are certain' : 'confirm first';
+    }
+}
+/**
+ * Build an annotation string for a completed action (for history storage).
+ * Annotations are appended to stored messages so the AI doesn't re-process.
+ */
+export function buildActionAnnotation(actionName, params) {
+    const summary = Object.entries(params)
+        .filter(([, v]) => v != null)
+        .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`)
+        .join(', ');
+    return `${actionName}: ${summary}`;
+}
+/**
+ * Build a combined annotation string for multiple actions.
+ */
+export function buildAnnotations(actions) {
+    return actions.map(a => buildActionAnnotation(a.name, a.params));
+}
+/**
+ * Annotate a message with outcome notes and raw action annotations for storage.
+ *
+ * Two-layer annotation system:
+ * - `---outcomes:` — AI-written outcome notes, preserved in LLM history so the AI
+ *   knows what it did on previous turns. Not shown to the user.
+ * - `---actions:` — Raw action data for debugging and UI pills. Stripped before
+ *   the AI sees history (to prevent API format leakage into future turns).
+ *
+ * Ordering matters: outcomes BEFORE actions, so stripping ---actions: preserves outcomes.
+ */
+export function annotateMessage(message, annotations, outcomeNotes) {
+    let result = message;
+    if (outcomeNotes && outcomeNotes.length > 0) {
+        result += `\n---outcomes: ${outcomeNotes.join('. ')}`;
+    }
+    if (annotations.length > 0) {
+        result += `\n---actions: ${annotations.join(' | ')}`;
+    }
+    return result;
+}
+/**
+ * Build annotation text for peer consultations that occurred mid-turn.
+ * Appended to the assistant message so the persona sees consultation context
+ * in its history on subsequent turns.
+ */
+export function buildPeerAnnotation(consultations) {
+    if (consultations.length === 0)
+        return '';
+    return consultations.map(c => {
+        const preview = c.response.length > 500
+            ? c.response.slice(0, 500) + '…'
+            : c.response;
+        return `---consulted: ${c.peer}---\nQuery: ${c.query}\nResponse: ${preview}\n---end consultation---`;
+    }).join('\n');
+}
+/**
+ * Strip all annotation markers from a message for user-facing display.
+ * Removes both `---outcomes:` and `---actions:` — the user sees neither.
+ * Use this when returning stored messages to the frontend.
+ */
+export function stripAnnotationsForDisplay(content) {
+    // Find the earliest annotation marker and strip from there
+    const markers = ['\n---outcomes:', '\n---actions:', '\n---consulted:'];
+    let earliest = -1;
+    for (const marker of markers) {
+        const idx = content.indexOf(marker);
+        if (idx !== -1 && (earliest === -1 || idx < earliest)) {
+            earliest = idx;
+        }
+    }
+    return earliest !== -1 ? content.slice(0, earliest).trimEnd() : content;
+}
+/**
+ * Strip `---actions:` suffixes from assistant messages in history.
+ * Preserves `---outcomes:` so the AI knows what it did on previous turns.
+ *
+ * The raw action data is stripped to prevent API format leakage — the AI
+ * must not learn action names or param schemas from historical messages.
+ * Outcome notes are safe because they're AI-written natural language.
+ */
+export function stripActionAnnotations(history) {
+    return history.map(msg => {
+        if (msg.role !== 'assistant' || !msg.content.includes('\n---actions:'))
+            return msg;
+        // Split on ---actions: and keep everything before it (including ---outcomes: if present)
+        const content = msg.content.split('\n---actions:')[0].trimEnd();
+        return { ...msg, content };
+    });
+}
+//# sourceMappingURL=actions.js.map

package/dist/core/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/core/actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAiB;IACxC,OAAO,WAAW,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAA;AAC9C,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiB;IAC1C,MAAM,GAAG,GAAI,MAAwD,CAAC,IAAI,CAAA;IAC1E,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAE1B,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAC/C,CAAC,CAAC,GAAG,CAAC,QAAQ;QACd,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAC5B,CAAC,CAAC,CAAC;gBACC,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,YAAY;gBACrB,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,aAAa;gBACvB,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,YAAY;aACtB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC,CAAC,EAAE,CAAA;IAER,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,UAAU,CAAA;QACnB,KAAK,WAAW;YACd,OAAO,CAAC,CAAA;QACV,KAAK,YAAY;YACf,OAAO,IAAI,CAAA;QACb,KAAK,YAAY;YACf,OAAO,GAAG,CAAC,KAAK,CAAA;QAClB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAA;YACxC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAA;YAC1E,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;QAC5B,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAA;YAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAK,KAAgB,EAAE,CAAC;gBACtE,OAAO,iBAAiB,CAAC,KAAkB,CAAC,CAAA;YAC9C,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAA;YACxF,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAK,IAAe,EAAE,CAAC;gBACnE,OAAO,CAAC,iBAAiB,CAAC,IAAiB,CAAC,CAAC,CAAA;YAC/C,CAAC;YACD,OAAO,CAAC,SAAS,CAAC,CAAA;QACpB,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAA;YAC1B,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;YACpE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAA;YAClD,MAAM,OAAO,GAA4B,EAAE,CAAA;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAkC,CAAC,EAAE,CAAC;gBAC9E,OAAO,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;YACzC,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;QACD;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAyC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,+CAA+C,CAAA;IACxD,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;IACzB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,GAAqB;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,MAAiB;IACvC,MAAM,GAAG,GAAI,MAAwD,CAAC,IAAI,CAAA;IAC1E,MAAM,QAAQ,GAAG,GAAG,EAAE,KAAK,CAAA;IAC3B,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEpE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,8CAA8C;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAkC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;YACnF,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;YACrC,IAAI,KAAK;gBAAE,OAAO,GAAG,GAAG,KAAK,KAAK,EAAE,CAAA;YACpC,MAAM,IAAI,GAAI,GAAgC,CAAC,WAAW;mBACpD,GAA2C,CAAC,IAAI,EAAE,WAAW,CAAA;YACnE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QACxC,CAAC,CAAC,CAAA;QACF,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACnC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAiB;IAC3C,MAAM,GAAG,GAAI,MAAwD,CAAC,IAAI,CAAA;IAC1E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IAErB,kGAAkG;IAClG,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAA;IACxB,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAA;IACzF,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,IAAK,QAAmB,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAG,cAAc,CAAC,QAAqB,CAAC,CAAA;QACnD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,KAAK,GAAG,CAAA;IACzC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAqD,EACrD,aAAyB,cAAc,EACvC,gBAAqC,MAAM;IAE3C,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAE5D,MAAM,KAAK,GAAa,CAAC,2BAA2B,CAAC,CAAA;IAErD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,8DAA8D;YAC9D,iEAAiE;YACjE,iEAAiE;YACjE,gEAAgE;YAChE,+DAA+D;YAC/D,6DAA6D;YAC7D,2DAA2D;YAC3D,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;YAC7C,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;YACzB,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QACrE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QAClF,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAA;QAC/B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,gBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9D,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,UAAU,KAAK,aAAa;gBAC1B,CAAC,CAAC,kBAAkB,GAAG,CAAC,UAAU,KAAK,eAAe,GAAG;gBACzD,CAAC,CAAC,mBAAmB,GAAG,CAAC,UAAU,KAAK,eAAe,GAAG,CAC7D,CAAA;QACH,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAa,EAAE,CAAA;QAC9B,SAAS,CAAC,IAAI,CAAC,yeAAye,CAAC,CAAA;QACzf,SAAS,CAAC,IAAI,CAAC,+QAA+Q,CAAC,CAAA;QAC/R,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;YAC/D,SAAS,CAAC,IAAI,CAAC,mMAAmM,CAAC,CAAA;QACrN,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACd,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YACxC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;QAC9C,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAA;QACtE,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,iBAAiB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC1D,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpE,KAAK,CAAC,IAAI,CAAC,4mBAA4mB,CAAC,CAAA;QACxnB,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,iMAAiM,CAAC,CAAA;QAC/M,CAAC;QACD,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAA;YACtF,KAAK,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAA;YAC3G,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACd,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAA;QACvF,CAAC;IACH,CAAC;IACD,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7B,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;YAC9D,KAAK,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAA;YAC/F,KAAK,CAAC,IAAI,CAAC,gGAAgG,CAAC,CAAA;QAC9G,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YAChC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;YACnC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAA;YAC/F,KAAK,CAAC,IAAI,CAAC,6GAA6G,CAAC,CAAA;QAC3H,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAA;YAC7F,KAAK,CAAC,IAAI,CACR,6GAA6G,CAC9G,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAyC;IACtE,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,OAAO,CAAC,CAAA;AAC5F,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA4B,EAAE,UAAsB;IAC7E,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,KAAK,CAAC,CAAC,OAAO,YAAY,CAAA;QAC/B,KAAK,QAAQ,CAAC,CAAC,OAAO,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,YAAY,CAAA;QACtJ,KAAK,MAAM,CAAC,CAAC,OAAO,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,eAAe,CAAA;IAC/I,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,MAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,GAAG,UAAU,KAAK,OAAO,EAAE,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiE;IAEjE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,WAAqB,EACrB,YAAuB;IAEvB,IAAI,MAAM,GAAG,OAAO,CAAA;IACpB,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,kBAAkB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IACvD,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,iBAAiB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAA;IACtD,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAAiC;IACnE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACzC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG;YACrC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG;YAChC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QACd,OAAO,iBAAiB,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,KAAK,eAAe,OAAO,0BAA0B,CAAA;IACtG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,2DAA2D;IAC3D,MAAM,OAAO,GAAG,CAAC,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAA;IACtE,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACnC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC;YACtD,QAAQ,GAAG,GAAG,CAAA;QAChB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAY;IAEZ,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;YAAE,OAAO,GAAG,CAAA;QAClF,yFAAyF;QACzF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;QAC/D,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/core/attachment-notes.d.ts

@@ -0,0 +1,7 @@
+export declare function buildAttachmentCarryForwardMessage(notes: string[]): string;
+export declare function parseAttachmentCarryForwardMessage(content: string): string[];
+export declare function buildAttachmentCarryForwardSection(notes: string[]): string;
+export declare function collectAttachmentCarryForwardNotes(messages: Array<{
+    content: string;
+}>): string[];
+//# sourceMappingURL=attachment-notes.d.ts.map

package/dist/core/attachment-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-notes.d.ts","sourceRoot":"","sources":["../../src/core/attachment-notes.ts"],"names":[],"mappings":"AAMA,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1E;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5E;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAS1E;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACnC,MAAM,EAAE,CAGV"}

package/dist/core/attachment-notes.js

@@ -0,0 +1,38 @@
+const ATTACHMENT_NOTE_MESSAGE_PREFIX = '__archetype_attachment_notes__';
+function normalizeNotes(notes) {
+    return [...new Set(notes.map(note => note.trim()).filter(Boolean))];
+}
+export function buildAttachmentCarryForwardMessage(notes) {
+    return `${ATTACHMENT_NOTE_MESSAGE_PREFIX}\n${JSON.stringify(normalizeNotes(notes))}`;
+}
+export function parseAttachmentCarryForwardMessage(content) {
+    if (!content.startsWith(ATTACHMENT_NOTE_MESSAGE_PREFIX))
+        return [];
+    const json = content.slice(ATTACHMENT_NOTE_MESSAGE_PREFIX.length).trim();
+    if (!json)
+        return [];
+    try {
+        const parsed = JSON.parse(json);
+        if (!Array.isArray(parsed))
+            return [];
+        return normalizeNotes(parsed.map(item => String(item)));
+    }
+    catch {
+        return [];
+    }
+}
+export function buildAttachmentCarryForwardSection(notes) {
+    const normalized = normalizeNotes(notes);
+    if (normalized.length === 0)
+        return '';
+    return [
+        'PRIOR IMAGE CONTEXT:',
+        ...normalized.map(note => `- ${note}`),
+        'These are compact carry-forward notes about earlier uploaded images. Use them when relevant, but do not pretend you can still inspect the raw image.',
+    ].join('\n');
+}
+export function collectAttachmentCarryForwardNotes(messages) {
+    const notes = messages.flatMap(message => parseAttachmentCarryForwardMessage(message.content));
+    return normalizeNotes(notes);
+}
+//# sourceMappingURL=attachment-notes.js.map

package/dist/core/attachment-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-notes.js","sourceRoot":"","sources":["../../src/core/attachment-notes.ts"],"names":[],"mappings":"AAAA,MAAM,8BAA8B,GAAG,gCAAgC,CAAA;AAEvE,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAe;IAChE,OAAO,GAAG,8BAA8B,KAAK,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,8BAA8B,CAAC;QAAE,OAAO,EAAE,CAAA;IAElE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACxE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAA;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAA;QACrC,OAAO,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAe;IAChE,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,OAAO;QACL,sBAAsB;QACtB,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,sJAAsJ;KACvJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAAoC;IAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,kCAAkC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9F,OAAO,cAAc,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,10 @@
+import type { ContextInputDefinition } from '../types.js';
+/**
+ * Serialize a single context block into a labeled prompt section.
+ */
+export declare function serializeContextBlock(key: string, definition: ContextInputDefinition, data: unknown): string;
+/**
+ * Serialize all context inputs into prompt sections, respecting budgets.
+ */
+export declare function serializeAllContext(definitions: Record<string, ContextInputDefinition>, data: Record<string, unknown>): string;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,sBAAsB,EAClC,IAAI,EAAE,OAAO,GACZ,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACnD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAWR"}

package/dist/core/context.js

@@ -0,0 +1,108 @@
+/**
+ * Serialize a single context block into a labeled prompt section.
+ */
+export function serializeContextBlock(key, definition, data) {
+    if (data == null)
+        return '';
+    const label = definition.label;
+    const format = definition.format ?? 'block';
+    let body;
+    const includeIds = definition.includeIds ?? false;
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            body = '(none)';
+        }
+        else {
+            body = formatArray(data, format, includeIds);
+        }
+    }
+    else if (typeof data === 'string') {
+        body = data;
+    }
+    else if (typeof data === 'object') {
+        body = formatObject(data, format);
+    }
+    else {
+        body = String(data);
+    }
+    // Apply budget if defined
+    if (definition.budget && body.length > definition.budget) {
+        body = body.slice(0, definition.budget) + '\n... (truncated to budget)';
+    }
+    const priority = definition.priority === 'critical' ? ' [CRITICAL]' : '';
+    const intentLine = definition.intent?.trim()
+        ? `Intent: ${definition.intent.trim()}\n`
+        : '';
+    return `--- ${label}${priority} ---\n${intentLine}${body}`;
+}
+/**
+ * Serialize all context inputs into prompt sections, respecting budgets.
+ */
+export function serializeAllContext(definitions, data) {
+    const blocks = [];
+    for (const [key, def] of Object.entries(definitions)) {
+        const value = data[key];
+        if (value == null)
+            continue;
+        const block = serializeContextBlock(key, def, value);
+        if (block)
+            blocks.push(block);
+    }
+    return blocks.join('\n\n');
+}
+function formatArray(items, format, includeIds = false) {
+    return items.map(item => {
+        if (typeof item === 'string')
+            return `- ${item}`;
+        if (typeof item === 'object' && item !== null) {
+            return formatObjectAsListItem(item, format, includeIds);
+        }
+        return `- ${String(item)}`;
+    }).join('\n');
+}
+function formatObjectAsListItem(obj, format, includeIds = false) {
+    if (format === 'kv') {
+        return Object.entries(obj)
+            .filter(([k]) => !includeIds || k !== 'id') // id shown as prefix when includeIds
+            .map(([k, v]) => `  ${k}: ${String(v)}`)
+            .join('\n');
+    }
+    // Default: try to build a sensible one-liner
+    const id = obj['id'] || obj['entityId'];
+    const title = obj['title'] || obj['name'] || obj['summary'] || obj['text'] || obj['what'] || obj['content'];
+    const status = obj['status'];
+    const extra = [];
+    for (const [k, v] of Object.entries(obj)) {
+        if (['id', 'entityId', 'title', 'name', 'summary', 'text', 'what', 'content', 'status'].includes(k))
+            continue;
+        if (v != null && v !== '') {
+            extra.push(`${k}=${typeof v === 'object' ? JSON.stringify(v) : String(v)}`);
+        }
+    }
+    let line = '- ';
+    if (includeIds && id) {
+        line += `(id:${id}) `;
+    }
+    if (status)
+        line += `[${status}] `;
+    if (title)
+        line += `${title}`;
+    if (!includeIds && id)
+        line += ` [${id}]`;
+    if (extra.length > 0)
+        line += ` — ${extra.join(', ')}`;
+    return line;
+}
+function formatObject(obj, format) {
+    if (format === 'kv') {
+        return Object.entries(obj)
+            .filter(([, v]) => v != null)
+            .map(([k, v]) => `${k}: ${typeof v === 'object' ? JSON.stringify(v) : String(v)}`)
+            .join('\n');
+    }
+    return Object.entries(obj)
+        .filter(([, v]) => v != null)
+        .map(([k, v]) => `- ${k}: ${typeof v === 'object' ? JSON.stringify(v) : String(v)}`)
+        .join('\n');
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/crud-prompt.d.ts

@@ -0,0 +1,16 @@
+import type { EntityConfig, PromptContractStyle, PromptMode } from '../types.js';
+import type { z } from 'zod';
+/**
+ * Convert any Zod schema to a compact human-readable description.
+ * Handles the full Zod type system: primitives, enums, arrays, objects,
+ * optionals, nullables, literals, and .describe() annotations.
+ *
+ * Same traversal pattern as zodToGeminiSchema but outputs text for prompts.
+ */
+export declare function zodToDescription(zodType: z.ZodType): string;
+/**
+ * Render the entities block for the system prompt.
+ * Includes entity definitions and CRUD format instructions.
+ */
+export declare function buildEntitiesBlock(entities: Record<string, EntityConfig>, promptMode?: PromptMode, contractStyle?: PromptContractStyle): string;
+//# sourceMappingURL=crud-prompt.d.ts.map

package/dist/core/crud-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-prompt.d.ts","sourceRoot":"","sources":["../../src/core/crud-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsI5B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAsF3D;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACtC,UAAU,GAAE,UAA2B,EACvC,aAAa,GAAE,mBAA4B,GAC1C,MAAM,CA6CR"}