@12ui/design 0.2.72 → 0.2.73

package/dist/slate-round-runner.js

@@ -0,0 +1,125 @@
+import sharp from 'sharp';
+import { generationVersionId, sha256Hex, slotOfCandidate } from './slate-ids.js';
+import { versionImageFile } from './slate-paths.js';
+import { ensureReferenceImage } from './slate-reference-store.js';
+import { optionPrompt, roundFrame } from './slate-round-prompt.js';
+import { chooseReferences } from './slate-round-search.js';
+import { failure, ledger, patchOp, setPhase, } from './slate-runner-context.js';
+import { imageFailureMessage } from './slate-runner-failure.js';
+import { readVersionBytes, writeImageOnce } from './slate-versions.js';
+import { findRound, loadWorkspaceAt } from './slate-workspace-store.js';
+/** The options still to draw, with the reference each one is drawn from. */
+const pendingSlots = async (env, params) => {
+    const { workspace } = await loadWorkspaceAt(env.root, env.clock.now);
+    return workspace.candidates
+        .filter((candidate) => candidate.roundId === params.roundId && candidate.versionIds.length === 0 && candidate.error === null)
+        .flatMap((candidate) => (candidate.referenceId ? [{
+            candidateId: candidate.candidateId,
+            slot: slotOfCandidate(candidate.candidateId),
+            label: candidate.label,
+            referenceId: candidate.referenceId,
+        }] : []));
+};
+const recordOptionFailure = async (env, slot, reason) => {
+    await patchOp(env, (_op, ws) => {
+        const candidate = ws.candidates.find((entry) => entry.candidateId === slot.candidateId);
+        if (candidate && candidate.versionIds.length === 0)
+            candidate.error = reason;
+    });
+    await env.log({ event: 'option_failed', slot: slot.slot, reason });
+};
+const drawOption = async (env, params, slot, references, from) => {
+    const reference = references.get(slot.referenceId);
+    if (!reference || reference instanceof Error) {
+        await recordOptionFailure(env, slot, 'The inspiration image could not be fetched.');
+        return;
+    }
+    const callId = `slate-${env.opId}-${slot.slot}`;
+    const frame = roundFrame(params.aspect);
+    try {
+        await ledger(env, { event: 'call_started', callId, slot: slot.slot });
+        const result = await env.executor.generate({
+            callId,
+            prompt: optionPrompt({ aspect: params.aspect, concept: params.concept, like: from !== null, label: slot.label }),
+            images: from ? [from, reference] : [reference],
+            expected: frame,
+        });
+        const png = await sharp(result.png, { animated: false, failOn: 'warning' }).png().toBuffer();
+        const facts = await sharp(png).metadata();
+        const sha256 = sha256Hex(png);
+        const versionId = generationVersionId(params.roundId, slot.slot);
+        await writeImageOnce(versionImageFile(env.root, versionId), png, sha256);
+        await ledger(env, { event: 'call_finished', callId, slot: slot.slot, sha256, reused: result.reused });
+        await patchOp(env, (op, ws) => {
+            const candidate = ws.candidates.find((entry) => entry.candidateId === slot.candidateId);
+            if (!candidate || ws.versions.some((entry) => entry.versionId === versionId))
+                return;
+            ws.versions.push({
+                versionId,
+                candidateId: candidate.candidateId,
+                n: 1,
+                kind: 'generation',
+                parentVersionId: null,
+                opId: env.opId,
+                prompt: null,
+                sentPromptSha256: null,
+                marks: null,
+                sha256,
+                width: facts.width ?? frame.width,
+                height: facts.height ?? frame.height,
+                createdAt: env.clock.now().toISOString(),
+            });
+            candidate.versionIds.push(versionId);
+            candidate.error = null;
+            op.resultVersionIds.push(versionId);
+        });
+        await env.log({ event: 'collected', slot: slot.slot, sha256, reused: result.reused });
+    }
+    catch (error) {
+        await env.log({ event: 'call_failed', slot: slot.slot, ...failureDetail(error) });
+        await recordOptionFailure(env, slot, imageFailureMessage(error));
+    }
+};
+const failureDetail = (error) => {
+    const cause = error?.cause;
+    return {
+        code: error?.code ?? null,
+        message: error instanceof Error ? error.message.slice(0, 300) : String(error).slice(0, 300),
+        ...(cause instanceof Error ? { cause: cause.message.slice(0, 300) } : {}),
+    };
+};
+export const runRound = async (env, op) => {
+    const params = op.params;
+    const refusal = await chooseReferences(env, params);
+    if (refusal)
+        return refusal;
+    const slots = await pendingSlots(env, params);
+    await setPhase(env, 'fetching');
+    const references = new Map();
+    await Promise.all([...new Set(slots.map((slot) => slot.referenceId))].map(async (referenceId) => {
+        try {
+            references.set(referenceId, (await ensureReferenceImage({ root: env.root, corpus: env.corpus, referenceId, size: 'ref' })).bytes);
+        }
+        catch (error) {
+            await env.log({ event: 'reference_failed', referenceId, message: error instanceof Error ? error.message : String(error) });
+            references.set(referenceId, error instanceof Error ? error : new Error(String(error)));
+        }
+    }));
+    let from = null;
+    if (params.from) {
+        const { workspace } = await loadWorkspaceAt(env.root, env.clock.now);
+        const version = workspace.versions.find((entry) => entry.versionId === params.from.versionId);
+        if (!version || version.sha256 !== params.from.sourceSha256)
+            return failure('source_changed', 'The image this round was started from changed after the click.');
+        from = await readVersionBytes(env.root, workspace, version);
+    }
+    await setPhase(env, 'drawing');
+    await Promise.all(slots.map((slot) => drawOption(env, params, slot, references, from)));
+    const { workspace } = await loadWorkspaceAt(env.root, env.clock.now);
+    const own = workspace.candidates.filter((candidate) => candidate.roundId === findRound(workspace, params.roundId).roundId);
+    if (own.some((candidate) => candidate.versionIds.length > 0))
+        return { state: 'succeeded' };
+    const reason = own.find((candidate) => candidate.error)?.error ?? 'No option could be drawn.';
+    return failure('all_options_failed', reason, { retryable: true });
+};
+//# sourceMappingURL=slate-round-runner.js.map

