lootforge 0.3.0

package/dist/service/generationRequest.js

@@ -0,0 +1,203 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { runPlanCommand } from "../cli/commands/plan.js";
+import { parseGenerateProviderFlag, runGeneratePipeline } from "../pipeline/generate.js";
+import { PROVIDER_NAMES } from "../providers/types-core.js";
+import { isRecord } from "../shared/typeGuards.js";
+export const CANONICAL_GENERATION_REQUEST_VERSION = "v1";
+const providerSelectionSchema = z.enum([...PROVIDER_NAMES, "auto"]);
+const canonicalGenerationRequestSchema = z
+    .object({
+    manifestPath: z.string().trim().min(1).optional(),
+    manifest: z.record(z.unknown()).optional(),
+    outDir: z.string().trim().min(1).optional(),
+    provider: providerSelectionSchema.optional(),
+    targetIds: z.array(z.string().trim().min(1)).optional(),
+    skipLocked: z.boolean().optional(),
+    selectionLockPath: z.string().trim().min(1).optional(),
+})
+    .refine((value) => value.manifestPath !== undefined || value.manifest !== undefined, {
+    message: "Either manifestPath or manifest must be provided.",
+    path: ["manifestPath"],
+});
+const canonicalGenerationEnvelopeSchema = z
+    .object({
+    requestId: z.union([z.string(), z.number()]).optional(),
+    request: canonicalGenerationRequestSchema,
+})
+    .passthrough();
+export class CanonicalGenerationRequestError extends Error {
+    code;
+    status;
+    constructor(message, options) {
+        super(message);
+        this.name = "CanonicalGenerationRequestError";
+        this.code = options.code;
+        this.status = options.status;
+    }
+}
+export function getCanonicalGenerationRequestContract() {
+    return {
+        version: CANONICAL_GENERATION_REQUEST_VERSION,
+        endpoint: "/v1/generation/requests",
+        summary: "Canonical generation request contract that maps service payloads to manifest planning + generation pipeline targets.",
+        fields: {
+            manifestPath: "String path to manifest JSON (required unless manifest is provided).",
+            manifest: "Inline manifest object; when present it is materialized to a service request manifest file before planning.",
+            outDir: "Output directory root for plan/generate artifacts. Falls back to service default out dir, then manifest parent directory.",
+            provider: "Provider selection (openai|nano|local|auto). Defaults to auto.",
+            targetIds: "Optional target-id subset for generation.",
+            skipLocked: "When true (default), lock-approved targets can be skipped during generation.",
+            selectionLockPath: "Optional selection lock path override.",
+        },
+    };
+}
+export async function runCanonicalGenerationRequest(payload, context) {
+    const envelope = parseCanonicalGenerationEnvelope(payload);
+    const request = envelope.request;
+    const requestedManifestPath = request.manifestPath
+        ? path.resolve(request.manifestPath)
+        : undefined;
+    assertNoNullBytes(requestedManifestPath, "manifestPath");
+    const outDir = resolveOutDir(request.outDir, context.defaultOutDir, requestedManifestPath);
+    assertNoNullBytes(outDir, "outDir");
+    const manifestResolution = await resolveManifestPathForRequest({
+        request,
+        outDir,
+        requestId: envelope.requestId,
+    });
+    const provider = parseGenerateProviderFlag(request.provider);
+    const targetIds = normalizeTargetIds(request.targetIds);
+    const skipLocked = request.skipLocked ?? true;
+    const selectionLockPath = request.selectionLockPath
+        ? path.resolve(request.selectionLockPath)
+        : undefined;
+    assertNoNullBytes(selectionLockPath, "selectionLockPath");
+    const requestManifestPath = manifestResolution.manifestPath;
+    const shouldCleanupManifest = manifestResolution.source === "inline";
+    try {
+        const planResult = await runPlanCommand(["--manifest", requestManifestPath, "--out", outDir]);
+        const generateResult = await runGeneratePipeline({
+            outDir,
+            targetsIndexPath: planResult.targetsIndexPath,
+            provider,
+            ids: targetIds,
+            skipLocked,
+            selectionLockPath,
+        });
+        return {
+            ...(envelope.requestId !== undefined ? { requestId: envelope.requestId } : {}),
+            mappingVersion: CANONICAL_GENERATION_REQUEST_VERSION,
+            normalizedRequest: {
+                outDir,
+                manifestPath: manifestResolution.manifestPath,
+                manifestSource: manifestResolution.source,
+                provider,
+                targetIds,
+                skipLocked,
+                ...(selectionLockPath ? { selectionLockPath } : {}),
+            },
+            plan: {
+                targets: planResult.targets,
+                warnings: planResult.warnings,
+                targetsIndexPath: planResult.targetsIndexPath,
+            },
+            generate: {
+                runId: generateResult.runId,
+                jobs: generateResult.jobs.length,
+                imagesDir: generateResult.imagesDir,
+                provenancePath: generateResult.provenancePath,
+                targetsIndexPath: generateResult.targetsIndexPath,
+            },
+        };
+    }
+    finally {
+        if (shouldCleanupManifest) {
+            await rm(requestManifestPath, { force: true });
+        }
+    }
+}
+function parseCanonicalGenerationEnvelope(value) {
+    if (!isRecord(value)) {
+        throw new CanonicalGenerationRequestError("Canonical generation request must be a JSON object.", {
+            code: "invalid_canonical_generation_request",
+            status: 400,
+        });
+    }
+    const envelopeLike = canonicalGenerationEnvelopeSchema.safeParse(value);
+    if (envelopeLike.success) {
+        return envelopeLike.data;
+    }
+    const requestOnly = canonicalGenerationRequestSchema.safeParse(value);
+    if (requestOnly.success) {
+        return {
+            request: requestOnly.data,
+        };
+    }
+    const issue = (envelopeLike.error.issues[0] ?? requestOnly.error.issues[0]);
+    throw new CanonicalGenerationRequestError(issue ? `${issue.path.join(".") || "request"}: ${issue.message}` : "Invalid request shape.", {
+        code: "invalid_canonical_generation_request",
+        status: 400,
+    });
+}
+function resolveOutDir(outDir, defaultOutDir, manifestPath) {
+    if (outDir) {
+        return path.resolve(outDir);
+    }
+    if (defaultOutDir) {
+        return path.resolve(defaultOutDir);
+    }
+    if (manifestPath) {
+        return path.dirname(manifestPath);
+    }
+    throw new CanonicalGenerationRequestError("Request must provide outDir (or service default out dir) when manifestPath is omitted.", {
+        code: "canonical_generation_missing_out_dir",
+        status: 400,
+    });
+}
+async function resolveManifestPathForRequest(params) {
+    if (params.request.manifest) {
+        const suggestedPath = params.request.manifestPath
+            ? path.resolve(params.request.manifestPath)
+            : undefined;
+        const manifestPath = suggestedPath ??
+            path.join(params.outDir, "jobs", "service-requests", `${createSafeRequestId(params.requestId)}-manifest.json`);
+        await mkdir(path.dirname(manifestPath), { recursive: true });
+        await writeFile(manifestPath, `${JSON.stringify(params.request.manifest, null, 2)}\n`, "utf8");
+        return {
+            manifestPath,
+            source: "inline",
+        };
+    }
+    if (params.request.manifestPath) {
+        return {
+            manifestPath: path.resolve(params.request.manifestPath),
+            source: "path",
+        };
+    }
+    throw new CanonicalGenerationRequestError("Either manifestPath or manifest is required.", {
+        code: "canonical_generation_missing_manifest",
+        status: 400,
+    });
+}
+function normalizeTargetIds(value) {
+    if (!value || value.length === 0) {
+        return [];
+    }
+    return Array.from(new Set(value.map((id) => id.trim()).filter((id) => id.length > 0)));
+}
+function createSafeRequestId(value) {
+    const source = String(value ?? Date.now());
+    const sanitized = source.replace(/[^a-zA-Z0-9_-]/g, "-");
+    return sanitized.length > 0 ? sanitized : "service-request";
+}
+function assertNoNullBytes(value, label) {
+    if (typeof value === "string" && value.includes("\0")) {
+        throw new CanonicalGenerationRequestError(`${label} contains a null byte.`, {
+            code: "canonical_generation_unsafe_path",
+            status: 400,
+        });
+    }
+}
+//# sourceMappingURL=generationRequest.js.map

