@civitai/app-sdk 0.1.0 → 0.7.0

package/dist/orchestrator/index.d.ts

@@ -3,6 +3,15 @@
  * starter's BFF. Client + server safe: no Node-only imports, no `process.env`
  * access. All configuration flows through the `OrchestratorClient` value that
  * the caller builds.
+ *
+ * The orchestrator is a workflow API: you POST a `{ steps: [...] }` body with
+ * one or more typed steps (`textToImage`, `imageGen`, `videoGen`, `comfy`, ...)
+ * and get back a workflow snapshot. {@link WORKFLOW_STEP_TYPES} is the catalog
+ * of available step types — start there to find the one you need, then either
+ * use the matching `build*Body` helper or hand-craft a body and pass it to
+ * {@link submitWorkflow} / {@link callOrchestrator}.
+ *
+ * Full OpenAPI spec: https://orchestration.civitai.com/openapi/v2-consumers.json
  */
 export declare const DEFAULT_ORCHESTRATOR_BASE_URL = "https://orchestration.civitai.com";
 /** Default SDXL base model. Replace per starter / per call as needed. */
@@ -12,6 +21,121 @@ export declare const DEFAULT_MODEL_AIR = "urn:air:sdxl:checkpoint:civitai:101055
  */
 export declare const TERMINAL_STATUSES: readonly ["succeeded", "failed", "expired", "canceled"];
 export type TerminalStatus = (typeof TERMINAL_STATUSES)[number];
