@nodaro/shared 2.15.0 → 2.17.0

package/src/model-constants.ts

@@ -211,16 +211,18 @@ export const TTS_TEXT_MAX = 5000
 
 /**
  * Per-model Text-to-Speech character cap (PER REQUEST), from official ElevenLabs
- * docs. turbo/multilingual accept FAR more than the old flat 5000; v3 uses the
- * conservative 3000 (official pages say 5000 but the API is widely reported to
- * hard-limit v3 at 3000 — conservative avoids prod rejections). Absent →
- * {@link TTS_TEXT_MAX}.
+ * docs. turbo/multilingual accept FAR more than the old flat 5000; v3 matches
+ * the official 5000 (probed live 2026-08-30: 4,500 AND 5,200 chars both
+ * returned 200 — the old "API hard-limits v3 at 3000" report no longer holds).
+ * Dialogue's documented 2,000 is a recommendation, not a limit (2,500 and
+ * 5,000 total chars both probed 200); we cap at 5000 like v3 — same model
+ * underneath. Absent → {@link TTS_TEXT_MAX}.
  */
 export const MAX_TTS_CHARS_BY_PROVIDER: Record<string, number> = {
   "elevenlabs-turbo": 40000,        // == eleven_flash_v2_5 (functionally equivalent)
   "elevenlabs-multilingual": 10000, // eleven_multilingual_v2
-  "elevenlabs-v3": 3000,            // conservative (official 5000 / API-reported 3000)
-  "elevenlabs-dialogue": 2000,      // text-to-dialogue recommended per-request max
+  "elevenlabs-v3": 5000,            // official cap (probed: 5,200 chars accepted; keep the clamp)
+  "elevenlabs-dialogue": 5000,      // total across lines; ≤2,000 recommended for best quality
 }
 
 /** Max TTS text length (chars) for a provider: verified override, else {@link TTS_TEXT_MAX}. */

package/src/model-tree.ts

@@ -62,6 +62,7 @@ const MODE_TO_NODE: Readonly<Partial<Record<ModelMode, string>>> = {
   "lip-sync": "lip-sync", "tts": "text-to-speech", "sfx": "text-to-audio",
   "music": "suno-generate", "voice-design": "voice-design", "voice-changer": "voice-changer",
   "isolation": "audio-isolation", "dubbing": "dubbing", "forced-alignment": "forced-alignment", "stt": "transcribe",
+  "dialogue": "text-to-dialogue",
   "video-analysis": "video-analysis",
 }
 

package/src/producer-types.ts

