@civitai/app-sdk 0.1.0 → 0.6.0

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.6.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,7 +49,7 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@types/node": "^20.19.9",
+    "@types/node": "^25.9.1",
     "typescript": "^5.9.2",
     "vitest": "^4.0.18"
   },
@@ -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"
   }
 }

package/schemas/app-block/v1.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://civitai.com/schemas/app-block/v1.json",
+  "title": "Civitai App Block Manifest v1",
+  "description": "Manifest shape for a Civitai App Block. Mirrors the runtime check performed by defineBlock() in @civitai/app-sdk/blocks.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "appId",
+    "blockId",
+    "version",
+    "name",
+    "type",
+    "targets",
+    "scopes",
+    "iframe",
+    "contentRating",
+    "minApiVersion"
+  ],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://civitai.com/schemas/app-block/v1.json"
+    },
+    "appId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "blockId": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]{3,64}$",
+      "description": "Immutable block identifier. Lowercase letters, digits, and hyphens; 3-64 characters."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$",
+      "description": "Semver."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80
+    },
+    "type": {
+      "type": "string",
+      "enum": ["block", "embed"]
+    },
+    "targets": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["slotId", "priority"],
+        "properties": {
+          "slotId": { "type": "string", "minLength": 1 },
+          "priority": { "type": "integer" },
+          "requiredContext": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    "scopes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z]+:[a-z]+:[a-z]+$",
+        "description": "Colon-separated lowercase, e.g. models:read:self. PascalCase is rejected."
+      }
+    },
+    "iframe": {
+      "type": "object",
+      "required": ["src", "minHeight", "resizable", "sandbox"],
+      "properties": {
+        "src": {
+          "type": "string",
+          "description": "HTTPS URL of the block app. http://localhost or http://127.0.0.1 also accepted for local dev."
+        },
+        "minHeight": { "type": "integer", "exclusiveMinimum": 0 },
+        "maxHeight": { "type": ["integer", "null"] },
+        "resizable": { "type": "boolean" },
+        "sandbox": {
+          "type": "string",
+          "allOf": [
+            {
+              "not": { "pattern": "(^|\\s)allow-same-origin(\\s|$)" },
+              "description": "Must not contain allow-same-origin — combined with allow-scripts it defeats the sandbox."
+            },
+            {
+              "not": { "pattern": "(^|\\s)allow-top-navigation(\\s|$)" },
+              "description": "Must not contain allow-top-navigation — use the NAVIGATE postMessage instead."
+            },
+            {
+              "not": { "pattern": "(^|\\s)allow-top-navigation-by-user-activation(\\s|$)" },
+              "description": "Must not contain allow-top-navigation-by-user-activation — same threat as allow-top-navigation, gated on a user gesture."
+            },
+            {
+              "not": { "pattern": "(^|\\s)allow-top-navigation-to-custom-protocols(\\s|$)" },
+              "description": "Must not contain allow-top-navigation-to-custom-protocols — same threat as allow-top-navigation, restricted to non-fetch schemes."
+            }
+          ]
+        }
+      }
+    },
+    "assets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["url", "integrity"],
+        "properties": {
+          "url": { "type": "string" },
+          "integrity": {
+            "type": "string",
+            "pattern": "^sha(256|384|512)-[A-Za-z0-9+/=]+$"
+          }
+        }
+      }
+    },
+    "settings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "type", "label"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "type": { "type": "string", "enum": ["string", "number", "boolean", "select"] },
+          "label": { "type": "string", "minLength": 1 },
+          "default": {},
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["value", "label"],
+              "properties": {
+                "value": { "type": "string" },
+                "label": { "type": "string" }
+              }
+            }
+          },
+          "min": { "type": "number" },
+          "max": { "type": "number" },
+          "required": { "type": "boolean" }
+        }
+      }
+    },
+    "contentRating": {
+      "type": "string",
+      "enum": ["g", "pg", "pg13", "r", "x"]
+    },
+    "preview": {
+      "type": "object",
+      "required": ["thumbnail", "description"],
+      "properties": {
+        "thumbnail": { "type": "string" },
+        "description": { "type": "string" },
+        "screenshots": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promotionEligible": { "type": "boolean" },
+    "minApiVersion": { "type": "string" },
+    "renderMode": {
+      "type": "string",
+      "enum": ["iframe", "inline", "hybrid"],
+      "description": "Optional. Defaults to iframe. v1 manifests may omit."
+    },
+    "assetBundle": {
+      "type": "object",
+      "properties": {
+        "url": { "type": ["string", "null"] },
+        "sha256": { "type": ["string", "null"] }
+      }
+    },
+    "trustTier": {
+      "type": "string",
+      "enum": ["unverified", "verified", "internal"]
+    }
+  }
+}

package/dist/client/index.d.ts

