@12ui/design 0.2.72 → 0.2.73

package/dist/slate-commit.js

@@ -0,0 +1,218 @@
+import { SlateError } from './slate-errors.js';
+import { recordApproval } from './slate-approvals.js';
+import { renderAnnotated } from './slate-annotate.js';
+import { assembleEditPrompt } from './slate-edit-prompt.js';
+import { editBlocker, optionOf } from './slate-editability.js';
+import { digestOf, editVersionId, sha256Hex, slotFor } from './slate-ids.js';
+import { nextOptionLabels, versionLabelFor } from './slate-labels.js';
+import { appendLedger } from './slate-ledger.js';
+import { editAnnotatedFile, editSourceFile, ensureEditDirectory } from './slate-paths.js';
+import { composeConcept, conceptLimitProblem, freshReferenceProblem, likeSearchImageProblem } from './slate-round-params.js';
+import { readVersionBytes, writeImageOnce } from './slate-versions.js';
+import { WORKSPACE_MAX_ROUNDS } from './slate-workspace-parse.js';
+import { NoWrite, findVersion, isNonTerminal, mutateWorkspace } from './slate-workspace-store.js';
+/**
+ * The commit critical section. Inside ONE workspace lock this does the op-id
+ * lookup, the intent lookup, the busy check, index and label allocation, the
+ * frozen selection and reference skip list, the edit's parent copy and
+ * annotated image, the approval write, and the op, round and option appends.
+ * Everything decided here is stored in `op.params` and is never recomputed by
+ * the runner or by `resume`.
+ */
+/** The dedupe key for one intent: the workspace and the normalized action, no op id. */
+export const intentDigestOf = (workspaceId, action) => digestOf({ workspaceId, action });
+/** References earlier rounds used, sorted, so a searching round meets ones it has not shown before. */
+export const referenceSkipList = (workspace) => ([...new Set(workspace.rounds.flatMap((round) => round.referenceIds))].sort());
+/** Option `i` of a round draws from the selected reference `i mod n`. */
+export const optionReferences = (selected, count) => (selected.length === 0 ? [] : Array.from({ length: count }, (_unused, index) => selected[index % selected.length]));
+const asSourceMissing = (error) => {
+    if (error instanceof SlateError && (error.code === 'file_missing' || error.code === 'file_changed')) {
+        throw new SlateError('source_missing', error.message);
+    }
+    throw error;
+};
+const freezeRound = async (action, ws, root) => {
+    if (!ws.brief.concept.trim())
+        throw new SlateError('invalid_input', 'This run has no recorded brief, so a new round cannot be written.');
+    if (ws.rounds.length >= WORKSPACE_MAX_ROUNDS)
+        throw new SlateError('invalid_input', 'This workspace has reached its round limit.');
+    const concept = composeConcept(ws.brief.concept, action.note);
+    const conceptProblem = conceptLimitProblem(concept);
+    if (conceptProblem)
+        throw new SlateError('invalid_input', conceptProblem);
+    const selected = [...ws.inspiration.selected];
+    let from = null;
+    if (action.fromVersionId) {
+        const version = findVersion(ws, action.fromVersionId);
+        const bytes = await readVersionBytes(root, ws, version).catch(asSourceMissing);
+        const sizeProblem = selected.length === 0 ? likeSearchImageProblem(bytes.byteLength) : null;
+        if (sizeProblem)
+            throw new SlateError('invalid_input', sizeProblem);
+        from = { versionId: version.versionId, sourceSha256: sha256Hex(bytes) };
+    }
+    const skip = selected.length === 0 ? referenceSkipList(ws) : [];
+    if (selected.length === 0) {
+        const problem = freshReferenceProblem({ count: action.count, skipCount: skip.length });
+        if (problem)
+            throw new SlateError('no_fresh_references', problem);
+    }
+    const index = 1 + Math.max(...ws.rounds.map((round) => round.index));
+    const roundId = `r${index}`;
+    const labels = nextOptionLabels(ws.candidates.map((candidate) => candidate.label), action.count);
+    const params = {
+        kind: 'round',
+        roundId,
+        index,
+        mode: action.mode,
+        count: action.count,
+        concept,
+        note: action.note,
+        aspect: ws.brief.aspect,
+        from,
+        references: selected,
+        referenceSkip: skip,
+        labels,
+        candidateIds: labels.map((_label, i) => `${roundId}_${slotFor(i)}`),
+    };
+    const perOption = optionReferences(selected, action.count);
+    const round = {
+        roundId,
+        index,
+        kind: action.mode,
+        opId: null,
+        note: action.note,
+        fromVersionId: from?.versionId ?? null,
+        count: action.count,
+        referenceIds: [...new Set(perOption)],
+        referenceSource: selected.length > 0 ? 'selected' : 'search',
+    };
+    return { params, round, selectedFor: perOption };
+};
+const freezeEdit = async (action, ws, root, opId) => {
+    const version = findVersion(ws, action.versionId);
+    const option = optionOf(ws, version.candidateId);
+    if (!option)
+        throw new SlateError('not_found', `Unknown option for version ${version.versionId}`);
+    const blocker = editBlocker(ws, option.candidate);
+    if (blocker)
+        throw new SlateError(blocker.code, blocker.message);
+    const bytes = await readVersionBytes(root, ws, version).catch(asSourceMissing);
+    await ensureEditDirectory(root, opId);
+    const sourceSha256 = sha256Hex(bytes);
+    await writeImageOnce(editSourceFile(root, opId), bytes, sourceSha256);
+    let region = null;
+    let annotatedSha256 = null;
+    let strokeColor = null;
+    let colorName = null;
+    if (action.strokes.length > 0) {
+        const annotated = await renderAnnotated(bytes, action.strokes);
+        annotatedSha256 = sha256Hex(annotated.png);
+        await writeImageOnce(editAnnotatedFile(root, opId), annotated.png, annotatedSha256);
+        region = annotated.region;
+        strokeColor = annotated.color.hex;
+        colorName = annotated.color.name;
+    }
+    const sent = assembleEditPrompt({ prompt: action.prompt, region, colorName });
+    const n = option.candidate.versionIds.length + 1;
+    return {
+        kind: 'edit',
+        candidateId: option.candidate.candidateId,
+        parentVersionId: version.versionId,
+        sourceSha256,
+        prompt: action.prompt,
+        sentPrompt: sent.sentPrompt,
+        sentPromptSha256: sent.sentPromptSha256,
+        strokeCount: action.strokes.length,
+        region,
+        annotatedSha256,
+        strokeColor,
+        newVersionId: editVersionId(opId),
+        newLabel: versionLabelFor(option.candidate.label, n),
+        n,
+        width: version.width,
+        height: version.height,
+    };
+};
+export const commitAction = async (args) => mutateWorkspace(args.root, async (ws, context) => {
+    const intentDigest = intentDigestOf(ws.workspaceId, args.action);
+    const found = ws.ops.find((op) => op.opId === args.opId);
+    if (found) {
+        if (found.intentDigest !== intentDigest) {
+            throw new SlateError('intent_conflict', 'This op id was already used for a different action.');
+        }
+        return new NoWrite({ op: found, created: false });
+    }
+    const twin = ws.ops.find((op) => op.intentDigest === intentDigest && isNonTerminal(op));
+    if (twin)
+        return new NoWrite({ op: twin, created: false });
+    const action = args.action;
+    let params;
+    let target;
+    let frozenRound;
+    if (action.kind === 'round') {
+        frozenRound = await freezeRound(action, ws, args.root);
+        params = frozenRound.params;
+        target = { roundId: frozenRound.params.roundId };
+    }
+    else {
+        params = await freezeEdit(action, ws, args.root, args.opId);
+        target = { candidateId: params.candidateId, versionId: params.parentVersionId };
+    }
+    const paramsDigest = digestOf(params);
+    const approvedAt = context.now.toISOString();
+    const op = {
+        opId: args.opId,
+        kind: params.kind,
+        intentDigest,
+        paramsDigest,
+        approvedAt,
+        state: 'running',
+        phase: 'ledgered',
+        attempt: 1,
+        owner: null,
+        spawnedAt: null,
+        params,
+        target,
+        startedAt: approvedAt,
+        finishedAt: null,
+        error: null,
+        resultVersionIds: [],
+    };
+    // The click is the consent, and the record of it exists before any work starts.
+    await recordApproval({
+        stateRoot: args.stateRoot,
+        now: context.now.getTime(),
+        entry: {
+            opId: args.opId,
+            workspaceId: ws.workspaceId,
+            rootRealpath: args.root,
+            kind: params.kind,
+            paramsDigest,
+            approvedAt,
+            settledAt: null,
+        },
+    });
+    if (frozenRound && params.kind === 'round') {
+        ws.rounds.push({ ...frozenRound.round, opId: args.opId });
+        params.candidateIds.forEach((candidateId, i) => {
+            ws.candidates.push({
+                candidateId,
+                label: params.labels[i],
+                roundId: params.roundId,
+                localSlot: null,
+                referenceId: frozenRound.selectedFor[i] ?? null,
+                versionIds: [],
+                latestOpId: args.opId,
+                error: null,
+            });
+        });
+    }
+    else if (params.kind === 'edit') {
+        const candidate = ws.candidates.find((entry) => entry.candidateId === params.candidateId);
+        candidate.latestOpId = args.opId;
+    }
+    ws.ops.push(op);
+    await appendLedger(args.root, { event: 'approved', opId: args.opId, kind: params.kind, at: approvedAt });
+    return { op, created: true };
+}, args.now ? { now: args.now } : {});
+//# sourceMappingURL=slate-commit.js.map