@@ -130,6 +130,12 @@ export const DYNAMIC_PRODUCER_TYPES: ReadonlySet<string> = new Set([
   // EVERY producer set or its outputs can't connect (was the "cannot connect
   // the outputs of voice-changer-pro" bug). Guarded by producer-types.test.ts.
   "voice-changer-pro",
+  // Dubbing joined the dual-mode family with the full-surface upgrade:
+  // audio in → dubbed audio; video in (or a video sourceUrl) → dubbed VIDEO
+  // (+ audio sidecar). Same wiring contract as voice-changer; stays in
+  // AUDIO_PRODUCER_TYPES as its default. Explicitly asserted in
+  // producer-types.test.ts (the suite does not fail on omission).
+  "dubbing",
   "reduce",
   // Dual-output time chunker (UI label "Split into Chunks"; type id stays
   // "split-media"): video in → video chunks, audio in → audio chunks — two

package/src/to-connected-references.ts

@@ -12,7 +12,7 @@ import { locationMentionSlug } from "./location-mention-slug.js"
 export interface EntityReferenceInput {
   /** The entity row id. */
   readonly id: string
-  readonly kind: "character" | "location" | "creature"
+  readonly kind: "character" | "location" | "creature" | "image"
   /** Display name — the slug is derived from this. */
   readonly name: string
   /** Resolved thumbnail/source URL; null/undefined → "" (placeholder-safe). */
@@ -30,7 +30,9 @@ export interface EntityReferenceInput {
  * `locationMentionSlug`), creature → `wired-creature` (no mention-slug machinery
  * — like `wired-object`, a bound creature AUTO-ATTACHES and gets a canonical-style
  * creature/animal-subject directive with zero typing; `{image:N:creature}` tokens
- * also resolve against it). Canonical-description fields are null here (a binding
+ * also resolve against it), image → `wired-image` (a plain media reference; it
+ * AUTO-ATTACHES, and an `@<name-slug>:<index>[:<role>]` mention re-seats it at the
+ * position it was typed). Canonical-description fields are null here (a binding
  * captures only name+variant; the picker/full-row path supplies descriptions).
  */
 export function toConnectedReference(entity: EntityReferenceInput): ConnectedReference {
@@ -47,6 +49,18 @@ export function toConnectedReference(entity: EntityReferenceInput): ConnectedRef
       variantDisplayName: entity.variant ?? "canonical",
     }
   }
+  if (entity.kind === "image") {
+    // No slug field — the resolver derives it from `defaultName` at prompt time
+    // (`knownImageSlugsFromRefs`), so a client cannot drift from the grammar and
+    // nothing changes on the wire.
+    return {
+      id: entity.id,
+      defaultName: entity.name,
+      source: "wired-image",
+      url: entity.url ?? "",
+      ...(entity.description ? { description: entity.description } : {}),
+    }
+  }
   if (entity.kind === "creature") {
     return {
       id: entity.id,

package/src/types.ts

@@ -163,13 +163,19 @@ export interface ConnectedReference {
    */
   readonly defaultUsageMode?: UsageMode
   /**
-   * Character node's HYBRID `defaultRole` (the role-dropdown pick: a
-   * `REFERENCE_ROLE_PRESETS["wired-character"]` value or a sanitized Custom
-   * slug) propagated into every entry derived from that node. Read via
+   * The reference's HYBRID `defaultRole` (the role-dropdown pick: a
+   * `REFERENCE_ROLE_PRESETS[source]` value or a sanitized Custom slug)
+   * propagated into every entry derived from that node. Read via
    * `resolveDefaultRole(defaultRole, defaultUsageMode, source)` at the hybrid
    * resolver sites — it takes precedence over `defaultUsageMode`. Absent for
-   * non-character refs and for nodes that never set a role (fall back to the
-   * `defaultUsageMode`-derived role, then the source default).
+   * nodes that never set a role (fall back to the `defaultUsageMode`-derived
+   * role, then the source default).
+   *
+   * Written by the character node's role dropdown, and accepted from any source
+   * on the wire (`connectedReferenceSchema`). The LOCATION paths read it through
+   * their own `resolveLocationRole` chain rather than `resolveDefaultRole` — the
+   * location role vocabulary is mode-derived and slug-normalized — so it is NOT
+   * a character-only field: do not re-narrow this doc to characters.
    */
   readonly defaultRole?: string
   /**

package/src/workflow-export.ts

@@ -96,6 +96,22 @@ export interface WorkflowPortability {
   unreachableMedia: WorkflowMediaRef[]
 }
 
+/** The four entity kinds a bundle's `assets` can carry. */
+export type WorkflowAssetKind = "character" | "object" | "creature" | "location"
+
+/**
+ * A bundled entity the import declined to re-create (#1088). The workflow
+ * still lands — the film is the thing the importer asked for — so this is how
+ * they hear that an `@` chip arrived unbound.
+ */
+export interface WorkflowImportSkippedAsset {
+  kind: WorkflowAssetKind
+  /** The entity's id IN THE BUNDLE (the exporter's row id). */
+  id: string
+  name: string
+  reason: string
+}
+
 /**
  * What the importer did about the bundle's media (#866). Publicly reachable
  * media that is not already on the importing instance's own storage is
@@ -103,11 +119,29 @@ export interface WorkflowPortability {
  * a host the importer cannot reach is left as-is and listed (`unreachable`);
  * anything declined for another reason (too large, not a media type, over
  * the per-import cap, upload failed) is listed with the reason (`skipped`).
+ *
+ * The bundle's ENTITY images (`assets`) ride the same walk (#1088) — with one
+ * rule of their own: they are copied even when they already sit on this
+ * instance, because they are the EXPORTER's bytes and the two accounts'
+ * lifecycles are uncorrelated (their delete, their quarantine sweep, their
+ * retention reaper). Only bytes the importer already owns are left alone.
  */
 export interface WorkflowImportReport {
   rehosted: number
   unreachable: WorkflowMediaRef[]
   skipped: Array<WorkflowMediaRef & { reason: string }>
+  /**
+   * Bundled entity id (the EXPORTER's) → the row created under the importer,
+   * for every entity the import re-created. Present whenever the bundle
+   * carried `assets`. A client that holds chips outside the graph — a
+   * timeline, a copy-a-shared-production path that never posts to
+   * `/v1/workflows/import` — re-points them with this; the server has already
+   * re-pointed every `references[]` entry inside the nodes it stored.
+   */
+  assetIdMap?: Record<string, string>
+  /** Entities the import declined to create (storage quota). The workflow
+   *  still landed; chips bound to these arrive unresolvable. */
+  assetsSkipped?: WorkflowImportSkippedAsset[]
   /** Anything else the importer should know, e.g. copies were made but the
    *  workflow could not be updated to use them. */
   notes?: string[]