@12ui/design 0.2.5 → 0.2.7

package/dist/image-generation-batch-manifest.js

@@ -0,0 +1,91 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { isImageGenerationAspect, } from './image-generation-request.js';
+import { isImageGenerationProvider, } from './image-provider-preflight.js';
+import { normalizeOptionalIdempotencyKey } from './idempotency-key.js';
+const isRecord = (value) => (typeof value === 'object' && value !== null && !Array.isArray(value));
+const requiredString = (record, key, context) => {
+    const value = record[key];
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`${context}.${key} must be a non-empty string`);
+    }
+    return value.trim();
+};
+const unique = (values, name) => {
+    if (new Set(values).size !== values.length) {
+        throw new Error(`Image batch candidates must use unique ${name}`);
+    }
+};
+export const readImageGenerationBatchManifest = async (manifestPath) => {
+    const source = new Uint8Array(await readFile(manifestPath));
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder().decode(source));
+    }
+    catch (error) {
+        throw new Error(`Image batch manifest is not valid JSON: ${manifestPath}`, { cause: error });
+    }
+    if (!isRecord(value) || value.version !== 1) {
+        throw new Error('Image batch manifest.version must be 1');
+    }
+    const provider = value.provider ?? 'auto';
+    if (!isImageGenerationProvider(provider)) {
+        throw new Error('Image batch manifest.provider must be auto, codex, or openai');
+    }
+    const aspect = value.aspect ?? 'landscape';
+    if (!isImageGenerationAspect(aspect)) {
+        throw new Error('Image batch manifest.aspect must be landscape, portrait, or square');
+    }
+    if (!Array.isArray(value.candidates) || value.candidates.length < 2 || value.candidates.length > 16) {
+        throw new Error('Image batch manifest.candidates must contain between 2 and 16 jobs');
+    }
+    const candidates = value.candidates.map((candidate, index) => {
+        const context = `Image batch manifest.candidates[${index}]`;
+        if (!isRecord(candidate))
+            throw new Error(`${context} must be an object`);
+        const id = requiredString(candidate, 'id', context);
+        if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u.test(id)) {
+            throw new Error(`${context}.id contains unsupported characters`);
+        }
+        const idempotencyKey = normalizeOptionalIdempotencyKey(requiredString(candidate, 'idempotencyKey', context), `${context}.idempotencyKey`);
+        if (!idempotencyKey)
+            throw new Error(`${context}.idempotencyKey is required`);
+        return {
+            id,
+            prompt: requiredString(candidate, 'prompt', context),
+            reference: requiredString(candidate, 'reference', context),
+            out: requiredString(candidate, 'out', context),
+            idempotencyKey,
+        };
+    });
+    unique(candidates.map((candidate) => candidate.id), 'ids');
+    unique(candidates.map((candidate) => candidate.idempotencyKey), 'idempotency keys');
+    return {
+        source,
+        manifest: {
+            version: 1,
+            projectRoot: requiredString(value, 'projectRoot', 'Image batch manifest'),
+            provider,
+            aspect,
+            candidates,
+        },
+    };
+};
+export const resolveImageGenerationBatchRequests = (args) => {
+    const base = path.dirname(args.manifestPath);
+    const resolve = (value) => path.resolve(base, value);
+    const requests = args.manifest.candidates.map((candidate) => ({
+        candidateId: candidate.id,
+        prompt: candidate.prompt,
+        promptSource: { kind: 'inline' },
+        referencePath: resolve(candidate.reference),
+        outputPath: resolve(candidate.out),
+        projectRoot: resolve(args.manifest.projectRoot),
+        provider: args.manifest.provider,
+        aspect: args.manifest.aspect,
+        idempotencyKey: candidate.idempotencyKey,
+    }));
+    unique(requests.map((request) => request.outputPath), 'output paths');
+    return requests;
+};
+//# sourceMappingURL=image-generation-batch-manifest.js.map

package/dist/image-generation-batch-manifest.js.map

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

package/dist/image-generation-evidence.d.ts