package/dist/slate-round-runner.js.map

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

package/dist/slate-round-search.d.ts

@@ -0,0 +1,7 @@
+import { type CorpusInspirationItem } from './corpus-client.js';
+import { type Outcome, type RunnerEnv } from './slate-runner-context.js';
+import type { SlateReferenceMeta, SlateRoundParams } from './slate-workspace-types.js';
+export declare const metaFromItem: (item: CorpusInspirationItem) => SlateReferenceMeta;
+/** The references for this round, recorded. `null` means the round already had them. */
+export declare const chooseReferences: (env: RunnerEnv, params: SlateRoundParams) => Promise<Outcome | null>;
+//# sourceMappingURL=slate-round-search.d.ts.map

package/dist/slate-round-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-round-search.d.ts","sourceRoot":"","sources":["../src/slate-round-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGlG,OAAO,EAAsC,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG7G,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAevF,eAAO,MAAM,YAAY,GAAI,MAAM,qBAAqB,KAAG,kBAOzD,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,GAAU,KAAK,SAAS,EAAE,QAAQ,gBAAgB,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CA+CvG,CAAC"}

package/dist/slate-round-search.js

@@ -0,0 +1,77 @@
+import { MAX_CORPUS_REFERENCE_IMAGE_BYTES } from './corpus-client.js';
+import { corpusFailure } from './slate-corpus.js';
+import { SlateError } from './slate-errors.js';
+import { failure, ledger, patchOp, setPhase } from './slate-runner-context.js';
+import { readVersionBytes } from './slate-versions.js';
+import { findRound, loadWorkspaceAt } from './slate-workspace-store.js';
+/**
+ * A round that was not given references picks its own with one free corpus
+ * search: the concept, balanced mode, and (for More like this) the version's
+ * own image. The search key is `slate-<opId>-search`, so a rerun after a crash
+ * replays the stored answer and spends none of the daily allowance. What the
+ * search found is recorded on the round and its options in one write, so a
+ * Resume never searches twice for different answers.
+ */
+const referenceAspect = (value) => (value === 'portrait' || value === 'square' ? value : 'landscape');
+export const metaFromItem = (item) => ({
+    referenceId: item.id,
+    aspect: referenceAspect(item.aspect),
+    width: Number.isSafeInteger(item.width) && (item.width ?? 0) > 0 ? item.width : null,
+    height: Number.isSafeInteger(item.height) && (item.height ?? 0) > 0 ? item.height : null,
+    description: typeof item.description === 'string' ? item.description.slice(0, 2_000) : null,
+    uiType: typeof item.uiType === 'string' ? item.uiType.slice(0, 200) : null,
+});
+/** The references for this round, recorded. `null` means the round already had them. */
+export const chooseReferences = async (env, params) => {
+    const { workspace } = await loadWorkspaceAt(env.root, env.clock.now);
+    const round = findRound(workspace, params.roundId);
+    if (round.referenceIds.length > 0)
+        return null;
+    await setPhase(env, 'searching');
+    let referenceImage;
+    if (params.from) {
+        const version = workspace.versions.find((entry) => entry.versionId === params.from.versionId);
+        if (!version)
+            return failure('source_missing', 'The version this round stays close to is not in the workspace.');
+        const bytes = await readVersionBytes(env.root, workspace, version).catch((error) => {
+            if (error instanceof SlateError)
+                return error;
+            throw error;
+        });
+        if (bytes instanceof SlateError)
+            return failure('source_missing', bytes.message);
+        if (version.sha256 !== params.from.sourceSha256)
+            return failure('source_changed', 'The image this round was started from changed after the click.');
+        if (bytes.byteLength > MAX_CORPUS_REFERENCE_IMAGE_BYTES)
+            return failure('source_missing', 'The image is too large for a reference search.');
+        referenceImage = { bytes, mediaType: 'image/png' };
+    }
+    await ledger(env, { event: 'search', k: params.count + params.referenceSkip.length, like: params.from !== null });
+    let items;
+    try {
+        const response = await env.corpus().inspire({ q: params.concept, mode: 'balanced', k: params.count + params.referenceSkip.length }, { idempotencyKey: `slate-${env.opId}-search`, ...(referenceImage ? { referenceImage } : {}) });
+        items = response.items;
+    }
+    catch (error) {
+        throw corpusFailure(error);
+    }
+    const skipped = new Set(params.referenceSkip);
+    const fresh = items.filter((item, index) => !skipped.has(item.id) && items.findIndex((other) => other.id === item.id) === index).slice(0, params.count);
+    if (fresh.length < params.count) {
+        return failure('no_fresh_references', 'Most matching references are already used in earlier rounds. Select some inspiration or add a steer note.');
+    }
+    await patchOp(env, (_op, ws) => {
+        const target = findRound(ws, params.roundId);
+        target.referenceIds = fresh.map((item) => item.id);
+        params.candidateIds.forEach((candidateId, index) => {
+            const candidate = ws.candidates.find((entry) => entry.candidateId === candidateId);
+            if (candidate)
+                candidate.referenceId = fresh[index].id;
+        });
+        for (const item of fresh)
+            ws.references[item.id] = metaFromItem(item);
+    });
+    await env.log({ event: 'searched', referenceIds: fresh.map((item) => item.id) });
+    return null;
+};
+//# sourceMappingURL=slate-round-search.js.map