@@ -1,23 +0,0 @@
-import { createCivitaiClient } from '@civitai/client';
-/** The orchestrator client returned by `createCivitaiClient`. */
-export type CivitaiClient = ReturnType<typeof createCivitaiClient>;
-export interface CreateAppClientOptions {
-    /** OAuth access token or personal API key. Used as Bearer credential. */
-    token: string;
-    /** Orchestrator base URL. Defaults to Civitai's prod orchestrator. */
-    baseUrl?: string;
-    /** SDK env mode. Defaults to 'prod'. */
-    env?: 'dev' | 'prod';
-}
-/**
- * Create a typed Civitai orchestrator client authenticated with the user's
- * OAuth access token (or a personal API key — same Bearer scheme).
- *
- * Wraps `@civitai/client`'s factory with sensible defaults. The returned
- * client is the same shape `@civitai/client` produces — pass it to the
- * SDK's standalone functions (`submitWorkflow({ client, body })`, etc.)
- * or to the wrappers in `@civitai/app-sdk/workflows`.
- */
-export declare function createAppClient(opts: CreateAppClientOptions): CivitaiClient;
-export type AppClient = CivitaiClient;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACtB;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,aAAa,CAM3E;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC"}

package/dist/client/index.js

@@ -1,19 +0,0 @@
-import { createCivitaiClient } from '@civitai/client';
-const DEFAULT_ORCHESTRATOR_BASE_URL = 'https://orchestration-new.civitai.com';
-/**
- * Create a typed Civitai orchestrator client authenticated with the user's
- * OAuth access token (or a personal API key — same Bearer scheme).
- *
- * Wraps `@civitai/client`'s factory with sensible defaults. The returned
- * client is the same shape `@civitai/client` produces — pass it to the
- * SDK's standalone functions (`submitWorkflow({ client, body })`, etc.)
- * or to the wrappers in `@civitai/app-sdk/workflows`.
- */
-export function createAppClient(opts) {
-    return createCivitaiClient({
-        baseUrl: opts.baseUrl ?? DEFAULT_ORCHESTRATOR_BASE_URL,
-        env: opts.env ?? 'prod',
-        auth: opts.token,
-    });
-}
-//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AActD,MAAM,6BAA6B,GAAG,uCAAuC,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAA4B;IAC1D,OAAO,mBAAmB,CAAC;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,6BAA6B;QACtD,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,MAAM;QACvB,IAAI,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/workflows/index.d.ts

@@ -1,52 +0,0 @@
-import { type SubmitWorkflowData, type Workflow } from '@civitai/client';
-import type { AppClient } from '../client/index.js';
-/**
- * Thin wrappers around the orchestrator's workflow endpoints with conventions
- * suited to third-party app starters. All calls use the user's OAuth token
- * (or API key) carried by the `AppClient` — the orchestrator debits Buzz
- * from whoever owns that token.
- */
-export type WorkflowBody = NonNullable<SubmitWorkflowData['body']>;
-export interface CostEstimate {
-    /** Buzz cost. Pulled from the workflow's `cost.total` field. */
-    total: number;
-    /** Full workflow response (validation result, queue placement, etc.). */
-    raw: Workflow;
-}
-declare class WorkflowError extends Error {
-    readonly status: number | undefined;
-    readonly detail: unknown;
-    readonly name = "WorkflowError";
-    constructor(message: string, status: number | undefined, detail: unknown);
-}
-/**
- * Cost preview ("what if") — runs the workflow validation/pricing pipeline
- * without committing any Buzz. Use this to show the user "this will cost X
- * Buzz" before they confirm submission.
- *
- * NOTE: per Civitai's docs, `whatif=true` validates and prices but does not
- * apply per-app spending caps to the response — a successful whatif can still
- * be denied at submit time if the user has set tight caps or insufficient
- * funds. Treat `whatif` as "this is the price" not "this is approved."
- */
-export declare function estimateCost(client: AppClient, body: WorkflowBody): Promise<CostEstimate>;
-/** Submit a workflow for real execution. Debits the token-owner's Buzz. */
-export declare function submitWorkflow(client: AppClient, body: WorkflowBody): Promise<Workflow>;
-export declare function getWorkflow(client: AppClient, workflowId: string): Promise<Workflow>;
-export interface PollWorkflowOptions {
-    /** Polling interval in ms. Default 2000. */
-    intervalMs?: number;
-    /** Max total time to poll in ms. Default 5 minutes. */
-    timeoutMs?: number;
-    /** Optional progress callback fired on every poll tick. */
-    onTick?: (snapshot: Workflow) => void;
-    /** Optional abort signal. */
-    signal?: AbortSignal;
-}
-/**
- * Poll a workflow until it reaches a terminal status (`Succeeded`, `Failed`,
- * `Canceled`) or the timeout elapses. Returns the final snapshot.
- */
-export declare function pollWorkflow(client: AppClient, workflowId: string, opts?: PollWorkflowOptions): Promise<Workflow>;
-export { WorkflowError };
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,QAAQ,CAAC;CACf;AAED,cAAM,aAAc,SAAQ,KAAK;IAI7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAJ1B,SAAkB,IAAI,mBAAmB;gBAEvC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,OAAO;CAI3B;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ/F;AAED,2EAA2E;AAC3E,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG7F;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM1F;AAED,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}