@@ -1,5 +1,6 @@
+import type { ImageGenerationUsageEvidence } from './image-generation-usage.js';
 export type ImageGenerationAttempt = {
-    schemaVersion: 2;
+    schemaVersion: 3;
     status: 'prepared' | 'dispatched' | 'succeeded' | 'failed';
     idempotencyKey: string;
     provider: 'codex' | 'openai';
@@ -23,9 +24,16 @@ export type ImageGenerationAttempt = {
     };
     outputPath: string;
     preparedAt: string;
+    batch?: {
+        candidateId: string;
+        manifestPath: string;
+        manifestSha256: string;
+    };
     dispatchedAt?: string;
+    providerStartedAt?: string;
     completedAt?: string;
     outputSha256?: string;
+    usage?: ImageGenerationUsageEvidence;
     error?: string;
 };
 export declare const imageAttemptPath: (outputPath: string) => string;

package/dist/image-generation-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-generation-evidence.d.ts","sourceRoot":"","sources":["../src/image-generation-evidence.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAC3C,2BAA2B,EAAE,OAAO,CAAC;IACrC,gBAAgB,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;KACvC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,MAAsC,CAAC;AAE7F,eAAO,MAAM,2BAA2B,GACtC,UAAU,MAAM,EAChB,SAAS,sBAAsB,EAC/B,mBAAiB,KAChB,OAAO,CAAC,IAAI,CAqBd,CAAC"}
+{"version":3,"file":"image-generation-evidence.d.ts","sourceRoot":"","sources":["../src/image-generation-evidence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAC3C,2BAA2B,EAAE,OAAO,CAAC;IACrC,gBAAgB,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;KACvC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,4BAA4B,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,MAAsC,CAAC;AAE7F,eAAO,MAAM,2BAA2B,GACtC,UAAU,MAAM,EAChB,SAAS,sBAAsB,EAC/B,mBAAiB,KAChB,OAAO,CAAC,IAAI,CAqBd,CAAC"}

package/dist/image-generation-evidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-generation-evidence.js","sourceRoot":"","sources":["../src/image-generation-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,IAAI,MAAM,WAAW,CAAC;AAyB7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,GAAG,UAAU,eAAe,CAAC;AAE7F,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAC9C,QAAgB,EAChB,OAA+B,EAC/B,SAAS,GAAG,KAAK,EACF,EAAE;IACjB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACjE,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,MAAM,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAClE,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"image-generation-evidence.js","sourceRoot":"","sources":["../src/image-generation-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,IAAI,MAAM,WAAW,CAAC;AAkC7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,GAAG,UAAU,eAAe,CAAC;AAE7F,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAC9C,QAAgB,EAChB,OAA+B,EAC/B,SAAS,GAAG,KAAK,EACF,EAAE;IACjB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACjE,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,MAAM,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAClE,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC,CAAC"}

package/dist/image-generation-request.d.ts

@@ -0,0 +1,29 @@
+import type { ImageGenerationAttempt } from './image-generation-evidence.js';
+import type { ImageGenerationProvider } from './image-provider-preflight.js';
+export declare const IMAGE_GENERATION_ASPECTS: readonly ["landscape", "portrait", "square"];
+export type ImageGenerationAspect = (typeof IMAGE_GENERATION_ASPECTS)[number];
+export declare const isImageGenerationAspect: (value: unknown) => value is ImageGenerationAspect;
+export declare const imageGenerationSha256: (value: Uint8Array | string) => string;
+export type ImageGenerationRequest = {
+    candidateId?: string;
+    prompt: string;
+    promptSource: ImageGenerationAttempt['promptSource'];
+    referencePath: string;
+    outputPath: string;
+    projectRoot: string;
+    provider: ImageGenerationProvider;
+    aspect: ImageGenerationAspect;
+    idempotencyKey: string;
+};
+export type PreparedImageGenerationRequest = ImageGenerationRequest & {
+    attemptFile: string;
+    promptSha256: string;
+    reference: {
+        path: string;
+        sha256: string;
+        dataUrl: string;
+    };
+};
+export declare const imageGenerationPathExists: (target: string) => Promise<boolean>;
+export declare const prepareImageGenerationRequest: (request: ImageGenerationRequest) => Promise<PreparedImageGenerationRequest>;
+//# sourceMappingURL=image-generation-request.d.ts.map

package/dist/image-generation-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-request.d.ts","sourceRoot":"","sources":["../src/image-generation-request.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,eAAO,MAAM,wBAAwB,8CAA+C,CAAC;AACrF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBAGjE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,UAAU,GAAG,MAAM,KAAG,MAElE,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,sBAAsB,GAAG;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,OAAO,CAQ/E,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,SAAS,sBAAsB,KAC9B,OAAO,CAAC,8BAA8B,CA0BxC,CAAC"}

package/dist/image-generation-request.js

@@ -0,0 +1,46 @@
+import { createHash } from 'node:crypto';
+import { lstat, mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { imageAttemptPath } from './image-generation-evidence.js';
+import { referenceImageDataUrl } from './image-generation-output.js';
+export const IMAGE_GENERATION_ASPECTS = ['landscape', 'portrait', 'square'];
+export const isImageGenerationAspect = (value) => (typeof value === 'string'
+    && IMAGE_GENERATION_ASPECTS.includes(value));
+export const imageGenerationSha256 = (value) => (createHash('sha256').update(value).digest('hex'));
+export const imageGenerationPathExists = async (target) => {
+    try {
+        await lstat(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+};
+export const prepareImageGenerationRequest = async (request) => {
+    if (path.extname(request.outputPath).toLowerCase() !== '.png') {
+        throw new Error('Image output must end in .png because image generation always writes PNG bytes');
+    }
+    const attemptFile = imageAttemptPath(request.outputPath);
+    if (await imageGenerationPathExists(request.outputPath)) {
+        throw new Error(`Refusing to dispatch because output already exists at ${request.outputPath}`);
+    }
+    if (await imageGenerationPathExists(attemptFile)) {
+        throw new Error(`Image attempt evidence already exists at ${attemptFile}. Refusing to redispatch an`
+            + ' ambiguous or completed request; inspect it and use a new output/idempotency key.');
+    }
+    await mkdir(path.dirname(request.outputPath), { recursive: true });
+    const referenceBytes = new Uint8Array(await readFile(request.referencePath));
+    return {
+        ...request,
+        attemptFile,
+        promptSha256: imageGenerationSha256(request.prompt),
+        reference: {
+            path: request.referencePath,
+            sha256: imageGenerationSha256(referenceBytes),
+            dataUrl: await referenceImageDataUrl(referenceBytes, request.referencePath),
+        },
+    };
+};
+//# sourceMappingURL=image-generation-request.js.map

package/dist/image-generation-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-request.js","sourceRoot":"","sources":["../src/image-generation-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAGrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAc,EAAkC,EAAE,CAAC,CACzF,OAAO,KAAK,KAAK,QAAQ;OACrB,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,CACnE,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAA0B,EAAU,EAAE,CAAC,CAC3E,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACjD,CAAC;AAwBF,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAAE,MAAc,EAAoB,EAAE;IAClF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,EAChD,OAA+B,EACU,EAAE;IAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,MAAM,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,yDAAyD,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,MAAM,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,4CAA4C,WAAW,6BAA6B;cAClF,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,GAAG,OAAO;QACV,WAAW;QACX,YAAY,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;QACnD,SAAS,EAAE;YACT,IAAI,EAAE,OAAO,CAAC,aAAa;YAC3B,MAAM,EAAE,qBAAqB,CAAC,cAAc,CAAC;YAC7C,OAAO,EAAE,MAAM,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,aAAa,CAAC;SAC5E;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/image-generation-run.d.ts

@@ -0,0 +1,35 @@
+import { ensembleImage } from '@just-every/ensemble';
+import { type ImageGenerationAttempt } from './image-generation-evidence.js';
+import { type PreparedImageGenerationRequest } from './image-generation-request.js';
+import { type ImageGenerationUsageEvidence } from './image-generation-usage.js';
+import type { ImageProviderPreflight } from './image-provider-preflight.js';
+export type ImageGenerationDependencies = {
+    generate?: typeof ensembleImage;
+    now?: () => Date;
+};
+export type ReservedImageGeneration = {
+    request: PreparedImageGenerationRequest;
+    preflight: ImageProviderPreflight;
+    attempt: ImageGenerationAttempt;
+};
+export type ImageGenerationResult = {
+    candidateId?: string;
+    provider: ImageGenerationAttempt['provider'];
+    model: ImageGenerationAttempt['model'];
+    outputPath: string;
+    outputSha256: string;
+    attemptFile: string;
+    providerStartedAt: string;
+    completedAt: string;
+    usage: ImageGenerationUsageEvidence;
+};
+export declare const reserveImageGeneration: (args: {
+    request: PreparedImageGenerationRequest;
+    preflight: ImageProviderPreflight;
+    batch?: ImageGenerationAttempt["batch"];
+    dependencies?: ImageGenerationDependencies;
+}) => Promise<ReservedImageGeneration>;
+export declare const markImageGenerationDispatched: (reserved: ReservedImageGeneration, dependencies?: ImageGenerationDependencies) => Promise<void>;
+export declare const failImageGenerationBeforeDispatch: (reserved: ReservedImageGeneration, error: string, dependencies?: ImageGenerationDependencies) => Promise<void>;
+export declare const dispatchImageGeneration: (reserved: ReservedImageGeneration, dependencies?: ImageGenerationDependencies) => Promise<ImageGenerationResult>;
+//# sourceMappingURL=image-generation-run.d.ts.map

package/dist/image-generation-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-run.d.ts","sourceRoot":"","sources":["../src/image-generation-run.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,EAAE,OAAO,aAAa,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,4BAA4B,CAAC;CACrC,CAAC;AAMF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C,KAAG,OAAO,CAAC,uBAAuB,CAkClC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAId,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,UAAU,uBAAuB,EACjC,OAAO,MAAM,EACb,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAKd,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,qBAAqB,CAsF/B,CAAC"}

package/dist/image-generation-run.js

@@ -0,0 +1,134 @@
+import { writeFile } from 'node:fs/promises';
+import { ensembleImage, } from '@just-every/ensemble';
+import { OpenAIProvider } from '@just-every/ensemble/model_providers/openai';
+import { writeImageGenerationAttempt, } from './image-generation-evidence.js';
+import { generatedPngBytes } from './image-generation-output.js';
+import { imageGenerationSha256, } from './image-generation-request.js';
+import { captureImageGenerationUsage, imageGenerationUsageEvidence, } from './image-generation-usage.js';
+const timestamp = (dependencies) => ((dependencies.now ?? (() => new Date()))().toISOString());
+export const reserveImageGeneration = async (args) => {
+    const dependencies = args.dependencies ?? {};
+    const attempt = {
+        schemaVersion: 3,
+        status: 'prepared',
+        idempotencyKey: args.request.idempotencyKey,
+        provider: args.preflight.provider,
+        model: args.preflight.model,
+        providerIdempotencyEnforced: args.preflight.provider === 'openai',
+        providerEvidence: args.preflight.provider === 'codex'
+            ? { codexVersion: args.preflight.codexVersion }
+            : { keySource: args.preflight.keySource },
+        prompt: args.request.prompt,
+        promptSource: args.request.promptSource,
+        promptSha256: args.request.promptSha256,
+        reference: {
+            path: args.request.reference.path,
+            sha256: args.request.reference.sha256,
+        },
+        outputPath: args.request.outputPath,
+        preparedAt: timestamp(dependencies),
+        ...(args.batch ? { batch: args.batch } : {}),
+    };
+    await writeImageGenerationAttempt(args.request.attemptFile, attempt, true).catch((error) => {
+        if (error.code === 'EEXIST') {
+            throw new Error(`Image attempt evidence already exists at ${args.request.attemptFile}. Refusing to`
+                + ' redispatch an ambiguous or completed request; inspect it and use a new output/'
+                + 'idempotency key.');
+        }
+        throw error;
+    });
+    return { request: args.request, preflight: args.preflight, attempt };
+};
+export const markImageGenerationDispatched = async (reserved, dependencies = {}) => {
+    reserved.attempt.status = 'dispatched';
+    reserved.attempt.dispatchedAt = timestamp(dependencies);
+    await writeImageGenerationAttempt(reserved.request.attemptFile, reserved.attempt);
+};
+export const failImageGenerationBeforeDispatch = async (reserved, error, dependencies = {}) => {
+    reserved.attempt.status = 'failed';
+    reserved.attempt.completedAt = timestamp(dependencies);
+    reserved.attempt.error = error;
+    await writeImageGenerationAttempt(reserved.request.attemptFile, reserved.attempt);
+};
+export const dispatchImageGeneration = async (reserved, dependencies = {}) => {
+    const { request, preflight, attempt } = reserved;
+    attempt.providerStartedAt = timestamp(dependencies);
+    await writeImageGenerationAttempt(request.attemptFile, attempt);
+    try {
+        const agent = {
+            agent_id: `12ui-image-${imageGenerationSha256(request.idempotencyKey).slice(0, 16)}`,
+            model: preflight.model,
+            cwd: request.projectRoot,
+            retryOptions: { maxRetries: 0 },
+        };
+        let providerRequestId;
+        const options = {
+            n: 1,
+            size: request.aspect,
+            quality: 'high',
+            source_images: [request.reference.dataUrl],
+            ...(preflight.provider === 'codex' ? { input_fidelity: 'high' } : {}),
+            output_format: 'png',
+            idempotency_key: request.idempotencyKey,
+            request_id: request.idempotencyKey,
+            on_metadata: (metadata) => {
+                if (metadata.request_id && metadata.request_id !== request.idempotencyKey)
+                    return;
+                if (metadata.provider_request_id)
+                    providerRequestId = metadata.provider_request_id;
+            },
+        };
+        const captured = await captureImageGenerationUsage({
+            requestId: request.idempotencyKey,
+            run: async () => (dependencies.generate
+                ? dependencies.generate(request.prompt, agent, options)
+                : preflight.provider === 'openai'
+                    ? new OpenAIProvider(preflight.apiKey).createImage(request.prompt, preflight.model, agent, options)
+                    : ensembleImage(request.prompt, agent, options)),
+        });
+        const generated = captured.outcome.status === 'fulfilled'
+            ? captured.outcome.value
+            : undefined;
+        attempt.usage = imageGenerationUsageEvidence({
+            provider: preflight.provider,
+            model: preflight.model,
+            requestId: request.idempotencyKey,
+            ...(providerRequestId ? { providerRequestId } : {}),
+            entries: captured.entries,
+            providerCompleted: captured.outcome.status === 'fulfilled',
+            ...(Array.isArray(generated) ? { generatedImageCount: generated.length } : {}),
+        });
+        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        if (captured.outcome.status === 'rejected')
+            throw captured.outcome.reason;
+        if (!Array.isArray(generated) || generated.length !== 1 || typeof generated[0] !== 'string') {
+            throw new Error('Image provider did not return exactly one image');
+        }
+        const bytes = await generatedPngBytes(generated[0]);
+        await writeFile(request.outputPath, bytes, { flag: 'wx' });
+        attempt.status = 'succeeded';
+        attempt.completedAt = timestamp(dependencies);
+        attempt.outputSha256 = imageGenerationSha256(bytes);
+        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        return {
+            ...(request.candidateId ? { candidateId: request.candidateId } : {}),
+            provider: attempt.provider,
+            model: attempt.model,
+            outputPath: request.outputPath,
+            outputSha256: attempt.outputSha256,
+            attemptFile: request.attemptFile,
+            providerStartedAt: attempt.providerStartedAt,
+            completedAt: attempt.completedAt,
+            usage: attempt.usage,
+        };
+    }
+    catch (error) {
+        attempt.status = 'failed';
+        attempt.completedAt = timestamp(dependencies);
+        attempt.error = error instanceof Error ? error.message : String(error);
+        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        throw new Error(`Image generation failed after dispatch with ${attempt.provider}; no provider fallback`
+            + ` was attempted. Evidence: ${request.attemptFile}. ${attempt.error}`, { cause: error });
+    }
+};
+//# sourceMappingURL=image-generation-run.js.map

package/dist/image-generation-run.js.map

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

package/dist/image-generation-usage.d.ts

@@ -0,0 +1,71 @@
+import { type ModelUsage } from '@just-every/ensemble';
+export type ImageGenerationUsageEntry = {
+    model?: string;
+    inputTokens?: number;
+    inputTokensByModality?: {
+        text: number;
+        image: number;
+    };
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedTokens?: number;
+    imageCount?: number;
+    inputModality?: ModelUsage['input_modality'];
+    outputModality?: ModelUsage['output_modality'];
+    costUsd?: number;
+    estimatedCostUsd?: number;
+};
+export type ImageGenerationUsageEvidence = {
+    requestId: string;
+    providerRequestId?: string;
+    billing: 'openai-api' | 'codex-included-quota';
+    method: 'provider-reported-token-usage' | 'provider-estimated-output-only' | 'incomplete-provider-token-usage' | 'missing-provider-usage' | 'provider-reported-included-quota' | 'selected-provider-included-quota';
+    completeness: 'full' | 'partial' | 'missing' | 'included-quota';
+    costUsd: number | null;
+    estimatedCostUsd?: number;
+    inputTokens?: number;
+    inputTokensByModality?: {
+        text: number;
+        image: number;
+    };
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedTokens?: number;
+    imageCount?: number;
+    entries: ImageGenerationUsageEntry[];
+};
+export type ImageGenerationBatchAccounting = {
+    billing: ImageGenerationUsageEvidence['billing'];
+    method: 'sum-candidate-evidence';
+    completeness: 'full' | 'partial' | 'missing' | 'included-quota';
+    candidateCount: number;
+    fullCostCandidateCount: number;
+    includedQuotaCandidateCount: number;
+    incompleteCandidateCount: number;
+    costUsd: number | null;
+    recordedCostUsd: number | null;
+};
+export type CapturedImageGeneration<T> = {
+    outcome: PromiseSettledResult<T>;
+    entries: ModelUsage[];
+};
+/**
+ * Capture usage for one provider request without serializing other image calls.
+ * Ensemble emits the caller-supplied request_id synchronously to every listener,
+ * so exact request filtering keeps parallel candidates isolated.
+ */
+export declare const captureImageGenerationUsage: <T>(args: {
+    requestId: string;
+    run: () => Promise<T>;
+}) => Promise<CapturedImageGeneration<T>>;
+export declare const imageGenerationUsageEvidence: (args: {
+    provider: "codex" | "openai";
+    model: "codex-gpt-image-2" | "gpt-image-2";
+    requestId: string;
+    providerRequestId?: string;
+    entries: ModelUsage[];
+    providerCompleted: boolean;
+    generatedImageCount?: number;
+}) => ImageGenerationUsageEvidence;
+export declare const summarizeImageGenerationUsage: (usages: Array<ImageGenerationUsageEvidence | undefined>, provider: "codex" | "openai") => ImageGenerationBatchAccounting;
+//# sourceMappingURL=image-generation-usage.d.ts.map

package/dist/image-generation-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-usage.d.ts","sourceRoot":"","sources":["../src/image-generation-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,cAAc,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,YAAY,GAAG,sBAAsB,CAAC;IAC/C,MAAM,EACF,+BAA+B,GAC/B,gCAAgC,GAChC,iCAAiC,GACjC,wBAAwB,GACxB,kCAAkC,GAClC,kCAAkC,CAAC;IACvC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,gBAAgB,CAAC;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,EAAE,wBAAwB,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,gBAAgB,CAAC;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B,EAAE,MAAM,CAAC;IACpC,wBAAwB,EAAE,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;IACvC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAU,CAAC,EAAE,MAAM;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CACvB,KAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAmBrC,CAAC;AAsFF,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,4BA+DH,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,QAAQ,KAAK,CAAC,4BAA4B,GAAG,SAAS,CAAC,EACvD,UAAU,OAAO,GAAG,QAAQ,KAC3B,8BA4BF,CAAC"}