@itaila/archetype 0.3.30

package/dist/engine/staging.d.ts

@@ -0,0 +1,29 @@
+import type { ParsedAction, ActionDefinition, StagedBatch, StagedActionStatus, BatchSummary } from '../types.js';
+import type { SideEffectHandler, SideEffectResult } from './side-effects.js';
+export interface BatchCommitResult {
+    results: SideEffectResult[];
+    summary: BatchSummary;
+}
+/**
+ * Create a staged batch from parsed actions.
+ * Validates each action against its definition — invalid/unknown actions are auto-rejected.
+ */
+export declare function createBatch(actions: ParsedAction[], actionDefs: Record<string, ActionDefinition>): StagedBatch;
+/**
+ * Update the status of a single action in the batch. Returns a new batch (immutable).
+ */
+export declare function updateActionStatus(batch: StagedBatch, index: number, status: StagedActionStatus): StagedBatch;
+/**
+ * Edit an action's params, re-validating against the schema. Returns a new batch.
+ * Throws if validation fails (caller surfaces as toast).
+ */
+export declare function editActionParams(batch: StagedBatch, index: number, newParams: Record<string, unknown>, actionDefs: Record<string, ActionDefinition>): StagedBatch;
+/**
+ * Commit all accepted actions in a batch by running their handlers sequentially.
+ */
+export declare function commitBatch(batch: StagedBatch, handlers: Record<string, SideEffectHandler>): Promise<BatchCommitResult>;
+/**
+ * Summarize a batch by status counts and labels.
+ */
+export declare function summarizeBatch(batch: StagedBatch): BatchSummary;
+//# sourceMappingURL=staging.d.ts.map

package/dist/engine/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../../src/engine/staging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAEhB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAG5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,YAAY,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC3C,WAAW,CA0Cb;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,kBAAkB,GACzB,WAAW,CASb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC3C,WAAW,CA2Bb;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC1C,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CA+B/D"}

package/dist/engine/staging.js