package/dist/slate-round-search.js.map

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

package/dist/slate-run-action.d.ts

@@ -0,0 +1,14 @@
+import type { SlateRuntime } from './slate-runtime.js';
+import type { SlateOp } from './slate-workspace-types.js';
+export declare const runAction: (args: {
+    runtime: SlateRuntime;
+    root: string;
+    opId: unknown;
+    actionInput: unknown;
+}) => Promise<SlateOp>;
+export declare const resumeAction: (args: {
+    runtime: SlateRuntime;
+    root: string;
+    opId: unknown;
+}) => Promise<SlateOp>;
+//# sourceMappingURL=slate-run-action.d.ts.map

package/dist/slate-run-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-run-action.d.ts","sourceRoot":"","sources":["../src/slate-run-action.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAqD1D,eAAO,MAAM,SAAS,GAAU,MAAM;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB,KAAG,OAAO,CAAC,OAAO,CAUlB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,MAAM;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,KAAG,OAAO,CAAC,OAAO,CAOhH,CAAC"}

package/dist/slate-run-action.js

@@ -0,0 +1,81 @@
+import { normalizeAction } from './slate-actions.js';
+import { commitAction } from './slate-commit.js';
+import { SlateError } from './slate-errors.js';
+import { OP_ID_PATTERN } from './slate-ids.js';
+import { readRunnerState } from './slate-liveness.js';
+import { resumeOp, RUNNER_SPAWN_FAILED } from './slate-resume.js';
+import { NoWrite, loadWorkspaceAt, mutateWorkspace } from './slate-workspace-store.js';
+/**
+ * `design.slate.run` and `design.slate.resume`: the only two tools that can
+ * start work, both only from a click. Each returns after a file commit and a
+ * process spawn; neither awaits a search, an image call or a download.
+ */
+const requireOpId = (value) => {
+    if (typeof value !== 'string' || !OP_ID_PATTERN.test(value)) {
+        throw new SlateError('invalid_input', 'opId must be a UUID v4 minted when the dialog opened.');
+    }
+    return value;
+};
+/** Nothing is written or spawned when this Mac cannot draw; the reason is the one the dialog already shows. */
+const requireLocalImage = async (runtime) => {
+    const state = await runtime.localImage();
+    if (!state.ready)
+        throw new SlateError('local_unavailable', state.reason ?? 'Codex is not ready on this Mac.');
+};
+/**
+ * Spawn the runner at most once per commit or resume: the claim is a
+ * compare-and-set on `spawnedAt` inside the workspace lock, so ten concurrent
+ * calls across two server processes produce one runner.
+ */
+const spawnRunnerOnce = async (runtime, root, opId) => {
+    const claimed = await mutateWorkspace(root, async (ws, context) => {
+        const op = ws.ops.find((entry) => entry.opId === opId);
+        if (!op || op.state !== 'running' || op.spawnedAt !== null)
+            return new NoWrite(false);
+        if ((await readRunnerState(root, opId, context.now.getTime())).alive)
+            return new NoWrite(false);
+        op.spawnedAt = context.now.toISOString();
+        return true;
+    }, { now: runtime.now });
+    if (!claimed)
+        return;
+    try {
+        await runtime.launchRunner({ root, opId, stateRoot: runtime.stateRoot });
+    }
+    catch (error) {
+        // Recorded on the op: it derives `interrupted` and the screen offers Resume.
+        await mutateWorkspace(root, (ws) => {
+            const op = ws.ops.find((entry) => entry.opId === opId);
+            if (op) {
+                op.error = {
+                    code: RUNNER_SPAWN_FAILED,
+                    message: `The background worker did not start: ${error instanceof Error ? error.message : String(error)}`,
+                    retryable: false,
+                    resumable: true,
+                };
+            }
+        }, { now: runtime.now });
+    }
+};
+export const runAction = async (args) => {
+    const { runtime, root } = args;
+    const opId = requireOpId(args.opId);
+    const action = normalizeAction(args.actionInput);
+    const { workspace } = await loadWorkspaceAt(root, runtime.now);
+    // A repeated click on an op that already exists must answer with that op, whatever the probe says now.
+    if (!workspace.ops.some((op) => op.opId === opId))
+        await requireLocalImage(runtime);
+    const committed = await commitAction({ root, stateRoot: runtime.stateRoot, opId, action, now: runtime.now });
+    await spawnRunnerOnce(runtime, root, committed.op.opId);
+    return (await loadWorkspaceAt(root, runtime.now)).workspace.ops.find((op) => op.opId === committed.op.opId) ?? committed.op;
+};
+export const resumeAction = async (args) => {
+    const { runtime, root } = args;
+    const opId = requireOpId(args.opId);
+    await requireLocalImage(runtime);
+    const outcome = await resumeOp({ root, stateRoot: runtime.stateRoot, opId, now: runtime.now });
+    if (outcome.spawn)
+        await spawnRunnerOnce(runtime, root, opId);
+    return (await loadWorkspaceAt(root, runtime.now)).workspace.ops.find((op) => op.opId === opId) ?? outcome.op;
+};
+//# sourceMappingURL=slate-run-action.js.map