package/dist/slate-commit.js.map

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

package/dist/slate-corpus.d.ts

@@ -0,0 +1,14 @@
+import { type CorpusConfig } from './config.js';
+import { TwelveUiCorpusClient } from './corpus-client.js';
+import { SlateError } from './slate-errors.js';
+/**
+ * The free corpus, as the workspace uses it: search and reference downloads,
+ * no account required. Only the three calls the workspace makes are named, so a
+ * test hands in a real client aimed at a local server and nothing else.
+ */
+export type SlateCorpus = Pick<TwelveUiCorpusClient, 'inspire' | 'download' | 'reference'>;
+/** A corpus client whose configuration is read once, on first use, and never fails on a missing key. */
+export declare const lazyCorpus: (config?: () => Partial<CorpusConfig>) => (() => SlateCorpus);
+/** A corpus failure as the tool result the workspace shows: retryable, with the wait when the service gave one. */
+export declare const corpusFailure: (error: unknown) => SlateError;
+//# sourceMappingURL=slate-corpus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-corpus.d.ts","sourceRoot":"","sources":["../src/slate-corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAE3F,wGAAwG;AACxG,eAAO,MAAM,UAAU,GAAI,SAAQ,MAAM,OAAO,CAAC,YAAY,CAAc,KAAG,CAAC,MAAM,WAAW,CAM/F,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,UAe9C,CAAC"}