@@ -0,0 +1,159 @@
+import { buildAnnotations } from '../core/actions.js';
+/**
+ * Create a staged batch from parsed actions.
+ * Validates each action against its definition — invalid/unknown actions are auto-rejected.
+ */
+export function createBatch(actions, actionDefs) {
+    const stagedActions = actions.map((action, index) => {
+        // Unknown action name → rejected
+        const def = actionDefs[action.name];
+        if (!def) {
+            return {
+                index,
+                action,
+                validatedParams: action.params,
+                annotation: `Unknown action: ${action.name}`,
+                status: 'rejected',
+            };
+        }
+        // Validate params
+        const parseResult = def.schema.safeParse(action.params);
+        if (!parseResult.success) {
+            return {
+                index,
+                action,
+                validatedParams: action.params,
+                annotation: `Invalid params: ${parseResult.error.message}`,
+                status: 'rejected',
+            };
+        }
+        // Valid → pending
+        const annotations = buildAnnotations([{ name: action.name, params: action.params }]);
+        return {
+            index,
+            action,
+            validatedParams: parseResult.data,
+            annotation: annotations[0],
+            status: 'pending',
+        };
+    });
+    return {
+        id: crypto.randomUUID(),
+        actions: stagedActions,
+        createdAt: new Date().toISOString(),
+    };
+}
+/**
+ * Update the status of a single action in the batch. Returns a new batch (immutable).
+ */
+export function updateActionStatus(batch, index, status) {
+    if (index < 0 || index >= batch.actions.length) {
+        throw new RangeError(`Index ${index} out of bounds (batch has ${batch.actions.length} actions)`);
+    }
+    const newActions = batch.actions.map((a, i) => i === index ? { ...a, status } : a);
+    return { ...batch, actions: newActions };
+}
+/**
+ * Edit an action's params, re-validating against the schema. Returns a new batch.
+ * Throws if validation fails (caller surfaces as toast).
+ */
+export function editActionParams(batch, index, newParams, actionDefs) {
+    if (index < 0 || index >= batch.actions.length) {
+        throw new RangeError(`Index ${index} out of bounds (batch has ${batch.actions.length} actions)`);
+    }
+    const action = batch.actions[index];
+    const def = actionDefs[action.action.name];
+    if (!def) {
+        throw new Error(`Unknown action: ${action.action.name}`);
+    }
+    const parseResult = def.schema.safeParse(newParams);
+    if (!parseResult.success) {
+        throw new Error(`Invalid params for ${action.action.name}: ${parseResult.error.message}`);
+    }
+    const annotations = buildAnnotations([{ name: action.action.name, params: newParams }]);
+    const newActions = batch.actions.map((a, i) => i === index
+        ? {
+            ...a,
+            validatedParams: parseResult.data,
+            annotation: annotations[0],
+        }
+        : a);
+    return { ...batch, actions: newActions };
+}
+/**
+ * Commit all accepted actions in a batch by running their handlers sequentially.
+ */
+export async function commitBatch(batch, handlers) {
+    const results = [];
+    const accepted = batch.actions.filter(a => a.status === 'accepted');
+    for (const staged of accepted) {
+        const handler = handlers[staged.action.name];
+        if (!handler) {
+            results.push({
+                action: staged.action,
+                status: 'failed',
+                success: false,
+                error: `No handler registered for action: ${staged.action.name}`,
+                annotation: staged.annotation,
+            });
+            continue;
+        }
+        try {
+            const result = await handler(staged.validatedParams);
+            results.push({
+                action: staged.action,
+                status: result.success ? 'executed' : 'failed',
+                success: result.success,
+                error: result.error,
+                annotation: staged.annotation,
+            });
+        }
+        catch (err) {
+            results.push({
+                action: staged.action,
+                status: 'failed',
+                success: false,
+                error: `Handler error for ${staged.action.name}: ${err instanceof Error ? err.message : String(err)}`,
+                annotation: staged.annotation,
+            });
+        }
+    }
+    return {
+        results,
+        summary: summarizeBatch(batch),
+    };
+}
+/**
+ * Summarize a batch by status counts and labels.
+ */
+export function summarizeBatch(batch) {
+    let accepted = 0;
+    let rejected = 0;
+    let pending = 0;
+    const acceptedLabels = [];
+    const rejectedLabels = [];
+    for (const action of batch.actions) {
+        switch (action.status) {
+            case 'accepted':
+                accepted++;
+                acceptedLabels.push(action.annotation);
+                break;
+            case 'rejected':
+                rejected++;
+                rejectedLabels.push(action.annotation);
+                break;
+            case 'pending':
+                pending++;
+                break;
+        }
+    }
+    return {
+        total: batch.actions.length,
+        accepted,
+        rejected,
+        pending,
+        acceptedLabels,
+        rejectedLabels,
+    };
+}
+//# sourceMappingURL=staging.js.map

package/dist/engine/staging.js.map

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

package/dist/engine/working-set.d.ts

@@ -0,0 +1,18 @@
+import type { ActionDefinition, ParsedAction, PersonaConfig, WorkingSetReviewDecision, WorkingSet, WorkingSetSummary } from '../types.js';
+import type { SideEffectHandler, SideEffectResult } from './side-effects.js';
+export interface WorkingSetCommitResult {
+    workingSet: WorkingSet;
+    results: SideEffectResult[];
+    summary: WorkingSetSummary;
+}
+export interface ReviewWorkingSetDeltaInput {
+    deltaId: string;
+    decision: WorkingSetReviewDecision;
+}
+export declare function usesWorkingSet(config: PersonaConfig): boolean;
+export declare function buildWorkingSetSection(workingSet?: WorkingSet | null): string | null;
+export declare function summarizeWorkingSet(workingSet?: WorkingSet | null): WorkingSetSummary | undefined;
+export declare function reviewWorkingSetDelta(workingSet: WorkingSet, input: ReviewWorkingSetDeltaInput): WorkingSet;
+export declare function applyActionsToWorkingSet(existing: WorkingSet | null | undefined, actions: ParsedAction[], actionDefs: Record<string, ActionDefinition> | undefined): WorkingSet | undefined;
+export declare function commitWorkingSet(workingSet: WorkingSet, handlers: Record<string, SideEffectHandler>, deltaIds?: string[]): Promise<WorkingSetCommitResult>;
+//# sourceMappingURL=working-set.d.ts.map

