@12ui/design 0.2.71 → 0.2.73

package/dist/slate-runtime.js.map

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

package/dist/slate-versions.d.ts

@@ -0,0 +1,26 @@
+import type { SlateVersion, SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * Version image files: reading them with their recorded digest, and writing
+ * them once, temp-then-rename, never over a file with different bytes.
+ */
+export type FileState = 'ok' | 'missing' | 'changed';
+/**
+ * The state of one version's file. Hashing a 1.4 MB PNG on every status read
+ * would make polling expensive, so the digest is cached by (path, size, mtime).
+ */
+export declare const fileStateOf: (root: string, workspace: SlateWorkspace, version: SlateVersion) => Promise<FileState>;
+/**
+ * The state of a file that lives outside the workspace root (the durable pick
+ * copy). Same rules as `fileStateOf`: a missing file, a symlink, a non-file
+ * or a different digest is reported, never named as if it were fine.
+ */
+export declare const durableFileState: (file: string, sha256: string) => Promise<FileState>;
+/** The bytes of a version, verified against the record. Explicit errors otherwise. */
+export declare const readVersionBytes: (root: string, workspace: SlateWorkspace, version: SlateVersion) => Promise<Buffer>;
+/**
+ * Write image bytes once. An existing file with the same digest is reused; a
+ * same-name file with different bytes is an explicit error, never overwritten.
+ */
+export declare const writeImageOnce: (file: string, bytes: Uint8Array, sha256: string) => Promise<"written" | "reused">;
+export declare const shortSha: (sha256: string) => string;
+//# sourceMappingURL=slate-versions.d.ts.map

package/dist/slate-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-versions.d.ts","sourceRoot":"","sources":["../src/slate-versions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE/E;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAIrD;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,WAAW,cAAc,EACzB,SAAS,YAAY,KACpB,OAAO,CAAC,SAAS,CAmBnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,SAAS,CAuBtF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,cAAc,EACzB,SAAS,YAAY,KACpB,OAAO,CAAC,MAAM,CAShB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,EAAE,OAAO,UAAU,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,CAiBlH,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,KAAG,MAA4B,CAAC"}

package/dist/slate-versions.js

@@ -0,0 +1,110 @@
+import { randomUUID } from 'node:crypto';
+import { chmod, lstat, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { SlateError } from './slate-errors.js';
+import { sha256Hex } from './slate-ids.js';
+import { readWorkspaceFile, versionFilePath } from './slate-paths.js';
+const stateCache = new Map();
+/**
+ * The state of one version's file. Hashing a 1.4 MB PNG on every status read
+ * would make polling expensive, so the digest is cached by (path, size, mtime).
+ */
+export const fileStateOf = async (root, workspace, version) => {
+    const file = versionFilePath(root, workspace, version.versionId);
+    let entry;
+    try {
+        entry = await lstat(file);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 'missing';
+        throw error;
+    }
+    if (entry.isSymbolicLink() || !entry.isFile())
+        return 'changed';
+    const cached = stateCache.get(file);
+    if (cached && cached.size === entry.size && cached.mtimeMs === entry.mtimeMs) {
+        return cached.sha256 === version.sha256 ? 'ok' : 'changed';
+    }
+    const read = await readWorkspaceFile(root, file);
+    if (read.state === 'missing')
+        return 'missing';
+    if (read.state === 'outside')
+        return 'changed';
+    stateCache.set(file, { size: entry.size, mtimeMs: entry.mtimeMs, sha256: read.sha256 });
+    return read.sha256 === version.sha256 ? 'ok' : 'changed';
+};
+/**
+ * The state of a file that lives outside the workspace root (the durable pick
+ * copy). Same rules as `fileStateOf`: a missing file, a symlink, a non-file
+ * or a different digest is reported, never named as if it were fine.
+ */
+export const durableFileState = async (file, sha256) => {
+    let entry;
+    try {
+        entry = await lstat(file);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 'missing';
+        throw error;
+    }
+    if (entry.isSymbolicLink() || !entry.isFile())
+        return 'changed';
+    const cached = stateCache.get(file);
+    if (cached && cached.size === entry.size && cached.mtimeMs === entry.mtimeMs) {
+        return cached.sha256 === sha256 ? 'ok' : 'changed';
+    }
+    let bytes;
+    try {
+        bytes = await readFile(file);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 'missing';
+        throw error;
+    }
+    const actual = sha256Hex(bytes);
+    stateCache.set(file, { size: entry.size, mtimeMs: entry.mtimeMs, sha256: actual });
+    return actual === sha256 ? 'ok' : 'changed';
+};
+/** The bytes of a version, verified against the record. Explicit errors otherwise. */
+export const readVersionBytes = async (root, workspace, version) => {
+    const file = versionFilePath(root, workspace, version.versionId);
+    const read = await readWorkspaceFile(root, file);
+    if (read.state === 'missing')
+        throw new SlateError('file_missing', `Version ${version.versionId} is missing on this Mac: ${file}`);
+    if (read.state === 'outside')
+        throw new SlateError('file_changed', `Version ${version.versionId} resolves outside the workspace`);
+    if (read.sha256 !== version.sha256) {
+        throw new SlateError('file_changed', `Version ${version.versionId} changed on disk: sha256 ${read.sha256} does not match the workspace record`);
+    }
+    return read.bytes;
+};
+/**
+ * Write image bytes once. An existing file with the same digest is reused; a
+ * same-name file with different bytes is an explicit error, never overwritten.
+ */
+export const writeImageOnce = async (file, bytes, sha256) => {
+    if (sha256Hex(bytes) !== sha256)
+        throw new Error(`Refusing to write ${file}: bytes do not match the expected digest`);
+    const existing = await readFile(file).catch(() => null);
+    if (existing) {
+        if (sha256Hex(existing) !== sha256)
+            throw new Error(`Refusing to replace ${file}: it holds different bytes`);
+        return 'reused';
+    }
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = path.join(path.dirname(file), `.${path.basename(file)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, bytes, { flag: 'wx', mode: 0o600 });
+        await rename(temporary, file);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+    await chmod(file, 0o600).catch(() => undefined);
+    return 'written';
+};
+export const shortSha = (sha256) => sha256.slice(0, 8);
+//# sourceMappingURL=slate-versions.js.map

package/dist/slate-versions.js.map

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

package/dist/slate-view-contract.d.ts

@@ -0,0 +1,233 @@
+/** The contract between the workspace UI and its tools. Types and names only. */
+export declare const SLATE_VIEW_SCHEMA: "12ui.slate.view/3";
+export declare const SLATE_UI_TOOLS: {
+    readonly show: "design.slate.show";
+    readonly data: "design.slate.data";
+    readonly open: "design.slate.open";
+    readonly image: "design.slate.image";
+    readonly reference: "design.slate.reference";
+    readonly inspire: "design.slate.inspire";
+    readonly inspiration: "design.slate.inspiration";
+    readonly pick: "design.slate.pick";
+    readonly run: "design.slate.run";
+    readonly resume: "design.slate.resume";
+    readonly status: "design.slate.status";
+    readonly handoff: "design.slate.handoff";
+};
+/** A box on an image in thousandths of its width and height. */
+export type SlateRegion = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** A freehand stroke: integer permille points [x, y], 0..1000, in the displayed image's frame. */
+export type SlateStroke = [number, number][];
+export type SlateOpError = {
+    code: string;
+    message: string;
+    retryable: boolean;
+    resumable: boolean;
+};
+export type SlateToolError = {
+    code: string;
+    message: string;
+    retryable: boolean;
+    retryAfterSeconds?: number;
+};
+export type SlateMarks = {
+    strokes: number;
+    region: SlateRegion;
+};
+export type SlateConvertOutput = 'html' | 'react' | 'assets' | 'layerdoc' | 'html_fixed' | 'svg' | 'png' | 'jpg' | 'webp' | 'pdf' | 'psd' | 'pptx' | 'sketch';
+export type SlateHandoffRecord = {
+    handoffId: string;
+    kind: 'branch';
+    versionId: string;
+    sha256: string;
+    requestedAt: string;
+    options: {
+        explanation: string;
+    };
+} | {
+    handoffId: string;
+    kind: 'convert';
+    versionId: string;
+    sha256: string;
+    requestedAt: string;
+    options: {
+        engine: 'local' | 'service';
+        output: SlateConvertOutput;
+        cleanAssets?: 'crop' | 'enhance';
+        model?: 'fast' | 'standard' | 'pro';
+        width?: number;
+        responsiveQuality?: 'standard' | 'pro';
+    };
+};
+export type SlateAction = {
+    kind: 'round';
+    mode: 'new' | 'like';
+    note?: string;
+    fromVersionId?: string;
+    count?: 2 | 4 | 6 | 8;
+} | {
+    kind: 'edit';
+    versionId: string;
+    prompt: string;
+    strokes?: SlateStroke[];
+};
+export type SlateReferenceMeta = {
+    referenceId: string;
+    aspect: 'portrait' | 'landscape' | 'square';
+    width: number | null;
+    height: number | null;
+    description: string | null;
+    uiType: string | null;
+};
+export type SlateWorkspaceView = {
+    schema: typeof SLATE_VIEW_SCHEMA;
+    rev: number;
+    /** `${rev}:${livenessDigest}`; changes when the record or any op's derived liveness changes. */
+    stamp: string;
+    workspaceId: string | null;
+    runDir: string | null;
+    brief: {
+        concept: string;
+        aspect: 'landscape' | 'portrait' | 'square';
+    } | null;
+    /** Whether Design and Edit can run on this Mac now. Probed at most once a minute per server. */
+    local: {
+        image: {
+            ready: boolean;
+            reason: string | null;
+        };
+    };
+    rounds: {
+        roundId: string;
+        index: number;
+        kind: 'root' | 'new' | 'like';
+        note: string | null;
+        fromVersionId: string | null;
+        state: 'running' | 'settled' | 'failed' | 'interrupted';
+        count: number;
+        readyCount: number;
+        /** The references that produced this round's options, in option order. */
+        referenceIds: string[];
+        referenceSource: 'root' | 'selected' | 'search';
+    }[];
+    candidates: {
+        candidateId: string;
+        label: string;
+        roundId: string;
+        state: 'ready' | 'pending' | 'failed';
+        error: string | null;
+        versionIds: string[];
+        latestVersionId: string | null;
+        busy: boolean;
+        busyOpId: string | null;
+        latestOpId: string | null;
+        referenceId: string | null;
+    }[];
+    versions: {
+        versionId: string;
+        candidateId: string;
+        label: string;
+        n: number;
+        kind: 'generation' | 'edit';
+        parentVersionId: string | null;
+        prompt: string | null;
+        marks: SlateMarks | null;
+        width: number;
+        height: number;
+        sha256: string;
+        /** Recomputed from ids on every read; never taken from the record. */
+        path: string;
+        createdAt: string;
+        fileState: 'ok' | 'missing' | 'changed';
+        /** True when the file is ok and no op is running on this option. */
+        editable: boolean;
+        editBlockedReason: string | null;
+    }[];
+    ops: {
+        opId: string;
+        kind: 'round' | 'edit';
+        state: 'starting' | 'running' | 'succeeded' | 'failed' | 'interrupted' | 'superseded';
+        phase: string;
+        attempt: number;
+        target: string | null;
+        startedAt: string;
+        finishedAt: string | null;
+        error: SlateOpError | null;
+        edit: {
+            parentVersionId: string;
+            prompt: string;
+            marks: SlateMarks | null;
+        } | null;
+        resultVersionIds: string[];
+        runner: {
+            alive: boolean;
+            pid: number | null;
+            heartbeatAgeMs: number | null;
+        };
+        /** Interrupted or failed-resumable, the approval record present, and the latest attempt. */
+        resumable: boolean;
+    }[];
+    pick: {
+        versionId: string;
+        label: string;
+        reason: string | null;
+        pickedAt: string;
+        /** The durable copy, or null when it is missing or no longer matches `sha256`. */
+        imagePath: string | null;
+        fileState: 'ok' | 'missing' | 'changed';
+        intact: boolean;
+        sourcePath: string;
+        sha256: string;
+    } | null;
+    inspiration: {
+        selected: string[];
+        searches: {
+            searchId: string;
+            query: string;
+            mode: 'balanced';
+            at: string;
+            referenceIds: string[];
+        }[];
+    };
+    /** Metadata for every reference id named anywhere above. */
+    references: Record<string, SlateReferenceMeta>;
+    /** Branch and Convert requests, oldest first. */
+    handoffs: (SlateHandoffRecord & {
+        label: string;
+        imagePath: string | null;
+    })[];
+};
+/** What the app tools return in `structuredContent` (an error result is `SlateToolError` with `isError`). */
+export type SlateStatusResult = SlateWorkspaceView | {
+    unchanged: true;
+    stamp: string;
+};
+export type SlatePickResult = {
+    pick: SlateWorkspaceView['pick'];
+    rev: number;
+    view: SlateWorkspaceView;
+};
+export type SlateRunResult = {
+    op: SlateWorkspaceView['ops'][number] | null;
+    view: SlateWorkspaceView;
+};
+export type SlateInspireResult = {
+    search: SlateWorkspaceView['inspiration']['searches'][number];
+    view: SlateWorkspaceView;
+};
+export type SlateInspirationResult = {
+    selected: string[];
+    rev: number;
+    view: SlateWorkspaceView;
+};
+export type SlateHandoffResult = {
+    handoff: SlateWorkspaceView['handoffs'][number];
+    rev: number;
+    view: SlateWorkspaceView;
+};
+//# sourceMappingURL=slate-view-contract.d.ts.map

package/dist/slate-view-contract.d.ts.map

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

package/dist/slate-view-contract.js

@@ -0,0 +1,17 @@
+/** The contract between the workspace UI and its tools. Types and names only. */
+export const SLATE_VIEW_SCHEMA = '12ui.slate.view/3';
+export const SLATE_UI_TOOLS = {
+    show: 'design.slate.show',
+    data: 'design.slate.data',
+    open: 'design.slate.open',
+    image: 'design.slate.image',
+    reference: 'design.slate.reference',
+    inspire: 'design.slate.inspire',
+    inspiration: 'design.slate.inspiration',
+    pick: 'design.slate.pick',
+    run: 'design.slate.run',
+    resume: 'design.slate.resume',
+    status: 'design.slate.status',
+    handoff: 'design.slate.handoff',
+};
+//# sourceMappingURL=slate-view-contract.js.map

package/dist/slate-view-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-view-contract.js","sourceRoot":"","sources":["../src/slate-view-contract.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAA4B,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,oBAAoB;IAC3B,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EAAE,0BAA0B;IACvC,IAAI,EAAE,mBAAmB;IACzB,GAAG,EAAE,kBAAkB;IACvB,MAAM,EAAE,qBAAqB;IAC7B,MAAM,EAAE,qBAAqB;IAC7B,OAAO,EAAE,sBAAsB;CACvB,CAAC"}

package/dist/slate-view-types.d.ts

@@ -0,0 +1,2 @@
+export * from './slate-view-contract.js';
+//# sourceMappingURL=slate-view-types.d.ts.map

package/dist/slate-view-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-view-types.d.ts","sourceRoot":"","sources":["../src/slate-view-types.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/slate-view-types.js

@@ -0,0 +1,2 @@
+export * from './slate-view-contract.js';
+//# sourceMappingURL=slate-view-types.js.map

package/dist/slate-view-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-view-types.js","sourceRoot":"","sources":["../src/slate-view-types.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/slate-view.d.ts

@@ -0,0 +1,19 @@
+import type { SlateWorkspaceView } from './slate-view-contract.js';
+import type { SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * The single view every tool returns. It is derived: file states from the
+ * files, op states from the lock files and the clock. Nothing in it is
+ * authority; the record and the approval store are. It carries no money.
+ */
+export type LocalImageState = SlateWorkspaceView['local']['image'];
+export declare const pickImagePath: (stateRoot: string, workspaceId: string, versionId: string, sha256: string) => string;
+export declare const handoffImagePath: (stateRoot: string, workspaceId: string, handoffId: string, sha256: string) => string;
+export declare const buildView: (args: {
+    root: string;
+    workspace: SlateWorkspace;
+    stateRoot: string;
+    now: Date;
+    local: LocalImageState;
+}) => Promise<SlateWorkspaceView>;
+export declare const emptyView: (local: LocalImageState) => SlateWorkspaceView;
+//# sourceMappingURL=slate-view.d.ts.map

package/dist/slate-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-view.d.ts","sourceRoot":"","sources":["../src/slate-view.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;AAEnE,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,EAAE,WAAW,MAAM,EAAE,QAAQ,MAAM,KAAG,MAEzG,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,EAAE,WAAW,MAAM,EAAE,QAAQ,MAAM,KAAG,MAE5G,CAAC;AAQF,eAAO,MAAM,SAAS,GAAU,MAAM;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,eAAe,CAAC;CACxB,KAAG,OAAO,CAAC,kBAAkB,CAiK7B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,eAAe,KAAG,kBAgBjD,CAAC"}

package/dist/slate-view.js

@@ -0,0 +1,184 @@
+import path from 'node:path';
+import { approvalKey, listApprovalKeys, slateHandoffsDirectory, slatePicksDirectory } from './slate-approvals.js';
+import { busyOp, editBlocker } from './slate-editability.js';
+import { readLiveness } from './slate-liveness.js';
+import { namedReferenceIds } from './slate-reference-ids.js';
+import { versionLabelFor } from './slate-labels.js';
+import { versionFilePath } from './slate-paths.js';
+import { SLATE_VIEW_SCHEMA } from './slate-view-contract.js';
+import { durableFileState, fileStateOf, shortSha } from './slate-versions.js';
+export const pickImagePath = (stateRoot, workspaceId, versionId, sha256) => (path.join(slatePicksDirectory(stateRoot, workspaceId), `${versionId}-${shortSha(sha256)}.png`));
+export const handoffImagePath = (stateRoot, workspaceId, handoffId, sha256) => (path.join(slateHandoffsDirectory(stateRoot, workspaceId), `${handoffId}-${shortSha(sha256)}.png`));
+const referenceMetadata = (workspace) => Object.fromEntries(namedReferenceIds(workspace).map((id) => [id, workspace.references[id] ?? {
+        referenceId: id, aspect: workspace.brief.aspect, width: null, height: null, description: null, uiType: null,
+    }]));
+export const buildView = async (args) => {
+    const { root, workspace, stateRoot, now } = args;
+    const nowMs = now.getTime();
+    const liveness = await readLiveness(root, workspace, nowMs);
+    const approvalKeys = await listApprovalKeys(stateRoot).catch(() => new Set());
+    const fileStates = new Map(await Promise.all(workspace.versions.map(async (version) => [version.versionId, await fileStateOf(root, workspace, version)])));
+    const candidateOf = (id) => workspace.candidates.find((entry) => entry.candidateId === id);
+    const ops = workspace.ops.map((op) => {
+        const runner = liveness.runners.get(op.opId);
+        const state = liveness.states.get(op.opId);
+        const candidate = op.kind === 'edit' ? candidateOf(op.target.candidateId) : undefined;
+        const target = op.params.kind === 'round' ? `Round ${op.params.index}` : candidate.label;
+        const waiting = state === 'interrupted' || (op.state === 'failed' && op.error?.resumable === true);
+        const latest = candidate ? candidate.latestOpId === op.opId : true;
+        return {
+            opId: op.opId,
+            kind: op.kind,
+            state,
+            phase: op.phase,
+            attempt: op.attempt,
+            target,
+            startedAt: op.startedAt,
+            finishedAt: op.finishedAt,
+            error: op.error,
+            edit: op.params.kind === 'edit'
+                ? {
+                    parentVersionId: op.params.parentVersionId,
+                    prompt: op.params.prompt,
+                    marks: op.params.region ? { strokes: op.params.strokeCount, region: op.params.region } : null,
+                }
+                : null,
+            resultVersionIds: op.resultVersionIds,
+            runner: { alive: runner.alive, pid: runner.pid, heartbeatAgeMs: runner.heartbeatAgeMs },
+            resumable: waiting && latest && approvalKeys.has(approvalKey(workspace.workspaceId, op.opId)),
+        };
+    });
+    const versions = workspace.versions.map((version) => {
+        const candidate = candidateOf(version.candidateId);
+        const fileState = fileStates.get(version.versionId);
+        const blocker = editBlocker(workspace, candidate);
+        const fileBlock = fileState === 'ok' ? null : fileState === 'missing' ? 'File missing on this Mac.' : 'This file changed on disk.';
+        return {
+            versionId: version.versionId,
+            candidateId: version.candidateId,
+            label: versionLabelFor(candidate.label, version.n),
+            n: version.n,
+            kind: version.kind,
+            parentVersionId: version.parentVersionId,
+            prompt: version.prompt,
+            marks: version.marks,
+            width: version.width,
+            height: version.height,
+            sha256: version.sha256,
+            path: versionFilePath(root, workspace, version.versionId),
+            createdAt: version.createdAt,
+            fileState,
+            editable: blocker === null && fileBlock === null,
+            editBlockedReason: fileBlock ?? blocker?.message ?? null,
+        };
+    });
+    const candidates = workspace.candidates.map((candidate) => {
+        const busy = busyOp(workspace, candidate);
+        // A round that ended failed and not resumable never draws its remaining options.
+        const refusal = candidate.versionIds.length === 0 && candidate.error === null
+            ? workspace.ops.filter((op) => op.params.kind === 'round' && op.params.candidateIds.includes(candidate.candidateId) && op.state === 'failed' && !op.error?.resumable).at(-1)?.error?.message
+            : undefined;
+        const state = candidate.versionIds.length > 0
+            ? 'ready'
+            : candidate.error !== null || refusal !== undefined ? 'failed' : 'pending';
+        return {
+            candidateId: candidate.candidateId,
+            label: candidate.label,
+            roundId: candidate.roundId,
+            state,
+            error: state === 'failed' ? candidate.error ?? refusal ?? 'This option could not be drawn.' : null,
+            versionIds: candidate.versionIds,
+            latestVersionId: candidate.versionIds.at(-1) ?? null,
+            busy: busy !== undefined,
+            busyOpId: busy?.opId ?? null,
+            latestOpId: candidate.latestOpId,
+            referenceId: candidate.referenceId,
+        };
+    });
+    const rounds = workspace.rounds.map((round) => {
+        const roundOps = workspace.ops.filter((op) => op.params.kind === 'round' && op.params.roundId === round.roundId);
+        const derived = roundOps.map((op) => liveness.states.get(op.opId));
+        const own = candidates.filter((candidate) => candidate.roundId === round.roundId);
+        const state = derived.some((s) => s === 'running' || s === 'starting')
+            ? 'running'
+            : derived.some((s) => s === 'interrupted') || roundOps.some((op) => op.state === 'failed' && op.error?.resumable)
+                ? 'interrupted'
+                : roundOps.some((op) => op.state === 'failed') && own.every((candidate) => candidate.state !== 'ready')
+                    ? 'failed'
+                    : 'settled';
+        return {
+            roundId: round.roundId,
+            index: round.index,
+            kind: round.kind,
+            note: round.note,
+            fromVersionId: round.fromVersionId,
+            state,
+            count: own.length || round.count,
+            readyCount: own.filter((candidate) => candidate.state === 'ready').length,
+            referenceIds: round.referenceIds,
+            referenceSource: round.referenceSource,
+        };
+    });
+    const recorded = workspace.pick;
+    const pick = recorded && await (async () => {
+        const version = workspace.versions.find((entry) => entry.versionId === recorded.versionId);
+        const candidate = candidateOf(version.candidateId);
+        const durable = pickImagePath(stateRoot, workspace.workspaceId, version.versionId, recorded.sha256);
+        const pickState = await durableFileState(durable, recorded.sha256);
+        return {
+            versionId: version.versionId,
+            label: versionLabelFor(candidate.label, version.n),
+            reason: recorded.reason,
+            pickedAt: recorded.pickedAt,
+            imagePath: pickState === 'ok' ? durable : null,
+            fileState: pickState,
+            intact: pickState === 'ok',
+            sourcePath: versionFilePath(root, workspace, version.versionId),
+            sha256: recorded.sha256,
+        };
+    })();
+    const handoffs = await Promise.all(workspace.handoffs.map(async (handoff) => {
+        const version = workspace.versions.find((entry) => entry.versionId === handoff.versionId);
+        const durable = handoffImagePath(stateRoot, workspace.workspaceId, handoff.handoffId, handoff.sha256);
+        const state = await durableFileState(durable, handoff.sha256);
+        return { ...handoff, label: versionLabelFor(candidateOf(version.candidateId).label, version.n), imagePath: state === 'ok' ? durable : null };
+    }));
+    return {
+        schema: SLATE_VIEW_SCHEMA,
+        rev: workspace.rev,
+        stamp: `${workspace.rev}:${liveness.digest}`,
+        workspaceId: workspace.workspaceId,
+        runDir: root,
+        brief: { concept: workspace.brief.concept, aspect: workspace.brief.aspect },
+        local: { image: args.local },
+        rounds,
+        candidates,
+        versions,
+        ops,
+        pick: pick ?? null,
+        inspiration: {
+            selected: workspace.inspiration.selected,
+            searches: workspace.inspiration.searches.map((search) => ({ ...search })),
+        },
+        references: referenceMetadata(workspace),
+        handoffs,
+    };
+};
+export const emptyView = (local) => ({
+    schema: SLATE_VIEW_SCHEMA,
+    rev: 0,
+    stamp: '0:none',
+    workspaceId: null,
+    runDir: null,
+    brief: null,
+    local: { image: local },
+    rounds: [],
+    candidates: [],
+    versions: [],
+    ops: [],
+    pick: null,
+    inspiration: { selected: [], searches: [] },
+    references: {},
+    handoffs: [],
+});
+//# sourceMappingURL=slate-view.js.map