package/dist/slate-corpus.js

@@ -0,0 +1,32 @@
+import { readCorpusConfig } from './config.js';
+import { CorpusRequestError } from './corpus-request-error.js';
+import { TwelveUiCorpusClient } from './corpus-client.js';
+import { SlateError } from './slate-errors.js';
+/** A corpus client whose configuration is read once, on first use, and never fails on a missing key. */
+export const lazyCorpus = (config = () => ({})) => {
+    let client;
+    return () => {
+        client ??= new TwelveUiCorpusClient(readCorpusConfig(config()));
+        return client;
+    };
+};
+/** A corpus failure as the tool result the workspace shows: retryable, with the wait when the service gave one. */
+export const corpusFailure = (error) => {
+    if (error instanceof SlateError)
+        return error;
+    if (error instanceof CorpusRequestError) {
+        if (error.status === 429) {
+            return new SlateError('rate_limited', 'The free reference search is at its limit for now.', {
+                ...(error.retryAfterSeconds === undefined ? {} : { retryAfterSeconds: error.retryAfterSeconds }),
+            });
+        }
+        if (error.status >= 400 && error.status < 500 && error.status !== 408) {
+            return new SlateError('invalid_input', `The corpus refused the request (${error.status}).`);
+        }
+        return new SlateError('corpus_unavailable', `The reference corpus could not be reached (${error.status}).`);
+    }
+    if (error instanceof TypeError || error instanceof RangeError)
+        return new SlateError('invalid_input', error.message);
+    return new SlateError('corpus_unavailable', error instanceof Error ? error.message : String(error));
+};
+//# sourceMappingURL=slate-corpus.js.map

