@cleocode/contracts 2026.5.122 → 2026.5.123

package/dist/operation-envelope-validation.js

@@ -0,0 +1,219 @@
+/**
+ * Operation-aware LAFS envelope validation.
+ *
+ * The base LAFS shape proves that an envelope is structurally valid. This
+ * module adds the dispatch-layer contract checks that require `_meta.operation`
+ * to resolve to a registered CLEO operation and, when a result schema is known,
+ * validates successful payloads against that operation's result contract.
+ *
+ * @task T10610
+ * @saga T10538
+ */
+import { OPERATIONS } from './dispatch/operations-registry.js';
+import { tasksFrontierResultSchema, tasksRollupResultSchema, tasksTraverseResultSchema, tasksTreeResultSchema, tasksWorkGraphAuditResultSchema, } from './workgraph.js';
+/** Stable issue code emitted when `_meta.operation` is absent or unknown. */
+export const E_LAFS_OPERATION_UNREGISTERED = 'E_LAFS_OPERATION_UNREGISTERED';
+/** Stable issue code emitted when an operation result fails its contract schema. */
+export const E_LAFS_OPERATION_RESULT_SCHEMA = 'E_LAFS_OPERATION_RESULT_SCHEMA';
+/** Stable issue code emitted when success/error envelope invariants are violated. */
+export const E_LAFS_OPERATION_ERROR_SHAPE = 'E_LAFS_OPERATION_ERROR_SHAPE';
+/** Canonical result schemas currently promoted to operation-aware LAFS validation. */
+export const OPERATION_RESULT_SCHEMAS = new Map([
+    ['tasks.traverse', tasksTraverseResultSchema],
+    ['tasks.tree', tasksTreeResultSchema],
+    ['tasks.rollup', tasksRollupResultSchema],
+    ['tasks.frontier', tasksFrontierResultSchema],
+    ['tasks.workgraph.audit', tasksWorkGraphAuditResultSchema],
+]);
+const LAFS_SCHEMA_URL = 'https://lafs.dev/schemas/v1/envelope.schema.json';
+const LAFS_TRANSPORTS = new Set(['cli', 'http', 'grpc', 'sdk']);
+const LAFS_MVI_LEVELS = new Set(['minimal', 'standard', 'full', 'custom']);
+const LAFS_ERROR_CATEGORIES = new Set([
+    'VALIDATION',
+    'AUTH',
+    'PERMISSION',
+    'NOT_FOUND',
+    'CONFLICT',
+    'RATE_LIMIT',
+    'TRANSIENT',
+    'INTERNAL',
+    'CONTRACT',
+    'MIGRATION',
+]);
+function issue(path, message, keyword = 'type') {
+    return { path, code: `LAFS_SCHEMA_${keyword.toUpperCase()}`, keyword, message };
+}
+function isRecord(input) {
+    return typeof input === 'object' && input !== null && !Array.isArray(input);
+}
+function validateBaseLafsEnvelope(input) {
+    if (!isRecord(input))
+        return [issue('/', 'LAFS envelope must be an object')];
+    const issues = [];
+    if (input.$schema !== LAFS_SCHEMA_URL) {
+        issues.push(issue('/$schema', `must equal ${LAFS_SCHEMA_URL}`, 'const'));
+    }
+    if (!isRecord(input._meta)) {
+        issues.push(issue('/_meta', 'must be an object'));
+    }
+    else {
+        const meta = input._meta;
+        for (const field of ['specVersion', 'schemaVersion', 'timestamp', 'operation', 'requestId']) {
+            if (typeof meta[field] !== 'string' || meta[field].length === 0) {
+                issues.push(issue(`/_meta/${field}`, 'must be a non-empty string'));
+            }
+        }
+        if (typeof meta.transport !== 'string' ||
+            !LAFS_TRANSPORTS.has(meta.transport)) {
+            issues.push(issue('/_meta/transport', 'must be a valid LAFS transport', 'enum'));
+        }
+        if (typeof meta.strict !== 'boolean') {
+            issues.push(issue('/_meta/strict', 'must be a boolean'));
+        }
+        if (typeof meta.mvi !== 'string' || !LAFS_MVI_LEVELS.has(meta.mvi)) {
+            issues.push(issue('/_meta/mvi', 'must be a valid LAFS MVI level', 'enum'));
+        }
+        if (!Number.isInteger(meta.contextVersion) || Number(meta.contextVersion) < 0) {
+            issues.push(issue('/_meta/contextVersion', 'must be a non-negative integer'));
+        }
+    }
+    if (typeof input.success !== 'boolean') {
+        issues.push(issue('/success', 'must be a boolean'));
+    }
+    if (!('result' in input)) {
+        issues.push(issue('/result', 'is required', 'required'));
+    }
+    else if (input.result !== null && !isRecord(input.result) && !Array.isArray(input.result)) {
+        issues.push(issue('/result', 'must be an object, array, or null'));
+    }
+    if (input.error !== null && input.error !== undefined) {
+        if (!isRecord(input.error)) {
+            issues.push(issue('/error', 'must be an object or null'));
+        }
+        else {
+            const error = input.error;
+            if (typeof error.code !== 'string' || error.code.length === 0) {
+                issues.push(issue('/error/code', 'must be a non-empty string'));
+            }
+            if (typeof error.message !== 'string' || error.message.length === 0) {
+                issues.push(issue('/error/message', 'must be a non-empty string'));
+            }
+            if (typeof error.category !== 'string' ||
+                !LAFS_ERROR_CATEGORIES.has(error.category)) {
+                issues.push(issue('/error/category', 'must be a valid LAFS error category', 'enum'));
+            }
+            if (typeof error.retryable !== 'boolean') {
+                issues.push(issue('/error/retryable', 'must be a boolean'));
+            }
+            if (error.retryAfterMs !== null &&
+                error.retryAfterMs !== undefined &&
+                (!Number.isInteger(error.retryAfterMs) || Number(error.retryAfterMs) < 0)) {
+                issues.push(issue('/error/retryAfterMs', 'must be a non-negative integer or null'));
+            }
+            if (!isRecord(error.details)) {
+                issues.push(issue('/error/details', 'must be an object'));
+            }
+        }
+    }
+    return issues;
+}
+function pointer(path) {
+    if (path.length === 0)
+        return '/result';
+    return `/result/${path
+        .map((segment) => String(segment).split('~').join('~0').split('/').join('~1'))
+        .join('/')}`;
+}
+function resolveOperation(operationName, operations) {
+    return operations.find((candidate) => `${candidate.domain}.${candidate.operation}` === operationName);
+}
+function hasCanonicalSuccessShape(envelope) {
+    if (envelope.success) {
+        if (envelope.result === null) {
+            return [
+                {
+                    path: '/result',
+                    code: E_LAFS_OPERATION_ERROR_SHAPE,
+                    message: 'successful LAFS envelopes must include a non-null result payload',
+                },
+            ];
+        }
+        if (envelope.error !== null && envelope.error !== undefined) {
+            return [
+                {
+                    path: '/error',
+                    code: E_LAFS_OPERATION_ERROR_SHAPE,
+                    message: 'successful LAFS envelopes must not include an error payload',
+                },
+            ];
+        }
+        return [];
+    }
+    const issues = [];
+    if (envelope.error === null || envelope.error === undefined) {
+        issues.push({
+            path: '/error',
+            code: E_LAFS_OPERATION_ERROR_SHAPE,
+            message: 'failed LAFS envelopes must include the canonical error payload',
+        });
+    }
+    if (envelope.result !== null) {
+        issues.push({
+            path: '/result',
+            code: E_LAFS_OPERATION_ERROR_SHAPE,
+            message: 'failed LAFS envelopes must set result to null',
+        });
+    }
+    return issues;
+}
+/**
+ * Validate a LAFS envelope against the dispatch operation registry and known
+ * operation result contracts.
+ */
+export function validateOperationEnvelope(input, options = {}) {
+    const issues = validateBaseLafsEnvelope(input);
+    if (issues.length > 0) {
+        return {
+            valid: false,
+            envelopeValid: false,
+            issues,
+            errors: issues.map((issue) => `${issue.path} ${issue.message}`.trim()),
+        };
+    }
+    const envelope = input;
+    const operationName = envelope._meta.operation;
+    const operations = options.operations ?? OPERATIONS;
+    const resultSchemas = options.resultSchemas ?? OPERATION_RESULT_SCHEMAS;
+    const operation = resolveOperation(operationName, operations);
+    if (operation === undefined) {
+        issues.push({
+            path: '/_meta/operation',
+            code: E_LAFS_OPERATION_UNREGISTERED,
+            message: `unknown LAFS operation '${operationName}'`,
+        });
+    }
+    issues.push(...hasCanonicalSuccessShape(envelope));
+    const schema = resultSchemas.get(operationName);
+    if (envelope.success && schema !== undefined && envelope.result !== null) {
+        const parsed = schema.safeParse(envelope.result);
+        if (!parsed.success) {
+            for (const zodIssue of parsed.error.issues) {
+                issues.push({
+                    path: pointer(zodIssue.path),
+                    code: E_LAFS_OPERATION_RESULT_SCHEMA,
+                    keyword: zodIssue.code,
+                    message: zodIssue.message,
+                });
+            }
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        envelopeValid: true,
+        operation,
+        resultSchemaOperation: schema === undefined ? undefined : operationName,
+        issues,
+        errors: issues.map((issue) => `${issue.path} ${issue.message}`.trim()),
+    };
+}
+//# sourceMappingURL=operation-envelope-validation.js.map

package/dist/operation-envelope-validation.js.map

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

package/dist/operations/__tests__/agent-operation-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-operation-contract.test.d.ts.map

package/dist/operations/__tests__/agent-operation-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-operation-contract.test.d.ts","sourceRoot":"","sources":["../../../src/operations/__tests__/agent-operation-contract.test.ts"],"names":[],"mappings":""}

package/dist/operations/__tests__/agent-operation-contract.test.js

@@ -0,0 +1,128 @@
+/**
+ * Tests for T10555 — agent operation contract doctrine.
+ */
+import { describe, expect, it } from 'vitest';
+import { AGENT_OPERATION_CONTRACT_DOCTRINE, } from '../agent-operation-contract.js';
+const session = {
+    executionSessionId: 'ses_worker_1',
+    originSessionId: 'ses_orchestrator_1',
+};
+describe('AgentMutationResult doctrine', () => {
+    it('standardizes mutation result shape with status, ok, data, items, summary, issues, and session', () => {
+        const result = {
+            status: 'success',
+            ok: true,
+            data: { taskIds: ['T1'] },
+            items: [
+                {
+                    id: 'T1',
+                    effect: 'applied',
+                    item: { title: 'ship contract' },
+                    issues: [],
+                },
+            ],
+            summary: {
+                requested: 1,
+                applied: 1,
+                planned: 0,
+                skipped: 0,
+                failed: 0,
+            },
+            issues: [],
+            session,
+        };
+        expect(result).toMatchObject({
+            status: 'success',
+            ok: true,
+            data: { taskIds: ['T1'] },
+            summary: { requested: 1, applied: 1, planned: 0, skipped: 0, failed: 0 },
+            session,
+        });
+        expect(AGENT_OPERATION_CONTRACT_DOCTRINE.mutationStatuses).toEqual([
+            'success',
+            'partial_success',
+            'empty',
+            'dry_run',
+            'failed',
+        ]);
+    });
+    it('defines partial-success as durable writes plus skipped or failed items', () => {
+        const result = {
+            status: 'partial_success',
+            ok: true,
+            data: { taskIds: ['T1'] },
+            items: [
+                { id: 'T1', effect: 'applied', item: { title: 'applied' }, issues: [] },
+                {
+                    id: 'T2',
+                    effect: 'failed',
+                    item: { title: 'rejected' },
+                    issues: [
+                        { code: 'E_TASK_LOCKED', severity: 'error', message: 'Task is locked', target: 'T2' },
+                    ],
+                },
+            ],
+            summary: {
+                requested: 2,
+                applied: 1,
+                planned: 0,
+                skipped: 0,
+                failed: 1,
+            },
+            issues: [
+                { code: 'E_TASK_LOCKED', severity: 'error', message: 'Task is locked', target: 'T2' },
+            ],
+            session,
+        };
+        expect(result.status).toBe(AGENT_OPERATION_CONTRACT_DOCTRINE.partialSuccess.status);
+        expect(result.summary.applied).toBeGreaterThanOrEqual(AGENT_OPERATION_CONTRACT_DOCTRINE.partialSuccess.requiresAppliedMinimum);
+        expect(result.summary.failed + result.summary.skipped).toBeGreaterThanOrEqual(AGENT_OPERATION_CONTRACT_DOCTRINE.partialSuccess.requiresRejectedOrSkippedMinimum);
+        expect(AGENT_OPERATION_CONTRACT_DOCTRINE.partialSuccess.inspect).toEqual(['items', 'issues']);
+    });
+    it('distinguishes executionSessionId from originSessionId for delegated operation lineage', () => {
+        expect(session.executionSessionId).toBe('ses_worker_1');
+        expect(session.originSessionId).toBe('ses_orchestrator_1');
+        expect(AGENT_OPERATION_CONTRACT_DOCTRINE.sessionLineage.executionSessionId).toContain('executed');
+        expect(AGENT_OPERATION_CONTRACT_DOCTRINE.sessionLineage.originSessionId).toContain('originated');
+    });
+    it('defines typed empty-state and dry-run semantics', () => {
+        const emptyState = {
+            code: 'EMPTY_NO_CANDIDATES',
+            reason: 'No candidate tasks matched the mutation filter.',
+            nextAction: 'Create or select a task before retrying.',
+        };
+        const dryRun = {
+            enabled: true,
+            plannedWrites: 2,
+            appliedWrites: 0,
+        };
+        const emptyResult = {
+            status: 'empty',
+            ok: true,
+            data: { taskIds: [] },
+            items: [],
+            summary: { requested: 0, applied: 0, planned: 0, skipped: 0, failed: 0 },
+            issues: [],
+            session,
+            emptyState,
+        };
+        const dryRunResult = {
+            status: 'dry_run',
+            ok: true,
+            data: { taskIds: ['T1', 'T2'] },
+            items: [
+                { id: 'T1', effect: 'planned', item: { title: 'preview one' }, issues: [] },
+                { id: 'T2', effect: 'planned', item: { title: 'preview two' }, issues: [] },
+            ],
+            summary: { requested: 2, applied: 0, planned: 2, skipped: 0, failed: 0 },
+            issues: [],
+            session,
+            dryRun,
+        };
+        expect(emptyResult.emptyState).toEqual(emptyState);
+        expect(dryRunResult.dryRun).toEqual(dryRun);
+        expect(dryRunResult.items.every((item) => item.effect === 'planned')).toBe(true);
+        expect(dryRunResult.summary.applied).toBe(AGENT_OPERATION_CONTRACT_DOCTRINE.dryRun.appliedWrites);
+    });
+});
+//# sourceMappingURL=agent-operation-contract.test.js.map

package/dist/operations/__tests__/agent-operation-contract.test.js.map

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

package/dist/operations/__tests__/tasks-input-contracts.test.js

@@ -53,6 +53,21 @@ describe('tasksAddBatchInputContract', () => {
     it('rejects unknown root-level fields via additionalProperties: false', () => {
         expect(tasksAddBatchInputContract.schema['additionalProperties']).toBe(false);
     });
+    it('keeps labels and acceptance canonical as arrays in the add-batch schema', () => {
+        const schema = tasksAddBatchInputContract.schema;
+        const entryProperties = schema.properties.tasks.items.properties;
+        expect(entryProperties.labels).toMatchObject({ type: 'array', items: { type: 'string' } });
+        expect(entryProperties.labels['x-fix-hint']).toContain('JSON array');
+        expect(entryProperties.acceptance).toMatchObject({ type: 'array', items: { type: 'string' } });
+        expect(entryProperties.acceptance['x-fix-hint']).toContain('not a pipe-delimited string');
+    });
+    it('ships add-batch examples with canonical labels and acceptance arrays', () => {
+        const withArrays = tasksAddBatchInputContract.examples.find((ex) => ex.name === 'two-tasks');
+        expect(withArrays).toBeDefined();
+        const firstTask = withArrays?.value.tasks[0];
+        expect(Array.isArray(firstTask?.labels)).toBe(true);
+        expect(Array.isArray(firstTask?.acceptance)).toBe(true);
+    });
     it('exports the raw schema constant for re-use', () => {
         expect(TASKS_ADD_BATCH_INPUT_SCHEMA).toBe(tasksAddBatchInputContract.schema);
     });

package/dist/operations/__tests__/tasks-input-contracts.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks-input-contracts.test.js","sourceRoot":"","sources":["../../../src/operations/__tests__/tasks-input-contracts.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks-input-contracts.test.js","sourceRoot":"","sources":["../../../src/operations/__tests__/tasks-input-contracts.test.ts"],"names":[],"mappings":"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"}

package/dist/operations/agent-operation-contract.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Agent operation contract doctrine for CLEO PM Core V2.
+ *
+ * The types in this module define the canonical result envelope for agent-facing
+ * mutate operations. They intentionally live in `@cleocode/contracts` so core
+ * implementations, CLI renderers, and validators share one vocabulary for
+ * success, partial success, dry-run previews, empty states, and session lineage.
+ *
+ * @task T10555 — E1.W0 Define agent operation contract doctrine.
+ */
+/**
+ * Canonical mutation result status for agent operation outputs.
+ *
+ * `partial_success` is a terminal success state with one or more durable writes
+ * and one or more rejected or skipped items. `empty` and `dry_run` are typed
+ * non-mutating states rather than ad-hoc empty arrays or prose-only messages.
+ */
+export type AgentMutationStatus = 'success' | 'partial_success' | 'empty' | 'dry_run' | 'failed';
+/**
+ * Per-item mutation effect recorded by an agent operation.
+ *
+ * `planned` is reserved for dry-run previews. `skipped` is a deliberate no-op
+ * such as an already-satisfied request or an empty-state guard. `failed` means
+ * the item did not mutate and MUST be paired with an issue entry.
+ */
+export type AgentMutationEffect = 'applied' | 'planned' | 'skipped' | 'failed';
+/**
+ * Machine-readable issue severity for mutation diagnostics.
+ */
+export type AgentOperationIssueSeverity = 'info' | 'warning' | 'error';
+/**
+ * Session lineage attached to every agent operation result.
+ */
+export interface AgentOperationSessionLineage {
+    /**
+     * Session that executed this operation attempt.
+     *
+     * For delegated workers this is the worker/current runtime session. For a
+     * resumed or handoff execution it changes to the session that actually ran
+     * the command. It MUST NOT be used to infer who originally requested the work.
+     */
+    executionSessionId: string;
+    /**
+     * Session that originated the intent being carried by this operation.
+     *
+     * For direct calls it usually equals `executionSessionId`. For delegated,
+     * resumed, or handoff work it remains the orchestrator/lead session that
+     * created the intent so audit trails can stitch execution back to origin.
+     */
+    originSessionId: string;
+}
+/**
+ * A typed empty-state explanation for operations that have no rows to return or
+ * no candidate records to mutate.
+ */
+export interface AgentOperationEmptyState {
+    /** Stable empty-state code, suitable for tests and renderers. */
+    code: string;
+    /** Human-readable reason the operation had no applicable records. */
+    reason: string;
+    /** Optional next action for callers that need to create prerequisite data. */
+    nextAction?: string;
+}
+/**
+ * Dry-run metadata for operations that preview mutations without writing.
+ */
+export interface AgentOperationDryRun {
+    /** Always true when the operation is a dry-run preview. */
+    enabled: true;
+    /** Number of writes that would have been attempted outside dry-run mode. */
+    plannedWrites: number;
+    /** Number of durable writes performed during the dry run; MUST be zero. */
+    appliedWrites: 0;
+}
+/**
+ * Machine-readable operation issue attached to rejected, skipped, or failed
+ * records and to whole-operation validation failures.
+ */
+export interface AgentOperationIssue {
+    /** Stable diagnostic code such as `E_TASK_NOT_FOUND`. */
+    code: string;
+    /** Severity for rendering and gate decisions. */
+    severity: AgentOperationIssueSeverity;
+    /** Human-readable diagnostic message. */
+    message: string;
+    /** Optional record identifier or logical path associated with the issue. */
+    target?: string;
+}
+/**
+ * Per-item outcome for a mutation request.
+ */
+export interface AgentMutationItem<TItem> {
+    /** Stable item identifier from the request or resulting domain row. */
+    id: string;
+    /** Effect observed for this item. */
+    effect: AgentMutationEffect;
+    /** Domain-specific item payload after applying, planning, or skipping. */
+    item: TItem;
+    /** Issues associated with this item, if any. */
+    issues: AgentOperationIssue[];
+}
+/**
+ * Counts that summarize a mutation operation without consumers inspecting every
+ * item. Counts MUST match `items` and `issues` for contract-backed outputs.
+ */
+export interface AgentMutationSummary {
+    /** Number of requested mutation targets. */
+    requested: number;
+    /** Number of durable item writes. */
+    applied: number;
+    /** Number of planned item writes in dry-run mode. */
+    planned: number;
+    /** Number of deliberate no-op items. */
+    skipped: number;
+    /** Number of item-level failures. */
+    failed: number;
+}
+/**
+ * Shared fields present on every agent-facing mutation result.
+ */
+export interface AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for renderer and validator behavior. */
+    status: AgentMutationStatus;
+    /** True for `success`, `partial_success`, `empty`, and `dry_run`; false for `failed`. */
+    ok: boolean;
+    /** Domain-specific aggregate payload. */
+    data: TData;
+    /** Per-item mutation outcomes. */
+    items: AgentMutationItem<TItem>[];
+    /** Count summary derived from `items`. */
+    summary: AgentMutationSummary;
+    /** Whole-operation and item-level diagnostics. */
+    issues: AgentOperationIssue[];
+    /** Execution and origin session lineage for audit stitching. */
+    session: AgentOperationSessionLineage;
+}
+/**
+ * Successful mutation result where all requested mutations were durably applied.
+ */
+export interface AgentMutationSuccessResult<TData, TItem> extends AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for all-applied success. */
+    status: 'success';
+    /** Success results are agent-safe. */
+    ok: true;
+}
+/**
+ * Partial-success mutation result.
+ *
+ * At least one item was durably applied and at least one item was skipped or
+ * failed; callers MUST inspect `items` and `issues` before assuming the whole
+ * request completed.
+ */
+export interface AgentMutationPartialSuccessResult<TData, TItem> extends AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for durable writes plus rejected/skipped items. */
+    status: 'partial_success';
+    /** Partial success is still a successful operation attempt. */
+    ok: true;
+}
+/**
+ * Typed empty-state mutation result.
+ *
+ * No mutation candidates existed; `emptyState` is required so renderers and
+ * agents do not infer meaning from an untyped empty array.
+ */
+export interface AgentMutationEmptyResult<TData, TItem> extends AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for no candidate records. */
+    status: 'empty';
+    /** Empty is a handled non-error state. */
+    ok: true;
+    /** Required typed empty-state explanation. */
+    emptyState: AgentOperationEmptyState;
+}
+/**
+ * Dry-run mutation result.
+ *
+ * No durable writes occurred; `dryRun` is required and mutating items MUST use
+ * the `planned` effect rather than `applied`.
+ */
+export interface AgentMutationDryRunResult<TData, TItem> extends AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for preview-only execution. */
+    status: 'dry_run';
+    /** Dry-run is a successful preview operation. */
+    ok: true;
+    /** Required dry-run write accounting. */
+    dryRun: AgentOperationDryRun;
+}
+/**
+ * Failed mutation result where no requested mutation was durably applied.
+ */
+export interface AgentMutationFailedResult<TData, TItem> extends AgentMutationResultBase<TData, TItem> {
+    /** Discriminating status for failed mutation attempts. */
+    status: 'failed';
+    /** Failed results are not agent-safe to treat as completion. */
+    ok: false;
+}
+/**
+ * Standardized result envelope for agent-facing mutate operations.
+ */
+export type AgentMutationResult<TData, TItem> = AgentMutationSuccessResult<TData, TItem> | AgentMutationPartialSuccessResult<TData, TItem> | AgentMutationEmptyResult<TData, TItem> | AgentMutationDryRunResult<TData, TItem> | AgentMutationFailedResult<TData, TItem>;
+/**
+ * Doctrine constants used by tests, docs generators, and future validators to
+ * describe the operation-result invariants without duplicating prose.
+ */
+export declare const AGENT_OPERATION_CONTRACT_DOCTRINE: {
+    readonly mutationStatuses: readonly ["success", "partial_success", "empty", "dry_run", "failed"];
+    readonly partialSuccess: {
+        readonly status: "partial_success";
+        readonly requiresAppliedMinimum: 1;
+        readonly requiresRejectedOrSkippedMinimum: 1;
+        readonly inspect: readonly ["items", "issues"];
+    };
+    readonly sessionLineage: {
+        readonly executionSessionId: "session that executed this operation attempt";
+        readonly originSessionId: "session that originated the operation intent";
+    };
+    readonly emptyState: {
+        readonly status: "empty";
+        readonly requiredField: "emptyState";
+    };
+    readonly dryRun: {
+        readonly status: "dry_run";
+        readonly requiredField: "dryRun";
+        readonly appliedWrites: 0;
+        readonly plannedEffect: "planned";
+    };
+};
+//# sourceMappingURL=agent-operation-contract.d.ts.map

package/dist/operations/agent-operation-contract.d.ts.map

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