lootforge 0.3.0

package/dist/providers/openai.js

@@ -0,0 +1,378 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_PROVIDER_REQUEST_TIMEOUT_MS, fetchWithTimeout, MAX_DECODED_IMAGE_BYTES, normalizeNonNegativeInteger, normalizePositiveInteger, ProviderRequestTimeoutError, toOptionalNonNegativeInteger, validateImageUrl, withCandidateSuffix, } from "./runtime.js";
+import { createProviderJob, nowIso, ProviderError, PROVIDER_CAPABILITIES, } from "./types.js";
+import { resolvePathWithinRoot } from "../shared/paths.js";
+const OPENAI_IMAGES_ENDPOINT = "https://api.openai.com/v1/images/generations";
+const OPENAI_EDITS_ENDPOINT = "https://api.openai.com/v1/images/edits";
+export const DEFAULT_OPENAI_MODEL = "gpt-image-1";
+const DEFAULT_EDIT_IMAGE_MIME_TYPE = "image/png";
+export class OpenAIProvider {
+    name = "openai";
+    capabilities;
+    model;
+    endpoint;
+    editsEndpoint;
+    timeoutMs;
+    maxRetries;
+    constructor(options = {}) {
+        const defaults = PROVIDER_CAPABILITIES.openai;
+        this.capabilities = {
+            ...defaults,
+            defaultConcurrency: normalizePositiveInteger(options.defaultConcurrency, defaults.defaultConcurrency),
+            minDelayMs: normalizeNonNegativeInteger(options.minDelayMs, defaults.minDelayMs),
+        };
+        this.model = options.model ?? DEFAULT_OPENAI_MODEL;
+        this.endpoint = options.endpoint ?? OPENAI_IMAGES_ENDPOINT;
+        this.editsEndpoint = options.editsEndpoint ?? OPENAI_EDITS_ENDPOINT;
+        this.timeoutMs = normalizePositiveInteger(options.timeoutMs, DEFAULT_PROVIDER_REQUEST_TIMEOUT_MS);
+        this.maxRetries = toOptionalNonNegativeInteger(options.maxRetries);
+    }
+    prepareJobs(targets, ctx) {
+        return targets.map((target) => createProviderJob({
+            provider: this.name,
+            target,
+            model: target.model ?? this.model,
+            imagesDir: ctx.imagesDir,
+            defaults: {
+                maxRetries: this.maxRetries,
+            },
+        }));
+    }
+    supports(feature) {
+        if (feature === "image-generation")
+            return true;
+        if (feature === "transparent-background")
+            return true;
+        if (feature === "image-edits")
+            return true;
+        if (feature === "multi-candidate")
+            return true;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (feature === "controlnet")
+            return false;
+        return false;
+    }
+    normalizeError(error) {
+        if (error instanceof ProviderError && error.provider === this.name) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new ProviderError({
+                provider: this.name,
+                code: "openai_request_failed",
+                message: error.message,
+                cause: error,
+                actionable: "Check OPENAI_API_KEY and provider/model settings, then retry generation.",
+            });
+        }
+        return new ProviderError({
+            provider: this.name,
+            code: "openai_request_failed",
+            message: "OpenAI provider failed with a non-error throwable.",
+            cause: error,
+            actionable: "Check OPENAI_API_KEY and provider/model settings, then retry generation.",
+        });
+    }
+    async runJob(job, ctx) {
+        const startedAt = nowIso(ctx.now);
+        const fetchImpl = ctx.fetchImpl ?? globalThis.fetch;
+        const apiKey = process.env.OPENAI_API_KEY?.trim();
+        if (!apiKey) {
+            throw new ProviderError({
+                provider: this.name,
+                code: "missing_api_key",
+                message: "OPENAI_API_KEY is required for OpenAI image generation.",
+                actionable: "Set OPENAI_API_KEY in the environment and rerun generate.",
+            });
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (!fetchImpl) {
+            throw new ProviderError({
+                provider: this.name,
+                code: "missing_fetch",
+                message: "Global fetch is unavailable for OpenAI provider.",
+                actionable: "Use Node.js 18+ or pass a fetch implementation in the run context.",
+            });
+        }
+        try {
+            const useEdits = this.shouldUseEdits(job);
+            const actualPrompt = useEdits ? this.buildEditPrompt(job) : job.prompt;
+            const response = useEdits
+                ? await this.runEditRequest(job, ctx, fetchImpl, apiKey)
+                : await this.requestWithTimeout(fetchImpl, this.endpoint, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        model: job.model,
+                        prompt: job.prompt,
+                        size: job.size,
+                        quality: job.quality,
+                        background: job.background,
+                        output_format: job.outputFormat,
+                        n: Math.max(1, job.candidateCount),
+                    }),
+                });
+            if (!response.ok) {
+                const bodyText = await response.text();
+                throw this.buildHttpError(response.status, bodyText);
+            }
+            const payload = (await response.json());
+            const images = payload.data ?? [];
+            if (images.length === 0) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_missing_image",
+                    message: "OpenAI returned no image data for this job.",
+                    actionable: "Check prompt/model compatibility and retry with a simpler prompt.",
+                });
+            }
+            const candidateOutputs = [];
+            const count = Math.max(job.candidateCount, 1);
+            for (let index = 0; index < count; index += 1) {
+                const image = images[index] ?? images[0];
+                const imageBytes = await this.resolveImageBytes(image, fetchImpl);
+                const outputPath = index === 0 ? job.outPath : withCandidateSuffix(job.outPath, index + 1);
+                await mkdir(path.dirname(outputPath), { recursive: true });
+                await writeFile(outputPath, imageBytes);
+                candidateOutputs.push({
+                    outputPath,
+                    bytesWritten: imageBytes.byteLength,
+                });
+            }
+            return {
+                jobId: job.id,
+                provider: this.name,
+                model: job.model,
+                targetId: job.targetId,
+                prompt: actualPrompt,
+                outputPath: candidateOutputs[0].outputPath,
+                bytesWritten: candidateOutputs[0].bytesWritten,
+                inputHash: job.inputHash,
+                startedAt,
+                finishedAt: nowIso(ctx.now),
+                candidateOutputs,
+            };
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    shouldUseEdits(job) {
+        if (job.target.generationMode !== "edit-first") {
+            return false;
+        }
+        return (job.target.edit?.inputs?.length ?? 0) > 0;
+    }
+    async runEditRequest(job, ctx, fetchImpl, apiKey) {
+        const editInputs = job.target.edit?.inputs ?? [];
+        const baseAndReferenceInputs = editInputs.filter((input) => input.role !== "mask");
+        const maskInputs = editInputs.filter((input) => input.role === "mask");
+        if (baseAndReferenceInputs.length === 0) {
+            throw new ProviderError({
+                provider: this.name,
+                code: "openai_edit_missing_base_image",
+                message: `Target "${job.targetId}" requested edit-first mode but no base/reference images were provided.`,
+                actionable: "Add at least one edit input with role base/reference for generationMode=edit-first.",
+            });
+        }
+        const form = new FormData();
+        form.set("model", job.model);
+        form.set("prompt", this.buildEditPrompt(job));
+        form.set("size", job.size);
+        form.set("quality", job.quality);
+        form.set("background", job.background);
+        form.set("output_format", job.outputFormat);
+        form.set("n", String(Math.max(1, job.candidateCount)));
+        for (const input of baseAndReferenceInputs) {
+            const resolvedPath = this.resolveEditInputPath(input.path, ctx.outDir, job.targetId);
+            const imageBytes = await this.readEditInputBytes(resolvedPath, job.targetId);
+            const imageData = new Uint8Array(imageBytes);
+            if (baseAndReferenceInputs.length === 1) {
+                form.append("image", new Blob([imageData], { type: this.mimeTypeForPath(resolvedPath) }), path.basename(resolvedPath));
+            }
+            else {
+                form.append("image[]", new Blob([imageData], { type: this.mimeTypeForPath(resolvedPath) }), path.basename(resolvedPath));
+            }
+        }
+        if (maskInputs.length > 0) {
+            const maskPath = this.resolveEditInputPath(maskInputs[0].path, ctx.outDir, job.targetId);
+            const maskBytes = await this.readEditInputBytes(maskPath, job.targetId);
+            const maskData = new Uint8Array(maskBytes);
+            form.append("mask", new Blob([maskData], { type: this.mimeTypeForPath(maskPath) }), path.basename(maskPath));
+        }
+        return this.requestWithTimeout(fetchImpl, this.editsEndpoint, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: form,
+        });
+    }
+    resolveEditInputPath(inputPath, outDir, targetId) {
+        try {
+            return resolvePathWithinRoot(outDir, inputPath, `edit input path for target "${targetId}"`);
+        }
+        catch (error) {
+            throw new ProviderError({
+                provider: this.name,
+                code: "openai_edit_input_unsafe_path",
+                message: `Unsafe edit input path "${inputPath}" for target "${targetId}".`,
+                actionable: `Edit input paths must stay within the output root (${path.resolve(outDir)}).`,
+                cause: error,
+            });
+        }
+    }
+    async readEditInputBytes(inputPath, targetId) {
+        try {
+            return await readFile(inputPath);
+        }
+        catch (error) {
+            throw new ProviderError({
+                provider: this.name,
+                code: "openai_edit_input_unreadable",
+                message: `Failed to read edit input "${inputPath}" for target "${targetId}".`,
+                actionable: "Ensure edit input files exist and paths are correct relative to --out (or absolute).",
+                cause: error,
+            });
+        }
+    }
+    buildEditPrompt(job) {
+        const instruction = job.target.edit?.instruction?.trim();
+        const preserveCompositionHint = job.target.edit?.preserveComposition
+            ? "Preserve composition and camera framing unless the instruction explicitly changes them."
+            : "";
+        if (!instruction) {
+            return [job.prompt, preserveCompositionHint].filter(Boolean).join("\n\n");
+        }
+        return [instruction, preserveCompositionHint, "Target style/output requirements:", job.prompt]
+            .filter(Boolean)
+            .join("\n\n");
+    }
+    mimeTypeForPath(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        if (ext === ".jpg" || ext === ".jpeg")
+            return "image/jpeg";
+        if (ext === ".webp")
+            return "image/webp";
+        if (ext === ".gif")
+            return "image/gif";
+        if (ext === ".bmp")
+            return "image/bmp";
+        if (ext === ".svg")
+            return "image/svg+xml";
+        return DEFAULT_EDIT_IMAGE_MIME_TYPE;
+    }
+    async resolveImageBytes(imageData, fetchImpl) {
+        if (typeof imageData.b64_json === "string" && imageData.b64_json.length > 0) {
+            const buffer = Buffer.from(imageData.b64_json, "base64");
+            if (buffer.byteLength > MAX_DECODED_IMAGE_BYTES) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_image_too_large",
+                    message: `Decoded image exceeds ${MAX_DECODED_IMAGE_BYTES} byte safety limit.`,
+                    actionable: "Request smaller images or reduce candidate count.",
+                });
+            }
+            return buffer;
+        }
+        if (typeof imageData.url === "string" && imageData.url.length > 0) {
+            validateImageUrl(imageData.url, "OpenAI image download");
+            const imageResponse = await this.requestWithTimeout(fetchImpl, imageData.url);
+            if (!imageResponse.ok) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_image_download_failed",
+                    status: imageResponse.status,
+                    message: `OpenAI image download failed with status ${imageResponse.status}.`,
+                    actionable: "Retry generation; if this persists, verify network egress and OpenAI response format.",
+                });
+            }
+            const buffer = Buffer.from(await imageResponse.arrayBuffer());
+            if (buffer.byteLength === 0) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_empty_image",
+                    message: "OpenAI returned an empty image payload.",
+                    actionable: "Retry generation and verify the requested model can output images.",
+                });
+            }
+            if (buffer.byteLength > MAX_DECODED_IMAGE_BYTES) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_image_too_large",
+                    message: `Decoded image exceeds ${MAX_DECODED_IMAGE_BYTES} byte safety limit.`,
+                    actionable: "Request smaller images or reduce candidate count.",
+                });
+            }
+            return buffer;
+        }
+        throw new ProviderError({
+            provider: this.name,
+            code: "openai_missing_image",
+            message: "OpenAI response had neither b64_json nor url image data.",
+            actionable: "Switch model or prompt format and verify the Images API response schema.",
+        });
+    }
+    buildHttpError(status, bodyText) {
+        const details = this.parseErrorPayload(bodyText);
+        let message = `OpenAI images request failed with status ${status}`;
+        if (details.code) {
+            message += ` (${details.code})`;
+        }
+        message += ".";
+        if (details.message) {
+            message += ` ${details.message}`;
+        }
+        return new ProviderError({
+            provider: this.name,
+            code: "openai_http_error",
+            status,
+            message,
+            actionable: this.httpErrorActionable(details.code),
+            cause: bodyText,
+        });
+    }
+    parseErrorPayload(bodyText) {
+        try {
+            const payload = JSON.parse(bodyText);
+            return {
+                message: payload.error?.message?.trim() ?? undefined,
+                code: payload.error?.code?.trim() ?? undefined,
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+    httpErrorActionable(code) {
+        if (code?.includes("billing") || code?.includes("quota")) {
+            return "Increase the OpenAI billing limit or switch providers, then retry generation.";
+        }
+        return "Confirm OPENAI_API_KEY permissions and model availability for the Images API.";
+    }
+    async requestWithTimeout(fetchImpl, input, init) {
+        try {
+            return await fetchWithTimeout(fetchImpl, input, init, this.timeoutMs);
+        }
+        catch (error) {
+            if (error instanceof ProviderRequestTimeoutError) {
+                throw new ProviderError({
+                    provider: this.name,
+                    code: "openai_request_timeout",
+                    message: `OpenAI request timed out after ${error.timeoutMs}ms.`,
+                    actionable: "Increase providers.openai.timeoutMs or LOOTFORGE_OPENAI_TIMEOUT_MS and retry.",
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+    }
+}
+export function createOpenAIProvider(options = {}) {
+    return new OpenAIProvider(options);
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/policy.d.ts

@@ -0,0 +1,9 @@
+import { type GenerationMode, type NormalizedGenerationPolicy, type NormalizedOutputFormat, type PlannedTarget, type PostProcessPolicy, type ProviderCapabilities, type ProviderName, type ProviderPolicyNormalizationResult } from "./types-core.js";
+export declare function normalizeOutputFormatAlias(value: string | undefined): NormalizedOutputFormat;
+export declare function getProviderCapabilities(provider: ProviderName): ProviderCapabilities;
+export declare function isProviderName(value: unknown): value is ProviderName;
+export declare function getTargetGenerationPolicy(target: PlannedTarget): NormalizedGenerationPolicy;
+export declare function getTargetGenerationMode(target: PlannedTarget): GenerationMode;
+export declare function normalizeGenerationPolicyForProvider(provider: ProviderName, rawPolicy: NormalizedGenerationPolicy): ProviderPolicyNormalizationResult;
+export declare function getTargetPostProcessPolicy(target: PlannedTarget): PostProcessPolicy;
+export declare function nowIso(now?: () => Date): string;

package/dist/providers/policy.js

@@ -0,0 +1,192 @@
+import { PROVIDER_CAPABILITIES, PROVIDER_NAMES } from "./types-core.js";
+const DEFAULT_SIZE = "1024x1024";
+const DEFAULT_QUALITY = "high";
+const DEFAULT_BACKGROUND = "opaque";
+const DEFAULT_OUTPUT_FORMAT = "png";
+const DEFAULT_POST_PROCESS_ALGORITHM = "lanczos3";
+const DEFAULT_CANDIDATE_COUNT = 1;
+const DEFAULT_GENERATION_MODE = "text";
+export function normalizeOutputFormatAlias(value) {
+    const normalized = value?.trim().toLowerCase() ?? "";
+    if (normalized === "jpg")
+        return "jpeg";
+    if (normalized === "jpeg")
+        return "jpeg";
+    if (normalized === "webp")
+        return "webp";
+    return "png";
+}
+export function getProviderCapabilities(provider) {
+    return PROVIDER_CAPABILITIES[provider];
+}
+export function isProviderName(value) {
+    return typeof value === "string" && PROVIDER_NAMES.includes(value);
+}
+export function getTargetGenerationPolicy(target) {
+    const policy = target.generationPolicy ?? {};
+    const normalizedHiresFix = normalizeHiresFixPolicy(policy.hiresFix);
+    const candidatesRaw = typeof policy.candidates === "number" && Number.isFinite(policy.candidates)
+        ? Math.round(policy.candidates)
+        : DEFAULT_CANDIDATE_COUNT;
+    const maxRetriesRaw = typeof policy.maxRetries === "number" && Number.isFinite(policy.maxRetries)
+        ? Math.round(policy.maxRetries)
+        : undefined;
+    const draftQuality = policy.draftQuality?.trim();
+    const finalQuality = policy.finalQuality?.trim();
+    return {
+        size: policy.size?.trim() ?? DEFAULT_SIZE,
+        quality: policy.quality?.trim() ?? DEFAULT_QUALITY,
+        ...(draftQuality ? { draftQuality } : {}),
+        ...(finalQuality ? { finalQuality } : {}),
+        background: policy.background?.trim() ?? DEFAULT_BACKGROUND,
+        outputFormat: normalizeOutputFormatAlias(policy.outputFormat ?? DEFAULT_OUTPUT_FORMAT),
+        ...(typeof policy.highQuality === "boolean" ? { highQuality: policy.highQuality } : {}),
+        ...(normalizedHiresFix ? { hiresFix: normalizedHiresFix } : {}),
+        candidates: Math.max(1, candidatesRaw),
+        ...(typeof maxRetriesRaw === "number" ? { maxRetries: Math.max(0, maxRetriesRaw) } : {}),
+        fallbackProviders: Array.isArray(policy.fallbackProviders)
+            ? policy.fallbackProviders.filter((name) => isProviderName(name))
+            : [],
+        providerConcurrency: typeof policy.providerConcurrency === "number" &&
+            Number.isFinite(policy.providerConcurrency) &&
+            policy.providerConcurrency > 0
+            ? Math.round(policy.providerConcurrency)
+            : undefined,
+        rateLimitPerMinute: typeof policy.rateLimitPerMinute === "number" &&
+            Number.isFinite(policy.rateLimitPerMinute) &&
+            policy.rateLimitPerMinute > 0
+            ? Math.round(policy.rateLimitPerMinute)
+            : undefined,
+        vlmGate: normalizeVlmGatePolicy(policy.vlmGate),
+        coarseToFine: normalizeCoarseToFinePolicy(policy.coarseToFine),
+        agenticRetry: normalizeAgenticRetryPolicy(policy.agenticRetry),
+    };
+}
+function normalizeHiresFixPolicy(policy) {
+    if (!policy) {
+        return undefined;
+    }
+    const normalized = {};
+    if (typeof policy.enabled === "boolean") {
+        normalized.enabled = policy.enabled;
+    }
+    if (typeof policy.upscale === "number" && Number.isFinite(policy.upscale)) {
+        normalized.upscale = Math.max(1.01, Math.min(4, policy.upscale));
+    }
+    if (typeof policy.denoiseStrength === "number" && Number.isFinite(policy.denoiseStrength)) {
+        normalized.denoiseStrength = Math.max(0, Math.min(1, policy.denoiseStrength));
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function normalizeVlmGatePolicy(policy) {
+    if (!policy) {
+        return undefined;
+    }
+    const threshold = typeof policy.threshold === "number" && Number.isFinite(policy.threshold)
+        ? policy.threshold
+        : 4;
+    const normalized = {
+        threshold: Math.max(0, Math.min(5, threshold)),
+    };
+    if (typeof policy.rubric === "string" && policy.rubric.trim()) {
+        normalized.rubric = policy.rubric.trim();
+    }
+    return normalized;
+}
+function normalizeCoarseToFinePolicy(policy) {
+    if (!policy) {
+        return undefined;
+    }
+    const promoteTopK = typeof policy.promoteTopK === "number" && Number.isFinite(policy.promoteTopK)
+        ? Math.max(1, Math.round(policy.promoteTopK))
+        : 1;
+    const minDraftScore = typeof policy.minDraftScore === "number" && Number.isFinite(policy.minDraftScore)
+        ? policy.minDraftScore
+        : undefined;
+    return {
+        enabled: policy.enabled ?? true,
+        promoteTopK,
+        ...(typeof minDraftScore === "number" ? { minDraftScore } : {}),
+        requireDraftAcceptance: policy.requireDraftAcceptance ?? true,
+    };
+}
+function normalizeAgenticRetryPolicy(policy) {
+    if (!policy) {
+        return undefined;
+    }
+    const maxRetries = typeof policy.maxRetries === "number" && Number.isFinite(policy.maxRetries)
+        ? Math.max(0, Math.round(policy.maxRetries))
+        : 1;
+    return {
+        enabled: policy.enabled ?? true,
+        maxRetries,
+    };
+}
+export function getTargetGenerationMode(target) {
+    if (target.generationMode === "edit-first") {
+        return "edit-first";
+    }
+    return DEFAULT_GENERATION_MODE;
+}
+export function normalizeGenerationPolicyForProvider(provider, rawPolicy) {
+    const capabilities = getProviderCapabilities(provider);
+    const issues = [];
+    const policy = {
+        ...rawPolicy,
+        outputFormat: normalizeOutputFormatAlias(rawPolicy.outputFormat),
+    };
+    if (!capabilities.supportedOutputFormats.has(policy.outputFormat)) {
+        issues.push({
+            level: "error",
+            code: "unsupported_output_format",
+            message: `${provider} does not support output format "${policy.outputFormat}".`,
+        });
+    }
+    if (policy.background === "transparent" && policy.outputFormat === "jpeg") {
+        policy.outputFormat = "png";
+        issues.push({
+            level: "warning",
+            code: "jpg_transparency_normalized",
+            message: "Transparent background requested with JPEG output; outputFormat normalized to png.",
+        });
+    }
+    if (policy.background === "transparent" && !capabilities.supportsTransparentBackground) {
+        issues.push({
+            level: "error",
+            code: "transparent_background_unsupported",
+            message: `${provider} does not support transparent backgrounds.`,
+        });
+    }
+    if (policy.candidates > capabilities.maxCandidates) {
+        issues.push({
+            level: "warning",
+            code: "candidate_count_clamped",
+            message: `${provider} max candidates is ${capabilities.maxCandidates}; clamped requested value.`,
+        });
+        policy.candidates = capabilities.maxCandidates;
+    }
+    if (policy.coarseToFine && policy.coarseToFine.promoteTopK > policy.candidates) {
+        issues.push({
+            level: "warning",
+            code: "coarse_to_fine_topk_clamped",
+            message: `coarseToFine.promoteTopK exceeds candidates; clamped to ${policy.candidates}.`,
+        });
+        policy.coarseToFine.promoteTopK = policy.candidates;
+    }
+    policy.fallbackProviders = policy.fallbackProviders.filter((name) => name !== provider);
+    return { policy, issues };
+}
+export function getTargetPostProcessPolicy(target) {
+    const policy = target.postProcess ?? {};
+    return {
+        resizeTo: policy.resizeTo,
+        algorithm: policy.algorithm ?? DEFAULT_POST_PROCESS_ALGORITHM,
+        stripMetadata: policy.stripMetadata ?? true,
+        pngPaletteColors: policy.pngPaletteColors,
+        operations: policy.operations,
+    };
+}
+export function nowIso(now) {
+    return (now ?? (() => new Date()))().toISOString();
+}
+//# sourceMappingURL=policy.js.map

package/dist/providers/policy.js.map

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

package/dist/providers/prompt.d.ts

@@ -0,0 +1,3 @@
+import { type PromptSpec } from "./types-core.js";
+export declare function normalizePromptSpec(spec: PromptSpec): PromptSpec;
+export declare function buildStructuredPrompt(promptSpec: PromptSpec): string;