package/dist/slate-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-corpus.js","sourceRoot":"","sources":["../src/slate-corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAU/C,wGAAwG;AACxG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAsC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAuB,EAAE;IAClG,IAAI,MAA+B,CAAC;IACpC,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,IAAI,oBAAoB,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,mHAAmH;AACnH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAc,EAAE;IAC1D,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACzB,OAAO,IAAI,UAAU,CAAC,cAAc,EAAE,oDAAoD,EAAE;gBAC1F,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;aACjG,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACtE,OAAO,IAAI,UAAU,CAAC,eAAe,EAAE,mCAAmC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,oBAAoB,EAAE,8CAA8C,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,IAAI,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACrH,OAAO,IAAI,UAAU,CAAC,oBAAoB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC"}

package/dist/slate-edit-prompt.d.ts

@@ -0,0 +1,18 @@
+import type { SlateRegion } from './slate-workspace-types.js';
+export declare const regionZone: (region: SlateRegion) => string;
+export declare const regionRanges: (region: SlateRegion) => {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+};
+export declare const assembleEditPrompt: (args: {
+    prompt: string;
+    region: SlateRegion | null;
+    /** The name of the stroke colour, present exactly when the second image is sent. */
+    colorName: string | null;
+}) => {
+    sentPrompt: string;
+    sentPromptSha256: string;
+};
+//# sourceMappingURL=slate-edit-prompt.d.ts.map

package/dist/slate-edit-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-edit-prompt.d.ts","sourceRoot":"","sources":["../src/slate-edit-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAc9D,eAAO,MAAM,UAAU,GAAI,QAAQ,WAAW,KAAG,MAOhD,CAAC;AAIF,eAAO,MAAM,YAAY,GAAI,QAAQ,WAAW,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAK3G,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAajD,CAAC"}

package/dist/slate-edit-prompt.js

@@ -0,0 +1,41 @@
+import { sha256Hex } from './slate-ids.js';
+/**
+ * Turn an edit instruction and the strokes' bounding box into the text the
+ * local image call gets. No path takes a mask, so the box is words, and the
+ * strokes themselves travel as a second image (`slate-annotate.ts`) that the
+ * prompt tells the model to use only to locate the change.
+ */
+const ZONE_ROWS = ['top', 'middle', 'bottom'];
+const ZONE_COLUMNS = ['left', 'center', 'right'];
+const third = (permille) => (permille < 334 ? 0 : permille < 667 ? 1 : 2);
+export const regionZone = (region) => {
+    const row = third(region.y + region.h / 2);
+    const column = third(region.x + region.w / 2);
+    if (row === 1 && column === 1)
+        return 'center';
+    if (row === 1)
+        return ZONE_COLUMNS[column];
+    if (column === 1)
+        return ZONE_ROWS[row];
+    return `${ZONE_ROWS[row]} ${ZONE_COLUMNS[column]}`;
+};
+const percent = (permille) => Math.round(permille / 10);
+export const regionRanges = (region) => ({
+    left: percent(region.x),
+    right: percent(region.x + region.w),
+    top: percent(region.y),
+    bottom: percent(region.y + region.h),
+});
+export const assembleEditPrompt = (args) => {
+    const parts = ['Edit the first attached image. Preserve everything else exactly: layout, text, colours, identity.'];
+    if (args.region && args.colorName) {
+        const ranges = regionRanges(args.region);
+        parts.push(`The second attached image is the same design with the requested area marked by freehand ${args.colorName} strokes. `
+            + 'Use the marks only to locate the change; do not draw them in the result. '
+            + `The change belongs in the ${regionZone(args.region)} area, roughly ${ranges.left}% to ${ranges.right}% across and ${ranges.top}% to ${ranges.bottom}% down.`);
+    }
+    parts.push('Return the complete edited image at the original size.', `Requested change: ${args.prompt}`);
+    const sentPrompt = parts.join(' ');
+    return { sentPrompt, sentPromptSha256: sha256Hex(sentPrompt) };
+};
+//# sourceMappingURL=slate-edit-prompt.js.map

