@nodaro/sdk 2.29.0 → 2.31.0

package/dist/chunk-I4A5VJRL.js

@@ -0,0 +1,352 @@
+import { NodaroError, ForbiddenError } from './chunk-JGS6YBDW.js';
+import { resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, speakerMapResultOf, cameraSwitchSpeakerMap, remapTranscriptThroughEdl } from '@nodaro/shared/edl';
+import { isUseCaseNodeType, USE_CASE_NODE_TYPES } from '@nodaro/shared/nodes';
+export { USE_CASE_NODE_TYPES } from '@nodaro/shared/nodes';
+
+// src/resources/edit-use-case-inputs.ts
+var TRAILER_FORMATS = ["9:16", "1:1", "4:5", "16:9"];
+var CLIP_PACK_MIN_TARGET_SEC = 5;
+var CLIP_PACK_MAX_TARGET_SEC = 180;
+function tightenBody(input) {
+  const { mediaUrl, ...rest } = input;
+  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)) };
+}
+function chaptersBody(input) {
+  return {
+    mediaUrls: [input.mediaUrl],
+    ...input.planTier !== void 0 ? { planTier: input.planTier } : {},
+    ...input.instructions !== void 0 ? { instructions: input.instructions } : {},
+    ...input.styleGuide !== void 0 ? { styleGuide: input.styleGuide } : {}
+  };
+}
+function trailerBody(input) {
+  return {
+    mediaUrls: [input.mediaUrl],
+    ...input.introCardUrl !== void 0 ? { introCardUrl: input.introCardUrl } : {},
+    // An empty list is sent as is: the route refuses it (at least one format).
+    ...input.formats !== void 0 ? { formats: input.formats } : {},
+    ...input.reviewBeforeRender !== void 0 ? { reviewBeforeRender: input.reviewBeforeRender } : {},
+    ...input.planTier !== void 0 ? { planTier: input.planTier } : {},
+    ...input.instructions !== void 0 ? { instructions: input.instructions } : {},
+    ...input.styleGuide !== void 0 ? { styleGuide: input.styleGuide } : {}
+  };
+}
+function clipPackBody(input) {
+  const { mediaUrl, ...rest } = input;
+  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)) };
+}
+var continuePathOf = (type) => `/v1/${type}/continue`;
+function idempotencyHeaders(options) {
+  return options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {};
+}
+var EditResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Detect silence ranges in an audio/video source (`POST /v1/silence-detect`).
+   * Keyless — one ffmpeg pass over the source's audio proxy.
+   */
+  silenceDetect(input) {
+    return this.client.request("POST", "/v1/silence-detect", {
+      body: {
+        audioUrl: input.audioUrl,
+        ...input.thresholdDb !== void 0 ? { thresholdDb: input.thresholdDb } : {},
+        ...input.minSilenceMs !== void 0 ? { minSilenceMs: input.minSilenceMs } : {},
+        ...input.padMs !== void 0 ? { padMs: input.padMs } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Measure how far apart the clocks of 2–6 recordings of one conversation are
+   * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one
+   * ffmpeg decode per source. The finished job's `output_data.json` is an
+   * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6
+   * sources, a repeated id, a `reference` that is not one of the ids) throws a
+   * typed `NodaroError` (400, `code: "validation_error"`) before any credits
+   * are reserved.
+   */
+  audioSync(input) {
+    return this.client.request("POST", "/v1/audio-sync", {
+      body: {
+        sources: input.sources.map((s) => ({ id: s.id, url: s.url })),
+        ...input.reference !== void 0 ? { reference: input.reference } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Which camera each speaker is on, from the cameras' own microphones (`POST
+   * /v1/speaker-map`), keyless. `output_data.json` is a `SpeakerMapResult`: pass
+   * it to {@link cameraSwitch} as `speakerMapResult`. A malformed request throws
+   * a `NodaroError` (400 `validation_error`; 422 `no_speakers` for a transcript
+   * with no speaker labels) before any credits are reserved.
+   */
+  speakerMap(input) {
+    return this.client.request("POST", "/v1/speaker-map", {
+      body: {
+        sources: input.sources.map((s) => ({ id: s.id, url: s.url, ...s.kind ? { kind: s.kind } : {} })),
+        transcript: input.transcript,
+        ...input.offsets !== void 0 ? { offsets: input.offsets } : {},
+        ...input.masterSourceId !== void 0 ? { masterSourceId: input.masterSourceId } : {},
+        ...input.wideSourceId !== void 0 ? { wideSourceId: input.wideSourceId } : {},
+        ...input.marginDb !== void 0 ? { marginDb: input.marginDb } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).
+   * The EDL is validated at ingress — an unresolvable source or a picture-less
+   * segment on a video edit throws a typed `NodaroError` (400, `code:
+   * "invalid_edl"`) before any credits are reserved.
+   */
+  applyEdl(input) {
+    return this.client.request("POST", "/v1/apply-edl", {
+      body: {
+        edl: input.edl,
+        ...input.sources !== void 0 ? { sources: input.sources } : {},
+        ...input.transcript !== void 0 ? { transcript: input.transcript } : {},
+        ...input.output !== void 0 ? { output: input.output } : {},
+        ...input.quality !== void 0 ? { quality: input.quality } : {},
+        ...input.crossfadeMs !== void 0 ? { crossfadeMs: input.crossfadeMs } : {},
+        ...input.clipKey !== void 0 ? { clipKey: input.clipKey } : {},
+        ...input.planBasis !== void 0 ? { planBasis: input.planBasis } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording
+   * in one call — transcribe, cut the silences and filler, render, with
+   * optional captions, music and framing. Answers the run's job to poll; its
+   * `output_data` holds the episode. The run is priced as its steps at their own
+   * rates plus the listed per-run fee. Quote it first with
+   * {@link estimateTightenEpisode}.
+   */
+  tightenEpisode(input, options) {
+    return this.client.request("POST", "/v1/tighten-episode", { body: tightenBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):
+   * its steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. The estimate leans high: the render is priced at the recording's
+   * full length, while the charge follows the minutes actually rendered.
+   */
+  estimateTightenEpisode(input) {
+    return this.client.request("POST", "/v1/tighten-episode/estimate", { body: tightenBody(input) });
+  }
+  /**
+   * Chapters (`POST /v1/episode-chapters`): transcribe a recording and list its
+   * chapters in one call. Answers the run's job to poll; the finished job's
+   * `output_data.text` is the list as show notes (one `0:00 Title` line per
+   * chapter; once a chapter starts at 1:00:00 or later, every line is
+   * `H:MM:SS`), `output_data.json` the list itself (`{ startMs, title }[]`, the
+   * same rows; the first starts at 0). A run that finds no chapters fails,
+   * and its fee is refunded. Priced as its steps at their own rates plus the
+   * listed per-run fee; quote it first with {@link estimateEpisodeChapters}.
+   */
+  episodeChapters(input, options) {
+    return this.client.request("POST", "/v1/episode-chapters", { body: chaptersBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Chapters run is estimated at (`POST /v1/episode-chapters/estimate`):
+   * its steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. A recording whose length cannot be read is estimated at the
+   * 180-minute ceiling.
+   */
+  estimateEpisodeChapters(input) {
+    return this.client.request("POST", "/v1/episode-chapters/estimate", { body: chaptersBody(input) });
+  }
+  /**
+   * Trailer (`POST /v1/episode-trailer`): cut a 20–40 s trailer of a recording
+   * and deliver it in each chosen format (padded, never cropped), optionally
+   * after an intro card, in one call. The finished job's `output_data.formats`
+   * is `{ format, url }[]` in format order, the first also `output_data.videoUrl`;
+   * a format that failed is named in `output_data.failedFormats` (the run keeps
+   * the others). With `reviewBeforeRender` the run stops at a preview
+   * (`videoUrl`, no formats yet). Priced as its steps at their own rates plus
+   * the listed per-run fee; quote it first with {@link estimateEpisodeTrailer}.
+   */
+  episodeTrailer(input, options) {
+    return this.client.request("POST", "/v1/episode-trailer", { body: trailerBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Trailer run is estimated at (`POST /v1/episode-trailer/estimate`):
+   * its steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. The trailer is quoted at 40 seconds, the longest trailer the
+   * plan cuts; a Render final is quoted on the trailer the run cut (with the
+   * review's edits), plus the intro card.
+   */
+  estimateEpisodeTrailer(input) {
+    return this.client.request("POST", "/v1/episode-trailer/estimate", { body: trailerBody(input) });
+  }
+  /**
+   * Clip Pack (`POST /v1/clip-pack`): cut a recording into a pack of short
+   * clips in one call — the plan finds the best moments (`count`, default 8,
+   * of about `targetDurationSec`, default 60), each is rendered (framed 9:16
+   * with the speakers stacked by default; `framing: null` keeps the
+   * recording's shape) and captioned. An audio recording makes audio clips.
+   * The finished job's `output_data.clips` is `{ url, title?, hook?, clipKey,
+   * thumbnailUrl?, captionsFailed? }[]` in plan order, the first also
+   * `output_data.videoUrl` (`audioUrl` for audio clips). Every clip is tried:
+   * one that cannot be rendered is skipped, not charged and counted on
+   * `failedClips` (the pack keeps the others and its fee); a clip whose
+   * captions failed comes uncaptioned (`captionsFailed`, counted on
+   * `failedCaptions`). When no clip renders the run fails and its fee is
+   * refunded. With `reviewBeforeRender` the run stops at previews; Render
+   * final ({@link continueUseCase}) renders only the clips the edit keeps.
+   * Priced as its steps at their own rates plus the listed per-run fee;
+   * quote it first with {@link estimateClipPack}.
+   */
+  clipPack(input, options) {
+    return this.client.request("POST", "/v1/clip-pack", { body: clipPackBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Clip Pack run is estimated at (`POST /v1/clip-pack/estimate`): its
+   * steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. Each clip is quoted at twice the target length (the plan may cut
+   * a clip longer than asked); the charge follows each clip's real length.
+   */
+  estimateClipPack(input) {
+    return this.client.request("POST", "/v1/clip-pack/estimate", { body: clipPackBody(input) });
+  }
+  /**
+   * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the
+   * run's own type: `input.nodeType`, else the type the job records, read with
+   * `GET /v1/jobs/:id`; when that read cannot tell, this rejects with a
+   * `NodaroError` coded `use_case_type_unknown` — pass `nodeType` then):
+   * `"from-failed"` keeps the steps that finished and runs the rest (the fee
+   * is held again; the failed run's was refunded);
+   * `"render-final"` renders the full-quality result after a review-on preview,
+   * with the preview's settings and no fee. A refusal that names another job
+   * (`already_running`, `continuation_superseded`,
+   * `render_final_already_rendered`) throws a `ContinuationRefusedError`
+   * carrying that `jobId`.
+   */
+  async continueUseCase(input, options) {
+    if (input.nodeType !== void 0 && !isUseCaseNodeType(input.nodeType)) {
+      throw new NodaroError(
+        `continueUseCase: nodeType "${String(input.nodeType)}" is not a use-case node type (${USE_CASE_NODE_TYPES.join(", ")})`,
+        "invalid_node_type",
+        400
+      );
+    }
+    const type = input.nodeType ?? await this.runTypeOf(input.jobId);
+    return this.client.request("POST", continuePathOf(type), {
+      body: { jobId: input.jobId, mode: input.mode, ...input.editedEdl !== void 0 ? { editedEdl: input.editedEdl } : {} },
+      ...idempotencyHeaders(options)
+    });
+  }
+  /**
+   * The use-case type a run records (`input_data.type`, else its `job_type`).
+   * When the key lacks the `jobs:read` scope (403 naming that scope) or the job
+   * names no use-case type, the type cannot be read: this rejects with a
+   * `NodaroError` (`use_case_type_unknown`, 400) asking for `nodeType`, and
+   * nothing is posted (decided 2026-10-18: no route is guessed for the run).
+   * Any other failure of the read, any other 403 included, is thrown as is.
+   */
+  async runTypeOf(jobId) {
+    const unknown = () => new NodaroError("continueUseCase: the run's node type cannot be read \u2014 pass nodeType", "use_case_type_unknown", 400);
+    let row;
+    try {
+      row = (await this.client.request("GET", `/v1/jobs/${encodeURIComponent(jobId)}`)).data;
+    } catch (err) {
+      if (err instanceof ForbiddenError && err.missingScope === "jobs:read") throw unknown();
+      throw err;
+    }
+    const input = row?.input_data;
+    const recorded = input && typeof input === "object" && !Array.isArray(input) ? input.type : void 0;
+    const type = typeof recorded === "string" && recorded.length > 0 ? recorded : row?.job_type;
+    if (!isUseCaseNodeType(type)) throw unknown();
+    return type;
+  }
+  /**
+   * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
+   * transcript (plus optional silence ranges) and the media sources, and plans
+   * the edit. The finished job's `output_data` holds the plan: an `Edl`
+   * (`"tighten"` or `"trailer"`), an {@link EdlClipSet} (`"clips"`), or a
+   * {@link ChapterSet} (`"chapters"`) — normalize it with {@link unwrapEditPlanOutput}.
+   *
+   * On a self-hosted install the request relays to nodaro.ai and needs the
+   * install connected (a 503 `code: "nodaro_connection_required"` otherwise);
+   * on nodaro.ai it runs directly.
+   */
+  editPlan(input) {
+    const planned = resolveEditPlanSources(input.sources, {
+      offsets: input.offsets,
+      transcriptSourceId: input.transcriptSourceId
+    });
+    if (!planned.ok) {
+      const message = planned.issues.map((issue) => describeAudioSyncOffsetIssue(issue)).join("; ");
+      return Promise.reject(new NodaroError(`editPlan: ${message}`, "edit_plan_sources", 400));
+    }
+    const transcript = planned.transcriptSourceId ? { ...input.transcript, sourceId: planned.transcriptSourceId } : input.transcript;
+    return this.client.request("POST", "/v1/edit-plan", {
+      body: {
+        mode: input.mode,
+        planTier: input.planTier,
+        transcript,
+        sources: planned.sources,
+        ...input.silence !== void 0 ? { silence: input.silence } : {},
+        ...input.instructions !== void 0 ? { instructions: input.instructions } : {},
+        ...input.styleGuide !== void 0 ? { styleGuide: input.styleGuide } : {},
+        ...input.count !== void 0 ? { count: input.count } : {},
+        ...input.targetDurationSec !== void 0 ? { targetDurationSec: input.targetDurationSec } : {},
+        ...input.targetAspect !== void 0 ? { targetAspect: input.targetAspect } : {},
+        ...input.platform !== void 0 ? { platform: input.platform } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`
+   * by who is speaking — the sound never changes. Cloud edition; a flat
+   * price. The finished job's `output_data.json` is the switched EDL (feed it
+   * to {@link applyEdl}) and `output_data.transcript` the transcript with
+   * `speakerNames` applied. A transcript with no speaker labels rejects with
+   * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
+   */
+  cameraSwitch(input) {
+    if (transcriptSpeakerLabels(input.transcript).length === 0) {
+      return Promise.reject(new NodaroError(
+        "cameraSwitch: the transcript has no speaker labels \u2014 transcribe with speaker detection on",
+        "no_speakers",
+        422
+      ));
+    }
+    const result = input.speakerMapResult;
+    if (result !== void 0 && !speakerMapResultOf(result)) return Promise.reject(new NodaroError("cameraSwitch: speakerMapResult is not a Speaker Map result \u2014 pass that job's output_data.json", "not_a_speaker_map", 400));
+    const speakerMap = result !== void 0 ? cameraSwitchSpeakerMap({ speakerMap: input.speakerMap }, input.edl, input.transcript, { speakerMap: result }) : input.speakerMap;
+    return this.client.request("POST", "/v1/camera-switch", {
+      body: {
+        edl: input.edl,
+        transcript: input.transcript,
+        ...speakerMap !== void 0 ? { speakerMap } : {},
+        ...input.speakerNames !== void 0 ? { speakerNames: input.speakerNames } : {},
+        ...input.minShotMs !== void 0 ? { minShotMs: input.minShotMs } : {},
+        ...input.leadMs !== void 0 ? { leadMs: input.leadMs } : {},
+        ...input.maxShotMs !== void 0 ? { maxShotMs: input.maxShotMs } : {},
+        ...input.wideEvery !== void 0 ? { wideEvery: input.wideEvery } : {},
+        ...input.layoutHints !== void 0 ? { layoutHints: input.layoutHints } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
+  /**
+   * Remap a transcript through an EDL — a PURE client-side transform (NO
+   * request). Returns a new transcript whose word (and segment) timings are on
+   * the EDL's rendered output clock, dropping words that fall in cut regions and
+   * clipping straddlers. Runs `@nodaro/shared`'s canonical
+   * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.
+   */
+  remapTranscript(edl, transcript) {
+    return remapTranscriptThroughEdl(edl, transcript);
+  }
+};
+
+export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS };
+//# sourceMappingURL=chunk-I4A5VJRL.js.map
+//# sourceMappingURL=chunk-I4A5VJRL.js.map

package/dist/chunk-I4A5VJRL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/edit-use-case-inputs.ts","../src/resources/edit.ts"],"names":[],"mappings":"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","file":"chunk-I4A5VJRL.js","sourcesContent":["/**\n * The inputs of the podcast use-case runs on the `edit` resource (Tighten\n * Episode, Chapters, Trailer, Clip Pack) and the request body each one sends.\n * Split from `edit.ts`, which holds the methods, the type list and the\n * continue routes; every name here is re-exported from there.\n */\nimport type { EditPlanTier, EdlTargetAspect, SpeakerEmphasisStyle, SpeakerSwitchId } from \"@nodaro/shared/edl\"\nimport type { CaptionStyle } from \"@nodaro/shared/captions\"\n\n/**\n * Input for {@link EditResource.tightenEpisode} and\n * {@link EditResource.estimateTightenEpisode}: one recording in, the tightened\n * episode out. Only `mediaUrl` is required; every other field left out takes\n * the node's default.\n */\nexport interface TightenEpisodeInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl: string\n  /** Optional music bed, ducked under the voice and ending with the episode. */\n  musicUrl?: string\n  /** `\"video\"` or `\"audio\"`; an audio recording always makes an audio episode. */\n  output?: \"video\" | \"audio\"\n  /**\n   * Frame a video episode with Speaker View: an output aspect and a layout,\n   * over automatic boxes on the speakers on screen. A layout the aspect does\n   * not draw is snapped to one it does. `null` or absent: no framing.\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n  } | null\n  /** Captions on a video episode (on by default). */\n  captions?: boolean\n  /** The captions' look. */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at a quick preview for a person to review; render the full-quality\n   * episode afterwards with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier. */\n  planTier?: EditPlanTier\n  /** Editing instructions for the planner (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n  /** How far the music dips under the voice, 0–100 (default 75). */\n  musicDuckAmount?: number\n}\n\n/**\n * Input for {@link EditResource.episodeChapters} and\n * {@link EditResource.estimateEpisodeChapters}: one recording in, its chapters\n * out. Only `mediaUrl` is required; every other field left out takes the\n * node's default.\n */\nexport interface EpisodeChaptersInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl: string\n  /** The planner's tier (default `\"economy\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the chapters, e.g. \"5 to 8 chapters\" (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the chapter titles (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The formats a Trailer is delivered in, in delivery order (16:9 is a 1920×1080 landscape). */\nexport const TRAILER_FORMATS = [\"9:16\", \"1:1\", \"4:5\", \"16:9\"] as const\n/** One Trailer format (see {@link TRAILER_FORMATS}). */\nexport type TrailerFormat = (typeof TRAILER_FORMATS)[number]\n\n/**\n * Input for {@link EditResource.episodeTrailer} and\n * {@link EditResource.estimateEpisodeTrailer}: one video recording in, a\n * 20–40 s trailer out in each chosen format. Only `mediaUrl` is required.\n */\nexport interface EpisodeTrailerInput {\n  /** The recording — a video URL, up to 3 hours (an audio-only recording is refused). */\n  mediaUrl: string\n  /** An optional intro card: a short video (15 s at most) played before the trailer. */\n  introCardUrl?: string\n  /** The formats to deliver, padded, never cropped (default `[\"9:16\", \"1:1\", \"4:5\"]`; an empty list is refused). */\n  formats?: TrailerFormat[]\n  /** Stop at a preview of the trailer; render every format with {@link EditResource.continueUseCase} (`mode: \"render-final\"`). */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the trailer (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The shortest and longest clip a Clip Pack asks the plan for, in seconds. */\nexport const CLIP_PACK_MIN_TARGET_SEC = 5\nexport const CLIP_PACK_MAX_TARGET_SEC = 180\n\n/**\n * A Clip Pack emphasis: `\"none\"`, or one or more of `\"scale\"`, `\"border\"` and\n * `\"dim\"` joined with `\"+\"` (each once — the route refuses a repeat).\n */\nexport type ClipPackEmphasis = SpeakerEmphasisStyle | `${Exclude<SpeakerEmphasisStyle, \"none\">}+${string}`\n\n/**\n * Input for {@link EditResource.clipPack} and\n * {@link EditResource.estimateClipPack}: one recording in, a pack of short\n * clips out. Only `mediaUrl` is required; every other field left out takes\n * the node's default.\n */\nexport interface ClipPackInput {\n  /** The recording — a video or audio URL, up to 3 hours. An audio recording makes audio clips (no framing, no captions). */\n  mediaUrl: string\n  /** How many clips to find, 1–50 (default 8). The plan may find fewer. */\n  count?: number\n  /** Each clip's target length in seconds, {@link CLIP_PACK_MIN_TARGET_SEC}–{@link CLIP_PACK_MAX_TARGET_SEC} (default 60). */\n  targetDurationSec?: number\n  /**\n   * Frame each video clip with Speaker View on automatic boxes over the\n   * episode's speakers: the shape, and optionally the layout (default\n   * `\"stacked\"`; one the shape does not draw is snapped), the switch at each\n   * speaker change (default `\"pan\"`) and the emphasis (default `\"scale\"`;\n   * `\"none\"`, or `\"scale\"`, `\"border\"` and `\"dim\"` joined with `\"+\"`). Left\n   * out: 9:16, stacked, pan, scale. `null`: no framing (the recording's shape).\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout?: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n    switchType?: SpeakerSwitchId\n    emphasisStyle?: ClipPackEmphasis\n  } | null\n  /** Caption each video clip (on by default). */\n  captions?: boolean\n  /** The captions' look (default `\"karaoke\"`). */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at quick previews of the clips for a person to review; render the\n   * kept clips at full quality with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`, an `editedEdl` that keeps or drops clips).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for picking the clips (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\nexport function tightenBody(input: TightenEpisodeInput): Record<string, unknown> {\n  const { mediaUrl, ...rest } = input\n  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)) }\n}\n\nexport function chaptersBody(input: EpisodeChaptersInput): Record<string, unknown> {\n  return {\n    mediaUrls: [input.mediaUrl],\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  }\n}\n\nexport function trailerBody(input: EpisodeTrailerInput): Record<string, unknown> {\n  return {\n    mediaUrls: [input.mediaUrl],\n    ...(input.introCardUrl !== undefined ? { introCardUrl: input.introCardUrl } : {}),\n    // An empty list is sent as is: the route refuses it (at least one format).\n    ...(input.formats !== undefined ? { formats: input.formats } : {}),\n    ...(input.reviewBeforeRender !== undefined ? { reviewBeforeRender: input.reviewBeforeRender } : {}),\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  }\n}\n\n/** Clip Pack's body: what the caller set, `framing: null` included (no framing). */\nexport function clipPackBody(input: ClipPackInput): Record<string, unknown> {\n  const { mediaUrl, ...rest } = input\n  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)) }\n}\n","import type { NodaroClientCore } from \"../core.js\"\nimport { ForbiddenError, NodaroError } from \"../errors.js\"\nimport {\n  remapTranscriptThroughEdl,\n  unwrapEditPlanOutput,\n  resolveEditPlanSources,\n  describeAudioSyncOffsetIssue,\n  transcriptSpeakerLabels,\n  cameraSwitchSpeakerMap, speakerMapResultOf, type SpeakerMapResult,\n  type Edl,\n  type Transcript,\n  type EditPlanMode,\n  type EditPlanTier,\n  type EdlClipSet,\n  type ChapterSet,\n  type EdlTargetAspect\n} from \"@nodaro/shared/edl\"\nimport { USE_CASE_NODE_TYPES, isUseCaseNodeType, type UseCaseNodeType } from \"@nodaro/shared/nodes\"\nimport type { SpeakerMapInput } from \"./speaker-map-inputs.js\"\nimport {\n  chaptersBody,\n  clipPackBody,\n  tightenBody,\n  trailerBody,\n  type ClipPackInput,\n  type EpisodeChaptersInput,\n  type EpisodeTrailerInput,\n  type TightenEpisodeInput,\n} from \"./edit-use-case-inputs.js\"\n\nexport { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, TRAILER_FORMATS } from \"./edit-use-case-inputs.js\"\nexport type { ClipPackEmphasis, ClipPackInput, EpisodeChaptersInput, EpisodeTrailerInput, TightenEpisodeInput, TrailerFormat } from \"./edit-use-case-inputs.js\"\n\n// Re-export the canonical EDL / transcript vocabulary from `@nodaro/shared`\n// (single source of truth — the shapes live at `packages/shared/src/edl.ts`).\n// `@nodaro/shared` is already a hard dep of this package, so there is no\n// bundle-size cost to importing from it, and an integration builds requests and\n// reads results with one dependency. `EdlClipSet` / `ChapterSet` are the raw\n// `output_data` shapes of the `clips` / `chapters` modes, and\n// `unwrapEditPlanOutput` is the sanctioned way to normalize any edit-plan job's\n// `output_data` (it also strips the relay's `viaNodaroCloud` marker).\nexport type { Edl, Transcript, EditPlanMode, EditPlanTier, EdlClipSet, ChapterSet }\nexport { unwrapEditPlanOutput }\n\n/**\n * A silence-detect job's `output_data.json` — the value to pass as\n * {@link EditPlanInput.silence}. It is NOT what {@link EditResource.silenceDetect}\n * returns (that is `{ jobId }`); fetch the finished job and read its\n * `output_data.json`. The planner reads the `ranges` array — an input without\n * one is silently ignored, so pass this whole object.\n */\nexport interface SilenceRanges {\n  /** Wire version of the payload. */\n  version?: number\n  /** Silence spans on the source clock, in ms. */\n  ranges: ReadonlyArray<{ startMs: number; endMs: number }>\n  /** Total source duration, in ms. */\n  durationMs?: number\n}\n\n/** Every editorial route answers with the queued job to poll. */\nexport interface EditJobResult {\n  /** The queued job id — follow it via `client.jobs.getStatus(jobId)`. */\n  jobId: string\n}\n\nexport interface SilenceDetectInput {\n  /**\n   * An audio OR video source. A single ffmpeg `silencedetect` pass runs over the\n   * source's audio proxy either way — no provider key required.\n   */\n  audioUrl: string\n  /** dBFS threshold, always ≤ 0. Default -35 (a good podcast default). */\n  thresholdDb?: number\n  /** Minimum silence length to report, in ms. Default 700. */\n  minSilenceMs?: number\n  /** Padding kept around speech, in ms — shrinks each reported range inward. Default 120. */\n  padMs?: number\n  /**\n   * Optionally associate this run with a workflow execution (display only — it\n   * ties the standalone job back to a workflow for the execution history).\n   */\n  workflowId?: string\n}\n\n/** One recording for {@link EditResource.audioSync}. */\nexport interface AudioSyncSource {\n  /**\n   * Your id for this recording (1–200 chars, unique within the request) —\n   * echoed back as its offset's `sourceId`. Use the id your EDL gives the same\n   * recording (`EdlSource.id`) and the result folds straight into it.\n   */\n  id: string\n  /** An audio OR video URL — the audio track is read either way. */\n  url: string\n}\n\nexport interface AudioSyncInput {\n  /** The 2–6 recordings of one conversation to line up (camera files and/or a master mic). */\n  sources: AudioSyncSource[]\n  /**\n   * The id of the source every offset is measured against (its own offset is\n   * 0). Must be one of `sources`' ids; default: the first source.\n   */\n  reference?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** One recording's measured clock offset in an {@link AudioSyncResult}. */\nexport interface AudioSyncOffset {\n  /** The recording's `id` from the request. */\n  sourceId: string\n  /**\n   * Where this recording sits on the reference's clock, in integer ms:\n   * `referenceMs = sourceMs + offsetMs` (the EDL's D19 sign — the value\n   * `EdlSource.offsetMs` takes when the reference is the master).\n   */\n  offsetMs: number\n  /** 0–1. Below 0.5 a `notes` line asks for a check by ear. */\n  confidence: number\n  /**\n   * Measured clock drift against the reference, in ms gained per hour; `null`\n   * when the shared stretch was too short to measure it. Drift is reported,\n   * never corrected — the offset is taken at the middle of the overlap.\n   */\n  driftMsPerHour: number | null\n}\n\n/**\n * An audio-sync job's `output_data.json`. It is NOT what\n * {@link EditResource.audioSync} returns (that is `{ jobId }`); fetch the\n * finished job and read its `output_data.json`.\n */\nexport interface AudioSyncResult {\n  /** Wire version of the payload. */\n  version: number\n  /** The source every offset is measured against (its own offset is 0). */\n  reference: string\n  offsets: AudioSyncOffset[]\n  /** Human-readable warnings: low confidence, measured drift, no shared sound. */\n  notes: string[]\n}\n\nexport interface ApplyEdlInput {\n  /** The edit decision list to render. Media resolves from each `edl.sources[i].url`. */\n  edl: Edl\n  /**\n   * Optional media-URL overrides for `edl.sources[i].url`, POSITIONAL in this\n   * array's order. Each URL is SSRF-guarded server-side like any media the\n   * platform fetches.\n   */\n  sources?: string[]\n  /**\n   * Optional transcript to remap through the cut. The rendered job returns the\n   * remapped transcript on its `json` output. A word-level multi-hour transcript\n   * is several MB — if you only need the re-timed transcript (not a render), use\n   * {@link EditResource.remapTranscript} locally instead of sending it here.\n   */\n  transcript?: Transcript\n  /** Render a full video (default) or an audio-only cut. */\n  output?: \"video\" | \"audio\"\n  /** Fast proxy draft or the final render. Default \"final\". */\n  quality?: \"proxy\" | \"final\"\n  /**\n   * Default crossfade (ms) on boundaries with no explicit transition; 0 = hard\n   * cuts. Per-boundary clamped to the ffmpeg-xfade limit server-side. Default 0.\n   */\n  crossfadeMs?: number\n  /**\n   * The plan clip this render cuts — `edlSpanKey(clip)` from `@nodaro/shared`\n   * (`\"<first inMs>-<last outMs>\"`). The job's result carries it back as\n   * `output_data.clipKey`, so renders of a clip set can be matched to their\n   * clips. Omit for a render of no plan clip.\n   */\n  clipKey?: string\n  /**\n   * The plan value this render cuts — `renderReadBasis(value)` from\n   * `@nodaro/shared` (16 lowercase hex digits), where `value` is the Edit\n   * Plan's Tighten EDL with any review applied, or the clip this render cuts.\n   * The job's result carries it back as `output_data.planBasis`, so a take can\n   * be told apart from one cut from an earlier plan. Send it only when the EDL\n   * you send IS that value (not one an intermediate step re-cut from an older\n   * plan); omit it otherwise. The result's `output_data.renderBasis` (the\n   * render's own settings and sources) is stamped by the server.\n   */\n  planBasis?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * One media source for an edit-plan run. Mirrors the shape the workflow engine\n * sends: a stable `id` (adopted verbatim as the plan's `EdlSource` id), the\n * media `url`, and the `kind`, plus optional per-source annotations the planner\n * honors.\n */\nexport interface EditPlanSource {\n  /** Stable id for this source — becomes the `EdlSource` id in the returned plan. */\n  id: string\n  /** The source's media URL (SSRF-guarded server-side). */\n  url: string\n  /** This source's medium. */\n  kind: \"video\" | \"audio\"\n  /** Role annotation. `\"master-audio\"` marks the clock the plan is reserved on. */\n  role?: \"master-audio\" | \"camera\" | \"wide\" | \"screen\"\n  /** Speaker labels present in this source. */\n  speakers?: string[]\n  /**\n   * This source's origin on the master clock (masterMs = sourceMs + offsetMs).\n   * Set by hand, it wins over a measured offset from `offsets`.\n   */\n  offsetMs?: number\n}\n\nexport interface EditPlanInput {\n  /**\n   * Planning mode. The finished job's `output_data` carries the plan — read it\n   * with {@link unwrapEditPlanOutput}, which also strips the relay's\n   * `viaNodaroCloud` marker:\n   *   - `\"tighten\"`  → an `Edl`.\n   *   - `\"clips\"`    → an {@link EdlClipSet} (`{ version, clips: Edl[] }`);\n   *                    `unwrapEditPlanOutput` returns the bare `Edl[]`.\n   *   - `\"chapters\"` → a {@link ChapterSet} (`{ version, chapters: [...] }`).\n   *   - `\"trailer\"`  → an `Edl` (one short teaser cut from the strongest moments).\n   */\n  mode: EditPlanMode\n  /** Reasoning tier — affects plan quality AND the credit bucket. */\n  planTier: EditPlanTier\n  /** The timed transcript driving the plan. */\n  transcript: Transcript\n  /**\n   * Optional detected silence ranges. Pass the silence-detect JOB'S RESULT —\n   * `getStatus(jobId).data.output_data.json` (a {@link SilenceRanges} object),\n   * NOT the `{ jobId }` that {@link EditResource.silenceDetect} returns. The\n   * planner reads the `ranges` array; an input without one is silently ignored.\n   */\n  silence?: SilenceRanges\n  /** The recording's media sources (1–6). */\n  sources: EditPlanSource[]\n  /**\n   * Multicam: an {@link AudioSyncResult} (the audio-sync job's\n   * `output_data.json`) measured over these same source ids. Each source's\n   * measured offset is written onto its `offsetMs` BEFORE the request, on the\n   * master's clock (the `master-audio` source, else the first) — a source's\n   * own `offsetMs` wins. `editPlan` rejects with a {@link NodaroError}\n   * (`code: \"edit_plan_sources\"`), before any request or charge, when a\n   * source was not measured or matched weakly (confidence < 0.5 — set its\n   * `offsetMs` by hand), or the master was not measured.\n   */\n  offsets?: AudioSyncResult | string\n  /**\n   * The id of the source the transcript was made from, when you know it. The\n   * plan follows the master's clock, so a transcript made from a source that\n   * is off it is rejected the same way.\n   */\n  transcriptSourceId?: string\n  /** Free-text editing steer. */\n  instructions?: string\n  /** Style-guide text applied to the plan. */\n  styleGuide?: string\n  /** `\"clips\"` mode only: how many clips to cut. */\n  count?: number\n  /** `\"clips\"` mode only: target duration per clip, in seconds. */\n  targetDurationSec?: number\n  /** Target aspect for cut clips (`\"clips\"`) or the teaser (`\"trailer\"`). */\n  targetAspect?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:5\"\n  /** Target platform hint (e.g. a social platform name). */\n  platform?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** Input for {@link EditResource.cameraSwitch} (podcast B5). */\nexport interface CameraSwitchInput {\n  /** One EDL — an `editPlan` result (`unwrapEditPlanOutput`), not a clip set. */\n  edl: Edl\n  /** The word transcript WITH speaker labels (transcribe with speaker detection). */\n  transcript: Transcript\n  /** Speaker label → the EDL source id of that speaker's camera. A speaker\n   *  left out shows the source whose `speakers` list names them, else the\n   *  `wide` camera, else any camera that filmed them. */\n  speakerMap?: Record<string, string>\n  /** A {@link EditResource.speakerMap} job's `output_data.json`: a label in `speakerMap`\n   *  wins, then this result, then the n-th speaker heard gets the n-th camera. */\n  speakerMapResult?: SpeakerMapResult | string\n  /** Speaker label → display name (on the segments and the returned transcript). */\n  speakerNames?: Record<string, string>\n  /** The shortest shot in ms (default 2 500): a shorter turn holds the shot. */\n  minShotMs?: number\n  /** Cut this long before the new speaker starts, ms (default 200). */\n  leadMs?: number\n  /** With a `wide` source: break to it after this long on one camera, ms (default 20 000). */\n  maxShotMs?: number\n  /** With a `wide` source: every N-th cut goes to the wide (default 0 = off). */\n  wideEvery?: number\n  /** Overlapping speech → a layout hint (default false; Apply EDL renders cut-only edits). */\n  layoutHints?: boolean\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * The podcast use-case node types, each one a route (`POST /v1/<type>`, and\n * `POST /v1/<type>/continue` to continue one of its runs).\n */\nexport { USE_CASE_NODE_TYPES, type UseCaseNodeType }\n\n/** The route that continues a run of `type`. */\nconst continuePathOf = (type: UseCaseNodeType): `/v1/${UseCaseNodeType}/continue` => `/v1/${type}/continue`\n\n/** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`) and `continueUseCase` answer: the run's job to poll. */\nexport interface UseCaseJobResult extends EditJobResult {\n  /** The run's execution (absent on a deduplicated retry). */\n  executionId?: string\n  /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */\n  deduped?: boolean\n}\n\n/** What `tightenEpisode` answers (a {@link UseCaseJobResult}). */\nexport type TightenEpisodeJobResult = UseCaseJobResult\n\n/**\n * What a use-case run is estimated at (`data`). Every credit amount is 0\n * on an edition without credits; `durationSec` is `null` when the recording's\n * length could not be read.\n */\nexport interface UseCaseEstimate {\n  /** The whole run: its steps plus the fee. */\n  totalCredits: number\n  /** The steps at their own rates. */\n  stepsCredits: number\n  /** The per-run fee. */\n  feeCredits: number\n  /** The recording's length, in seconds. */\n  durationSec: number | null\n}\n\n/** What a Tighten Episode run is estimated at (a {@link UseCaseEstimate}). */\nexport type TightenEpisodeEstimate = UseCaseEstimate\n\n/** Input for {@link EditResource.continueUseCase}. */\nexport interface UseCaseContinueInput {\n  /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer` or `clipPack` (or an earlier continuation) answered. */\n  jobId: string\n  /**\n   * `\"from-failed\"` re-runs what did not finish of a failed run;\n   * `\"render-final\"` renders the full-quality result after a review-on preview\n   * (a Chapters run has no preview: it is refused `render_final_not_preview`;\n   * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).\n   */\n  mode: \"from-failed\" | \"render-final\"\n  /** Render final only: the reviewer's edit of the plan (an EDL). */\n  editedEdl?: unknown\n  /**\n   * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.\n   * Optional: when absent the job is read first (`GET /v1/jobs/:id`, which\n   * needs the `jobs:read` scope on an app token) for the type the run records.\n   * Required when that read cannot answer: a key without `jobs:read`, or a job\n   * that records no use-case type (the call rejects with `use_case_type_unknown`).\n   */\n  nodeType?: UseCaseNodeType\n}\n\n/** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, and their continuations). */\nexport interface UseCaseRequestOptions {\n  /**\n   * Sent as the `Idempotency-Key` header. Reuse the same value when retrying\n   * the same request and the server answers the run it already started\n   * (`deduped: true`) instead of starting a second one.\n   */\n  idempotencyKey?: string\n}\n\nfunction idempotencyHeaders(options?: UseCaseRequestOptions): { headers?: Record<string, string> } {\n  return options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}\n}\n\n/**\n * Editorial primitives for podcast / long-form video editing, single-camera\n * and multicam: measure the cameras' offsets ({@link audioSync}), plan the cut\n * ({@link editPlan}), put each cut on the speaker's camera\n * ({@link cameraSwitch}), render a Preview to review (`applyEdl` with\n * `quality: \"proxy\"`), then the final (`quality: \"final\"`).\n *\n * - {@link silenceDetect}, {@link audioSync} and {@link applyEdl} are core nodes\n *   available on every edition.\n * - {@link editPlan} and {@link cameraSwitch} run on nodaro.ai; a self-hosted\n *   install relays them once it is connected (a 503\n *   `code: \"nodaro_connection_required\"` otherwise).\n * - {@link tightenEpisode} runs the whole chain (transcribe, plan, render, and\n *   optionally captions, music and framing) in one call. It is core, but a\n *   self-hosted install needs a nodaro.ai connection for the steps that run\n *   there (a 503 `code: \"nodaro_connection_required\"` otherwise).\n *   {@link continueUseCase} continues one of its runs.\n * - {@link episodeChapters} lists a recording's chapters (transcribe, then the\n *   plan in chapters mode) in one call; nothing renders. Like\n *   {@link tightenEpisode}, a self-hosted install needs a nodaro.ai connection.\n * - {@link episodeTrailer} cuts a 20–40 s trailer of a recording and delivers\n *   it in each chosen format in one call; the same connection applies.\n * - {@link clipPack} cuts a recording into a pack of short clips (framed and\n *   captioned by default) in one call; the same connection applies.\n * - {@link remapTranscript} is a PURE local transform (no request) — the same\n *   remap `applyEdl` performs on its `transcript`, exposed for callers that hold\n *   an EDL and a transcript and only want the re-timed transcript.\n *\n * Every request method except the estimates ({@link estimateTightenEpisode},\n * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},\n * {@link estimateClipPack}: a quote, `{ data }`) returns\n * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the\n * `jobId` with `client.jobs.getStatus(jobId)`.\n */\nexport class EditResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Detect silence ranges in an audio/video source (`POST /v1/silence-detect`).\n   * Keyless — one ffmpeg pass over the source's audio proxy.\n   */\n  silenceDetect(input: SilenceDetectInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/silence-detect\", {\n      body: {\n        audioUrl: input.audioUrl,\n        ...(input.thresholdDb !== undefined ? { thresholdDb: input.thresholdDb } : {}),\n        ...(input.minSilenceMs !== undefined ? { minSilenceMs: input.minSilenceMs } : {}),\n        ...(input.padMs !== undefined ? { padMs: input.padMs } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Measure how far apart the clocks of 2–6 recordings of one conversation are\n   * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one\n   * ffmpeg decode per source. The finished job's `output_data.json` is an\n   * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6\n   * sources, a repeated id, a `reference` that is not one of the ids) throws a\n   * typed `NodaroError` (400, `code: \"validation_error\"`) before any credits\n   * are reserved.\n   */\n  audioSync(input: AudioSyncInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/audio-sync\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url })),\n        ...(input.reference !== undefined ? { reference: input.reference } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Which camera each speaker is on, from the cameras' own microphones (`POST\n   * /v1/speaker-map`), keyless. `output_data.json` is a `SpeakerMapResult`: pass\n   * it to {@link cameraSwitch} as `speakerMapResult`. A malformed request throws\n   * a `NodaroError` (400 `validation_error`; 422 `no_speakers` for a transcript\n   * with no speaker labels) before any credits are reserved.\n   */\n  speakerMap(input: SpeakerMapInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/speaker-map\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url, ...(s.kind ? { kind: s.kind } : {}) })),\n        transcript: input.transcript,\n        ...(input.offsets !== undefined ? { offsets: input.offsets } : {}),\n        ...(input.masterSourceId !== undefined ? { masterSourceId: input.masterSourceId } : {}),\n        ...(input.wideSourceId !== undefined ? { wideSourceId: input.wideSourceId } : {}),\n        ...(input.marginDb !== undefined ? { marginDb: input.marginDb } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).\n   * The EDL is validated at ingress — an unresolvable source or a picture-less\n   * segment on a video edit throws a typed `NodaroError` (400, `code:\n   * \"invalid_edl\"`) before any credits are reserved.\n   */\n  applyEdl(input: ApplyEdlInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/apply-edl\", {\n      body: {\n        edl: input.edl,\n        ...(input.sources !== undefined ? { sources: input.sources } : {}),\n        ...(input.transcript !== undefined ? { transcript: input.transcript } : {}),\n        ...(input.output !== undefined ? { output: input.output } : {}),\n        ...(input.quality !== undefined ? { quality: input.quality } : {}),\n        ...(input.crossfadeMs !== undefined ? { crossfadeMs: input.crossfadeMs } : {}),\n        ...(input.clipKey !== undefined ? { clipKey: input.clipKey } : {}),\n        ...(input.planBasis !== undefined ? { planBasis: input.planBasis } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording\n   * in one call — transcribe, cut the silences and filler, render, with\n   * optional captions, music and framing. Answers the run's job to poll; its\n   * `output_data` holds the episode. The run is priced as its steps at their own\n   * rates plus the listed per-run fee. Quote it first with\n   * {@link estimateTightenEpisode}.\n   */\n  tightenEpisode(input: TightenEpisodeInput, options?: UseCaseRequestOptions): Promise<TightenEpisodeJobResult> {\n    return this.client.request(\"POST\", \"/v1/tighten-episode\", { body: tightenBody(input), ...idempotencyHeaders(options) })\n  }\n\n  /**\n   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The estimate leans high: the render is priced at the recording's\n   * full length, while the charge follows the minutes actually rendered.\n   */\n  estimateTightenEpisode(input: TightenEpisodeInput): Promise<{ data: TightenEpisodeEstimate }> {\n    return this.client.request(\"POST\", \"/v1/tighten-episode/estimate\", { body: tightenBody(input) })\n  }\n\n  /**\n   * Chapters (`POST /v1/episode-chapters`): transcribe a recording and list its\n   * chapters in one call. Answers the run's job to poll; the finished job's\n   * `output_data.text` is the list as show notes (one `0:00 Title` line per\n   * chapter; once a chapter starts at 1:00:00 or later, every line is\n   * `H:MM:SS`), `output_data.json` the list itself (`{ startMs, title }[]`, the\n   * same rows; the first starts at 0). A run that finds no chapters fails,\n   * and its fee is refunded. Priced as its steps at their own rates plus the\n   * listed per-run fee; quote it first with {@link estimateEpisodeChapters}.\n   */\n  episodeChapters(input: EpisodeChaptersInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return this.client.request(\"POST\", \"/v1/episode-chapters\", { body: chaptersBody(input), ...idempotencyHeaders(options) })\n  }\n\n  /**\n   * What a Chapters run is estimated at (`POST /v1/episode-chapters/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. A recording whose length cannot be read is estimated at the\n   * 180-minute ceiling.\n   */\n  estimateEpisodeChapters(input: EpisodeChaptersInput): Promise<{ data: UseCaseEstimate }> {\n    return this.client.request(\"POST\", \"/v1/episode-chapters/estimate\", { body: chaptersBody(input) })\n  }\n\n  /**\n   * Trailer (`POST /v1/episode-trailer`): cut a 20–40 s trailer of a recording\n   * and deliver it in each chosen format (padded, never cropped), optionally\n   * after an intro card, in one call. The finished job's `output_data.formats`\n   * is `{ format, url }[]` in format order, the first also `output_data.videoUrl`;\n   * a format that failed is named in `output_data.failedFormats` (the run keeps\n   * the others). With `reviewBeforeRender` the run stops at a preview\n   * (`videoUrl`, no formats yet). Priced as its steps at their own rates plus\n   * the listed per-run fee; quote it first with {@link estimateEpisodeTrailer}.\n   */\n  episodeTrailer(input: EpisodeTrailerInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return this.client.request(\"POST\", \"/v1/episode-trailer\", { body: trailerBody(input), ...idempotencyHeaders(options) })\n  }\n\n  /**\n   * What a Trailer run is estimated at (`POST /v1/episode-trailer/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The trailer is quoted at 40 seconds, the longest trailer the\n   * plan cuts; a Render final is quoted on the trailer the run cut (with the\n   * review's edits), plus the intro card.\n   */\n  estimateEpisodeTrailer(input: EpisodeTrailerInput): Promise<{ data: UseCaseEstimate }> {\n    return this.client.request(\"POST\", \"/v1/episode-trailer/estimate\", { body: trailerBody(input) })\n  }\n\n  /**\n   * Clip Pack (`POST /v1/clip-pack`): cut a recording into a pack of short\n   * clips in one call — the plan finds the best moments (`count`, default 8,\n   * of about `targetDurationSec`, default 60), each is rendered (framed 9:16\n   * with the speakers stacked by default; `framing: null` keeps the\n   * recording's shape) and captioned. An audio recording makes audio clips.\n   * The finished job's `output_data.clips` is `{ url, title?, hook?, clipKey,\n   * thumbnailUrl?, captionsFailed? }[]` in plan order, the first also\n   * `output_data.videoUrl` (`audioUrl` for audio clips). Every clip is tried:\n   * one that cannot be rendered is skipped, not charged and counted on\n   * `failedClips` (the pack keeps the others and its fee); a clip whose\n   * captions failed comes uncaptioned (`captionsFailed`, counted on\n   * `failedCaptions`). When no clip renders the run fails and its fee is\n   * refunded. With `reviewBeforeRender` the run stops at previews; Render\n   * final ({@link continueUseCase}) renders only the clips the edit keeps.\n   * Priced as its steps at their own rates plus the listed per-run fee;\n   * quote it first with {@link estimateClipPack}.\n   */\n  clipPack(input: ClipPackInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return this.client.request(\"POST\", \"/v1/clip-pack\", { body: clipPackBody(input), ...idempotencyHeaders(options) })\n  }\n\n  /**\n   * What a Clip Pack run is estimated at (`POST /v1/clip-pack/estimate`): its\n   * steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. Each clip is quoted at twice the target length (the plan may cut\n   * a clip longer than asked); the charge follows each clip's real length.\n   */\n  estimateClipPack(input: ClipPackInput): Promise<{ data: UseCaseEstimate }> {\n    return this.client.request(\"POST\", \"/v1/clip-pack/estimate\", { body: clipPackBody(input) })\n  }\n\n  /**\n   * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the\n   * run's own type: `input.nodeType`, else the type the job records, read with\n   * `GET /v1/jobs/:id`; when that read cannot tell, this rejects with a\n   * `NodaroError` coded `use_case_type_unknown` — pass `nodeType` then):\n   * `\"from-failed\"` keeps the steps that finished and runs the rest (the fee\n   * is held again; the failed run's was refunded);\n   * `\"render-final\"` renders the full-quality result after a review-on preview,\n   * with the preview's settings and no fee. A refusal that names another job\n   * (`already_running`, `continuation_superseded`,\n   * `render_final_already_rendered`) throws a `ContinuationRefusedError`\n   * carrying that `jobId`.\n   */\n  async continueUseCase(input: UseCaseContinueInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    if (input.nodeType !== undefined && !isUseCaseNodeType(input.nodeType)) {\n      throw new NodaroError(\n        `continueUseCase: nodeType \"${String(input.nodeType)}\" is not a use-case node type (${USE_CASE_NODE_TYPES.join(\", \")})`,\n        \"invalid_node_type\",\n        400,\n      )\n    }\n    const type = input.nodeType ?? (await this.runTypeOf(input.jobId))\n    return this.client.request(\"POST\", continuePathOf(type), {\n      body: { jobId: input.jobId, mode: input.mode, ...(input.editedEdl !== undefined ? { editedEdl: input.editedEdl } : {}) },\n      ...idempotencyHeaders(options),\n    })\n  }\n\n  /**\n   * The use-case type a run records (`input_data.type`, else its `job_type`).\n   * When the key lacks the `jobs:read` scope (403 naming that scope) or the job\n   * names no use-case type, the type cannot be read: this rejects with a\n   * `NodaroError` (`use_case_type_unknown`, 400) asking for `nodeType`, and\n   * nothing is posted (decided 2026-10-18: no route is guessed for the run).\n   * Any other failure of the read, any other 403 included, is thrown as is.\n   */\n  private async runTypeOf(jobId: string): Promise<UseCaseNodeType> {\n    const unknown = () =>\n      new NodaroError(\"continueUseCase: the run's node type cannot be read — pass nodeType\", \"use_case_type_unknown\", 400)\n    let row: { job_type?: unknown; input_data?: unknown } | undefined\n    try {\n      row = (await this.client.request<{ data?: { job_type?: unknown; input_data?: unknown } }>(\"GET\", `/v1/jobs/${encodeURIComponent(jobId)}`)).data\n    } catch (err) {\n      if (err instanceof ForbiddenError && err.missingScope === \"jobs:read\") throw unknown()\n      throw err\n    }\n    const input = row?.input_data\n    const recorded = input && typeof input === \"object\" && !Array.isArray(input) ? (input as { type?: unknown }).type : undefined\n    const type = typeof recorded === \"string\" && recorded.length > 0 ? recorded : row?.job_type\n    if (!isUseCaseNodeType(type)) throw unknown()\n    return type\n  }\n\n  /**\n   * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed\n   * transcript (plus optional silence ranges) and the media sources, and plans\n   * the edit. The finished job's `output_data` holds the plan: an `Edl`\n   * (`\"tighten\"` or `\"trailer\"`), an {@link EdlClipSet} (`\"clips\"`), or a\n   * {@link ChapterSet} (`\"chapters\"`) — normalize it with {@link unwrapEditPlanOutput}.\n   *\n   * On a self-hosted install the request relays to nodaro.ai and needs the\n   * install connected (a 503 `code: \"nodaro_connection_required\"` otherwise);\n   * on nodaro.ai it runs directly.\n   */\n  editPlan(input: EditPlanInput): Promise<EditJobResult> {\n    // The same pre-dispatch check the canvas and MCP run (B4): the server never\n    // sees `offsets` — they are written onto the sources here.\n    const planned = resolveEditPlanSources(input.sources, {\n      offsets: input.offsets,\n      transcriptSourceId: input.transcriptSourceId,\n    })\n    if (!planned.ok) {\n      const message = planned.issues.map((issue) => describeAudioSyncOffsetIssue(issue)).join(\"; \")\n      return Promise.reject(new NodaroError(`editPlan: ${message}`, \"edit_plan_sources\", 400))\n    }\n    const transcript = planned.transcriptSourceId\n      ? { ...input.transcript, sourceId: planned.transcriptSourceId }\n      : input.transcript\n    return this.client.request(\"POST\", \"/v1/edit-plan\", {\n      body: {\n        mode: input.mode,\n        planTier: input.planTier,\n        transcript,\n        sources: planned.sources,\n        ...(input.silence !== undefined ? { silence: input.silence } : {}),\n        ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n        ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n        ...(input.count !== undefined ? { count: input.count } : {}),\n        ...(input.targetDurationSec !== undefined ? { targetDurationSec: input.targetDurationSec } : {}),\n        ...(input.targetAspect !== undefined ? { targetAspect: input.targetAspect } : {}),\n        ...(input.platform !== undefined ? { platform: input.platform } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`\n   * by who is speaking — the sound never changes. Cloud edition; a flat\n   * price. The finished job's `output_data.json` is the switched EDL (feed it\n   * to {@link applyEdl}) and `output_data.transcript` the transcript with\n   * `speakerNames` applied. A transcript with no speaker labels rejects with\n   * a {@link NodaroError} (`code: \"no_speakers\"`) before any request or charge.\n   */\n  cameraSwitch(input: CameraSwitchInput): Promise<EditJobResult> {\n    if (transcriptSpeakerLabels(input.transcript).length === 0) {\n      return Promise.reject(new NodaroError(\n        \"cameraSwitch: the transcript has no speaker labels — transcribe with speaker detection on\",\n        \"no_speakers\",\n        422,\n      ))\n    }\n    const result = input.speakerMapResult\n    if (result !== undefined && !speakerMapResultOf(result)) return Promise.reject(new NodaroError(\"cameraSwitch: speakerMapResult is not a Speaker Map result — pass that job's output_data.json\", \"not_a_speaker_map\", 400))\n    const speakerMap = result !== undefined ? cameraSwitchSpeakerMap({ speakerMap: input.speakerMap }, input.edl, input.transcript, { speakerMap: result }) : input.speakerMap\n    return this.client.request(\"POST\", \"/v1/camera-switch\", {\n      body: {\n        edl: input.edl,\n        transcript: input.transcript,\n        ...(speakerMap !== undefined ? { speakerMap } : {}),\n        ...(input.speakerNames !== undefined ? { speakerNames: input.speakerNames } : {}),\n        ...(input.minShotMs !== undefined ? { minShotMs: input.minShotMs } : {}),\n        ...(input.leadMs !== undefined ? { leadMs: input.leadMs } : {}),\n        ...(input.maxShotMs !== undefined ? { maxShotMs: input.maxShotMs } : {}),\n        ...(input.wideEvery !== undefined ? { wideEvery: input.wideEvery } : {}),\n        ...(input.layoutHints !== undefined ? { layoutHints: input.layoutHints } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Remap a transcript through an EDL — a PURE client-side transform (NO\n   * request). Returns a new transcript whose word (and segment) timings are on\n   * the EDL's rendered output clock, dropping words that fall in cut regions and\n   * clipping straddlers. Runs `@nodaro/shared`'s canonical\n   * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.\n   */\n  remapTranscript(edl: Edl, transcript: Transcript): Transcript {\n    return remapTranscriptThroughEdl(edl, transcript)\n  }\n}\n"]}

package/dist/chunk-I6CXC345.js

@@ -0,0 +1,102 @@
+import { readSseStream } from './chunk-JMOKD6ZP.js';
+
+// src/resources/copilot.ts
+var COPILOT_FRAME_TYPES = /* @__PURE__ */ new Set([
+  "metadata",
+  "token",
+  "tool_call",
+  "workflow_updated",
+  "workflow_created",
+  "run_proposed",
+  "memory_saved",
+  "usage",
+  "done",
+  "error"
+]);
+function isCopilotFrame(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const type = value.type;
+  return typeof type === "string" && COPILOT_FRAME_TYPES.has(type);
+}
+var CopilotResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on
+   * a workflow the server creates from `prompt`. Re-opening a workflow that
+   * already has an active thread answers THAT thread rather than a second one.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/copilot/threads", { body: input });
+  }
+  /**
+   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),
+   * or `null` when the user has none open on it.
+   */
+  list(params) {
+    return this.client.request("GET", "/v1/copilot/threads", { query: { workflowId: params.workflowId } });
+  }
+  /**
+   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads
+   * only what followed that sequence number (the panel's catch-up); `limit`
+   * caps the page at the server's own ceiling.
+   */
+  get(id, opts = {}) {
+    return this.client.request("GET", `/v1/copilot/threads/${encodeURIComponent(id)}`, {
+      query: { ...opts.after !== void 0 ? { after: opts.after } : {}, ...opts.limit !== void 0 ? { limit: opts.limit } : {} }
+    });
+  }
+  /**
+   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not
+   * deletion — the messages stay readable. Refused while a turn is running.
+   */
+  archive(id) {
+    return this.client.request("DELETE", `/v1/copilot/threads/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the
+   * turn it asked to stop; the turn's own stream ends with a `done` frame.
+   */
+  cancel(id) {
+    return this.client.request("POST", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`);
+  }
+  /**
+   * Send one message and iterate the turn's frames
+   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).
+   *
+   * Deliberately NOT routed through `client.request`: that path arms an abort
+   * timer around the whole exchange, and a turn legitimately runs for minutes —
+   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller
+   * owns the lifetime instead: pass `signal` to end the stream, or stop
+   * iterating (the reader cancels the body, which ends the request).
+   *
+   * A frame kind this package does not model is skipped rather than thrown, so
+   * a newer server cannot break an older caller.
+   */
+  async *stream(threadId, opts) {
+    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...token ? { Authorization: `Bearer ${token}` } : {}
+      },
+      body: JSON.stringify({
+        message: opts.message,
+        ...opts.baseVersion !== void 0 ? { baseVersion: opts.baseVersion } : {},
+        ...opts.tier ? { tier: opts.tier } : {}
+      }),
+      signal: opts.signal
+    });
+    for await (const value of readSseStream(res, { label: "copilot stream" })) {
+      if (isCopilotFrame(value)) yield value;
+    }
+  }
+};
+
+export { CopilotResource };
+//# sourceMappingURL=chunk-I6CXC345.js.map
+//# sourceMappingURL=chunk-I6CXC345.js.map

package/dist/chunk-I6CXC345.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/copilot.ts"],"names":[],"mappings":"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","file":"chunk-I6CXC345.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { readSseStream } from \"../sse.js\"\n\n/**\n * The assistant's conversation surface (`/v1/copilot/*`) — threads, and one\n * turn as a live stream.\n *\n * A thread is the conversation; a TURN is one message and everything the\n * assistant does in answer to it. `stream` is the only method that spends: it\n * POSTs the message and yields the turn's frames as they arrive, so a caller\n * renders prose, tool activity and proposals live instead of waiting for a\n * finished answer.\n *\n * Two shapes here are deliberately TOLERANT of a deployment that predates a\n * field, because the SDK ships ahead of every instance it talks to:\n *  - `surface` is optional on both {@link CopilotThread} and the `metadata`\n *    frame — absent is a value (\"this deployment does not say\"), never a\n *    default this package invents.\n *  - An event kind this package does not model is IGNORED, not thrown: a\n *    newer server may emit frames a caller was built before.\n */\n\n/** How this thread runs what it proposes: ask first, or run within a budget. */\nexport type CopilotRunMode = \"ask\" | \"auto\"\n\n/** The thread's model rung. Absent from a server that predates it. */\nexport type CopilotModelTier = \"economy\" | \"standard\" | \"premium\"\n\n/**\n * Which product the conversation belongs to.\n *\n * NO deployment sends this today — nothing in the platform emits it yet — and\n * it is typed here so that the day one does, a caller reads what the server\n * said. That is why it is OPTIONAL everywhere it appears: absent is a value\n * (\"this deployment does not say\"), never a default this package invents.\n */\nexport type CopilotSurface = \"studio\" | \"workflow\"\n\nexport interface CopilotThread {\n  id: string\n  workflowId: string\n  runMode: CopilotRunMode\n  /** See {@link CopilotSurface} — absent means the server did not say. */\n  surface?: CopilotSurface\n  /** Whether this thread may build nodes that publish to connected accounts. */\n  allowPublishing?: boolean\n  modelTier?: CopilotModelTier\n  autoRunLimitCredits: number\n  userTurnCount: number\n  lastMessageAt: string | null\n  createdAt: string\n  /** Only on {@link CopilotResource.get} — derived from a live turn. */\n  status?: \"running\" | \"idle\"\n  activeTurnId?: string | null\n}\n\n/** The workflow a thread was opened on, as `create` answers it. */\nexport interface CopilotThreadWorkflow {\n  id: string\n  projectId: string\n  name: string\n  version: number\n}\n\nexport type CopilotMessagePart =\n  | { kind: \"text\"; text: string }\n  | { kind: \"tool_call\"; id: string; name: string; label: string; status: \"finished\" | \"failed\" }\n\nexport interface CopilotMessage {\n  id: string\n  seq: number\n  turnId: string\n  role: \"user\" | \"assistant\"\n  createdAt: string\n  parts: CopilotMessagePart[]\n}\n\n/** Open a thread on an existing workflow, or on one this call creates. */\nexport interface CreateCopilotThreadInput {\n  /** The workflow to work on. Give this OR `prompt`. */\n  workflowId?: string\n  /** Start from nothing: the server creates a workflow seeded by this prompt. */\n  prompt?: string\n  /** Name for a workflow created by `prompt` (defaults to the prompt's head). */\n  name?: string\n}\n\nexport interface CopilotStreamOptions {\n  /** The user's turn. */\n  message: string\n  /** The workflow version this message was composed against — a newer one 409s. */\n  baseVersion?: number\n  /** The composer's echo of the thread's rung; the thread row stays authoritative. */\n  tier?: CopilotModelTier\n  /**\n   * Ends the stream. The client's request timeout is NOT applied to a turn.\n   *\n   * Aborting REJECTS the iteration — with the platform's raw `AbortError`, not\n   * a `NodaroError` — whether it fires before the first frame or between two of\n   * them. Wrap the loop in `try`/`catch` if a cancelled turn is an ordinary\n   * ending in your UI. (`media.downloadVideoProgress` behaves the same way.)\n   */\n  signal?: AbortSignal\n}\n\nexport interface CopilotToolCallFrameData {\n  id: string\n  name: string\n  label: string\n  status: \"started\" | \"finished\" | \"failed\"\n  summary?: string\n}\n\nexport interface CopilotWorkflowUpdateFrameData {\n  workflowId: string\n  version: number\n  updatedAt?: string\n  note?: string | null\n  addedNodeIds: string[]\n  updatedNodeIds: string[]\n  removedNodeIds: string[]\n  addedNodeTypes: string[]\n  nodeCount: number\n  edgeCount: number\n  adjustments: string[]\n}\n\n/** A file the turn wired onto a node — named on the run card, never counted. */\nexport interface CopilotWiredAsset {\n  id: string\n  kind: string\n  filename: string\n  nodeId: string\n}\n\nexport interface CopilotRunProposalNode {\n  id: string\n  type: string\n  graphVersion: number\n  label: string\n}\n\nexport interface CopilotRunProposalFrameData {\n  workflowId: string\n  addedNodeTypes: string[]\n  wiredAssets?: CopilotWiredAsset[]\n  note: string | null\n  /** Present when ONE node was proposed rather than the whole graph. */\n  node?: CopilotRunProposalNode | null\n}\n\n/** A workflow the turn created — a different one from the open canvas. */\nexport interface CopilotWorkflowCreatedFrameData {\n  workflowId: string\n  name: string\n  projectId: string\n}\n\n/** One thing the assistant saved to memory this turn. */\nexport interface CopilotMemorySavedFrameData {\n  id: string\n  content: string\n}\n\nexport interface CopilotMetadataFrameData {\n  threadId: string\n  turnId: string\n  jobId: string\n  model: string\n  baseVersion: number | null\n  runMode: CopilotRunMode\n  autoRunLimitCredits: number\n  allowPublishing?: boolean\n  modelTier?: CopilotModelTier\n  /** See {@link CopilotSurface} — absent means the server did not say. */\n  surface?: CopilotSurface\n}\n\n/**\n * One frame of a turn.\n *\n * The union covers the frame KINDS; a frame's `data` is passed through\n * untouched, so a field this package does not model still reaches the caller\n * rather than being stripped on the way.\n */\nexport type CopilotStreamFrame =\n  | { type: \"metadata\"; data: CopilotMetadataFrameData }\n  | { type: \"token\"; data: { text: string } }\n  | { type: \"tool_call\"; data: CopilotToolCallFrameData }\n  | { type: \"workflow_updated\"; data: CopilotWorkflowUpdateFrameData }\n  | { type: \"workflow_created\"; data: CopilotWorkflowCreatedFrameData }\n  | { type: \"run_proposed\"; data: CopilotRunProposalFrameData }\n  | { type: \"memory_saved\"; data: CopilotMemorySavedFrameData }\n  | { type: \"usage\"; data: { inputTokens: number; outputTokens: number; cacheReadTokens: number; creditsCharged: number | null } }\n  | { type: \"done\"; data: { turnId: string; messageId: string | null; status: \"completed\" | \"capped\" | \"cancelled\"; finalVersion: number | null } }\n  | { type: \"error\"; data: { code: string; message: string } }\n\n/** The kinds above, as the wire spells them — the whole of what `stream` yields. */\nconst COPILOT_FRAME_TYPES: ReadonlySet<string> = new Set([\n  \"metadata\",\n  \"token\",\n  \"tool_call\",\n  \"workflow_updated\",\n  \"workflow_created\",\n  \"run_proposed\",\n  \"memory_saved\",\n  \"usage\",\n  \"done\",\n  \"error\",\n])\n\nfunction isCopilotFrame(value: unknown): value is CopilotStreamFrame {\n  if (typeof value !== \"object\" || value === null) return false\n  const type = (value as { type?: unknown }).type\n  return typeof type === \"string\" && COPILOT_FRAME_TYPES.has(type)\n}\n\nexport class CopilotResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on\n   * a workflow the server creates from `prompt`. Re-opening a workflow that\n   * already has an active thread answers THAT thread rather than a second one.\n   */\n  create(input: CreateCopilotThreadInput): Promise<{ data: { thread: CopilotThread; workflow: CopilotThreadWorkflow } }> {\n    return this.client.request(\"POST\", \"/v1/copilot/threads\", { body: input })\n  }\n\n  /**\n   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),\n   * or `null` when the user has none open on it.\n   */\n  list(params: { workflowId: string }): Promise<{ data: { thread: CopilotThread | null } }> {\n    return this.client.request(\"GET\", \"/v1/copilot/threads\", { query: { workflowId: params.workflowId } })\n  }\n\n  /**\n   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads\n   * only what followed that sequence number (the panel's catch-up); `limit`\n   * caps the page at the server's own ceiling.\n   */\n  get(\n    id: string,\n    opts: { after?: number; limit?: number } = {},\n  ): Promise<{ data: { thread: CopilotThread; messages: CopilotMessage[] } }> {\n    return this.client.request(\"GET\", `/v1/copilot/threads/${encodeURIComponent(id)}`, {\n      query: { ...(opts.after !== undefined ? { after: opts.after } : {}), ...(opts.limit !== undefined ? { limit: opts.limit } : {}) },\n    })\n  }\n\n  /**\n   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not\n   * deletion — the messages stay readable. Refused while a turn is running.\n   */\n  archive(id: string): Promise<{ data: { archived: true } }> {\n    return this.client.request(\"DELETE\", `/v1/copilot/threads/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the\n   * turn it asked to stop; the turn's own stream ends with a `done` frame.\n   */\n  cancel(id: string): Promise<{ data: { cancelling: true; turnId: string } }> {\n    return this.client.request(\"POST\", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`)\n  }\n\n  /**\n   * Send one message and iterate the turn's frames\n   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).\n   *\n   * Deliberately NOT routed through `client.request`: that path arms an abort\n   * timer around the whole exchange, and a turn legitimately runs for minutes —\n   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller\n   * owns the lifetime instead: pass `signal` to end the stream, or stop\n   * iterating (the reader cancels the body, which ends the request).\n   *\n   * A frame kind this package does not model is skipped rather than thrown, so\n   * a newer server cannot break an older caller.\n   */\n  async *stream(threadId: string, opts: CopilotStreamOptions): AsyncGenerator<CopilotStreamFrame, void, undefined> {\n    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`\n    const token = await this.client.auth.getToken()\n    const res = await this.client.fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(token ? { Authorization: `Bearer ${token}` } : {}),\n      },\n      body: JSON.stringify({\n        message: opts.message,\n        ...(opts.baseVersion !== undefined ? { baseVersion: opts.baseVersion } : {}),\n        ...(opts.tier ? { tier: opts.tier } : {}),\n      }),\n      signal: opts.signal,\n    })\n    for await (const value of readSseStream<unknown>(res, { label: \"copilot stream\" })) {\n      if (isCopilotFrame(value)) yield value\n    }\n  }\n}\n"]}

package/dist/chunk-IGOPUMEX.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-IGOPUMEX.cjs.map
+//# sourceMappingURL=chunk-IGOPUMEX.cjs.map

package/dist/chunk-IGOPUMEX.cjs.map

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