+/**
+ * Every workflow step type the orchestrator accepts, with a one-line
+ * description. Use this as a map: find the step `$type` you want, then look
+ * at the matching `build*Body` helper (if one exists) or fall back to
+ * {@link callOrchestrator} with a hand-crafted body.
+ *
+ * Source of truth is `https://orchestration.civitai.com/openapi/v2-consumers.json`.
+ * If a step type is missing here, the catalog is stale — open a PR.
+ */
+export declare const WORKFLOW_STEP_TYPES: {
+    /** Diffusion image gen (SDXL / Flux.1 / Pony / Illustrious / SD1.5 / etc.). Use {@link buildTextToImageBody}. */
+    readonly textToImage: "Text-to-image via diffusion checkpoints (AIR URN models)";
+    /**
+     * Closed-source image-gen APIs (Nano Banana, Gemini, Flux.1 Kontext, Flux.2,
+     * GPT-Image, Seedream, Grok, fal, …). Each engine has its own input shape;
+     * see {@link IMAGE_GEN_ENGINES}. Use {@link buildImageGenBody}.
+     */
+    readonly imageGen: "Closed-source image gen (Nano Banana, Gemini, GPT-Image, Flux Kontext, Seedream, Grok, fal, …)";
+    /** Arbitrary ComfyUI workflow graphs. Pass a `prompt` object (node graph). */
+    readonly comfy: "Custom ComfyUI node-graph workflows";
+    /** Upscale an existing image. Input is a source image URL + scale factor. */
+    readonly imageUpscaler: "Image upscaling";
+    /** LoRA / DoRA / embedding training. Long-running. */
+    readonly imageResourceTraining: "Train a LoRA / DoRA / embedding from a dataset";
+    /** Pre-process an image (resize, ControlNet preprocessor, etc.). */
+    readonly preprocessImage: "Image preprocessing (resize, ControlNet preprocessors, …)";
+    /** Format conversion between png/jpeg/webp/avif. */
+    readonly convertImage: "Image format conversion";
+    /** Upload arbitrary blob bytes for use as a reference in a later step. */
+    readonly imageUpload: "Upload an image blob to use as input in a later step";
+    /** Video gen across all engines (VEO 3, Kling, Wan, Vidu, Sora, LTX, …). */
+    readonly videoGen: "Video generation across all engines (VEO 3, Kling, Wan, Vidu, Sora, LTX, …)";
+    /** Upscale an existing video. */
+    readonly videoUpscaler: "Video upscaling";
+    /** Frame interpolation / smoothing. */
+    readonly videoInterpolation: "Video frame interpolation";
+    /** Per-frame transformations (denoise, color correct, etc.). */
+    readonly videoEnhancement: "Per-frame video enhancement";
+    /** Extract individual frames from a video. */
+    readonly videoFrameExtraction: "Extract frames from a video";
+    /** Read video metadata (duration, codec, dimensions). */
+    readonly videoMetadata: "Read video file metadata";
+    /** Transcode video format / codec. */
+    readonly transcode: "Audio/video transcoding";
+    /** Text-to-speech (multi-voice, multi-language). */
+    readonly textToSpeech: "Text-to-speech synthesis";
+    /** Music generation via ACE Step 1.5 (lyrics + style → song). */
+    readonly aceStepAudio: "Music generation (ACE Step 1.5)";
+    /** Speech-to-text transcription. */
+    readonly transcription: "Speech-to-text transcription";
+    /** Mix multiple audio tracks. */
+    readonly audioMix: "Audio track mixing";
+    /** Generate captions from audio. */
+    readonly audioCaptioning: "Caption generation from audio";
+    /** Hash an image / video / model for dedup or lookup. */
+    readonly mediaHash: "Media content hashing";
+    /** Hash a model file. */
+    readonly modelHash: "Model file hashing";
+    /** Rate media on aesthetic / quality axes. */
+    readonly mediaRating: "Media aesthetic / quality rating";
+    /** Caption an image with a vision model. */
+    readonly mediaCaptioning: "Image captioning via vision models";
+    /** WD-14 tagger (anime / booru tags). */
+    readonly wdTagging: "WD-14 anime tagging";
+    /** Estimate an age range for faces in an image. */
+    readonly ageClassification: "Age range classification";
+    /** xGuard NSFW / safety moderation. */
+    readonly xGuardModeration: "NSFW / safety moderation";
+    /** ClamAV scan a model file for malware. */
+    readonly modelClamScan: "Antivirus scan a model file";
+    /** Pickle-scan a model file for unsafe pickles. */
+    readonly modelPickleScan: "Pickle-safety scan for model files";
+    /** Parse model file metadata (SafeTensors / GGUF headers). */
+    readonly modelParseMetadata: "Parse model file metadata";
+    /** Chat completion (OpenAI / Anthropic / Gemini / local OSS). */
+    readonly chatCompletion: "LLM chat completion";
+    /** Generate a richer prompt from a short seed prompt. */
+    readonly promptEnhancement: "Prompt expansion via LLM";
+    /** Echo the input back. Useful for testing the round-trip. */
+    readonly echo: "Echo step — round-trip the input for testing";
+    /** Package multiple blobs into a zip archive. */
+    readonly blobArchive: "Zip multiple blobs into an archive";
+};
+export type WorkflowStepType = keyof typeof WORKFLOW_STEP_TYPES;
+/**
+ * Engines that the `imageGen` step accepts. Each one has its own input shape;
+ * the body's `engine` field selects which shape applies.
+ *
+ * Pair with {@link buildImageGenBody} or hand-craft via {@link callOrchestrator}.
+ */
+export declare const IMAGE_GEN_ENGINES: {
+    /** Nano Banana 2 / Nano Banana Pro / Imagen 4. */
+    readonly google: "Google (Nano Banana, Imagen)";
+    /** Gemini 2.5 Flash image gen + editing. */
+    readonly gemini: "Gemini";
+    /** GPT-Image-1 / GPT-Image-1.5 / DALL-E-3. */
+    readonly openai: "OpenAI (GPT-Image, DALL-E)";
+    /** Flux.1 Kontext (pro/max/dev) — image editing with ref images. */
+    readonly 'flux1-kontext': "Flux.1 Kontext (image editing)";
+    /** Flux.2 family (pro/max/dev/flex/klein). */
+    readonly flux2: "Flux.2";
+    /** Seedream (ByteDance) — 2K/4K image gen. */
+    readonly seedream: "Seedream";
+    /** Grok image generation. */
+    readonly grok: "Grok";
+    /** Wan image generation. */
+    readonly wan: "Wan";
+    /** Self-hosted SDCpp (stable-diffusion.cpp) gen. */
+    readonly sdcpp: "SDCpp (self-hosted diffusion)";
+    /** fal.ai routed gen. */
+    readonly fal: "fal.ai";
+    /** Comfy graph as an imageGen step (vs. the top-level `comfy` step). */
+    readonly comfy: "Comfy (engine-style)";
+};
+export type ImageGenEngine = keyof typeof IMAGE_GEN_ENGINES;
 /**
  * Orchestrator workflow status. Lowercase — matches what the orchestrator
  * actually returns. Forward-compat: open-ended string union so unknown
@@ -90,6 +214,106 @@ export interface BuildTextToImageBodyOptions {
  * the shape every starter's existing `buildWorkflowBody` produced.
  */
 export declare function buildTextToImageBody(input: GenerateInput, opts?: BuildTextToImageBodyOptions): unknown;