package/dist/slate-edit-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-edit-prompt.js","sourceRoot":"","sources":["../src/slate-edit-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;GAKG;AAEH,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AACvD,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAE1D,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAa,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAU,EAAE;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,MAAM,CAAE,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,GAAG,CAAE,CAAC;IACzC,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAgE,EAAE,CAAC,CAAC;IAClH,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACnC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAKlC,EAAoD,EAAE;IACrD,MAAM,KAAK,GAAG,CAAC,mGAAmG,CAAC,CAAC;IACpH,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CACR,2FAA2F,IAAI,CAAC,SAAS,YAAY;cACnH,2EAA2E;cAC3E,6BAA6B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,KAAK,gBAAgB,MAAM,CAAC,GAAG,QAAQ,MAAM,CAAC,MAAM,SAAS,CAChK,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,wDAAwD,EAAE,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzG,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type Outcome, type RunnerEnv } from './slate-runner-context.js';
+import type { SlateOp } from './slate-workspace-types.js';
+export declare const runEdit: (env: RunnerEnv, op: SlateOp) => Promise<Outcome>;
+//# sourceMappingURL=slate-edit-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-edit-runner.d.ts","sourceRoot":"","sources":["../src/slate-edit-runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAmB,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAe3E,eAAO,MAAM,OAAO,GAAU,KAAK,SAAS,EAAE,IAAI,OAAO,KAAG,OAAO,CAAC,OAAO,CAmE1E,CAAC"}

package/dist/slate-edit-runner.js

