@nodaro/sdk 2.29.0 → 2.32.0

package/dist/entries/picker-catalogs.d.ts

@@ -0,0 +1,148 @@
+import { CharacterMotionMetadata } from '@nodaro/shared/types';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Picker-catalog types. Mirrors `@nodaro/shared`'s `ProjectedPickerCatalog` /
+ * `PickerCatalogSummary` so the SDK stays dependency-free (same convention as
+ * `NodeDescriptor` mirroring node-registry).
+ */
+interface PickerOption {
+    id: string;
+    label: string;
+    description?: string;
+    category?: string;
+    /** The prompt fragment this id injects downstream. Present only when detail="full". */
+    promptHint?: string;
+    /**
+     * Short professional term injected by compact hint mode; `label` is for
+     * display. Present at BOTH detail levels — a thin client renders `label`
+     * and injects `term`. Empty for a no-op ("auto"/"none") entry that injects
+     * nothing.
+     */
+    term?: string;
+    icon?: string;
+    /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */
+    motion?: CharacterMotionMetadata;
+    /**
+     * Per-option parameters — node-data fields that apply only while THIS option
+     * is picked (the Transition catalog's `wipe` → `wipeDirection`). Same shape
+     * as a catalog's `dimensions`, at both detail levels; `auto` leads each list
+     * and means "send nothing". Absent on every other option.
+     */
+    params?: PickerDimension[];
+    /**
+     * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
+     * Cloud only) rendered look preview — on the installation's own host, or the
+     * Nodaro CDN for look previews. Absent when the option has no picture. Use it
+     * as given: file names carry a content hash, so it can be cached for good.
+     */
+    imageUrl?: string;
+}
+interface PickerDimension {
+    field: string;
+    label: string;
+    options: PickerOption[];
+}
+/** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
+interface PickerCatalogSection {
+    /** English topic name, e.g. "Identity", "Beauty & Hair". */
+    label: string;
+    /** Node-data fields of the settings in this topic, in display order. */
+    fields: string[];
+    /** Absolute URL of the topic's round picture. Absent when it has none. */
+    imageUrl?: string;
+}
+interface PickerCatalog {
+    nodeType: string;
+    label: string;
+    catalogId: string;
+    kind: "single" | "multi";
+    /** single only — the node-data field the chosen id writes to. */
+    valueField?: string;
+    defaultValue?: string;
+    categoryOrder?: string[];
+    categoryLabels?: Record<string, string>;
+    /** single-dim catalogs. */
+    options?: PickerOption[];
+    /** multi-dim catalogs. */
+    fields?: string[];
+    /** Per-field option lists. Multi-dim catalogs always carry these; a
+     *  single-dim catalog carries them when it has secondary parameter
+     *  fields beside its main picker (transition position/duration/intensity). */
+    dimensions?: PickerDimension[];
+    detail?: "compact" | "full";
+    /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
+    sections?: PickerCatalogSection[];
+}
+interface PickerCatalogSummary {
+    nodeType: string;
+    label: string;
+    catalogId: string;
+    kind: "single" | "multi";
+    valueField?: string;
+    fields?: string[];
+    optionCount: number;
+    /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */
+    imageCount?: number;
+}
+interface GetPickerCatalogOptions {
+    /** "compact" (default) = id, label, category, term, icon, imageUrl; "full" additionally includes description + promptHint. */
+    detail?: "compact" | "full";
+    /** single-dim: filter to one category. */
+    category?: string;
+    /** multi-dim: only this dimension field. */
+    field?: string;
+}
+/** Input for `analyzeText` (POST /v1/text-to-picker). */
+interface TextToPickerParams {
+    /** Free-text scene/shot description to analyze. */
+    text: string;
+    /** Picker node types to fill. Omit for ALL analyzable pickers (the server
+     *  fans the analysis out per family and merges). */
+    targetPickers?: string[];
+    /** Extra guidance appended to the analyzer system prompt. */
+    instructions?: string;
+    /** Originating client app slug (e.g. "cine") — attribution only. */
+    origin?: string;
+    llmModel?: string;
+    reasoningEffort?: string;
+}
+interface TextToPickerResult {
+    jobId: string;
+    /** pickerType → dimension → chosen catalog id(s) — same shape as
+     *  describe-to-picker; hydrate pickers from it verbatim. */
+    pickerJson: Record<string, Record<string, string | string[]>>;
+    /** Catalog-coverage feedback (attributes the text described that no
+     *  catalog id represents well). Surface as "we couldn't infer X". */
+    gaps?: {
+        missingItems: Array<{
+            picker: string;
+            dimension: string;
+            observed: string;
+        }>;
+        missingCategories: Array<{
+            picker: string;
+            suggestedDimension: string;
+            observed: string;
+        }>;
+    };
+}
+declare class PickerCatalogsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** List every parameter-picker node type + its option count. Cached publicly 5 min. */
+    list(): Promise<{
+        data: PickerCatalogSummary[];
+    }>;
+    /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+     *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+    analyzeText(params: TextToPickerParams): Promise<TextToPickerResult>;
+    /** Get one picker's catalog of valid values. */
+    get(nodeType: string, opts?: GetPickerCatalogOptions): Promise<{
+        data: PickerCatalog;
+    }>;
+}
+
+export { type GetPickerCatalogOptions, type PickerCatalog, type PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, type TextToPickerParams, type TextToPickerResult };

