@12ui/design 0.2.27 → 0.2.28

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

@@ -1,49 +0,0 @@
-import { type ImageGenerationAttempt } from './image-generation-evidence.js';
-/**
- * What a resume is allowed to do with one candidate, decided only from durable
- * evidence. The single invariant every disposition serves: a resume may finish
- * delivering work that was already bought, and may start work that provably was
- * not, but it may never buy the same candidate twice.
- */
-export type ImageGenerationResumeDisposition = 
-/** PNG and evidence are already in their destination. Nothing to do, nothing to buy. */
-'materialized'
-/** The paid bytes are already on disk in staging. Move them into place; no provider call. */
- | 'stageable'
-/** Provably unbilled, or billed under a key the provider itself deduplicates. */
- | 'redispatchable'
-/** Billed and lost, with no free way to ask for it again. Refuse rather than re-buy. */
- | 'unrecoverable';
-export type ImageGenerationResumeState = {
-    candidateId?: string;
-    outputPath: string;
-    attemptFile: string;
-    disposition: ImageGenerationResumeDisposition;
-    reason: string;
-    attempt?: ImageGenerationAttempt;
-};
-export declare const classifyImageGenerationResume: (args: {
-    outputPath: string;
-    candidateId?: string;
-}) => Promise<ImageGenerationResumeState>;
-export declare const resumeStateSummary: (states: readonly ImageGenerationResumeState[]) => {
-    materialized: number;
-    stageable: number;
-    redispatchable: number;
-    unrecoverable: number;
-};
-export declare const describeResumeState: (state: ImageGenerationResumeState) => string;
-/**
- * Nothing was ever started here: no candidate has an attempt ledger, staged
- * bytes, or a delivered file.
- *
- * This is a categorically different situation from a recovery that cannot
- * recover, and it must never be reported with recovery counts. A caller that
- * reaches for `--resume` before dispatching once — measured in 18 of 24
- * compliance runs — reads "0 recovered, 4 unrecoverable" as a provider outage
- * and abandons the whole pipeline, in one case discarding four valid PNGs a
- * later dispatch had actually produced. The honest answer is that the work has
- * not been asked for yet.
- */
-export declare const batchWasNeverDispatched: (states: readonly ImageGenerationResumeState[]) => boolean;
-//# sourceMappingURL=image-generation-resume.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"image-generation-resume.d.ts","sourceRoot":"","sources":["../src/image-generation-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAO/F;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC;AAC1C,wFAAwF;AACtF,cAAc;AAChB,6FAA6F;GAC3F,WAAW;AACb,iFAAiF;GAC/E,gBAAgB;AAClB,wFAAwF;GACtF,eAAe,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,gCAAgC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAU,MAAM;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,OAAO,CAAC,0BAA0B,CAuErC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,0BAA0B,EAAE,KAAG;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CAMtB,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,OAAO,0BAA0B,KAAG,MAEvE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,0BAA0B,EAAE,KAC5C,OAED,CAAC"}

package/dist/image-generation-resume.js

