@12ui/design 0.2.13 → 0.2.15

package/dist/package-submission.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { CONVERSION_OUTPUT_EXTENSIONS, } from './conversion-outputs.js';
+import { readImageDimensions } from './image-dimensions.js';
+/**
+ * One page, submitted as ONE package conversion of its ordered viewports.
+ *
+ * Converting a continuous page one screenshot at a time throws away page order
+ * and the stitching between viewports, which is the entire reason to have
+ * branched. This module is the single owner of that submission for both
+ * `12ui convert package` and `12ui branch execute --convert`.
+ */
+export const PACKAGE_RESULT_FILENAME = 'package.result.json';
+export const PACKAGE_POLL_INTERVAL_MS = 4_000;
+export const PACKAGE_TIMEOUT_MS = 30 * 60_000;
+/**
+ * The stitch precondition, checked HERE rather than at admission. Composition
+ * joins a page's viewports into one tall source, so a width disagreement is
+ * fatal — and the server discovers it only after every viewport is paid for.
+ */
+export const assertPackagePageWidths = async (pages) => {
+    const dimensions = new Map();
+    for (const page of pages) {
+        if (page.viewports.length === 0) {
+            throw new Error(`Page ${page.id} has no viewports to convert.`);
+        }
+        for (const viewport of page.viewports) {
+            dimensions.set(`${page.id}/${viewport.id}`, await readImageDimensions(viewport.bytes));
+        }
+        const first = dimensions.get(`${page.id}/${page.viewports[0].id}`);
+        const mismatched = page.viewports.find((viewport) => (dimensions.get(`${page.id}/${viewport.id}`).width !== first.width));
+        if (mismatched) {
+            const actual = dimensions.get(`${page.id}/${mismatched.id}`);
+            throw new Error(`Page ${page.id} screen ${mismatched.id} (${mismatched.imagePath}) is ${actual.width}px`
+                + ` wide but the page is ${first.width}px wide; every viewport of a page must share one`
+                + ' width. Re-render or crop the odd screen before submitting the page.');
+        }
+    }
+    return dimensions;
+};
+export const buildConversionPackageRequest = async (submission) => {
+    const dimensions = await assertPackagePageWidths(submission.pages);
+    const screenshots = [];
+    const manifest = {
+        version: 1,
+        output: submission.output,
+        ...(submission.model ? { model: submission.model } : {}),
+        ...(submission.responsiveQuality && submission.output === 'html'
+            ? { responsive_quality: submission.responsiveQuality }
+            : {}),
+        pages: submission.pages.map((page) => ({
+            id: page.id,
+            ordinal: page.ordinal,
+            ...(page.kind ? { kind: page.kind } : {}),
+            ...(page.title ? { title: page.title } : {}),
+            ...(page.purpose ? { purpose: page.purpose } : {}),
+            ...(page.path ? { path: page.path } : {}),
+            viewports: page.viewports.map((viewport) => {
+                const size = dimensions.get(`${page.id}/${viewport.id}`);
+                if (viewport.sourceConversionId) {
+                    return {
+                        id: viewport.id,
+                        ordinal: viewport.ordinal,
+                        source_conversion_id: viewport.sourceConversionId,
+                        screenshot: {
+                            sha256: createHash('sha256').update(viewport.bytes).digest('hex'),
+                            media_type: viewport.mediaType,
+                            size_bytes: viewport.bytes.byteLength,
+                            width: size.width,
+                            height: size.height,
+                        },
+                    };
+                }
+                const partId = `${page.id}--${viewport.id}`;
+                screenshots.push({ partId, bytes: viewport.bytes, mediaType: viewport.mediaType });
+                return { id: viewport.id, ordinal: viewport.ordinal, screenshot_part: partId };
+            }),
+        })),
+    };
+    return { manifest, screenshots };
+};
+export const packageProgressEvent = (operation) => {
+    const progress = operation.progress;
+    return {
+        stage: progress?.stage ?? operation.status,
+        ...(progress?.percent === undefined ? {} : { percent: progress.percent }),
+        ...(progress?.completed === undefined
+            ? {}
+            : { completed: progress.completed, total: progress.total }),
+        ...(progress?.running === undefined ? {} : { running: progress.running }),
+        ...(progress?.stage_since === undefined ? {} : { stageSince: progress.stage_since }),
+        ...(progress?.pages_available === undefined
+            ? {}
+            : { pagesAvailable: progress.pages_available }),
+        ...(progress?.bands_available === undefined
+            ? {}
+            : { bandsAvailable: progress.bands_available }),
+    };
+};
+const delay = async (milliseconds, signal) => (new Promise((resolve, reject) => {
+    const timer = setTimeout(resolve, milliseconds);
+    signal?.addEventListener('abort', () => {
+        clearTimeout(timer);
+        reject(signal.reason ?? new Error('Package wait aborted'));
+    }, { once: true });
+}));
+/**
+ * Submit, wait, and materialize. The package's own operation record is the
+ * durable identity: a retry under the same derived key replays it rather than
+ * buying the pages again.
+ */
+export const submitConversionPackage = async (args) => {
+    const { manifest, screenshots } = await buildConversionPackageRequest(args.submission);
+    const sleep = args.sleep ?? delay;
+    const created = await args.client.createPackage({
+        manifest,
+        screenshots,
+        idempotencyKey: args.submission.idempotencyKey,
+        ...(args.signal ? { signal: args.signal } : {}),
+    });
+    args.onSubmitted?.(created.id);
+    const deadline = Date.now() + (args.timeoutMs ?? PACKAGE_TIMEOUT_MS);
+    let operation = created;
+    while (operation.status === 'queued' || operation.status === 'running') {
+        if (Date.now() >= deadline) {
+            throw new Error(`Timed out waiting for package ${created.id}. It is still running server-side; read it`
+                + ` back with GET /api/v1/convert/package/${created.id} rather than submitting again.`);
+        }
+        args.onProgress?.(packageProgressEvent(operation));
+        await sleep(args.pollIntervalMs ?? PACKAGE_POLL_INTERVAL_MS, args.signal);
+        operation = await args.client.getPackage(created.id, args.signal);
+    }
+    args.onProgress?.({ stage: operation.status });
+    await mkdir(args.outDir, { recursive: true });
+    const extension = CONVERSION_OUTPUT_EXTENSIONS[args.submission.output];
+    const pages = [];
+    const viewportsOf = (page) => (page.viewports.length === 0 ? {} : {
+        viewports: page.viewports.map((viewport) => ({
+            id: viewport.id,
+            ordinal: viewport.ordinal,
+            status: viewport.status,
+            ...(viewport.conversion_id ? { conversionId: viewport.conversion_id } : {}),
+        })),
+    });
+    for (const page of operation.pages) {
+        if (page.status !== 'succeeded' || !page.href) {
+            pages.push({
+                id: page.id,
+                ordinal: page.ordinal,
+                ...(page.title ? { title: page.title } : {}),
+                status: 'failed',
+                error: operation.error?.detail ?? `Page ${page.id} finished ${page.status}.`,
+                ...viewportsOf(page),
+            });
+            continue;
+        }
+        const downloaded = await args.client.downloadPage(operation, page.id, args.signal);
+        const outFile = path.join(args.outDir, `${page.id}.${extension}`);
+        await writeFile(outFile, downloaded.bytes);
+        pages.push({
+            id: page.id,
+            ordinal: page.ordinal,
+            ...(page.title ? { title: page.title } : {}),
+            ...(page.conversion_id ? { conversionId: page.conversion_id } : {}),
+            outFile,
+            sha256: createHash('sha256').update(downloaded.bytes).digest('hex'),
+            bytes: downloaded.bytes.byteLength,
+            mediaType: downloaded.mediaType,
+            status: 'succeeded',
+            ...viewportsOf(page),
+        });
+    }
+    if (operation.status !== 'succeeded' && pages.every((page) => page.status === 'failed')) {
+        throw new Error(operation.error?.detail
+            ?? `Package ${operation.id} finished ${operation.status} with no converted page.`);
+    }
+    return {
+        packageId: operation.id,
+        status: operation.status,
+        output: args.submission.output,
+        idempotencyKey: args.submission.idempotencyKey,
+        ...(operation.expires_at ? { expiresAt: operation.expires_at } : {}),
+        pages,
+    };
+};
+export const writePackageResultRecord = async (outDir, result) => {
+    const file = path.join(outDir, PACKAGE_RESULT_FILENAME);
+    await mkdir(outDir, { recursive: true });
+    await writeFile(file, `${JSON.stringify({ version: 1, ...result }, null, 2)}\n`, {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+    return file;
+};
+//# sourceMappingURL=package-submission.js.map

package/dist/package-submission.js.map

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

package/dist/selection-record.d.ts

@@ -0,0 +1,95 @@
+import type { DraftRecord } from './draft-workspace.js';
+/**
+ * `selection.json`, version 6 — the same contract the skill used to ask an
+ * agent to hand-assemble from four other files. Every field here is copied
+ * from durable evidence the run already wrote, which is the point: a record
+ * assembled by hand can disagree with the run it describes, and this one
+ * cannot.
+ *
+ * The recommendation protocol is preserved exactly: `recommended` when the
+ * winner is the recommended candidate, `override` when it is not (and then a
+ * specific reason is required), `no-recommendation` when the run indicated
+ * none.
+ */
+export declare const SELECTION_RECORD_VERSION = 6;
+export type SelectionRecord = {
+    version: 6;
+    createdAt: string;
+    requestSummary: string;
+    viewportMode: 'first-viewport';
+    designMode: DraftRecord['mode'];
+    redesignSource: {
+        originalPath: string | null;
+        originalSha256: string | null;
+        preparedPath: string | null;
+        preparedSha256: string | null;
+        preparation: 'none' | 'first-viewport-crop';
+    };
+    contract: {
+        preserve: string[];
+        change: string[];
+    };
+    referencePolicy: {
+        retrieval: 'text-only' | 'text-and-redesign-source';
+        generation: 'one-corpus-image-per-candidate' | 'redesign-source-only';
+        imagesPerGeneration: 1;
+    };
+    corpus: {
+        query: string;
+        mode: string;
+        fallback: null;
+        idempotencyKey: string;
+        setId: string;
+        references: {
+            id: string;
+            path: string;
+            sha256: string;
+            aspect: string;
+        }[];
+    };
+    generation: {
+        referenceMode: 'inspiration' | 'preserve-structure';
+        manifestPath: string;
+        manifestSha256: string;
+        batchAttemptPath: string;
+    };
+    candidates: {
+        id: string;
+        path: string;
+        sha256: string | null;
+        prompt: string;
+        promptSha256: string;
+        directionReferenceId: string | null;
+        direction: string;
+        generationReferencePath: string;
+        generationReferenceSha256: string;
+        referenceMode: 'inspiration' | 'preserve-structure';
+        provider: string | null;
+        idempotencyKey: string;
+        providerIdempotencyEnforced: boolean;
+        attemptEvidencePath: string;
+        rejectionReasons: string[];
+    }[];
+    recommendation: {
+        candidateId: string | null;
+        source: string | null;
+    };
+    winner: string;
+    selectionSource: 'recommended' | 'override' | 'no-recommendation';
+    selectionOverrideReason: string | null;
+    rationale: string;
+};
+export declare const buildSelectionRecord: (args: {
+    draft: DraftRecord;
+    winner: string;
+    reason: string;
+    recommendation?: {
+        candidateId: string | null;
+        source: string | null;
+    };
+    rejectionReasons?: Record<string, string[]>;
+    now?: () => Date;
+}) => Promise<SelectionRecord>;
+export declare const writeSelectionRecord: (file: string, record: SelectionRecord) => Promise<void>;
+export declare const readSelectionRecord: (file: string) => Promise<SelectionRecord | undefined>;
+//# sourceMappingURL=selection-record.d.ts.map

package/dist/selection-record.d.ts.map

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

package/dist/selection-record.js

@@ -0,0 +1,121 @@
+import { createHash } from 'node:crypto';
+import { readFile, writeFile } from 'node:fs/promises';
+import { readBatchAttempt, imageBatchAttemptPath } from './image-generation-batch-attempt.js';
+import { imageAttemptPath } from './image-generation-evidence.js';
+import { readImageGenerationAttemptFile } from './image-generation-staging.js';
+/**
+ * `selection.json`, version 6 — the same contract the skill used to ask an
+ * agent to hand-assemble from four other files. Every field here is copied
+ * from durable evidence the run already wrote, which is the point: a record
+ * assembled by hand can disagree with the run it describes, and this one
+ * cannot.
+ *
+ * The recommendation protocol is preserved exactly: `recommended` when the
+ * winner is the recommended candidate, `override` when it is not (and then a
+ * specific reason is required), `no-recommendation` when the run indicated
+ * none.
+ */
+export const SELECTION_RECORD_VERSION = 6;
+export const buildSelectionRecord = async (args) => {
+    const now = args.now ?? (() => new Date());
+    const { draft } = args;
+    if (!draft.generation.candidates.some((candidate) => candidate.id === args.winner)) {
+        throw new Error(`Candidate ${args.winner} is not in this run. It has`
+            + ` ${draft.generation.candidates.map((candidate) => candidate.id).join(', ')}.`);
+    }
+    const batchAttemptPath = imageBatchAttemptPath(draft.generation.manifestPath);
+    const batch = await readBatchAttempt(batchAttemptPath);
+    const candidates = await Promise.all(draft.generation.candidates.map(async (candidate) => {
+        const attemptEvidencePath = imageAttemptPath(candidate.outputPath);
+        const attempt = await readImageGenerationAttemptFile(attemptEvidencePath);
+        const bytes = await readFile(candidate.outputPath).catch(() => null);
+        return {
+            id: candidate.id,
+            path: candidate.outputPath,
+            sha256: attempt?.outputSha256
+                ?? (bytes ? createHash('sha256').update(bytes).digest('hex') : null),
+            prompt: candidate.prompt,
+            promptSha256: candidate.promptSha256,
+            directionReferenceId: candidate.referenceId,
+            direction: candidate.direction,
+            generationReferencePath: candidate.referencePath,
+            generationReferenceSha256: candidate.referenceSha256,
+            referenceMode: draft.referenceMode,
+            provider: attempt?.provider ?? batch?.provider ?? null,
+            idempotencyKey: candidate.idempotencyKey,
+            // Only ever the recorded CLI value, never an assumed guarantee.
+            providerIdempotencyEnforced: attempt?.providerIdempotencyEnforced === true,
+            attemptEvidencePath,
+            rejectionReasons: candidate.id === args.winner
+                ? []
+                : args.rejectionReasons?.[candidate.id] ?? [],
+        };
+    }));
+    const recommendation = args.recommendation ?? { candidateId: null, source: null };
+    const selectionSource = recommendation.candidateId === null
+        ? 'no-recommendation'
+        : recommendation.candidateId === args.winner
+            ? 'recommended'
+            : 'override';
+    if (selectionSource === 'override' && !args.reason.trim()) {
+        throw new Error('Overriding the recommended candidate requires a specific reason');
+    }
+    const reskin = draft.mode === 'structure-preserving-reskin';
+    return {
+        version: SELECTION_RECORD_VERSION,
+        createdAt: now().toISOString(),
+        requestSummary: draft.query,
+        viewportMode: 'first-viewport',
+        designMode: draft.mode,
+        redesignSource: {
+            originalPath: draft.redesignSource?.path ?? null,
+            originalSha256: draft.redesignSource?.sha256 ?? null,
+            preparedPath: draft.redesignSource?.path ?? null,
+            preparedSha256: draft.redesignSource?.sha256 ?? null,
+            preparation: 'none',
+        },
+        contract: { preserve: [], change: [] },
+        referencePolicy: {
+            retrieval: draft.redesignSource ? 'text-and-redesign-source' : 'text-only',
+            generation: reskin ? 'redesign-source-only' : 'one-corpus-image-per-candidate',
+            imagesPerGeneration: 1,
+        },
+        corpus: {
+            query: draft.corpus.query,
+            mode: draft.corpus.mode,
+            fallback: null,
+            idempotencyKey: draft.corpus.idempotencyKey,
+            setId: draft.corpus.setId,
+            references: draft.corpus.references.map((reference) => ({
+                id: reference.id,
+                path: reference.path,
+                sha256: reference.sha256,
+                aspect: reference.aspect,
+            })),
+        },
+        generation: {
+            referenceMode: draft.referenceMode,
+            manifestPath: draft.generation.manifestPath,
+            manifestSha256: draft.generation.manifestSha256,
+            batchAttemptPath,
+        },
+        candidates,
+        recommendation,
+        winner: args.winner,
+        selectionSource,
+        selectionOverrideReason: selectionSource === 'override' ? args.reason.trim() : null,
+        rationale: args.reason.trim(),
+    };
+};
+export const writeSelectionRecord = async (file, record) => {
+    await writeFile(file, `${JSON.stringify(record, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+};
+export const readSelectionRecord = async (file) => {
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=selection-record.js.map

package/dist/selection-record.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "type": "module",
   "description": "The canonical 12UI CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",