package/dist/slate-run-action.js.map

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

package/dist/slate-runner-context.d.ts

@@ -0,0 +1,57 @@
+import type { SlateCorpus } from './slate-corpus.js';
+import type { SlateImageExecutor } from './slate-image-executor.js';
+import { type LedgerInput } from './slate-ledger.js';
+import type { SlateOp, SlateOpError, SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * What every runner shares: the frozen op, the clock, and the helpers that
+ * write progress into `workspace.json` under the workspace lock. A runner
+ * never reads a workspace field as an instruction except `op.params`, and only
+ * after the approval digest matched.
+ */
+export type RunnerClock = {
+    now: () => Date;
+    /** Resolves after the delay, or at once when `signal` aborts (the timer is then released). */
+    sleep: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+};
+export type RunnerEnv = {
+    root: string;
+    stateRoot: string;
+    opId: string;
+    workspaceId: string;
+    corpus: () => SlateCorpus;
+    executor: SlateImageExecutor;
+    clock: RunnerClock;
+    log: (entry: Record<string, unknown>) => Promise<void>;
+};
+/** `ops/<opId>.log`: JSON lines, 1 MiB, rotating once, because the runner's stdio is ignored. */
+export declare const createRunLog: (root: string, opId: string) => RunnerEnv["log"];
+export declare const opIn: (workspace: SlateWorkspace, opId: string) => SlateOp;
+/** A ledger line, written BEFORE the step it names. */
+export declare const ledger: (env: RunnerEnv, entry: LedgerInput) => Promise<void>;
+export declare const patchOp: (env: RunnerEnv, apply: (op: SlateOp, workspace: SlateWorkspace) => void) => Promise<void>;
+export declare const setPhase: (env: RunnerEnv, phase: string) => Promise<void>;
+export type Outcome = {
+    state: 'succeeded';
+} | {
+    state: 'failed';
+    error: SlateOpError;
+} | {
+    state: 'superseded';
+};
+export declare const failure: (code: string, message: string, flags?: {
+    retryable?: boolean;
+    resumable?: boolean;
+}) => Outcome;
+/** Write the terminal state, settle the approval, close the ledger. */
+export declare const finishOp: (env: RunnerEnv, outcome: Outcome) => Promise<void>;
+/**
+ * The error a thrown failure becomes. Nothing here costs money and every call
+ * id is stable, so an unclassified runner error is resumable: a Resume replays
+ * the same ids and the call store never repeats a finished call. A refusal the
+ * workspace itself made (a changed source file, a bad reference) is not; a
+ * corpus outage or rate limit (a retryable `SlateError`) is, because the search
+ * replays on its own key.
+ */
+export declare const errorFromRunner: (error: unknown) => SlateOpError;
+export declare const sleepFor: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+//# sourceMappingURL=slate-runner-context.d.ts.map

package/dist/slate-runner-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-context.d.ts","sourceRoot":"","sources":["../src/slate-runner-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAExF;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,8FAA8F;IAC9F,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,WAAW,CAAC;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD,CAAC;AAIF,iGAAiG;AACjG,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,SAAS,CAAC,KAAK,CAYxE,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,WAAW,cAAc,EAAE,MAAM,MAAM,KAAG,OAI9D,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,MAAM,GAAI,KAAK,SAAS,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,IAAI,CAEvE,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,KAAK,IAAI,KAAG,OAAO,CAAC,IAAI,CAE7G,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAU,KAAK,SAAS,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAG1E,CAAC;AAEF,MAAM,MAAM,OAAO,GACf;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE5B,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,QAAO;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,OAGhH,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,QAAQ,GAAU,KAAK,SAAS,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAa7E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,YAMhD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,cAAc,MAAM,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAKhF,CAAC"}

package/dist/slate-runner-context.js

@@ -0,0 +1,79 @@
+import { appendFile, rename, rm, stat } from 'node:fs/promises';
+import { settleApproval } from './slate-approvals.js';
+import { SlateError } from './slate-errors.js';
+import { appendLedger } from './slate-ledger.js';
+import { opLogFile } from './slate-paths.js';
+import { mutateWorkspace } from './slate-workspace-store.js';
+const LOG_LIMIT_BYTES = 1024 * 1024;
+/** `ops/<opId>.log`: JSON lines, 1 MiB, rotating once, because the runner's stdio is ignored. */
+export const createRunLog = (root, opId) => {
+    const file = opLogFile(root, opId);
+    return async (entry) => {
+        try {
+            const size = await stat(file).then((info) => info.size, () => 0);
+            if (size > LOG_LIMIT_BYTES) {
+                await rm(`${file}.1`, { force: true });
+                await rename(file, `${file}.1`);
+            }
+            await appendFile(file, `${JSON.stringify({ at: new Date().toISOString(), pid: process.pid, ...entry })}\n`, { mode: 0o600 });
+        }
+        catch { /* the log is diagnostics only; it never fails an op */ }
+    };
+};
+export const opIn = (workspace, opId) => {
+    const op = workspace.ops.find((entry) => entry.opId === opId);
+    if (!op)
+        throw new Error(`op ${opId} is not in the workspace record`);
+    return op;
+};
+/** A ledger line, written BEFORE the step it names. */
+export const ledger = (env, entry) => (appendLedger(env.root, { ...entry, opId: env.opId, at: env.clock.now().toISOString() }));
+export const patchOp = (env, apply) => (mutateWorkspace(env.root, (workspace) => { apply(opIn(workspace, env.opId), workspace); }, { now: env.clock.now }));
+export const setPhase = async (env, phase) => {
+    await patchOp(env, (op) => { op.phase = phase; });
+    await env.log({ event: 'phase', phase });
+};
+export const failure = (code, message, flags = {}) => ({
+    state: 'failed',
+    error: { code, message, retryable: flags.retryable ?? false, resumable: flags.resumable ?? false },
+});
+/** Write the terminal state, settle the approval, close the ledger. */
+export const finishOp = async (env, outcome) => {
+    const at = env.clock.now().toISOString();
+    await patchOp(env, (op) => {
+        op.state = outcome.state;
+        op.error = outcome.state === 'failed' ? outcome.error : null;
+        op.finishedAt = at;
+        op.phase = 'settled';
+    });
+    await settleApproval({ stateRoot: env.stateRoot, workspaceId: env.workspaceId, opId: env.opId, at });
+    await ledger(env, outcome.state === 'failed'
+        ? { event: 'failed', code: outcome.error.code, message: outcome.error.message }
+        : { event: outcome.state === 'superseded' ? 'superseded' : 'settled' });
+    await env.log({ event: 'finished', outcome: outcome.state });
+};
+/**
+ * The error a thrown failure becomes. Nothing here costs money and every call
+ * id is stable, so an unclassified runner error is resumable: a Resume replays
+ * the same ids and the call store never repeats a finished call. A refusal the
+ * workspace itself made (a changed source file, a bad reference) is not; a
+ * corpus outage or rate limit (a retryable `SlateError`) is, because the search
+ * replays on its own key.
+ */
+export const errorFromRunner = (error) => {
+    if (error instanceof SlateError) {
+        const resumable = error.retryable;
+        return { code: error.code, message: error.message, retryable: error.retryable, resumable };
+    }
+    return { code: 'runner_error', message: error instanceof Error ? error.message : String(error), retryable: false, resumable: true };
+};
+export const sleepFor = (milliseconds, signal) => new Promise((resolve) => {
+    if (signal?.aborted) {
+        resolve();
+        return;
+    }
+    const finish = () => { clearTimeout(timer); signal?.removeEventListener('abort', finish); resolve(); };
+    const timer = setTimeout(finish, milliseconds);
+    signal?.addEventListener('abort', finish, { once: true });
+});
+//# sourceMappingURL=slate-runner-context.js.map

package/dist/slate-runner-context.js.map

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

package/dist/slate-runner-failure.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The sentence a person sees when one image call failed. The store's own
+ * messages are fixed text (it never copies a provider body into them), but the
+ * detail still goes only to the operator's log, so this maps by code and never
+ * echoes what the process printed.
+ */
+export declare const imageFailureMessage: (error: unknown) => string;
+//# sourceMappingURL=slate-runner-failure.d.ts.map

package/dist/slate-runner-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-failure.d.ts","sourceRoot":"","sources":["../src/slate-runner-failure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MAMpD,CAAC"}

package/dist/slate-runner-failure.js

@@ -0,0 +1,17 @@
+/**
+ * The sentence a person sees when one image call failed. The store's own
+ * messages are fixed text (it never copies a provider body into them), but the
+ * detail still goes only to the operator's log, so this maps by code and never
+ * echoes what the process printed.
+ */
+export const imageFailureMessage = (error) => {
+    const code = error?.code;
+    if (code === 'NEEDS_RECONCILIATION')
+        return 'The image call did not return an image.';
+    if (code === 'CALL_LOCKED')
+        return 'This image call is already running.';
+    if (code === 'REQUEST_CHANGED')
+        return 'This image call was started with different inputs.';
+    return 'This option could not be drawn.';
+};
+//# sourceMappingURL=slate-runner-failure.js.map

package/dist/slate-runner-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-failure.js","sourceRoot":"","sources":["../src/slate-runner-failure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAU,EAAE;IAC5D,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,yCAAyC,CAAC;IACtF,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,qCAAqC,CAAC;IACzE,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,oDAAoD,CAAC;IAC5F,OAAO,iCAAiC,CAAC;AAC3C,CAAC,CAAC"}

package/dist/slate-runner-flag.d.ts

@@ -0,0 +1,3 @@
+/** The environment marker only the workspace's own spawn sets; a hand-typed `12ui slate-runner` is refused. */
+export declare const RUNNER_ENV_FLAG = "TWELVE_UI_SLATE_RUNNER";
+//# sourceMappingURL=slate-runner-flag.d.ts.map

package/dist/slate-runner-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-flag.d.ts","sourceRoot":"","sources":["../src/slate-runner-flag.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,eAAO,MAAM,eAAe,2BAA2B,CAAC"}

package/dist/slate-runner-flag.js

@@ -0,0 +1,3 @@
+/** The environment marker only the workspace's own spawn sets; a hand-typed `12ui slate-runner` is refused. */
+export const RUNNER_ENV_FLAG = 'TWELVE_UI_SLATE_RUNNER';
+//# sourceMappingURL=slate-runner-flag.js.map

package/dist/slate-runner-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-flag.js","sourceRoot":"","sources":["../src/slate-runner-flag.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC"}

package/dist/slate-runner-main.d.ts

@@ -0,0 +1,31 @@
+import { type SlateCorpus } from './slate-corpus.js';
+import { type SlateImageExecutor } from './slate-image-executor.js';
+import { type RunnerClock } from './slate-runner-context.js';
+/**
+ * The detached process that owns one op to a terminal state (D1).
+ *
+ * Image work never runs inside the MCP server: a committed click spawns
+ * `12ui slate-runner <root> <opId>` and returns. The runner refuses (exit 2,
+ * nothing started) unless it was started by the server, the op is in the
+ * workspace, and the approval record written outside the run directory matches
+ * the frozen params: it runs `codex exec` with full access to its own scratch
+ * folder, so a planted `workspace.json` must never make it execute. It then
+ * takes the per-op lock, keeps a heartbeat in the lock's mtime, sets itself as
+ * the op's owner (compare-and-set), executes, and writes the terminal state.
+ * It reads no 12ui credentials: the workspace costs nothing.
+ */
+export type RunnerDependencies = {
+    /** The free corpus client; the default reads the optional-auth corpus configuration. */
+    corpus?: () => SlateCorpus;
+    /** The image executor; the default is the local Codex CLI's native image call. */
+    executor?: (root: string) => SlateImageExecutor;
+    clock?: Partial<RunnerClock>;
+    heartbeatIntervalMs?: number;
+};
+export declare const runSlateRunner: (args: {
+    root: string;
+    opId: string;
+    env?: NodeJS.ProcessEnv;
+    deps?: RunnerDependencies;
+}) => Promise<number>;
+//# sourceMappingURL=slate-runner-main.d.ts.map

package/dist/slate-runner-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-runner-main.d.ts","sourceRoot":"","sources":["../src/slate-runner-main.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAU/F,OAAO,EAQL,KAAK,WAAW,EAEjB,MAAM,2BAA2B,CAAC;AAKnC;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,WAAW,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,CAAC;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,MAAM;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,KAAG,OAAO,CAAC,MAAM,CAoEjB,CAAC"}