@nodaro/shared 1.16.0 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/llm-models.test.ts

@@ -25,7 +25,7 @@ import { PIPELINE_PINNABLE_SCRIPT_LLMS } from "../pipeline-types.js"
 // ---------------------------------------------------------------------------
 describe("LLM_MODELS data integrity", () => {
   it("should have exactly 15 models", () => {
-    expect(LLM_MODELS).toHaveLength(15)
+    expect(LLM_MODELS).toHaveLength(16)
   })
 
   it("each model has all required fields", () => {
@@ -60,14 +60,14 @@ describe("LLM_MODELS data integrity", () => {
     expect(new Set(ids).size).toBe(ids.length)
   })
 
-  it("has 4 economy, 4 standard, 7 premium models", () => {
+  it("has 4 economy, 4 standard, 8 premium models", () => {
     const tierCounts: Record<LlmTier, number> = { economy: 0, standard: 0, premium: 0 }
     for (const model of LLM_MODELS) {
       tierCounts[model.tier]++
     }
     expect(tierCounts.economy).toBe(4)
     expect(tierCounts.standard).toBe(4)
-    expect(tierCounts.premium).toBe(7)
+    expect(tierCounts.premium).toBe(8)
   })
 
   it("all three kieFormats are represented", () => {
@@ -121,6 +121,7 @@ describe("LLM_MODEL_IDS", () => {
       "gpt-5.6-sol",
       "claude-sonnet-5",
       "claude-opus-4.8",
+      "claude-opus-5",
       "claude-fable-5",
     ]
     expect(LLM_MODEL_IDS).toEqual(expected)
@@ -399,17 +400,22 @@ describe("LLM_FEATURE_DEFAULTS", () => {
     expect(getLlmTier(LLM_FEATURE_DEFAULTS["ai-writer"])).toBe("standard")
   })
 
-  it('"describe-to-picker" defaults to "claude-opus-4.7" (premium vision)', () => {
-    expect(LLM_FEATURE_DEFAULTS["describe-to-picker"]).toBe("claude-opus-4.7")
+  it('"describe-to-picker" defaults to "claude-opus-5" (premium vision)', () => {
+    expect(LLM_FEATURE_DEFAULTS["describe-to-picker"]).toBe("claude-opus-5")
     expect(getLlmTier(LLM_FEATURE_DEFAULTS["describe-to-picker"])).toBe("premium")
     // The default MUST be an accepted analyzer model (vision + structured output).
-    expect(STRUCTURED_VISION_MODELS.map((m) => m.id)).toContain("claude-opus-4.7")
+    expect(STRUCTURED_VISION_MODELS.map((m) => m.id)).toContain("claude-opus-5")
   })
 
   it('"generate-script" defaults to "gemini-3.6-flash" (economy)', () => {
     expect(LLM_FEATURE_DEFAULTS["generate-script"]).toBe("gemini-3.6-flash")
   })
 
+  it('"qa-check" defaults to "gemini-3.6-flash" (economy)', () => {
+    expect(LLM_FEATURE_DEFAULTS["qa-check"]).toBe("gemini-3.6-flash")
+    expect(getLlmTier(LLM_FEATURE_DEFAULTS["qa-check"])).toBe("economy")
+  })
+
   it('"translate" defaults to "gemini-3.6-flash" (economy)', () => {
     expect(LLM_FEATURE_DEFAULTS["translate"]).toBe("gemini-3.6-flash")
   })
@@ -460,6 +466,7 @@ describe("STRUCTURED_VISION_MODELS", () => {
         "gemini-3.1-pro",
         "claude-sonnet-5",
         "claude-opus-4.8",
+        "claude-opus-5",
         "claude-fable-5",
         // responses-format GPTs — KIE text.format json_schema live-verified
         // 2026-07-14 (text AND vision inputs).

package/src/freecut-protocol.ts

@@ -27,6 +27,8 @@ export interface FreecutImportFile {
 
 export interface NodaroLoadVideoPayload {
   readonly videoUrl: string
+  /** Display/file name for the primary video ("Shot 1.mp4") — optional; absent = URL-derived name (fork default). */
+  readonly videoName?: string
   readonly videoBuffer?: ArrayBuffer
   readonly projectJson?: unknown
   readonly additionalFiles?: ReadonlyArray<FreecutImportFile>

package/src/llm-models.ts

@@ -245,7 +245,7 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
   {
     id: "claude-opus-4.8",
     displayName: "Claude Opus 4.8",
-    desc: "Most capable Claude, long-horizon work",
+    desc: "Previous-gen Opus, long-horizon work",
     tier: "premium",
     kieFormat: "messages",
     kieSlugOrModel: "claude-opus-4-8",
@@ -258,6 +258,25 @@ export const LLM_MODELS: readonly LlmModelDef[] = [
     supportsTemperature: false,
     preferKie: true,
   },
+  {
+    id: "claude-opus-5",
+    displayName: "Claude Opus 5",
+    desc: "Latest Opus, deepest agentic reasoning",
+    tier: "premium",
+    kieFormat: "messages",
+    // KIE serves Opus 5 on the Claude-native messages dialect under the plain
+    // id (docs.kie.ai/market/claude/claude-opus-5.md) — same path shape as
+    // claude-opus-4-8 / claude-fable-5.
+    kieSlugOrModel: "claude-opus-5",
+    vendor: "anthropic",
+    structuredOutputMode: "anthropic-tool",
+    supportsImages: true,
+    maxOutputTokens: 16384,
+    directFallbackModel: "claude-opus-5",
+    reasoningEfforts: ["low", "medium", "high", "xhigh", "max"],
+    supportsTemperature: false,
+    preferKie: true,
+  },
   {
     id: "claude-fable-5",
     displayName: "Claude Fable 5",
@@ -323,8 +342,8 @@ export const LLM_FEATURE_DEFAULTS: Record<LlmFeature, string> = {
   "lottie-overlay": "claude-sonnet-4.6",
   "3d-title": "claude-sonnet-4.6",
   "image-to-text": "claude-sonnet-4.6",
-  "describe-to-picker": "claude-opus-4.7",
-  "qa-check": "claude-sonnet-4.6",
+  "describe-to-picker": "claude-opus-5",
+  "qa-check": "gemini-3.6-flash",
   "generate-script": "gemini-3.6-flash",
   "translate": "gemini-3.6-flash",
   "image-critic": "claude-sonnet-4.6",
@@ -354,6 +373,7 @@ export const LLM_MODALITY_CAPS: Record<string, { image: boolean; video: boolean;
   "gpt-5.6-sol":       { image: true,  video: false, audio: false },
   "claude-sonnet-5":   { image: true,  video: false, audio: false },
   "claude-opus-4.8":   { image: true,  video: false, audio: false },
+  "claude-opus-5":     { image: true,  video: false, audio: false },
   "claude-fable-5":    { image: true,  video: false, audio: false },
 }
 

package/src/pipeline-types.ts

@@ -84,6 +84,7 @@ export const PIPELINE_PINNABLE_SCRIPT_LLMS = [
   "claude-haiku-4-5",
   "claude-sonnet-4-6",
   "claude-opus-4-7",
+  "claude-opus-5",
 ] as const
 export type PipelinePinnableScriptLlm = (typeof PIPELINE_PINNABLE_SCRIPT_LLMS)[number]