package/dist/service/generationRequest.js.map

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

package/dist/service/providerCapabilities.d.ts

@@ -0,0 +1,40 @@
+import { type ProviderName } from "../providers/types.js";
+type CapabilitySupportMode = "native" | "post-process" | "edit-input" | "scaffold-only" | "none";
+export interface CapabilityDirectiveSupport {
+    supported: boolean;
+    mode: CapabilitySupportMode;
+    notes: string;
+}
+export interface ServiceProviderCapabilityDescriptor {
+    provider: ProviderName;
+    model: string;
+    providerFeatures: {
+        transparentBackground: boolean;
+        imageEdits: boolean;
+        controlNet: boolean;
+        multiCandidate: boolean;
+        maxCandidates: number;
+        supportedOutputFormats: string[];
+        defaultConcurrency: number;
+        minDelayMs: number;
+    };
+    directives: {
+        pixel: CapabilityDirectiveSupport;
+        highRes: CapabilityDirectiveSupport;
+        references: CapabilityDirectiveSupport;
+    };
+}
+export interface ServiceProviderCapabilityContract {
+    version: string;
+    endpoint: string;
+    query: Record<string, string>;
+    fields: Record<string, string>;
+}
+export interface ResolveProviderCapabilityOptions {
+    provider?: ProviderName;
+    model?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function getProviderCapabilitiesContract(): ServiceProviderCapabilityContract;
+export declare function resolveProviderCapabilityDescriptors(options?: ResolveProviderCapabilityOptions): ServiceProviderCapabilityDescriptor[];
+export {};

package/dist/service/providerCapabilities.js

@@ -0,0 +1,114 @@
+import { DEFAULT_LOCAL_MODEL } from "../providers/localDiffusion.js";
+import { DEFAULT_NANO_MODEL } from "../providers/nano.js";
+import { DEFAULT_OPENAI_MODEL } from "../providers/openai.js";
+import { createProviderRegistry } from "../providers/registry.js";
+import { buildProviderRegistryOptions } from "../providers/runtimeConfig.js";
+const PROVIDER_CAPABILITY_CONTRACT_VERSION = "v1";
+const PROVIDER_CAPABILITY_ENDPOINT = "/v1/providers/capabilities";
+const PROVIDER_NAMES = ["openai", "nano", "local"];
+export function getProviderCapabilitiesContract() {
+    return {
+        version: PROVIDER_CAPABILITY_CONTRACT_VERSION,
+        endpoint: PROVIDER_CAPABILITY_ENDPOINT,
+        query: {
+            provider: "Optional provider filter (`openai|nano|local`). Required when `model` is provided.",
+            model: "Optional model override for capability introspection (applies to selected provider only).",
+        },
+        fields: {
+            provider: "Provider identifier.",
+            model: "Effective model used for capability introspection.",
+            providerFeatures: "Core runtime capability claims (transparency, edits, controlnet, candidate limits, formats, concurrency, delay).",
+            directives: "Feature-gating signals for `pixel`, `highRes`, and `references` with support mode + notes.",
+        },
+    };
+}
+export function resolveProviderCapabilityDescriptors(options = {}) {
+    const baseOptions = buildProviderRegistryOptions(undefined, options.env);
+    const registryOptions = withModelOverride(baseOptions, options.provider, options.model);
+    const registry = createProviderRegistry(registryOptions);
+    const selectedProviders = options.provider ? [options.provider] : PROVIDER_NAMES;
+    return selectedProviders.map((provider) => toCapabilityDescriptor({
+        provider,
+        capabilities: registry[provider].capabilities,
+        model: resolveEffectiveModel(provider, registryOptions),
+    }));
+}
+function withModelOverride(options, provider, model) {
+    if (!provider || !model) {
+        return options;
+    }
+    if (provider === "openai") {
+        return {
+            ...options,
+            openai: {
+                ...(options.openai ?? {}),
+                model,
+            },
+        };
+    }
+    if (provider === "nano") {
+        return {
+            ...options,
+            nano: {
+                ...(options.nano ?? {}),
+                model,
+            },
+        };
+    }
+    return {
+        ...options,
+        local: {
+            ...(options.local ?? {}),
+            model,
+        },
+    };
+}
+function resolveEffectiveModel(provider, options) {
+    if (provider === "openai") {
+        return options.openai?.model ?? DEFAULT_OPENAI_MODEL;
+    }
+    if (provider === "nano") {
+        return options.nano?.model ?? DEFAULT_NANO_MODEL;
+    }
+    return options.local?.model ?? DEFAULT_LOCAL_MODEL;
+}
+function toCapabilityDescriptor(params) {
+    return {
+        provider: params.provider,
+        model: params.model,
+        providerFeatures: {
+            transparentBackground: params.capabilities.supportsTransparentBackground,
+            imageEdits: params.capabilities.supportsEdits,
+            controlNet: params.capabilities.supportsControlNet,
+            multiCandidate: params.capabilities.maxCandidates > 1,
+            maxCandidates: params.capabilities.maxCandidates,
+            supportedOutputFormats: Array.from(params.capabilities.supportedOutputFormats).sort(),
+            defaultConcurrency: params.capabilities.defaultConcurrency,
+            minDelayMs: params.capabilities.minDelayMs,
+        },
+        directives: {
+            pixel: {
+                supported: true,
+                mode: "post-process",
+                notes: "Pixel policy is enforced in LootForge process-stage transforms (pixelPerfect/quantize), independent of provider-native features.",
+            },
+            highRes: {
+                supported: false,
+                mode: "scaffold-only",
+                notes: "highQuality/hiresFix are currently manifest/planner scaffolds without provider-native refinement execution in 0.3.",
+            },
+            references: params.capabilities.supportsEdits
+                ? {
+                    supported: true,
+                    mode: "edit-input",
+                    notes: "Reference/base/mask image inputs are supported through edit-first provider flows.",
+                }
+                : {
+                    supported: false,
+                    mode: "none",
+                    notes: "Provider does not support reference image inputs for edit-first requests.",
+                },
+        },
+    };
+}
+//# sourceMappingURL=providerCapabilities.js.map

package/dist/service/providerCapabilities.js.map

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

package/dist/service/server.d.ts

@@ -0,0 +1,31 @@
+export declare const SERVICE_API_VERSION = "v1";
+type ServiceToolName = "init" | "plan" | "validate" | "generate" | "regenerate" | "process" | "atlas" | "eval" | "review" | "select" | "package";
+type ServiceParamKind = "string" | "boolean" | "string_list";
+export interface ServiceToolDescriptor {
+    name: ServiceToolName;
+    description: string;
+    endpoint: string;
+    alias: string;
+    params: {
+        key: string;
+        type: ServiceParamKind;
+        description: string;
+    }[];
+}
+export interface StartLootForgeServiceOptions {
+    host: string;
+    port: number;
+    defaultOutDir?: string;
+    maxActiveJobs?: number;
+    onListen?: (result: LootForgeService) => void;
+}
+export interface LootForgeService {
+    host: string;
+    port: number;
+    baseUrl: string;
+    maxActiveJobs: number;
+    close: () => Promise<void>;
+}
+export declare function getServiceToolDescriptors(): ServiceToolDescriptor[];
+export declare function startLootForgeService(options: StartLootForgeServiceOptions): Promise<LootForgeService>;
+export {};