+/**
+ * Input for an `imageGen` step. The engine + model pair picks which
+ * sub-schema applies. Every closed-source image-gen API plugs in here:
+ *
+ *  - `{ engine: 'google', model: 'nano-banana-2' | 'nano-banana-pro' | 'imagen4', images?: string[] }`
+ *  - `{ engine: 'gemini', model: '2.5-flash', operation: 'createImage' | 'editImage', images?: string[] }`
+ *  - `{ engine: 'flux1-kontext', model: 'pro' | 'max' | 'dev', images?: string[] }`
+ *  - `{ engine: 'flux2', model: 'pro' | 'max' | 'dev' | 'flex' | 'klein' }`
+ *  - `{ engine: 'openai', model: 'gpt-image-1' | 'gpt-image-1.5' | 'dall-e-3' | 'dall-e-2' }`
+ *  - `{ engine: 'seedream', model: '4b' | '20b' | 'v1.0' }`
+ *  - `{ engine: 'grok', model: 'createImage' | 'editImage' }`
+ *  - `{ engine: 'fal' | 'wan' | 'sdcpp' | 'comfy', model: ..., ... }`
+ *
+ * Reference images go in `images: [...]` (URL, data URL, or base64 string).
+ * For aspect ratio / dimensions / seed / etc., pass the engine-specific
+ * input fields directly — this builder is intentionally pass-through.
+ *
+ * See `https://orchestration.civitai.com/openapi/v2-consumers.json` for the
+ * complete per-engine schema. The shape is forward-compat: any field the
+ * engine accepts can be added to `input` without changing this SDK.
+ */
+export interface ImageGenInput {
+    engine: ImageGenEngine | (string & {});
+    model: string;
+    prompt?: string;
+    /** Reference images. Each item is a URL, data URL, or raw base64 string. */
+    images?: string[];
+    /** Catch-all for engine-specific fields. */
+    [field: string]: unknown;
+}
+export interface BuildImageGenBodyOptions {
+    tags?: string[];
+    /** Step name. Defaults to `step_0`. */
+    name?: string;
+    /** Step timeout. Defaults to `'00:10:00'`. */
+    timeout?: string;
+}
+/**
+ * Build an `imageGen` workflow body. Pass-through for engine-specific input
+ * fields — see {@link ImageGenInput} for examples per engine.
+ *
+ * @example  Nano Banana 2 with a reference image
+ * ```ts
+ * const body = buildImageGenBody({
+ *   engine: 'google',
+ *   model: 'nano-banana-2',
+ *   prompt: 'turn this into a cartoon sticker',
+ *   images: ['data:image/png;base64,...'],
+ *   aspectRatio: '1:1',
+ *   numImages: 1,
+ *   resolution: '1K',
+ * }, { tags: ['my-app'] });
+ *
+ * const estimate = await estimateWorkflow(client, body);
+ * const submitted = await submitWorkflow(client, body);
+ * ```
+ *
+ * @example  Flux.1 Kontext for image editing
+ * ```ts
+ * const body = buildImageGenBody({
+ *   engine: 'flux1-kontext',
+ *   model: 'pro',
+ *   prompt: 'add sunglasses',
+ *   images: ['https://example.com/portrait.jpg'],
+ *   aspectRatio: '1:1',
+ * });
+ * ```
+ */
+export declare function buildImageGenBody(input: ImageGenInput, opts?: BuildImageGenBodyOptions): unknown;
+export interface BuildWorkflowBodyStep {
+    $type: WorkflowStepType | (string & {});
+    /** Step name. Defaults to `step_0`. */
+    name?: string;
+    /** Step timeout. Defaults to `'00:10:00'`. */
+    timeout?: string;
+    /** The step's input — shape is per-step-type. See {@link WORKFLOW_STEP_TYPES}. */
+    input: unknown;
+    /** Optional metadata attached to the step. */
+    metadata?: Record<string, unknown>;
+}
+export interface BuildWorkflowBodyOptions {
+    tags?: string[];
+}
+/**
+ * Lowest-level body builder — drops a single step into the `{ steps: [...] }`
+ * envelope and fills in `name` / `timeout` defaults. Use this when no dedicated
+ * `build*Body` exists for your step type.
+ *
+ * For multi-step workflows, hand-build `{ tags?, steps: [step1, step2, ...] }`
+ * yourself — there's no special envelope work beyond a JSON array.
+ *
+ * @example  videoGen via VEO 3
+ * ```ts
+ * const body = buildWorkflowBody({
+ *   $type: 'videoGen',
+ *   input: { engine: 'veo3', prompt: 'a fox jumping', duration: 8 },
+ * }, { tags: ['my-app'] });
+ * ```
+ */
+export declare function buildWorkflowBody(step: BuildWorkflowBodyStep, opts?: BuildWorkflowBodyOptions): unknown;
 /**
  * Cost preview ("what if") — runs the workflow validation/pricing pipeline
  * without committing any Buzz.

package/dist/orchestrator/index.d.ts.map

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

package/dist/orchestrator/index.js

@@ -3,6 +3,15 @@
  * starter's BFF. Client + server safe: no Node-only imports, no `process.env`
  * access. All configuration flows through the `OrchestratorClient` value that
  * the caller builds.
+ *
+ * The orchestrator is a workflow API: you POST a `{ steps: [...] }` body with
+ * one or more typed steps (`textToImage`, `imageGen`, `videoGen`, `comfy`, ...)
+ * and get back a workflow snapshot. {@link WORKFLOW_STEP_TYPES} is the catalog
+ * of available step types — start there to find the one you need, then either
+ * use the matching `build*Body` helper or hand-craft a body and pass it to
+ * {@link submitWorkflow} / {@link callOrchestrator}.
+ *
+ * Full OpenAPI spec: https://orchestration.civitai.com/openapi/v2-consumers.json
  */
 // ---------- Constants -------------------------------------------------------
 export const DEFAULT_ORCHESTRATOR_BASE_URL = 'https://orchestration.civitai.com';