@@ -1,96 +0,0 @@
-import { imageAttemptPath } from './image-generation-evidence.js';
-import { imageGenerationPathExists } from './image-generation-fs.js';
-import { imageGenerationStagedPaths, readImageGenerationAttemptFile, } from './image-generation-staging.js';
-export const classifyImageGenerationResume = async (args) => {
-    const attemptFile = imageAttemptPath(args.outputPath);
-    const staged = imageGenerationStagedPaths(args.outputPath);
-    const [outputExists, stagedOutputExists, finalAttempt, stagedAttempt] = await Promise.all([
-        imageGenerationPathExists(args.outputPath),
-        imageGenerationPathExists(staged.stagedOutputPath),
-        readImageGenerationAttemptFile(attemptFile),
-        readImageGenerationAttemptFile(staged.stagedAttemptFile),
-    ]);
-    const attempt = stagedAttempt ?? finalAttempt;
-    const base = {
-        ...(args.candidateId ? { candidateId: args.candidateId } : {}),
-        outputPath: args.outputPath,
-        attemptFile,
-        ...(attempt ? { attempt } : {}),
-    };
-    const stagingRemnant = stagedOutputExists || stagedAttempt !== undefined;
-    if (outputExists && finalAttempt && !stagingRemnant) {
-        return {
-            ...base,
-            disposition: 'materialized',
-            reason: 'the candidate and its evidence are already in place',
-        };
-    }
-    // Bytes on disk mean the call was already paid for and only delivery is
-    // outstanding — either the PNG is still staged, or it landed and its ledger
-    // entry did not.
-    if (stagedOutputExists || (outputExists && stagingRemnant)) {
-        return {
-            ...base,
-            disposition: 'stageable',
-            reason: 'the generated image is already on disk and only needs moving into place',
-        };
-    }
-    if (!attempt) {
-        return {
-            ...base,
-            disposition: 'redispatchable',
-            reason: 'no attempt evidence exists, so no provider call was ever reserved for it',
-        };
-    }
-    if (!attempt.providerStartedAt) {
-        return {
-            ...base,
-            disposition: 'redispatchable',
-            reason: 'the provider call was never started, so nothing was billed for it',
-        };
-    }
-    if (attempt.status === 'failed') {
-        return {
-            ...base,
-            disposition: 'unrecoverable',
-            reason: `the provider call failed after dispatch (${attempt.error ?? 'no recorded error'});`
-                + ' repeating it would be a second paid call',
-        };
-    }
-    if (attempt.providerIdempotencyEnforced) {
-        return {
-            ...base,
-            disposition: 'redispatchable',
-            reason: 'the provider enforces idempotency on the recorded key, so re-requesting the same'
-                + ' identity returns the same result without a second charge',
-        };
-    }
-    return {
-        ...base,
-        disposition: 'unrecoverable',
-        reason: `the ${attempt.provider} call was dispatched and its result was lost, and that provider`
-            + ' does not enforce idempotency on the recorded key, so re-requesting it would be a second'
-            + ' paid call; give this candidate a new output path and idempotency key to buy it again',
-    };
-};
-export const resumeStateSummary = (states) => ({
-    materialized: states.filter((state) => state.disposition === 'materialized').length,
-    stageable: states.filter((state) => state.disposition === 'stageable').length,
-    redispatchable: states.filter((state) => state.disposition === 'redispatchable').length,
-    unrecoverable: states.filter((state) => state.disposition === 'unrecoverable').length,
-});
-export const describeResumeState = (state) => (`${state.candidateId ?? state.outputPath}: ${state.disposition} — ${state.reason}`);
-/**
- * Nothing was ever started here: no candidate has an attempt ledger, staged
- * bytes, or a delivered file.
- *
- * This is a categorically different situation from a recovery that cannot
- * recover, and it must never be reported with recovery counts. A caller that
- * reaches for `--resume` before dispatching once — measured in 18 of 24
- * compliance runs — reads "0 recovered, 4 unrecoverable" as a provider outage
- * and abandons the whole pipeline, in one case discarding four valid PNGs a
- * later dispatch had actually produced. The honest answer is that the work has
- * not been asked for yet.
- */
-export const batchWasNeverDispatched = (states) => states.length > 0 && states.every((state) => (state.attempt === undefined && state.disposition === 'redispatchable'));
-//# sourceMappingURL=image-generation-resume.js.map

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

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

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

@@ -1,46 +0,0 @@
-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;
-    outputBytes: number;
-    attemptFile: string;
-    providerStartedAt: string;
-    completedAt: string;
-    usage: ImageGenerationUsageEvidence;
-};
-export declare const reserveImageGeneration: (args: {
-    request: PreparedImageGenerationRequest;
-    preflight: ImageProviderPreflight;
-    batch?: ImageGenerationAttempt["batch"];
-    dependencies?: ImageGenerationDependencies;
-}) => Promise<ReservedImageGeneration>;
-/**
- * Re-enter an existing candidate identity without minting a new ledger entry.
- * The caller must already have proved, from that entry, that redispatching it
- * cannot double-spend.
- */
-export declare const resumeReservedImageGeneration: (args: {
-    request: PreparedImageGenerationRequest;
-    preflight: ImageProviderPreflight;
-    attempt: ImageGenerationAttempt;
-}) => 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

@@ -1 +0,0 @@
-{"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;AAMxC,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,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,CAmClC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAClD,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC,KAAG,uBAIF,CAAC;AAEH,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,CAiG/B,CAAC"}

package/dist/image-generation-run.js