package/dist/engine/working-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-set.d.ts","sourceRoot":"","sources":["../../src/engine/working-set.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EAGb,wBAAwB,EACxB,UAAU,EACV,iBAAiB,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAI5E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,wBAAwB,CAAA;CACnC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAwBpF;AAED,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAsBjG;AAYD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,0BAA0B,GAChC,UAAU,CAwCZ;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACvC,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,GACvD,UAAU,GAAG,SAAS,CAuFxB;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,sBAAsB,CAAC,CA4EjC"}

package/dist/engine/working-set.js

@@ -0,0 +1,246 @@
+import { buildAnnotations } from '../core/actions.js';
+import { MEMORY_ACTION_NAMES } from '../core/memory-actions.js';
+const REVIEWABLE_STATES = new Set(['accepted', 'pending']);
+export function usesWorkingSet(config) {
+    return config.staging?.model === 'working-set';
+}
+export function buildWorkingSetSection(workingSet) {
+    if (!workingSet)
+        return null;
+    const visible = workingSet.deltas.filter(delta => delta.reviewState === 'accepted' && delta.commitState !== 'committed');
+    if (visible.length === 0)
+        return null;
+    const lines = visible.map(delta => {
+        const commitLabel = delta.layer === 'transport'
+            ? delta.commitState === 'committed'
+                ? 'committed'
+                : 'accepted but not executed'
+            : 'current draft';
+        return `- ${delta.annotation} [${delta.layer}; ${commitLabel}]`;
+    });
+    return [
+        'CURRENT WORKING SET:',
+        'Accepted meaning-layer items are the current working truth of this conversation.',
+        'Accepted transport-layer items are approved within the conversation, but not executed externally unless explicitly committed.',
+        ...lines,
+        'Do not re-propose accepted items unless the user challenges them. Never claim a transport action already happened unless it is committed.',
+    ].join('\n');
+}
+export function summarizeWorkingSet(workingSet) {
+    if (!workingSet)
+        return undefined;
+    const summary = {
+        total: workingSet.deltas.length,
+        accepted: 0,
+        pending: 0,
+        rejected: 0,
+        superseded: 0,
+        ready: 0,
+        committed: 0,
+        failed: 0,
+    };
+    for (const delta of workingSet.deltas) {
+        summary[delta.reviewState]++;
+        if (delta.commitState === 'ready')
+            summary.ready++;
+        if (delta.commitState === 'committed')
+            summary.committed++;
+        if (delta.commitState === 'failed')
+            summary.failed++;
+    }
+    return summary;
+}
+function deriveReviewCommitState(delta, decision) {
+    if (delta.layer === 'transport') {
+        return decision === 'accept' ? 'ready' : 'not_required';
+    }
+    return 'not_required';
+}
+export function reviewWorkingSetDelta(workingSet, input) {
+    const index = workingSet.deltas.findIndex(delta => delta.id === input.deltaId);
+    if (index === -1) {
+        throw new Error(`Working-set delta not found: ${input.deltaId}`);
+    }
+    const current = workingSet.deltas[index];
+    if (current.reviewState === 'superseded') {
+        throw new Error(`Cannot review superseded delta: ${input.deltaId}`);
+    }
+    if (current.commitState === 'committed') {
+        throw new Error(`Cannot review committed delta: ${input.deltaId}`);
+    }
+    const nextReviewState = input.decision === 'accept' ? 'accepted' : 'rejected';
+    const nextCommitState = deriveReviewCommitState(current, input.decision);
+    if (current.reviewState === nextReviewState &&
+        current.commitState === nextCommitState &&
+        !current.error) {
+        return workingSet;
+    }
+    const now = new Date().toISOString();
+    const deltas = [...workingSet.deltas];
+    deltas[index] = {
+        ...current,
+        reviewState: nextReviewState,
+        commitState: nextCommitState,
+        updatedAt: now,
+        error: undefined,
+    };
+    return {
+        ...workingSet,
+        deltas,
+        updatedAt: now,
+    };
+}
+export function applyActionsToWorkingSet(existing, actions, actionDefs) {
+    if (!actionDefs || actions.length === 0) {
+        return existing ?? undefined;
+    }
+    const now = new Date().toISOString();
+    const base = existing ?? {
+        id: crypto.randomUUID(),
+        deltas: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+    let deltas = [...base.deltas];
+    let changed = false;
+    for (const action of actions) {
+        const def = actionDefs[action.name];
+        if (!def)
+            continue;
+        if (MEMORY_ACTION_NAMES.has(action.name))
+            continue;
+        const validated = def.schema.safeParse(action.params);
+        if (!validated.success)
+            continue;
+        const layer = def.layer ?? 'meaning';
+        const reviewState = def.defaultReviewState ?? 'accepted';
+        const commitMode = def.commitMode ?? (layer === 'transport' ? 'explicit' : 'not_required');
+        if (commitMode === 'immediate')
+            continue;
+        const targetKey = def.targetKey?.(validated.data) ?? null;
+        let supersededId;
+        if (targetKey) {
+            deltas = deltas.map(delta => {
+                if (delta.targetKey === targetKey &&
+                    REVIEWABLE_STATES.has(delta.reviewState) &&
+                    delta.commitState !== 'committed') {
+                    supersededId = delta.id;
+                    changed = true;
+                    return {
+                        ...delta,
+                        reviewState: 'superseded',
+                        updatedAt: now,
+                    };
+                }
+                return delta;
+            });
+        }
+        const annotation = buildAnnotations([{ name: action.name, params: validated.data }])[0];
+        const commitState = commitMode === 'explicit'
+            ? (reviewState === 'accepted' ? 'ready' : 'not_required')
+            : commitMode === 'committed'
+                ? 'committed'
+                : commitMode === 'failed'
+                    ? 'failed'
+                    : 'not_required';
+        const delta = {
+            id: crypto.randomUUID(),
+            action,
+            validatedParams: validated.data,
+            annotation,
+            layer,
+            reviewState,
+            commitState,
+            targetKey,
+            supersedes: supersededId,
+            createdAt: now,
+            updatedAt: now,
+        };
+        deltas.push(delta);
+        changed = true;
+    }
+    if (!changed)
+        return existing ?? undefined;
+    return {
+        ...base,
+        deltas,
+        updatedAt: now,
+    };
+}
+export async function commitWorkingSet(workingSet, handlers, deltaIds) {
+    const allowed = deltaIds ? new Set(deltaIds) : null;
+    const results = [];
+    const now = new Date().toISOString();
+    const deltas = [...workingSet.deltas];
+    for (let i = 0; i < deltas.length; i++) {
+        const delta = deltas[i];
+        if (delta.layer !== 'transport')
+            continue;
+        if (delta.reviewState !== 'accepted')
+            continue;
+        if (delta.commitState !== 'ready')
+            continue;
+        if (allowed && !allowed.has(delta.id))
+            continue;
+        const handler = handlers[delta.action.name];
+        if (!handler) {
+            deltas[i] = {
+                ...delta,
+                commitState: 'failed',
+                updatedAt: now,
+                error: `No handler registered for action: ${delta.action.name}`,
+            };
+            results.push({
+                action: delta.action,
+                status: 'failed',
+                success: false,
+                error: `No handler registered for action: ${delta.action.name}`,
+                annotation: delta.annotation,
+            });
+            continue;
+        }
+        try {
+            const outcome = await handler(delta.validatedParams);
+            deltas[i] = {
+                ...delta,
+                commitState: outcome.success ? 'committed' : 'failed',
+                updatedAt: now,
+                error: outcome.error,
+            };
+            results.push({
+                action: delta.action,
+                status: outcome.success ? 'executed' : 'failed',
+                success: outcome.success,
+                error: outcome.error,
+                annotation: delta.annotation,
+            });
+        }
+        catch (err) {
+            const message = `Handler error for ${delta.action.name}: ${err instanceof Error ? err.message : String(err)}`;
+            deltas[i] = {
+                ...delta,
+                commitState: 'failed',
+                updatedAt: now,
+                error: message,
+            };
+            results.push({
+                action: delta.action,
+                status: 'failed',
+                success: false,
+                error: message,
+                annotation: delta.annotation,
+            });
+        }
+    }
+    const nextWorkingSet = {
+        ...workingSet,
+        deltas,
+        updatedAt: now,
+    };
+    return {
+        workingSet: nextWorkingSet,
+        results,
+        summary: summarizeWorkingSet(nextWorkingSet),
+    };
+}
+//# sourceMappingURL=working-set.js.map

package/dist/engine/working-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-set.js","sourceRoot":"","sources":["../../src/engine/working-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAa/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC,CAAA;AAanE,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,OAAO,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,aAAa,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAA8B;IACnE,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAE5B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CACtC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAC/E,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAErC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,KAAK,WAAW;YAC7C,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW;gBACjC,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,2BAA2B;YAC/B,CAAC,CAAC,eAAe,CAAA;QACnB,OAAO,KAAK,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,KAAK,WAAW,GAAG,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,sBAAsB;QACtB,kFAAkF;QAClF,+HAA+H;QAC/H,GAAG,KAAK;QACR,2IAA2I;KAC5I,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IAChE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IAEjC,MAAM,OAAO,GAAsB;QACjC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM;QAC/B,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC;KACV,CAAA;IAED,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAA;QAC5B,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO;YAAE,OAAO,CAAC,KAAK,EAAE,CAAA;QAClD,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW;YAAE,OAAO,CAAC,SAAS,EAAE,CAAA;QAC1D,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ;YAAE,OAAO,CAAC,MAAM,EAAE,CAAA;IACtD,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAmB,EACnB,QAAkC;IAElC,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAA;IACzD,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAsB,EACtB,KAAiC;IAEjC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9E,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,OAAO,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IAC7E,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IAExE,IACE,OAAO,CAAC,WAAW,KAAK,eAAe;QACvC,OAAO,CAAC,WAAW,KAAK,eAAe;QACvC,CAAC,OAAO,CAAC,KAAK,EACd,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,CAAC,KAAK,CAAC,GAAG;QACd,GAAG,OAAO;QACV,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,eAAe;QAC5B,SAAS,EAAE,GAAG;QACd,KAAK,EAAE,SAAS;KACjB,CAAA;IAED,OAAO;QACL,GAAG,UAAU;QACb,MAAM;QACN,SAAS,EAAE,GAAG;KACf,CAAA;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAuC,EACvC,OAAuB,EACvB,UAAwD;IAExD,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,QAAQ,IAAI,SAAS,CAAA;IAC9B,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,IAAI,GAAe,QAAQ,IAAI;QACnC,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAA;IAED,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG;YAAE,SAAQ;QAClB,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,SAAQ;QAElD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACrD,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE,SAAQ;QAEhC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,SAAS,CAAA;QACpC,MAAM,WAAW,GAAG,GAAG,CAAC,kBAAkB,IAAI,UAAU,CAAA;QACxD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAA;QAE1F,IAAI,UAAU,KAAK,WAAW;YAAE,SAAQ;QAExC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,IAA+B,CAAC,IAAI,IAAI,CAAA;QACpF,IAAI,YAAgC,CAAA;QAEpC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;gBAC1B,IACE,KAAK,CAAC,SAAS,KAAK,SAAS;oBAC7B,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAqC,CAAC;oBAClE,KAAK,CAAC,WAAW,KAAK,WAAW,EACjC,CAAC;oBACD,YAAY,GAAG,KAAK,CAAC,EAAE,CAAA;oBACvB,OAAO,GAAG,IAAI,CAAA;oBACd,OAAO;wBACL,GAAG,KAAK;wBACR,WAAW,EAAE,YAAqB;wBAClC,SAAS,EAAE,GAAG;qBACf,CAAA;gBACH,CAAC;gBACD,OAAO,KAAK,CAAA;YACd,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,IAA+B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAClH,MAAM,WAAW,GACf,UAAU,KAAK,UAAU;YACvB,CAAC,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;YACzD,CAAC,CAAC,UAAU,KAAK,WAAW;gBAC1B,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,UAAU,KAAK,QAAQ;oBACvB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,cAAc,CAAA;QAExB,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,MAAM;YACN,eAAe,EAAE,SAAS,CAAC,IAA+B;YAC1D,UAAU;YACV,KAAK;YACL,WAAW;YACX,WAAW;YACX,SAAS;YACT,UAAU,EAAE,YAAY;YACxB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAA;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClB,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,QAAQ,IAAI,SAAS,CAAA;IAE1C,OAAO;QACL,GAAG,IAAI;QACP,MAAM;QACN,SAAS,EAAE,GAAG;KACf,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAsB,EACtB,QAA2C,EAC3C,QAAmB;IAEnB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACnD,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW;YAAE,SAAQ;QACzC,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU;YAAE,SAAQ;QAC9C,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO;YAAE,SAAQ;QAC3C,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,SAAQ;QAE/C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,CAAC,CAAC,GAAG;gBACV,GAAG,KAAK;gBACR,WAAW,EAAE,QAAQ;gBACrB,SAAS,EAAE,GAAG;gBACd,KAAK,EAAE,qCAAqC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;aAChE,CAAA;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,qCAAqC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC/D,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;YACpD,MAAM,CAAC,CAAC,CAAC,GAAG;gBACV,GAAG,KAAK;gBACR,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;gBACrD,SAAS,EAAE,GAAG;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAA;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;gBAC/C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,qBAAqB,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;YAC7G,MAAM,CAAC,CAAC,CAAC,GAAG;gBACV,GAAG,KAAK;gBACR,WAAW,EAAE,QAAQ;gBACrB,SAAS,EAAE,GAAG;gBACd,KAAK,EAAE,OAAO;aACf,CAAA;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAe;QACjC,GAAG,UAAU;QACb,MAAM;QACN,SAAS,EAAE,GAAG;KACf,CAAA;IAED,OAAO;QACL,UAAU,EAAE,cAAc;QAC1B,OAAO;QACP,OAAO,EAAE,mBAAmB,CAAC,cAAc,CAAE;KAC9C,CAAA;AACH,CAAC"}

package/dist/evals/action-contracts.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Action & entity contract auditor — catches the "malformed tool call" pattern
+ * at its real source: ambiguous contracts.
+ *
+ * When an AI emits a malformed or wrong-shaped action, the instinct is to
+ * assume the AI is "dumb" and add validation/boxing in code. The AI is as
+ * capable as the engineer — the problem is almost always that the contract
+ * (name + schema + description + field describe() annotations) didn't
+ * clearly tell it what the action represents.
+ *
+ * This audit flags the specific shapes that force the AI to guess:
+ *  - Generic action/entity names (data, handle, process, update, etc.)
+ *  - Self-documenting names with long descriptions that restate the name
+ *  - Vague schemas (any types, untyped strings that should be enums, etc.)
+ *  - Missing field descriptions on non-obvious fields
+ *  - Fights between name/description (e.g., name says "send", description says "draft")
+ */
+import type { PersonaConfig } from '../types.js';
+export interface ActionContractAuditInput {
+    config: PersonaConfig;
+}
+export interface ActionContractIssue {
+    severity: 'error' | 'warn';
+    /** 'action' or 'entity'. */
+    surface: 'action' | 'entity';
+    /** The action or entity name. */
+    name: string;
+    /** Which aspect of the contract is unclear. */
+    principle: 'generic-name' | 'self-documenting-overdocumented' | 'missing-description' | 'missing-field-description' | 'vague-schema-type' | 'name-description-conflict';
+    /** Concrete explanation. */
+    message: string;
+    /** Suggested fix. */
+    suggestion: string;
+}
+export interface ActionContractAuditResult {
+    pass: boolean;
+    issues: ActionContractIssue[];
+}
+export declare function auditActionContracts(input: ActionContractAuditInput): ActionContractAuditResult;
+//# sourceMappingURL=action-contracts.d.ts.map

package/dist/evals/action-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-contracts.d.ts","sourceRoot":"","sources":["../../src/evals/action-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,aAAa,CAAA;AAGhF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,4BAA4B;IAC5B,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,SAAS,EACL,cAAc,GACd,iCAAiC,GACjC,qBAAqB,GACrB,2BAA2B,GAC3B,mBAAmB,GACnB,2BAA2B,CAAA;IAC/B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAC9B;AAoBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,wBAAwB,GAAG,yBAAyB,CAgB/F"}