package/dist/entries/picker-catalogs.js

@@ -0,0 +1,4 @@
+import '../chunk-QVQCKOBM.js';
+export { PickerCatalogsResource } from '../chunk-BLA44UCM.js';
+//# sourceMappingURL=picker-catalogs.js.map
+//# sourceMappingURL=picker-catalogs.js.map

package/dist/entries/picker-catalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"picker-catalogs.js"}

package/dist/entries/pipelines.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-ZQPLRNKX.cjs');
+var chunkCOCKKMNP_cjs = require('../chunk-COCKKMNP.cjs');
+
+
+
+Object.defineProperty(exports, "PipelinesResource", {
+  enumerable: true,
+  get: function () { return chunkCOCKKMNP_cjs.PipelinesResource; }
+});
+//# sourceMappingURL=pipelines.cjs.map
+//# sourceMappingURL=pipelines.cjs.map

package/dist/entries/pipelines.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"pipelines.cjs"}

package/dist/entries/pipelines.d.cts

@@ -0,0 +1,255 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { PipelineStageName, ProposedChange, PipelineInput, PipelineStatus, PipelineMode, AnimateSubGate, ChatEnabledStage } from '@nodaro/shared/pipeline';
+export { AnimateSubGate, ChatEnabledStage, PipelineInput, PipelineMode, PipelineStageName, PipelineStatus, ProposedChange, SubGateName } from '@nodaro/shared/pipeline';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Owner-scoped pipeline record returned by `get` / `list` (the server strips
+ * `user_id`). Mirrors the public field set of `GET /v1/pipelines/:id`.
+ */
+interface PipelineRecord {
+    id: string;
+    status: PipelineStatus;
+    current_stage: string | null;
+    spent_credits: number;
+    reserved_credits: number;
+    upfront_credit_estimate: number;
+    branched_from_pipeline_id: string | null;
+    branched_from_stage: string | null;
+    mode: PipelineMode | null;
+    failure_reason: string | null;
+    current_progress_message: string | null;
+}
+/** One stage currently awaiting approval (from `pendingApprovals`). */
+interface PendingApproval {
+    stage_name: PipelineStageName;
+    /** Stage output snapshot; shape varies by stage. */
+    output: unknown;
+}
+/**
+ * Assembled timeline (`GET /v1/pipelines/:id/timeline`) — ordered scene
+ * composites + their durations, plus optional music/narration and live
+ * per-shot animate progress. The data the studio turns into a render.
+ */
+interface PipelineTimeline {
+    fps: number;
+    width: number;
+    height: number;
+    scenes: Array<{
+        compositeUrl: string;
+        durationSeconds: number;
+    }>;
+    musicUrl?: string;
+    narrationUrl?: string;
+    animateProgress?: {
+        totalShots: number;
+        shotsDone: number;
+        percent: number;
+    };
+}
+interface BranchPipelineInput {
+    /** The stage to re-run from. Upstream stages are cloned as approved. */
+    fromStage: PipelineStageName;
+}
+interface BranchPipelineResult {
+    /** The id of the newly created pipeline. */
+    pipelineId: string;
+    /** Stage names that were cloned as 'approved' (stages before `fromStage`). */
+    clonedStages: string[];
+    /** Number of entity rows cloned into the new pipeline. */
+    clonedEntities: number;
+}
+/**
+ * A single chat turn returned by `getStageChat`. Mirrors the
+ * `pipeline_chat_turns` row shape selected by the GET handler.
+ *
+ * `@nodaro/shared` does not yet export a Zod schema for the full row; it only
+ * exports `ChatTurnResponseSchema` (the LLM response shape) and the
+ * `ProposedChange` discriminated union. Define the wire-format row locally so
+ * callers get end-to-end typing today without re-shaping the backend payload.
+ */
+interface ChatTurn {
+    id: string;
+    turn_n: number;
+    role: "user" | "assistant";
+    content: string;
+    proposed_change: ProposedChange | null;
+    llm_call_id: string | null;
+    applied_to_attempt_id: string | null;
+    created_at: string;
+}
+/**
+ * Result of `chatStage` — the assistant turn that was just persisted. The
+ * route always echoes the assistant message back so callers can render the
+ * reply without a follow-up GET (SSE is the secondary delivery channel).
+ */
+interface ChatStageResult {
+    turnId: string;
+    role: "assistant";
+    content: string;
+    proposed_change: ProposedChange | null;
+}
+/**
+ * Result of `applyChatProposal`. Discriminated on `applied`:
+ *
+ * - `applied: true` — `applyStageEdit` validated + persisted a new attempt and
+ *   flipped the stage to approved. `newOutput` is the post-patch artifact.
+ * - `applied: false` — recoverable failure (schema_invalid or
+ *   reference_integrity_failed); the backend has already inserted a follow-up
+ *   assistant turn with a human-readable hint so the user can iterate via
+ *   chat. Hard failures throw via the client's error pipeline (409).
+ */
+type ApplyChatProposalResult = {
+    applied: true;
+    attemptId: string;
+    newOutput: unknown;
+} | {
+    applied: false;
+    error: {
+        code: string;
+        detail?: unknown;
+    };
+};
+declare class PipelinesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Start a new pipeline (headless film generation) — the programmatic
+     * equivalent of the studio's "Create film". In Auto mode the engine
+     * self-advances to completion; poll {@link get} for status and
+     * {@link getTimeline} for the assembled output. In manual/guided mode, drive
+     * it with {@link pendingApprovals} + {@link approveStage} /
+     * {@link approveSubGate} / {@link acceptMatchCutBreak}.
+     *
+     * Requires `pipelines:execute` scope. Returns the new pipeline id.
+     */
+    create(input: PipelineInput): Promise<{
+        id: string;
+    }>;
+    /**
+     * Fetch current pipeline state: `status`, `current_stage`, credit counters,
+     * `mode`, and `failure_reason` (set when `status='failed'`). Poll this to
+     * track a headless Auto run to completion. Requires `pipelines:read`.
+     */
+    get(id: string): Promise<PipelineRecord>;
+    /** List the caller's pipelines (most recent first). Requires `pipelines:read`. */
+    list(): Promise<PipelineRecord[]>;
+    /**
+     * Cancel a running pipeline. Unspent reserved credits refund. Idempotent on
+     * an already-terminal pipeline. Requires `pipelines:execute`.
+     */
+    cancel(id: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Stages currently `awaiting_approval`. Empty in a clean Auto run (the engine
+     * self-approves); populated in manual/guided mode at each gate. Requires
+     * `pipelines:read`.
+     */
+    pendingApprovals(id: string): Promise<PendingApproval[]>;
+    /**
+     * Approve a stage so the engine advances to the next one. An optional `edits`
+     * JSON-Patch is applied to the stage output before approval. Requires
+     * `pipelines:approve`.
+     */
+    approveStage(id: string, stage: PipelineStageName, edits?: unknown): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Reject a stage with feedback; the engine re-runs it incorporating the note.
+     * Requires `pipelines:approve`.
+     */
+    rejectStage(id: string, stage: PipelineStageName, feedback: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Approve a Stage 7 (`animate_audio_edit`) sub-gate — `silent_cut_preview`
+     * or `dialogue_recheck` — so the orchestrator resumes from the next
+     * sub-step. Stage 6's `match_cut_break_pending` is not approved here: accept
+     * each break with {@link acceptMatchCutBreak}. Requires `pipelines:approve`.
+     */
+    approveSubGate(id: string, gate: AnimateSubGate): Promise<{
+        ok: true;
+        gate: AnimateSubGate;
+        resumed_at: string;
+    }>;
+    /**
+     * Accept one match-cut break Stage 6 (`scene_images`) flagged. While any
+     * break is pending, the stage pauses at the `match_cut_break_pending`
+     * sub-gate, and its output lists the pending shot ids; accepting the last
+     * one resumes the stage. `sceneId` is the scene entity that holds the shot.
+     * Requires `pipelines:approve`.
+     */
+    acceptMatchCutBreak(id: string, sceneId: string, shotId: string): Promise<{
+        ok: true;
+        pendingRemaining: number;
+    }>;
+    /**
+     * Read a single stage's `status`, `output`, and `critic_feedback`. Useful for
+     * inspecting the script/plan before approving. Requires `pipelines:read`.
+     */
+    getStage(id: string, stage: PipelineStageName): Promise<{
+        status: string;
+        output: unknown;
+        critic_feedback: unknown;
+    }>;
+    /**
+     * Assembled timeline — ordered scene composites + durations + audio URLs +
+     * live animate progress. The output a headless caller renders or hands to a
+     * downstream editor. Requires `pipelines:read`.
+     */
+    getTimeline(id: string): Promise<PipelineTimeline>;
+    /**
+     * Branch a completed pipeline into a new pipeline that re-runs from the
+     * given stage. The original pipeline's upstream stages and entities are
+     * cloned into the new pipeline; downstream stages are created by the
+     * orchestrator as it advances.
+     *
+     * Requires `pipelines:execute` scope.
+     * The source pipeline must have `status='completed'`.
+     *
+     * @returns 201 with `{ pipelineId, clonedStages, clonedEntities }`.
+     */
+    branch(id: string, input: BranchPipelineInput): Promise<BranchPipelineResult>;
+    /**
+     * Send a chat message to the Showrunner Refinement Director (Guided Mode).
+     * Persists user + assistant turns; returns the assistant's reply and an
+     * optional `proposed_change` the user can `applyChatProposal` to commit.
+     *
+     * Requires `pipelines:approve` scope. The pipeline must have
+     * `mode='guided'` and the stage must be `awaiting_approval`.
+     *
+     * Only the Script stage ships a wired specialist in Phase 1D.2b — the other
+     * chat-enabled stages (`shot_list`, `post_merge`) return 501 until 1D.2d.
+     */
+    chatStage(pipelineId: string, stage: ChatEnabledStage, message: string): Promise<ChatStageResult>;
+    /**
+     * Accept a proposed change from a prior assistant turn. Routes through
+     * `applyStageEdit` (validates JSON Patch + per-stage schema +
+     * reference-integrity, inserts a new pipeline_stage_attempts row, CAS-flips
+     * the stage to approved, emits `chat:proposal_applied` SSE).
+     *
+     * Requires `pipelines:approve` scope.
+     *
+     * Returns `{ applied: true, attemptId, newOutput }` on success, or
+     * `{ applied: false, error }` on recoverable failures (the backend already
+     * inserted a follow-up assistant turn with a hint). Hard failures
+     * (`patch_invalid`, `stage_not_awaiting`) throw via the standard error
+     * pipeline (HTTP 409).
+     */
+    applyChatProposal(pipelineId: string, stage: ChatEnabledStage, turnId: string): Promise<ApplyChatProposalResult>;
+    /**
+     * Fetch the chat history for a stage. Returns an empty array when no turns
+     * exist yet (e.g., stage has not been started or the user hasn't sent any
+     * messages). Used by the frontend chat panel on initial mount; subsequent
+     * updates arrive via SSE (`chat:turn` events).
+     *
+     * Requires `pipelines:read` scope.
+     */
+    getStageChat(pipelineId: string, stage: ChatEnabledStage): Promise<{
+        turns: ChatTurn[];
+    }>;
+}
+
+export { type ApplyChatProposalResult, type BranchPipelineInput, type BranchPipelineResult, type ChatStageResult, type ChatTurn, type PendingApproval, type PipelineRecord, type PipelineTimeline, PipelinesResource };

package/dist/entries/pipelines.d.ts

@@ -0,0 +1,255 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { PipelineStageName, ProposedChange, PipelineInput, PipelineStatus, PipelineMode, AnimateSubGate, ChatEnabledStage } from '@nodaro/shared/pipeline';
+export { AnimateSubGate, ChatEnabledStage, PipelineInput, PipelineMode, PipelineStageName, PipelineStatus, ProposedChange, SubGateName } from '@nodaro/shared/pipeline';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Owner-scoped pipeline record returned by `get` / `list` (the server strips
+ * `user_id`). Mirrors the public field set of `GET /v1/pipelines/:id`.
+ */
+interface PipelineRecord {
+    id: string;
+    status: PipelineStatus;
+    current_stage: string | null;
+    spent_credits: number;
+    reserved_credits: number;
+    upfront_credit_estimate: number;
+    branched_from_pipeline_id: string | null;
+    branched_from_stage: string | null;
+    mode: PipelineMode | null;
+    failure_reason: string | null;
+    current_progress_message: string | null;
+}
+/** One stage currently awaiting approval (from `pendingApprovals`). */
+interface PendingApproval {
+    stage_name: PipelineStageName;
+    /** Stage output snapshot; shape varies by stage. */
+    output: unknown;
+}
+/**
+ * Assembled timeline (`GET /v1/pipelines/:id/timeline`) — ordered scene
+ * composites + their durations, plus optional music/narration and live
+ * per-shot animate progress. The data the studio turns into a render.
+ */
+interface PipelineTimeline {
+    fps: number;
+    width: number;
+    height: number;
+    scenes: Array<{
+        compositeUrl: string;
+        durationSeconds: number;
+    }>;
+    musicUrl?: string;
+    narrationUrl?: string;
+    animateProgress?: {
+        totalShots: number;
+        shotsDone: number;
+        percent: number;
+    };
+}
+interface BranchPipelineInput {
+    /** The stage to re-run from. Upstream stages are cloned as approved. */
+    fromStage: PipelineStageName;
+}
+interface BranchPipelineResult {
+    /** The id of the newly created pipeline. */
+    pipelineId: string;
+    /** Stage names that were cloned as 'approved' (stages before `fromStage`). */
+    clonedStages: string[];
+    /** Number of entity rows cloned into the new pipeline. */
+    clonedEntities: number;
+}
+/**
+ * A single chat turn returned by `getStageChat`. Mirrors the
+ * `pipeline_chat_turns` row shape selected by the GET handler.
+ *
+ * `@nodaro/shared` does not yet export a Zod schema for the full row; it only
+ * exports `ChatTurnResponseSchema` (the LLM response shape) and the
+ * `ProposedChange` discriminated union. Define the wire-format row locally so
+ * callers get end-to-end typing today without re-shaping the backend payload.
+ */
+interface ChatTurn {
+    id: string;
+    turn_n: number;
+    role: "user" | "assistant";
+    content: string;
+    proposed_change: ProposedChange | null;
+    llm_call_id: string | null;
+    applied_to_attempt_id: string | null;
+    created_at: string;
+}
+/**
+ * Result of `chatStage` — the assistant turn that was just persisted. The
+ * route always echoes the assistant message back so callers can render the
+ * reply without a follow-up GET (SSE is the secondary delivery channel).
+ */
+interface ChatStageResult {
+    turnId: string;
+    role: "assistant";
+    content: string;
+    proposed_change: ProposedChange | null;
+}
+/**
+ * Result of `applyChatProposal`. Discriminated on `applied`:
+ *
+ * - `applied: true` — `applyStageEdit` validated + persisted a new attempt and
+ *   flipped the stage to approved. `newOutput` is the post-patch artifact.
+ * - `applied: false` — recoverable failure (schema_invalid or
+ *   reference_integrity_failed); the backend has already inserted a follow-up
+ *   assistant turn with a human-readable hint so the user can iterate via
+ *   chat. Hard failures throw via the client's error pipeline (409).
+ */
+type ApplyChatProposalResult = {
+    applied: true;
+    attemptId: string;
+    newOutput: unknown;
+} | {
+    applied: false;
+    error: {
+        code: string;
+        detail?: unknown;
+    };
+};
+declare class PipelinesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Start a new pipeline (headless film generation) — the programmatic
+     * equivalent of the studio's "Create film". In Auto mode the engine
+     * self-advances to completion; poll {@link get} for status and
+     * {@link getTimeline} for the assembled output. In manual/guided mode, drive
+     * it with {@link pendingApprovals} + {@link approveStage} /
+     * {@link approveSubGate} / {@link acceptMatchCutBreak}.
+     *
+     * Requires `pipelines:execute` scope. Returns the new pipeline id.
+     */
+    create(input: PipelineInput): Promise<{
+        id: string;
+    }>;
+    /**
+     * Fetch current pipeline state: `status`, `current_stage`, credit counters,
+     * `mode`, and `failure_reason` (set when `status='failed'`). Poll this to
+     * track a headless Auto run to completion. Requires `pipelines:read`.
+     */
+    get(id: string): Promise<PipelineRecord>;
+    /** List the caller's pipelines (most recent first). Requires `pipelines:read`. */
+    list(): Promise<PipelineRecord[]>;
+    /**
+     * Cancel a running pipeline. Unspent reserved credits refund. Idempotent on
+     * an already-terminal pipeline. Requires `pipelines:execute`.
+     */
+    cancel(id: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Stages currently `awaiting_approval`. Empty in a clean Auto run (the engine
+     * self-approves); populated in manual/guided mode at each gate. Requires
+     * `pipelines:read`.
+     */
+    pendingApprovals(id: string): Promise<PendingApproval[]>;
+    /**
+     * Approve a stage so the engine advances to the next one. An optional `edits`
+     * JSON-Patch is applied to the stage output before approval. Requires
+     * `pipelines:approve`.
+     */
+    approveStage(id: string, stage: PipelineStageName, edits?: unknown): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Reject a stage with feedback; the engine re-runs it incorporating the note.
+     * Requires `pipelines:approve`.
+     */
+    rejectStage(id: string, stage: PipelineStageName, feedback: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Approve a Stage 7 (`animate_audio_edit`) sub-gate — `silent_cut_preview`
+     * or `dialogue_recheck` — so the orchestrator resumes from the next
+     * sub-step. Stage 6's `match_cut_break_pending` is not approved here: accept
+     * each break with {@link acceptMatchCutBreak}. Requires `pipelines:approve`.
+     */
+    approveSubGate(id: string, gate: AnimateSubGate): Promise<{
+        ok: true;
+        gate: AnimateSubGate;
+        resumed_at: string;
+    }>;
+    /**
+     * Accept one match-cut break Stage 6 (`scene_images`) flagged. While any
+     * break is pending, the stage pauses at the `match_cut_break_pending`
+     * sub-gate, and its output lists the pending shot ids; accepting the last
+     * one resumes the stage. `sceneId` is the scene entity that holds the shot.
+     * Requires `pipelines:approve`.
+     */
+    acceptMatchCutBreak(id: string, sceneId: string, shotId: string): Promise<{
+        ok: true;
+        pendingRemaining: number;
+    }>;
+    /**
+     * Read a single stage's `status`, `output`, and `critic_feedback`. Useful for
+     * inspecting the script/plan before approving. Requires `pipelines:read`.
+     */
+    getStage(id: string, stage: PipelineStageName): Promise<{
+        status: string;
+        output: unknown;
+        critic_feedback: unknown;
+    }>;
+    /**
+     * Assembled timeline — ordered scene composites + durations + audio URLs +
+     * live animate progress. The output a headless caller renders or hands to a
+     * downstream editor. Requires `pipelines:read`.
+     */
+    getTimeline(id: string): Promise<PipelineTimeline>;
+    /**
+     * Branch a completed pipeline into a new pipeline that re-runs from the
+     * given stage. The original pipeline's upstream stages and entities are
+     * cloned into the new pipeline; downstream stages are created by the
+     * orchestrator as it advances.
+     *
+     * Requires `pipelines:execute` scope.
+     * The source pipeline must have `status='completed'`.
+     *
+     * @returns 201 with `{ pipelineId, clonedStages, clonedEntities }`.
+     */
+    branch(id: string, input: BranchPipelineInput): Promise<BranchPipelineResult>;
+    /**
+     * Send a chat message to the Showrunner Refinement Director (Guided Mode).
+     * Persists user + assistant turns; returns the assistant's reply and an
+     * optional `proposed_change` the user can `applyChatProposal` to commit.
+     *
+     * Requires `pipelines:approve` scope. The pipeline must have
+     * `mode='guided'` and the stage must be `awaiting_approval`.
+     *
+     * Only the Script stage ships a wired specialist in Phase 1D.2b — the other
+     * chat-enabled stages (`shot_list`, `post_merge`) return 501 until 1D.2d.
+     */
+    chatStage(pipelineId: string, stage: ChatEnabledStage, message: string): Promise<ChatStageResult>;
+    /**
+     * Accept a proposed change from a prior assistant turn. Routes through
+     * `applyStageEdit` (validates JSON Patch + per-stage schema +
+     * reference-integrity, inserts a new pipeline_stage_attempts row, CAS-flips
+     * the stage to approved, emits `chat:proposal_applied` SSE).
+     *
+     * Requires `pipelines:approve` scope.
+     *
+     * Returns `{ applied: true, attemptId, newOutput }` on success, or
+     * `{ applied: false, error }` on recoverable failures (the backend already
+     * inserted a follow-up assistant turn with a hint). Hard failures
+     * (`patch_invalid`, `stage_not_awaiting`) throw via the standard error
+     * pipeline (HTTP 409).
+     */
+    applyChatProposal(pipelineId: string, stage: ChatEnabledStage, turnId: string): Promise<ApplyChatProposalResult>;
+    /**
+     * Fetch the chat history for a stage. Returns an empty array when no turns
+     * exist yet (e.g., stage has not been started or the user hasn't sent any
+     * messages). Used by the frontend chat panel on initial mount; subsequent
+     * updates arrive via SSE (`chat:turn` events).
+     *
+     * Requires `pipelines:read` scope.
+     */
+    getStageChat(pipelineId: string, stage: ChatEnabledStage): Promise<{
+        turns: ChatTurn[];
+    }>;
+}
+
+export { type ApplyChatProposalResult, type BranchPipelineInput, type BranchPipelineResult, type ChatStageResult, type ChatTurn, type PendingApproval, type PipelineRecord, type PipelineTimeline, PipelinesResource };

package/dist/entries/pipelines.js

@@ -0,0 +1,4 @@
+import '../chunk-IQ6KWSXP.js';
+export { PipelinesResource } from '../chunk-K4RQOSJH.js';
+//# sourceMappingURL=pipelines.js.map
+//# sourceMappingURL=pipelines.js.map