@@ -1,158 +0,0 @@
-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 { imageGenerationErrorMessage, imageGenerationProviderRequestId, } from './image-generation-error.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: 4,
-        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,
-        },
-        referenceMode: args.request.referenceMode,
-        outputPath: args.request.outputPath,
-        preparedAt: timestamp(dependencies),
-        ...(args.batch ? { batch: args.batch } : {}),
-    };
-    await writeImageGenerationAttempt(args.request.stagedAttemptFile, attempt, true).catch((error) => {
-        if (error.code === 'EEXIST') {
-            throw new Error(`Image attempt evidence already exists at ${args.request.stagedAttemptFile}. 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 };
-};
-/**
- * Re-enter an existing candidate identity without minting a new ledger entry.
- * The caller must already have proved, from that entry, that redispatching it
- * cannot double-spend.
- */
-export const resumeReservedImageGeneration = (args) => ({
-    request: args.request,
-    preflight: args.preflight,
-    attempt: { ...args.attempt, status: 'prepared', error: undefined },
-});
-export const markImageGenerationDispatched = async (reserved, dependencies = {}) => {
-    reserved.attempt.status = 'dispatched';
-    reserved.attempt.dispatchedAt = timestamp(dependencies);
-    await writeImageGenerationAttempt(reserved.request.stagedAttemptFile, 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.stagedAttemptFile, reserved.attempt);
-};
-export const dispatchImageGeneration = async (reserved, dependencies = {}) => {
-    const { request, preflight, attempt } = reserved;
-    let providerRequestId;
-    attempt.providerStartedAt = timestamp(dependencies);
-    await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
-    try {
-        const agent = {
-            agent_id: `12ui-image-${imageGenerationSha256(request.idempotencyKey).slice(0, 16)}`,
-            model: preflight.model,
-            cwd: request.projectRoot,
-            retryOptions: { maxRetries: 0 },
-        };
-        const options = {
-            n: 1,
-            size: request.aspect,
-            quality: 'high',
-            source_images: [request.reference.dataUrl],
-            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 } : {}),
-        });
-        if (providerRequestId)
-            attempt.providerRequestId = providerRequestId;
-        await writeImageGenerationAttempt(request.stagedAttemptFile, 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]);
-        // Staged, not delivered. The caller materializes every candidate together
-        // once the batch is terminal, so no directory listing can catch a
-        // half-written set of candidates.
-        await writeFile(request.stagedOutputPath, bytes, { flag: 'wx' });
-        attempt.status = 'succeeded';
-        attempt.completedAt = timestamp(dependencies);
-        attempt.outputSha256 = imageGenerationSha256(bytes);
-        await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
-        return {
-            ...(request.candidateId ? { candidateId: request.candidateId } : {}),
-            provider: attempt.provider,
-            model: attempt.model,
-            outputPath: request.outputPath,
-            outputSha256: attempt.outputSha256,
-            outputBytes: bytes.byteLength,
-            attemptFile: request.attemptFile,
-            providerStartedAt: attempt.providerStartedAt,
-            completedAt: attempt.completedAt,
-            usage: attempt.usage,
-        };
-    }
-    catch (error) {
-        providerRequestId ??= imageGenerationProviderRequestId(error);
-        if (providerRequestId) {
-            attempt.providerRequestId = providerRequestId;
-            if (attempt.usage && !attempt.usage.providerRequestId) {
-                attempt.usage.providerRequestId = providerRequestId;
-            }
-        }
-        attempt.status = 'failed';
-        attempt.completedAt = timestamp(dependencies);
-        attempt.error = imageGenerationErrorMessage(error);
-        await writeImageGenerationAttempt(request.stagedAttemptFile, 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

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

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

@@ -1,25 +0,0 @@
-import { type ImageGenerationAttempt } from './image-generation-evidence.js';
-export declare const IMAGE_STAGING_DIRECTORY_NAME = ".12ui-image-staging";
-export type ImageGenerationStagedPaths = {
-    stagingDirectory: string;
-    stagedOutputPath: string;
-    stagedAttemptFile: string;
-};
-export declare const imageGenerationStagedPaths: (outputPath: string) => ImageGenerationStagedPaths;
-export declare const ensureImageGenerationStaging: (outputPath: string) => Promise<void>;
-export declare const readStagedImageGenerationAttempt: (outputPath: string) => Promise<ImageGenerationAttempt | undefined>;
-export declare const readImageGenerationAttemptFile: (file: string) => Promise<ImageGenerationAttempt | undefined>;
-export type ImageGenerationMaterialization = {
-    outputPath: string;
-    attemptFile: string;
-    movedOutput: boolean;
-    movedAttempt: boolean;
-};
-/**
- * Move one candidate's staged artifacts into their destination. The PNG lands
- * before its evidence so that a crash between the two renames leaves the
- * staged ledger in place, which is what lets a later resume prove the work was
- * already paid for instead of buying it again.
- */
-export declare const materializeImageGeneration: (outputPath: string) => Promise<ImageGenerationMaterialization>;
-//# sourceMappingURL=image-generation-staging.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"image-generation-staging.d.ts","sourceRoot":"","sources":["../src/image-generation-staging.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAW/F,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,YAAY,MAAM,KAAG,0BAQ/D,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAEnF,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,YAAY,MAAM,KACjB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAE5C,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,KACX,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAkB5C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,MAAM,KACjB,OAAO,CAAC,8BAA8B,CA0BxC,CAAC"}

package/dist/image-generation-staging.js

@@ -1,80 +0,0 @@
-import { mkdir, readFile, rename, rmdir } from 'node:fs/promises';
-import path from 'node:path';
-import { imageGenerationPathExists } from './image-generation-fs.js';
-import { imageAttemptPath } from './image-generation-evidence.js';
-// Every in-flight candidate — its PNG bytes and its attempt ledger — is written
-// inside a hidden staging directory and moved into the destination directory
-// only once the batch is terminal. A caller listing the candidates directory
-// therefore never observes the half-written state that made eleven benchmark
-// runs declare failure roughly thirty seconds before valid candidates landed.
-//
-// The staging directory is a child of the destination directory on purpose:
-// same-directory renames are same-filesystem, so materialization is atomic and
-// can never fail with EXDEV the way a system-temp staging path could.
-export const IMAGE_STAGING_DIRECTORY_NAME = '.12ui-image-staging';
-export const imageGenerationStagedPaths = (outputPath) => {
-    const stagingDirectory = path.join(path.dirname(outputPath), IMAGE_STAGING_DIRECTORY_NAME);
-    const base = path.basename(outputPath);
-    return {
-        stagingDirectory,
-        stagedOutputPath: path.join(stagingDirectory, `${base}.part`),
-        stagedAttemptFile: path.join(stagingDirectory, `${base}.attempt.json`),
-    };
-};
-export const ensureImageGenerationStaging = async (outputPath) => {
-    await mkdir(imageGenerationStagedPaths(outputPath).stagingDirectory, { recursive: true });
-};
-export const readStagedImageGenerationAttempt = async (outputPath) => (readImageGenerationAttemptFile(imageGenerationStagedPaths(outputPath).stagedAttemptFile));
-export const readImageGenerationAttemptFile = async (file) => {
-    let source;
-    try {
-        source = await readFile(file, 'utf8');
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-    try {
-        const value = JSON.parse(source);
-        if (typeof value !== 'object' || value === null)
-            return undefined;
-        return value;
-    }
-    catch {
-        // Unreadable evidence is still evidence that a request was reserved here.
-        // Callers must treat it as "something happened" rather than "nothing did",
-        // so surface a minimal record instead of pretending the file is absent.
-        return { status: 'dispatched' };
-    }
-};
-/**
- * Move one candidate's staged artifacts into their destination. The PNG lands
- * before its evidence so that a crash between the two renames leaves the
- * staged ledger in place, which is what lets a later resume prove the work was
- * already paid for instead of buying it again.
- */
-export const materializeImageGeneration = async (outputPath) => {
-    const attemptFile = imageAttemptPath(outputPath);
-    const { stagingDirectory, stagedOutputPath, stagedAttemptFile } = (imageGenerationStagedPaths(outputPath));
-    let movedOutput = false;
-    let movedAttempt = false;
-    if (await imageGenerationPathExists(stagedOutputPath)) {
-        if (await imageGenerationPathExists(outputPath)) {
-            throw new Error(`Refusing to overwrite an existing candidate at ${outputPath} with staged bytes from`
-                + ` ${stagedOutputPath}; inspect both before continuing.`);
-        }
-        await rename(stagedOutputPath, outputPath);
-        movedOutput = true;
-    }
-    if (await imageGenerationPathExists(stagedAttemptFile)) {
-        await rename(stagedAttemptFile, attemptFile);
-        movedAttempt = true;
-    }
-    // Leave nothing behind once the last candidate in this directory is
-    // delivered. Anything still staged means work that is not delivered yet, and
-    // rmdir refuses a non-empty directory, so the check is the guarantee.
-    await rmdir(stagingDirectory).catch(() => undefined);
-    return { outputPath, attemptFile, movedOutput, movedAttempt };
-};
-//# sourceMappingURL=image-generation-staging.js.map

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

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

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

@@ -1,75 +0,0 @@
-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;
-    cacheWriteTokens?: number;
-    cacheWrite1hTokens?: 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;
-    cacheWriteTokens?: number;
-    cacheWrite1hTokens?: 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

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