@@ -12,6 +21,126 @@ export const DEFAULT_MODEL_AIR = 'urn:air:sdxl:checkpoint:civitai:101055@128078'
  * Terminal orchestrator statuses (lowercase — matches what the API returns).
  */
 export const TERMINAL_STATUSES = ['succeeded', 'failed', 'expired', 'canceled'];
+// ---------- Step type catalog ----------------------------------------------
+/**
+ * Every workflow step type the orchestrator accepts, with a one-line
+ * description. Use this as a map: find the step `$type` you want, then look
+ * at the matching `build*Body` helper (if one exists) or fall back to
+ * {@link callOrchestrator} with a hand-crafted body.
+ *
+ * Source of truth is `https://orchestration.civitai.com/openapi/v2-consumers.json`.
+ * If a step type is missing here, the catalog is stale — open a PR.
+ */
+export const WORKFLOW_STEP_TYPES = {
+    // ----- Image gen ---------------------------------------------------------
+    /** Diffusion image gen (SDXL / Flux.1 / Pony / Illustrious / SD1.5 / etc.). Use {@link buildTextToImageBody}. */
+    textToImage: 'Text-to-image via diffusion checkpoints (AIR URN models)',
+    /**
+     * Closed-source image-gen APIs (Nano Banana, Gemini, Flux.1 Kontext, Flux.2,
+     * GPT-Image, Seedream, Grok, fal, …). Each engine has its own input shape;
+     * see {@link IMAGE_GEN_ENGINES}. Use {@link buildImageGenBody}.
+     */
+    imageGen: 'Closed-source image gen (Nano Banana, Gemini, GPT-Image, Flux Kontext, Seedream, Grok, fal, …)',
+    /** Arbitrary ComfyUI workflow graphs. Pass a `prompt` object (node graph). */
+    comfy: 'Custom ComfyUI node-graph workflows',
+    /** Upscale an existing image. Input is a source image URL + scale factor. */
+    imageUpscaler: 'Image upscaling',
+    /** LoRA / DoRA / embedding training. Long-running. */
+    imageResourceTraining: 'Train a LoRA / DoRA / embedding from a dataset',
+    /** Pre-process an image (resize, ControlNet preprocessor, etc.). */
+    preprocessImage: 'Image preprocessing (resize, ControlNet preprocessors, …)',
+    /** Format conversion between png/jpeg/webp/avif. */
+    convertImage: 'Image format conversion',
+    /** Upload arbitrary blob bytes for use as a reference in a later step. */
+    imageUpload: 'Upload an image blob to use as input in a later step',
+    // ----- Video gen ---------------------------------------------------------
+    /** Video gen across all engines (VEO 3, Kling, Wan, Vidu, Sora, LTX, …). */
+    videoGen: 'Video generation across all engines (VEO 3, Kling, Wan, Vidu, Sora, LTX, …)',
+    /** Upscale an existing video. */
+    videoUpscaler: 'Video upscaling',
+    /** Frame interpolation / smoothing. */
+    videoInterpolation: 'Video frame interpolation',
+    /** Per-frame transformations (denoise, color correct, etc.). */
+    videoEnhancement: 'Per-frame video enhancement',
+    /** Extract individual frames from a video. */
+    videoFrameExtraction: 'Extract frames from a video',
+    /** Read video metadata (duration, codec, dimensions). */
+    videoMetadata: 'Read video file metadata',
+    /** Transcode video format / codec. */
+    transcode: 'Audio/video transcoding',
+    // ----- Audio -------------------------------------------------------------
+    /** Text-to-speech (multi-voice, multi-language). */
+    textToSpeech: 'Text-to-speech synthesis',
+    /** Music generation via ACE Step 1.5 (lyrics + style → song). */
+    aceStepAudio: 'Music generation (ACE Step 1.5)',
+    /** Speech-to-text transcription. */
+    transcription: 'Speech-to-text transcription',
+    /** Mix multiple audio tracks. */
+    audioMix: 'Audio track mixing',
+    /** Generate captions from audio. */
+    audioCaptioning: 'Caption generation from audio',
+    // ----- Classification / tagging / moderation ----------------------------
+    /** Hash an image / video / model for dedup or lookup. */
+    mediaHash: 'Media content hashing',
+    /** Hash a model file. */
+    modelHash: 'Model file hashing',
+    /** Rate media on aesthetic / quality axes. */
+    mediaRating: 'Media aesthetic / quality rating',
+    /** Caption an image with a vision model. */
+    mediaCaptioning: 'Image captioning via vision models',
+    /** WD-14 tagger (anime / booru tags). */
+    wdTagging: 'WD-14 anime tagging',
+    /** Estimate an age range for faces in an image. */
+    ageClassification: 'Age range classification',
+    /** xGuard NSFW / safety moderation. */
+    xGuardModeration: 'NSFW / safety moderation',
+    /** ClamAV scan a model file for malware. */
+    modelClamScan: 'Antivirus scan a model file',
+    /** Pickle-scan a model file for unsafe pickles. */
+    modelPickleScan: 'Pickle-safety scan for model files',
+    /** Parse model file metadata (SafeTensors / GGUF headers). */
+    modelParseMetadata: 'Parse model file metadata',
+    // ----- LLM ---------------------------------------------------------------
+    /** Chat completion (OpenAI / Anthropic / Gemini / local OSS). */
+    chatCompletion: 'LLM chat completion',
+    /** Generate a richer prompt from a short seed prompt. */
+    promptEnhancement: 'Prompt expansion via LLM',
+    // ----- Utility -----------------------------------------------------------
+    /** Echo the input back. Useful for testing the round-trip. */
+    echo: 'Echo step — round-trip the input for testing',
+    /** Package multiple blobs into a zip archive. */
+    blobArchive: 'Zip multiple blobs into an archive',
+};
+/**
+ * Engines that the `imageGen` step accepts. Each one has its own input shape;
+ * the body's `engine` field selects which shape applies.
+ *
+ * Pair with {@link buildImageGenBody} or hand-craft via {@link callOrchestrator}.
+ */
+export const IMAGE_GEN_ENGINES = {
+    /** Nano Banana 2 / Nano Banana Pro / Imagen 4. */
+    google: 'Google (Nano Banana, Imagen)',
+    /** Gemini 2.5 Flash image gen + editing. */
+    gemini: 'Gemini',
+    /** GPT-Image-1 / GPT-Image-1.5 / DALL-E-3. */
+    openai: 'OpenAI (GPT-Image, DALL-E)',
+    /** Flux.1 Kontext (pro/max/dev) — image editing with ref images. */
+    'flux1-kontext': 'Flux.1 Kontext (image editing)',
+    /** Flux.2 family (pro/max/dev/flex/klein). */
+    flux2: 'Flux.2',
+    /** Seedream (ByteDance) — 2K/4K image gen. */
+    seedream: 'Seedream',
+    /** Grok image generation. */
+    grok: 'Grok',
+    /** Wan image generation. */
+    wan: 'Wan',
+    /** Self-hosted SDCpp (stable-diffusion.cpp) gen. */
+    sdcpp: 'SDCpp (self-hosted diffusion)',
+    /** fal.ai routed gen. */
+    fal: 'fal.ai',
+    /** Comfy graph as an imageGen step (vs. the top-level `comfy` step). */
+    comfy: 'Comfy (engine-style)',
+};
 export class OrchestratorError extends Error {
     status;
     body;
@@ -88,6 +217,84 @@ export function buildTextToImageBody(input, opts = {}) {
         body.tags = opts.tags;
     return body;
 }
+/**
+ * Build an `imageGen` workflow body. Pass-through for engine-specific input
+ * fields — see {@link ImageGenInput} for examples per engine.
+ *
+ * @example  Nano Banana 2 with a reference image
+ * ```ts
+ * const body = buildImageGenBody({
+ *   engine: 'google',
+ *   model: 'nano-banana-2',
+ *   prompt: 'turn this into a cartoon sticker',
+ *   images: ['data:image/png;base64,...'],
+ *   aspectRatio: '1:1',
+ *   numImages: 1,
+ *   resolution: '1K',
+ * }, { tags: ['my-app'] });
+ *
+ * const estimate = await estimateWorkflow(client, body);
+ * const submitted = await submitWorkflow(client, body);
+ * ```
+ *
+ * @example  Flux.1 Kontext for image editing
+ * ```ts
+ * const body = buildImageGenBody({
+ *   engine: 'flux1-kontext',
+ *   model: 'pro',
+ *   prompt: 'add sunglasses',
+ *   images: ['https://example.com/portrait.jpg'],
+ *   aspectRatio: '1:1',
+ * });
+ * ```
+ */
+export function buildImageGenBody(input, opts = {}) {
+    const body = {
+        steps: [
+            {
+                $type: 'imageGen',
+                name: opts.name ?? 'step_0',
+                timeout: opts.timeout ?? '00:10:00',
+                input,
+            },
+        ],
+    };
+    if (opts.tags && opts.tags.length > 0)
+        body.tags = opts.tags;
+    return body;
+}
+/**
+ * Lowest-level body builder — drops a single step into the `{ steps: [...] }`
+ * envelope and fills in `name` / `timeout` defaults. Use this when no dedicated
+ * `build*Body` exists for your step type.
+ *
+ * For multi-step workflows, hand-build `{ tags?, steps: [step1, step2, ...] }`
+ * yourself — there's no special envelope work beyond a JSON array.
+ *
+ * @example  videoGen via VEO 3
+ * ```ts
+ * const body = buildWorkflowBody({
+ *   $type: 'videoGen',
+ *   input: { engine: 'veo3', prompt: 'a fox jumping', duration: 8 },
+ * }, { tags: ['my-app'] });
+ * ```
+ */
+export function buildWorkflowBody(step, opts = {}) {
+    const body = {
+        steps: [
+            {
+                $type: step.$type,
+                name: step.name ?? 'step_0',
+                timeout: step.timeout ?? '00:10:00',
+                input: step.input,
+                ...(step.metadata ? { metadata: step.metadata } : {}),
+            },
+        ],
+    };
+    if (opts.tags && opts.tags.length > 0)
+        body.tags = opts.tags;
+    return body;
+}
 // ---------- Workflow endpoints ---------------------------------------------
 /**
  * Cost preview ("what if") — runs the workflow validation/pricing pipeline

package/dist/orchestrator/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@civitai/app-sdk",
-  "version": "0.1.0",
+  "version": "0.7.0",
   "description": "OAuth + PKCE, encrypted-cookie sessions, scopes, and orchestrator helpers for building third-party Civitai apps.",
   "license": "MIT",
   "type": "module",
@@ -26,10 +26,16 @@
     "./orchestrator": {
       "types": "./dist/orchestrator/index.d.ts",
       "import": "./dist/orchestrator/index.js"
-    }
+    },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.ts",
+      "import": "./dist/blocks/index.js"
+    },
+    "./schemas/app-block/v1.json": "./schemas/app-block/v1.json"
   },
   "files": [
     "dist",
+    "schemas",
     "README.md"
   ],
   "scripts": {
@@ -43,9 +49,9 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@types/node": "^20.19.9",
+    "@types/node": "^25.9.1",
     "typescript": "^5.9.2",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.7"
   },
   "publishConfig": {
     "access": "public"
@@ -65,7 +71,7 @@
   "bugs": "https://github.com/civitai/civitai-app-starters/issues",
   "repository": {
     "type": "git",
-    "url": "https://github.com/civitai/civitai-app-starters.git",
+    "url": "git+https://github.com/civitai/civitai-app-starters.git",
     "directory": "packages/civitai-app-sdk"
   }
 }