@@ -0,0 +1,90 @@
+import sharp from 'sharp';
+import { sha256Hex } from './slate-ids.js';
+import { editAnnotatedFile, editSourceFile, readWorkspaceFile, versionImageFile } from './slate-paths.js';
+import { errorFromRunner, failure, ledger, patchOp, setPhase, } from './slate-runner-context.js';
+import { imageFailureMessage } from './slate-runner-failure.js';
+import { writeImageOnce } from './slate-versions.js';
+import { findCandidate } from './slate-workspace-store.js';
+/**
+ * Edit: one native image call with the parent and, when the user drew, the
+ * annotated copy, both read from the files the click committed and checked
+ * against the digests frozen in `op.params`. The parent version is never
+ * touched; the new image is written once under `versions/` and registered as
+ * the option's next version. The call id is `slate-<opId>`.
+ */
+const readFrozen = async (env, file, sha256) => {
+    const read = await readWorkspaceFile(env.root, file);
+    return read.state === 'ok' && read.sha256 === sha256 ? read.bytes : null;
+};
+export const runEdit = async (env, op) => {
+    const params = op.params;
+    const source = await readFrozen(env, editSourceFile(env.root, env.opId), params.sourceSha256);
+    if (!source)
+        return failure('source_changed', 'The image this edit was started from is missing or changed.');
+    let annotated = null;
+    if (params.annotatedSha256) {
+        annotated = await readFrozen(env, editAnnotatedFile(env.root, env.opId), params.annotatedSha256);
+        if (!annotated)
+            return failure('source_changed', 'The marked copy of the image is missing or changed.');
+    }
+    const callId = `slate-${env.opId}`;
+    await setPhase(env, 'drawing');
+    let png;
+    let reused;
+    try {
+        await ledger(env, { event: 'call_started', callId });
+        const result = await env.executor.generate({
+            callId,
+            prompt: params.sentPrompt,
+            images: annotated ? [source, annotated] : [source],
+            expected: { width: params.width, height: params.height },
+        });
+        png = await sharp(result.png, { animated: false, failOn: 'warning' }).png().toBuffer();
+        reused = result.reused;
+    }
+    catch (error) {
+        const cause = error?.cause;
+        await env.log({
+            event: 'call_failed',
+            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) } : {}),
+        });
+        return failure('edit_failed', imageFailureMessage(error), { retryable: true });
+    }
+    try {
+        const facts = await sharp(png).metadata();
+        const sha256 = sha256Hex(png);
+        await writeImageOnce(versionImageFile(env.root, params.newVersionId), png, sha256);
+        await ledger(env, { event: 'call_finished', callId, sha256, reused });
+        await patchOp(env, (current, workspace) => {
+            if (workspace.versions.some((entry) => entry.versionId === params.newVersionId))
+                return;
+            const candidate = findCandidate(workspace, params.candidateId);
+            workspace.versions.push({
+                versionId: params.newVersionId,
+                candidateId: params.candidateId,
+                n: params.n,
+                kind: 'edit',
+                parentVersionId: params.parentVersionId,
+                opId: env.opId,
+                prompt: params.prompt,
+                sentPromptSha256: params.sentPromptSha256,
+                marks: params.region ? { strokes: params.strokeCount, region: params.region } : null,
+                sha256,
+                width: facts.width ?? params.width,
+                height: facts.height ?? params.height,
+                createdAt: env.clock.now().toISOString(),
+            });
+            candidate.versionIds.push(params.newVersionId);
+            current.resultVersionIds = [params.newVersionId];
+        });
+        await env.log({ event: 'collected', sha256, reused });
+    }
+    catch (error) {
+        // The image is on disk (or the record write failed): a Resume registers it without another call.
+        return { state: 'failed', error: { ...errorFromRunner(error), resumable: true } };
+    }
+    return { state: 'succeeded' };
+};
+//# sourceMappingURL=slate-edit-runner.js.map

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

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

package/dist/slate-editability.d.ts

