@12ui/design 0.2.71 → 0.2.73

package/dist/workflow/service.js

@@ -0,0 +1,170 @@
+import { lstat, mkdir, realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { replaceFileAtomically } from '../atomic-file-replace.js';
+import { importArtifact, resolveArtifactPath } from './artifact.js';
+import { discoverProviders } from './providers.js';
+import { selectProvider } from './routing.js';
+import { executeProvider } from './adapters.js';
+import { completeOperation, dispatchOperation, failOperation, listOperations, prepareOperation, readOperation } from './store.js';
+import { validateOutputSchema } from './schema.js';
+import { workflowPaths, errorCode } from './store-paths.js';
+import { canonicalJson, digest } from './store-json.js';
+import { collectProjectEvidence, persistProjectBaseline, readProjectBaseline } from './project-evidence.js';
+import { WorkflowError } from './types.js';
+export async function discoverWorkflowProviders(options = {}) {
+    return discoverProviders({
+        env: options.env,
+        binaries: options.binaries,
+        timeoutMs: Math.min(options.timeoutMs ?? 5000, 5000),
+        trustCodexConfig: options.trustCodexConfig,
+        ...(options.sessionCapabilities ? { session: { capabilities: options.sessionCapabilities } } : {}),
+    });
+}
+export async function importWorkflowArtifact(args) {
+    return importArtifact(args.workspace, args.file, { mediaType: args.mediaType, role: args.role });
+}
+export async function prepareWorkflow(args) {
+    validateOutputSchema(args.request);
+    return prepareOperation(args.workspace, args.request, args.key);
+}
+export async function workflowStatus(args) {
+    return args.operationId ? readOperation(args.workspace, args.operationId) : listOperations(args.workspace);
+}
+export async function registerWorkflow(args) {
+    const operation = await readOperation(args.workspace, args.operationId);
+    if (operation.attempts.at(-1)?.number !== args.attemptNumber)
+        throw new WorkflowError('attempt_conflict', 'The result belongs to a different dispatch attempt.');
+    if (!['dispatched', 'reconcile', 'succeeded'].includes(operation.state))
+        throw new WorkflowError('operation_not_dispatched', 'Only the response to an active dispatch can be registered.');
+    const directories = await executionDirectories(await executionRoot(args.workspace, operation), args.attemptNumber);
+    const contents = canonicalJson(args.result);
+    await replaceFileAtomically({ file: path.join(directories.evidenceDir, `registration-${digest(contents)}.json`), contents });
+    const result = await withProjectEvidence(operation.request, args.result, directories);
+    return completeOperation(args.workspace, args.operationId, result, args.attemptNumber);
+}
+/** Explicit evidence about an attempt, never inferred from elapsed time. */
+export async function recordWorkflowFailure(args) {
+    return failOperation(args.workspace, args.operationId, args.failure, args.attemptNumber);
+}
+const fallbackSafe = (failure) => failure.disposition === 'not-dispatched' || failure.disposition === 'terminal-no-output';
+async function checkedDirectory(directory) {
+    await mkdir(directory).catch((error) => { if (errorCode(error) !== 'EEXIST')
+        throw error; });
+    const info = await lstat(directory);
+    if (!info.isDirectory() || info.isSymbolicLink())
+        throw new WorkflowError('unsafe_workspace', 'Execution directories must be real directories within the workspace.');
+    return directory;
+}
+/** Validate shared custody and the selected project before claiming an attempt. */
+async function executionRoot(workspace, operation) {
+    const { base } = await workflowPaths(workspace);
+    const executions = await checkedDirectory(path.join(base, 'executions'));
+    const directory = await checkedDirectory(path.join(executions, operation.id));
+    const projectCwd = operation.request.parameters?.projectCwd;
+    if (operation.request.output.kind === 'project' && projectCwd === undefined) {
+        throw new WorkflowError('project_directory_invalid', 'Project output requires an explicitly selected projectCwd before dispatch.');
+    }
+    if (projectCwd !== undefined) {
+        if (operation.request.capability !== 'code' || typeof projectCwd !== 'string' || !path.isAbsolute(projectCwd)) {
+            throw new WorkflowError('project_directory_invalid', 'Project execution requires an explicit absolute projectCwd and the code capability.');
+        }
+        const workDir = await realpath(projectCwd);
+        if (!(await stat(workDir)).isDirectory())
+            throw new WorkflowError('project_directory_invalid', 'projectCwd must be a directory.');
+        return { directory, projectDir: workDir };
+    }
+    return { directory, projectDir: undefined };
+}
+/** Bind evidence to the attempt returned by the locked dispatch, never an earlier snapshot. */
+async function executionDirectories(root, attemptNumber) {
+    const evidenceDir = await checkedDirectory(path.join(root.directory, String(attemptNumber)));
+    const workDir = root.projectDir ?? await checkedDirectory(path.join(evidenceDir, 'work'));
+    return { workDir, evidenceDir };
+}
+async function withProjectEvidence(request, result, directories) {
+    if (request.output.kind !== 'project')
+        return result;
+    const baseline = await readProjectBaseline({ projectDir: directories.workDir, evidenceDir: directories.evidenceDir });
+    const evidence = await collectProjectEvidence({ projectDir: directories.workDir, baseline, evidenceDir: directories.evidenceDir });
+    return { ...result, files: [...(result.files ?? []).filter(file => !['project-evidence', 'project-change'].includes(file.role ?? '')), ...evidence] };
+}
+/** CLI and MCP share this dispatcher. Route selection happens before a durable dispatch. */
+export async function executeWorkflow(args, dependencies = {}) {
+    let operation = await readOperation(args.workspace, args.operationId);
+    if (operation.state === 'succeeded')
+        return { operation };
+    if (operation.state === 'dispatched' || operation.state === 'reconcile') {
+        throw new WorkflowError('reconciliation_required', 'This operation has already been handed off or dispatched. Inspect its existing output and register that result; execution will not repeat or switch providers.', 'ambiguous');
+    }
+    if (operation.failure && !fallbackSafe(operation.failure)) {
+        throw new WorkflowError(operation.failure.code, operation.failure.message, operation.failure.disposition);
+    }
+    validateOutputSchema(operation.request);
+    const inputs = await Promise.all(operation.request.inputs.map(async (artifact) => ({ ...artifact, path: await resolveArtifactPath(args.workspace, artifact) })));
+    const providers = await (dependencies.discover ?? discoverWorkflowProviders)({ ...args, trustCodexConfig: args.policy?.trustCodexConfig });
+    const attempted = new Set();
+    while (true) {
+        const candidates = providers.map(provider => attempted.has(provider.id)
+            ? { ...provider, available: false, reason: 'This invocation already attempted this provider without output.' }
+            : provider);
+        const route = selectProvider(operation.request.capability, candidates, args.policy ?? {});
+        const root = await executionRoot(args.workspace, operation);
+        operation = await dispatchOperation(args.workspace, operation.id, route);
+        const attemptNumber = operation.attempts.at(-1).number;
+        let directories;
+        try {
+            directories = await executionDirectories(root, attemptNumber);
+            if (operation.request.output.kind === 'project')
+                await persistProjectBaseline({ projectDir: directories.workDir, evidenceDir: directories.evidenceDir });
+        }
+        catch (error) {
+            const failure = { code: error instanceof WorkflowError ? error.code : 'execution_setup_failed', message: error instanceof WorkflowError ? error.message : 'The attempt workspace could not be prepared; no provider was invoked.', disposition: 'not-dispatched' };
+            await failOperation(args.workspace, operation.id, failure, attemptNumber);
+            throw new WorkflowError(failure.code, failure.message);
+        }
+        if (route.execution === 'session') {
+            return {
+                operation,
+                handoff: {
+                    operationId: operation.id,
+                    attemptNumber,
+                    requestHash: operation.requestHash,
+                    capability: operation.request.capability,
+                    prompt: operation.request.prompt,
+                    inputs,
+                    output: operation.request.output,
+                    parameters: operation.request.parameters,
+                    ...directories,
+                    instruction: 'Use the declared native session capability for this frozen request exactly once. Save the actual result and register it with this operation ID. If interrupted or uncertain, reconcile existing output; do not execute again or switch providers. Report a refusal or permission denial as a terminal stop.',
+                },
+            };
+        }
+        let responseReceived = false;
+        try {
+            let result = await (dependencies.execute ?? executeProvider)(route, { ...operation.request, inputs }, {
+                ...directories,
+                policy: args.policy,
+                env: args.env,
+                binaries: args.binaries,
+                models: args.models,
+                timeoutMs: args.timeoutMs,
+                apiOrigin: args.apiOrigin,
+                idempotencyKey: `workflow-${digest(`${operation.id}:${operation.requestHash}`)}`,
+            });
+            responseReceived = true;
+            await replaceFileAtomically({ file: path.join(directories.evidenceDir, 'provider-result.json'), contents: JSON.stringify(result) });
+            result = await withProjectEvidence(operation.request, result, directories);
+            return { operation: await completeOperation(args.workspace, operation.id, result, attemptNumber) };
+        }
+        catch (error) {
+            const failure = error instanceof WorkflowError
+                ? { code: error.code, message: error.message, disposition: responseReceived ? 'ambiguous' : error.disposition }
+                : { code: 'execution_outcome_unknown', message: 'Provider execution did not yield a durable result. Reconcile its retained evidence before doing more work.', disposition: 'ambiguous' };
+            operation = await failOperation(args.workspace, operation.id, failure, attemptNumber);
+            if (!fallbackSafe(failure) || args.policy?.provider)
+                throw new WorkflowError(failure.code, failure.message, failure.disposition);
+            attempted.add(route.provider);
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/workflow/service.js.map

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

package/dist/workflow/store-json.d.ts

@@ -0,0 +1,5 @@
+/** Stable JSON for identity and persistence. Reject values JSON.stringify would silently change. */
+export declare const canonicalJson: (value: unknown) => string;
+export declare const digest: (bytes: string | Uint8Array) => string;
+export declare const cloneJson: <T>(value: T) => T;
+//# sourceMappingURL=store-json.d.ts.map

package/dist/workflow/store-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-json.d.ts","sourceRoot":"","sources":["../../src/workflow/store-json.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAmB9C,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,UAAU,KAAG,MAA0D,CAAC;AAC/G,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAA0C,CAAC"}

package/dist/workflow/store-json.js

@@ -0,0 +1,35 @@
+import { createHash } from 'node:crypto';
+import { WorkflowError } from './types.js';
+/** Stable JSON for identity and persistence. Reject values JSON.stringify would silently change. */
+export const canonicalJson = (value) => {
+    const ancestors = new Set();
+    const normalize = (item) => {
+        if (item === null || typeof item === 'string' || typeof item === 'boolean')
+            return item;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return item;
+        if (typeof item !== 'object' || item === null || ancestors.has(item))
+            throw new WorkflowError('invalid_json', 'Workflow data must be finite, acyclic JSON.');
+        if (!Array.isArray(item) && Object.getPrototypeOf(item) !== Object.prototype && Object.getPrototypeOf(item) !== null)
+            throw new WorkflowError('invalid_json', 'Workflow data must contain only plain JSON objects.');
+        ancestors.add(item);
+        try {
+            if (Array.isArray(item))
+                return item.map(normalize);
+            const result = Object.create(null);
+            for (const key of Object.keys(item).sort()) {
+                const next = item[key];
+                if (next !== undefined)
+                    result[key] = normalize(next);
+            }
+            return result;
+        }
+        finally {
+            ancestors.delete(item);
+        }
+    };
+    return JSON.stringify(normalize(value));
+};
+export const digest = (bytes) => createHash('sha256').update(bytes).digest('hex');
+export const cloneJson = (value) => JSON.parse(canonicalJson(value));
+//# sourceMappingURL=store-json.js.map

package/dist/workflow/store-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-json.js","sourceRoot":"","sources":["../../src/workflow/store-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,oGAAoG;AACpG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAU,EAAE;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,SAAS,GAAG,CAAC,IAAa,EAAW,EAAE;QAC3C,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACxF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,6CAA6C,CAAC,CAAC;QAC7J,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,qDAAqD,CAAC,CAAC;QACrN,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACpD,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;gBACpD,IAAI,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;IACvC,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAA0B,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/G,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAM,CAAC"}

package/dist/workflow/store-lock.d.ts

@@ -0,0 +1,3 @@
+/** Short critical sections only. Missing ownership/foreign hosts fail closed; age proves nothing. */
+export declare const withStoreLock: <T>(locks: string, key: string, action: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=store-lock.d.ts.map

package/dist/workflow/store-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-lock.d.ts","sourceRoot":"","sources":["../../src/workflow/store-lock.ts"],"names":[],"mappings":"AAoCA,qGAAqG;AACrG,eAAO,MAAM,aAAa,GAAU,CAAC,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAmBtG,CAAC"}

package/dist/workflow/store-lock.js

@@ -0,0 +1,85 @@
+import { randomUUID } from 'node:crypto';
+import { hostname } from 'node:os';
+import { mkdir, readFile, rename, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { replaceFileAtomically } from '../atomic-file-replace.js';
+import { errorCode } from './store-paths.js';
+import { WorkflowError } from './types.js';
+const readOwner = async (directory) => {
+    try {
+        const value = JSON.parse(await readFile(path.join(directory, 'owner.json'), 'utf8'));
+        return Number.isInteger(value.pid) && value.pid > 0 && typeof value.host === 'string' && typeof value.nonce === 'string'
+            ? value : null;
+    }
+    catch {
+        return null;
+    }
+};
+const dead = (owner) => {
+    if (owner.host !== hostname())
+        return false;
+    try {
+        process.kill(owner.pid, 0);
+        return false;
+    }
+    catch (error) {
+        return errorCode(error) === 'ESRCH';
+    }
+};
+/** Serialize stale-owner reclaim so two reclaimers cannot remove a newly acquired lock. */
+const reclaim = async (directory) => {
+    const recovery = `${directory}.recovery`;
+    try {
+        await mkdir(recovery);
+    }
+    catch (error) {
+        if (errorCode(error) === 'EEXIST')
+            return;
+        throw error;
+    }
+    try {
+        const owner = await readOwner(directory);
+        if (!owner || !dead(owner))
+            return;
+        // No new owner can acquire the canonical path until this rename. After it,
+        // this reclaimer touches only the abandoned directory, never the new lock.
+        const abandoned = `${directory}.abandoned-${randomUUID()}`;
+        await rename(directory, abandoned).catch((error) => { if (errorCode(error) !== 'ENOENT')
+            throw error; });
+        await rm(abandoned, { recursive: true, force: true });
+    }
+    finally {
+        await rm(recovery, { recursive: true, force: true });
+    }
+};
+/** Short critical sections only. Missing ownership/foreign hosts fail closed; age proves nothing. */
+export const withStoreLock = async (locks, key, action) => {
+    if (!/^[a-z0-9-]+$/u.test(key))
+        throw new WorkflowError('invalid_lock', 'Invalid workflow lock key.');
+    const directory = path.join(locks, key);
+    const owner = { pid: process.pid, host: hostname(), nonce: randomUUID() };
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            await mkdir(directory);
+            break;
+        }
+        catch (error) {
+            if (errorCode(error) !== 'EEXIST')
+                throw error;
+            await reclaim(directory);
+            if (attempt >= 199)
+                throw new WorkflowError('workflow_busy', 'Another writer owns this operation. A lock with missing or uncertain ownership requires inspection before recovery.');
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    try {
+        await replaceFileAtomically({ file: path.join(directory, 'owner.json'), contents: JSON.stringify(owner) });
+        return await action();
+    }
+    finally {
+        const current = await readOwner(directory);
+        if (current?.nonce === owner.nonce)
+            await rm(directory, { recursive: true });
+    }
+};
+//# sourceMappingURL=store-lock.js.map

package/dist/workflow/store-lock.js.map

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

package/dist/workflow/store-paths.d.ts

@@ -0,0 +1,17 @@
+export declare const WORKFLOW_DIRECTORY = ".12ui/workflow";
+export declare const operationIdPattern: RegExp;
+export declare const errorCode: (error: unknown) => string | undefined;
+export declare const inside: (root: string, candidate: string) => boolean;
+/** Resolve the caller's workspace once; internal directories may never be symlinks. */
+export declare const workflowPaths: (workspace: string) => Promise<{
+    operations: string;
+    artifacts: string;
+    locks: string;
+    root: string;
+    base: string;
+}>;
+export declare const operationFile: (directory: string, id: string) => string;
+/** Open the inode without following a final symlink, then validate that same inode. */
+export declare const readRegularFile: (file: string) => Promise<Buffer>;
+export declare const syncDirectory: (directory: string) => Promise<void>;
+//# sourceMappingURL=store-paths.d.ts.map

package/dist/workflow/store-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-paths.d.ts","sourceRoot":"","sources":["../../src/workflow/store-paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AAEvD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAAmD,CAAC;AAExG,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,OAGxD,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM;;;;;;EAmBpD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,IAAI,MAAM,KAAG,MAG7D,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,MAAM,CAQlE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAGnE,CAAC"}

package/dist/workflow/store-paths.js

@@ -0,0 +1,67 @@
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { WorkflowError } from './types.js';
+export const WORKFLOW_DIRECTORY = '.12ui/workflow';
+export const operationIdPattern = /^op-[a-f0-9]{64}$/u;
+export const errorCode = (error) => error?.code;
+export const inside = (root, candidate) => {
+    const relative = path.relative(root, candidate);
+    return relative !== '' && relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+};
+/** Resolve the caller's workspace once; internal directories may never be symlinks. */
+export const workflowPaths = async (workspace) => {
+    await mkdir(path.resolve(workspace), { recursive: true });
+    const root = await realpath(path.resolve(workspace));
+    const parts = ['.12ui', 'workflow'];
+    let current = root;
+    for (const part of parts) {
+        current = path.join(current, part);
+        await mkdir(current).catch((error) => { if (errorCode(error) !== 'EEXIST')
+            throw error; });
+        const stat = await lstat(current);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new WorkflowError('unsafe_workspace', 'Workflow directories must be real directories inside the workspace.');
+    }
+    const base = current;
+    const directories = { operations: path.join(base, 'operations'), artifacts: path.join(base, 'artifacts'), locks: path.join(base, 'locks') };
+    for (const directory of Object.values(directories)) {
+        await mkdir(directory).catch((error) => { if (errorCode(error) !== 'EEXIST')
+            throw error; });
+        const stat = await lstat(directory);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new WorkflowError('unsafe_workspace', 'Workflow directories must not follow symlinks.');
+    }
+    return { root, base, ...directories };
+};
+export const operationFile = (directory, id) => {
+    if (!operationIdPattern.test(id))
+        throw new WorkflowError('invalid_operation_id', 'Operation ID is invalid.');
+    return path.join(directory, `${id}.json`);
+};
+/** Open the inode without following a final symlink, then validate that same inode. */
+export const readRegularFile = async (file) => {
+    const handle = await open(file, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        if (!(await handle.stat()).isFile())
+            throw new WorkflowError('invalid_artifact', 'Artifacts and records must be regular files.');
+        return await handle.readFile();
+    }
+    finally {
+        await handle.close();
+    }
+};
+export const syncDirectory = async (directory) => {
+    const handle = await open(directory, 'r');
+    try {
+        await handle.sync();
+    }
+    catch (error) {
+        if (errorCode(error) !== 'EINVAL')
+            throw error;
+    }
+    finally {
+        await handle.close();
+    }
+};
+//# sourceMappingURL=store-paths.js.map

package/dist/workflow/store-paths.js.map

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

package/dist/workflow/store-validation.d.ts

@@ -0,0 +1,7 @@
+import { type Artifact, type ExecutionResult, type OperationFailure, type RoutingDecision, type WorkflowOperation, type WorkflowRequest } from './types.js';
+export declare const validateRequest: (request: WorkflowRequest) => void;
+export declare const validateRoute: (route: RoutingDecision, request: WorkflowRequest) => void;
+export declare const validateFailure: (failure: OperationFailure) => void;
+export declare const validateOperation: (value: unknown, expectedId: string) => WorkflowOperation;
+export declare const validateResult: (workspace: string, request: WorkflowRequest, result: ExecutionResult, artifacts: Artifact[]) => Promise<void>;
+//# sourceMappingURL=store-validation.d.ts.map

package/dist/workflow/store-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-validation.d.ts","sourceRoot":"","sources":["../../src/workflow/store-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAoBrN,eAAO,MAAM,eAAe,GAAI,SAAS,eAAe,KAAG,IAS1D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,eAAe,EAAE,SAAS,eAAe,KAAG,IAUhF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,IAI3D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,EAAE,YAAY,MAAM,KAAG,iBAqBtE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,WAAW,MAAM,EAAE,SAAS,eAAe,EAAE,QAAQ,eAAe,EAAE,WAAW,QAAQ,EAAE,KAAG,OAAO,CAAC,IAAI,CAsB9I,CAAC"}

package/dist/workflow/store-validation.js

@@ -0,0 +1,119 @@
+import { CAPABILITIES, PROVIDERS, WORKFLOW_SCHEMA, WorkflowError } from './types.js';
+import { canonicalJson, digest } from './store-json.js';
+import { validateBundleMappings } from './bundle-paths.js';
+import { resolveArtifactPath } from './artifact.js';
+import { readRegularFile } from './store-paths.js';
+import { validateProjectEvidence } from './project-evidence.js';
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const forbidden = /^(?:env|environment|headers|authorization|credentials?|secrets?|api[_-]?key|access[_-]?token|refresh[_-]?token|password|bearer[_-]?token)$/iu;
+/** Provider configuration belongs in adapters, never in a persistent request. */
+const validatePublicParameters = (value) => {
+    if (Array.isArray(value)) {
+        value.forEach(validatePublicParameters);
+        return;
+    }
+    if (!object(value))
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        if (forbidden.test(key))
+            throw new WorkflowError('private_configuration', 'Workflow parameters must not include credentials, headers or environment configuration.');
+        validatePublicParameters(child);
+    }
+};
+export const validateRequest = (request) => {
+    canonicalJson(request);
+    if (!object(request) || !CAPABILITIES.includes(request.capability) || typeof request.prompt !== 'string'
+        || !Array.isArray(request.inputs) || !object(request.output) || !['json', 'image', 'html', 'project'].includes(request.output.kind)
+        || (request.output.schema !== undefined && !object(request.output.schema))
+        || (request.parameters !== undefined && !object(request.parameters)))
+        throw new WorkflowError('invalid_request', 'Workflow request does not match the public workflow contract.');
+    if (Object.keys(request).some((key) => !['capability', 'prompt', 'inputs', 'output', 'parameters'].includes(key)))
+        throw new WorkflowError('invalid_request', 'Unsupported workflow request field.');
+    if (Object.keys(request.output).some((key) => !['kind', 'schema'].includes(key)))
+        throw new WorkflowError('invalid_request', 'Unsupported output contract field.');
+    validatePublicParameters(request.parameters);
+};
+export const validateRoute = (route, request) => {
+    canonicalJson(route);
+    const funding = { session: 'user-plan', codex: 'user-plan', claude: 'user-plan', openai: 'openai-key', '12ui': '12ui-credits' };
+    const execution = { session: 'session', codex: 'process', claude: 'process', openai: 'http', '12ui': 'http' };
+    if (!route || !PROVIDERS.includes(route.provider) || route.capability !== request.capability
+        || route.funding !== funding[route.provider] || route.execution !== execution[route.provider]
+        || !Array.isArray(route.considered)
+        || Object.keys(route).some((key) => !['provider', 'capability', 'funding', 'execution', 'considered'].includes(key))
+        || route.considered.some((item) => !item || !PROVIDERS.includes(item.provider) || typeof item.eligible !== 'boolean' || typeof item.reason !== 'string'
+            || Object.keys(item).some((key) => !['provider', 'eligible', 'reason'].includes(key))))
+        throw new WorkflowError('invalid_route', 'Dispatch route does not match the requested capability and provider.');
+};
+export const validateFailure = (failure) => {
+    canonicalJson(failure);
+    if (!failure || typeof failure.code !== 'string' || !failure.code || typeof failure.message !== 'string'
+        || !['not-dispatched', 'terminal-no-output', 'terminal-stop', 'ambiguous'].includes(failure.disposition))
+        throw new WorkflowError('invalid_failure', 'Operation failure must declare its dispatch disposition.');
+};
+export const validateOperation = (value, expectedId) => {
+    if (!object(value))
+        throw new WorkflowError('operation_corrupt', 'Workflow operation is not an object.');
+    const operation = value;
+    validateRequest(operation.request);
+    if (operation.schema !== WORKFLOW_SCHEMA || operation.id !== expectedId || typeof operation.idempotencyKey !== 'string'
+        || operation.id !== `op-${digest(operation.idempotencyKey)}` || operation.requestHash !== digest(canonicalJson(operation.request))
+        || !['prepared', 'dispatched', 'succeeded', 'failed', 'reconcile'].includes(operation.state)
+        || !Array.isArray(operation.attempts) || !Number.isFinite(Date.parse(operation.createdAt)) || !Number.isFinite(Date.parse(operation.updatedAt)))
+        throw new WorkflowError('operation_corrupt', 'Workflow operation identity or state is invalid.');
+    operation.attempts.forEach((attempt, index) => {
+        if (!attempt || attempt.number !== index + 1 || !Number.isFinite(Date.parse(attempt.dispatchedAt)))
+            throw new WorkflowError('operation_corrupt', 'Operation attempt history is invalid.');
+        validateRoute(attempt.route, operation.request);
+        if (attempt.failure)
+            validateFailure(attempt.failure);
+    });
+    if (operation.failure)
+        validateFailure(operation.failure);
+    if ((operation.state === 'prepared' && operation.attempts.length !== 0)
+        || (['dispatched', 'reconcile', 'succeeded'].includes(operation.state) && operation.attempts.length === 0)
+        || (operation.state === 'reconcile' && operation.failure?.disposition !== 'ambiguous')
+        || (operation.state === 'failed' && (!operation.failure || operation.failure.disposition === 'ambiguous'))
+        || (operation.state === 'succeeded' && (!operation.result || !Array.isArray(operation.result.artifacts))))
+        throw new WorkflowError('operation_corrupt', 'Operation state contradicts its durable history.');
+    if (operation.result)
+        validateBundleMappings(operation.result.artifacts);
+    return operation;
+};
+export const validateResult = async (workspace, request, result, artifacts) => {
+    if (!object(result))
+        throw new WorkflowError('invalid_result', 'Execution result must be an object.');
+    if (result.providerRequestId !== undefined && (typeof result.providerRequestId !== 'string' || !result.providerRequestId))
+        throw new WorkflowError('invalid_result', 'Provider request identity must be a non-empty string.');
+    if (result.usage !== undefined) {
+        if (!object(result.usage))
+            throw new WorkflowError('invalid_result', 'Usage evidence must be a JSON object.');
+        canonicalJson(result.usage);
+        validatePublicParameters(result.usage);
+    }
+    const kind = request.output.kind;
+    if (kind === 'json') {
+        if (result.value === undefined)
+            throw new WorkflowError('invalid_output', 'A JSON operation requires a JSON value.');
+        canonicalJson(result.value);
+    }
+    if (kind === 'image' && !artifacts.some((artifact) => artifact.mediaType.startsWith('image/') && artifact.width && artifact.height))
+        throw new WorkflowError('invalid_output', 'An image operation requires a verified image artifact.');
+    if (kind === 'html' && !artifacts.some((artifact) => artifact.mediaType === 'text/html' && artifact.bytes > 0))
+        throw new WorkflowError('invalid_output', 'An HTML operation requires a verified, non-empty HTML file artifact.');
+    if (kind === 'project') {
+        const evidenceFiles = artifacts.filter((artifact) => artifact.role === 'project-evidence');
+        if (evidenceFiles.length !== 1 || evidenceFiles[0].mediaType !== 'application/json')
+            throw new WorkflowError('invalid_output', 'A project operation requires one verified project-evidence JSON artifact documenting actual changes.');
+        const bytes = await readRegularFile(await resolveArtifactPath(workspace, evidenceFiles[0]));
+        let evidence;
+        try {
+            evidence = JSON.parse(bytes.toString('utf8'));
+        }
+        catch {
+            throw new WorkflowError('invalid_output', 'Project evidence must be valid JSON.');
+        }
+        await validateProjectEvidence(request, evidence, artifacts);
+    }
+};
+//# sourceMappingURL=store-validation.js.map

package/dist/workflow/store-validation.js.map

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

package/dist/workflow/store.d.ts

@@ -0,0 +1,10 @@
+import { type ExecutionResult, type OperationFailure, type RoutingDecision, type WorkflowOperation, type WorkflowRequest } from './types.js';
+export { importArtifact, resolveArtifactPath, verifyArtifact } from './artifact.js';
+export declare const operationIdForKey: (idempotencyKey: string) => string;
+export declare const prepareOperation: (workspace: string, request: WorkflowRequest, idempotencyKey: string) => Promise<WorkflowOperation>;
+export declare const readOperation: (workspace: string, id: string) => Promise<WorkflowOperation>;
+export declare const listOperations: (workspace: string) => Promise<WorkflowOperation[]>;
+export declare const dispatchOperation: (workspace: string, id: string, route: RoutingDecision) => Promise<WorkflowOperation>;
+export declare const completeOperation: (workspace: string, id: string, result: ExecutionResult, attemptNumber: number) => Promise<WorkflowOperation>;
+export declare const failOperation: (workspace: string, id: string, failure: OperationFailure, attemptNumber: number) => Promise<WorkflowOperation>;
+//# sourceMappingURL=store.d.ts.map

package/dist/workflow/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/workflow/store.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkC,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7K,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpF,eAAO,MAAM,iBAAiB,GAAI,gBAAgB,MAAM,KAAG,MAG1D,CAAC;AAuBF,eAAO,MAAM,gBAAgB,GAAU,WAAW,MAAM,EAAE,SAAS,eAAe,EAAE,gBAAgB,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAoBrI,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM,EAAE,IAAI,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAM5F,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,iBAAiB,EAAE,CAInF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,WAAW,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,eAAe,KAAG,OAAO,CAAC,iBAAiB,CAiBxH,CAAC;AASF,eAAO,MAAM,iBAAiB,GAAU,WAAW,MAAM,EAAE,IAAI,MAAM,EAAE,QAAQ,eAAe,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,iBAAiB,CA2ChJ,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM,EAAE,IAAI,MAAM,EAAE,SAAS,gBAAgB,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,iBAAiB,CA6B9I,CAAC"}