@@ -0,0 +1,20 @@
+import type { SlateErrorCode } from './slate-errors.js';
+import type { SlateCandidate, SlateOp, SlateRound, SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * Whether an option can take another action, decided from the record alone
+ * (no file reads, no network), so the view and `run` agree.
+ */
+export type Blocker = {
+    code: SlateErrorCode;
+    message: string;
+};
+/** An op keeps its option busy while it runs, is interrupted, or ended in a state a free Resume continues. */
+export declare const opHoldsOption: (op: SlateOp) => boolean;
+export declare const optionOf: (workspace: SlateWorkspace, candidateId: string) => {
+    candidate: SlateCandidate;
+    round: SlateRound;
+} | undefined;
+export declare const busyOp: (workspace: SlateWorkspace, candidate: SlateCandidate) => SlateOp | undefined;
+/** `null` when the option can take an edit now. */
+export declare const editBlocker: (workspace: SlateWorkspace, candidate: SlateCandidate) => Blocker | null;
+//# sourceMappingURL=slate-editability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-editability.d.ts","sourceRoot":"","sources":["../src/slate-editability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEtG;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,8GAA8G;AAC9G,eAAO,MAAM,aAAa,GAAI,IAAI,OAAO,KAAG,OAE3C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,WAAW,cAAc,EAAE,aAAa,MAAM,KAAG;IACxE,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,SAIH,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,WAAW,cAAc,EAAE,WAAW,cAAc,KAAG,OAAO,GAAG,SAMvF,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,WAAW,GAAI,WAAW,cAAc,EAAE,WAAW,cAAc,KAAG,OAAO,GAAG,IAI5F,CAAC"}

package/dist/slate-editability.js

@@ -0,0 +1,19 @@
+/** An op keeps its option busy while it runs, is interrupted, or ended in a state a free Resume continues. */
+export const opHoldsOption = (op) => (op.state === 'running' || (op.state === 'failed' && op.error?.resumable === true));
+export const optionOf = (workspace, candidateId) => {
+    const candidate = workspace.candidates.find((entry) => entry.candidateId === candidateId);
+    const round = candidate && workspace.rounds.find((entry) => entry.roundId === candidate.roundId);
+    return candidate && round ? { candidate, round } : undefined;
+};
+export const busyOp = (workspace, candidate) => (workspace.ops.find((op) => {
+    if (!opHoldsOption(op))
+        return false;
+    if (op.params.kind === 'round')
+        return op.params.candidateIds.includes(candidate.candidateId);
+    return op.target.candidateId === candidate.candidateId;
+}));
+/** `null` when the option can take an edit now. */
+export const editBlocker = (workspace, candidate) => (busyOp(workspace, candidate)
+    ? { code: 'candidate_busy', message: `${candidate.label} is busy with work that has not finished.` }
+    : null);
+//# sourceMappingURL=slate-editability.js.map

package/dist/slate-editability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-editability.js","sourceRoot":"","sources":["../src/slate-editability.ts"],"names":[],"mappings":"AAUA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAW,EAAW,EAAE,CAAC,CACrD,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,CAClF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAyB,EAAE,WAAmB,EAGzD,EAAE;IACd,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;IACjG,OAAO,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAyB,EAAE,SAAyB,EAAuB,EAAE,CAAC,CACnG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;IACxB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9F,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW,CAAC;AACzD,CAAC,CAAC,CACH,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAyB,EAAE,SAAyB,EAAkB,EAAE,CAAC,CACnG,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;IAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,2CAA2C,EAAE;IACpG,CAAC,CAAC,IAAI,CACT,CAAC"}

package/dist/slate-errors.d.ts

@@ -0,0 +1,15 @@
+/** Errors the design workspace tools return as `{ code, message, retryable }`. */
+export type SlateErrorCode = 'intent_conflict' | 'candidate_busy' | 'no_fresh_references' | 'local_unavailable' | 'source_missing' | 'invalid_input' | 'workspace_busy' | 'state_invalid' | 'approval_missing' | 'approval_mismatch' | 'not_resumable' | 'superseded' | 'file_missing' | 'file_changed' | 'not_found' | 'unknown_reference' | 'rate_limited' | 'corpus_unavailable' | 'too_large';
+export declare class SlateError extends Error {
+    readonly code: SlateErrorCode;
+    readonly retryable: boolean;
+    readonly retryAfterSeconds: number | undefined;
+    constructor(code: SlateErrorCode, message: string, options?: {
+        retryAfterSeconds?: number;
+    });
+}
+/** A record on disk failed strict validation. Never repaired silently. */
+export declare class SlateStateInvalidError extends SlateError {
+    constructor(file: string, detail: string);
+}
+//# sourceMappingURL=slate-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slate-errors.d.ts","sourceRoot":"","sources":["../src/slate-errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,WAAW,GACX,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,WAAW,CAAC;AAIhB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;CAOhG;AAED,0EAA0E;AAC1E,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGzC"}

package/dist/slate-errors.js

@@ -0,0 +1,21 @@
+/** Errors the design workspace tools return as `{ code, message, retryable }`. */
+const RETRYABLE = new Set(['workspace_busy', 'rate_limited', 'corpus_unavailable']);
+export class SlateError extends Error {
+    code;
+    retryable;
+    retryAfterSeconds;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = 'SlateError';
+        this.code = code;
+        this.retryable = RETRYABLE.has(code);
+        this.retryAfterSeconds = options.retryAfterSeconds;
+    }
+}
+/** A record on disk failed strict validation. Never repaired silently. */
+export class SlateStateInvalidError extends SlateError {
+    constructor(file, detail) {
+        super('state_invalid', `${file} is not a valid 12ui workspace record: ${detail}`);
+    }
+}
+//# sourceMappingURL=slate-errors.js.map

package/dist/slate-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-errors.js","sourceRoot":"","sources":["../src/slate-errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAuBlF,MAAM,SAAS,GAAgC,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEjH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,SAAS,CAAU;IACnB,iBAAiB,CAAqB;IAE/C,YAAY,IAAoB,EAAE,OAAe,EAAE,UAA0C,EAAE;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACrD,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,eAAe,EAAE,GAAG,IAAI,0CAA0C,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}

package/dist/slate-handoff-options.d.ts

@@ -0,0 +1,40 @@
+import type { SlateHandoffRecord } from './slate-view-contract.js';
+/**
+ * What a Branch or Convert hand-off may carry, decided in one place: the
+ * record parser, the `handoff` tool and the text the agent reads all use it.
+ * The combinations are the CLI's own (`12ui convert`): local formats are HTML,
+ * React and Assets with `--clean-assets`; every other format is the 12ui
+ * service and takes `--model`, `--width` and, for responsive HTML only,
+ * `--responsive-quality`.
+ */
+export declare const BRANCH_EXPLANATION_MAX_CHARACTERS = 2000;
+export declare const LOCAL_CONVERT_OUTPUTS: readonly ["html", "react", "assets"];
+export declare const SERVICE_CONVERT_OUTPUTS: readonly ["html", "layerdoc", "html_fixed", "svg", "png", "jpg", "webp", "pdf", "psd", "pptx", "sketch"];
+type BranchOptions = Extract<SlateHandoffRecord, {
+    kind: 'branch';
+}>['options'];
+type ConvertOptions = Extract<SlateHandoffRecord, {
+    kind: 'convert';
+}>['options'];
+export type HandoffOptionsResult<T> = {
+    ok: true;
+    options: T;
+} | {
+    ok: false;
+    message: string;
+};
+/** Control characters are stripped except tab and newline; the rest is the user's text, verbatim. */
+export declare const cleanExplanation: (value: string) => string;
+export declare const parseBranchOptions: (value: unknown) => HandoffOptionsResult<BranchOptions>;
+export declare const parseConvertOptions: (value: unknown) => HandoffOptionsResult<ConvertOptions>;
+export declare const parseHandoffOptions: (kind: unknown, value: unknown) => HandoffOptionsResult<SlateHandoffRecord["options"]>;
+/** The command lines an agent runs for a recorded Convert, with the image path filled in. */
+export declare const convertCommands: (options: ConvertOptions, imagePath: string) => string[];
+/**
+ * The choice in words an agent maps to the commands above: a local format is
+ * the free Codex engine's HTML run, and React and Assets are derived from that
+ * run by `12ui export`; a service format is one `12ui convert --engine api`.
+ */
+export declare const convertChoiceWords: (options: ConvertOptions) => string;
+export {};
+//# sourceMappingURL=slate-handoff-options.d.ts.map

package/dist/slate-handoff-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-handoff-options.d.ts","sourceRoot":"","sources":["../src/slate-handoff-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;;;;;;GAOG;AAEH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,eAAO,MAAM,qBAAqB,sCAAuC,CAAC;AAC1E,eAAO,MAAM,uBAAuB,0GAEc,CAAC;AAEnD,KAAK,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC;AAChF,KAAK,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,SAAS,CAAC,CAAC;AAClF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAShG,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAGhD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,oBAAoB,CAAC,aAAa,CAWrF,CAAC;AAIF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,oBAAoB,CAAC,cAAc,CAoCvF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,OAAO,OAAO,KAAG,oBAAoB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAIrH,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,EAAE,WAAW,MAAM,KAAG,MAAM,EAelF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,cAAc,KAAG,MAM5D,CAAC"}