@lingjingai/scriptctl 0.61.3 → 0.62.1

package/dist/llm/types.d.ts

@@ -56,6 +56,10 @@ export type VideoMediaInput = {
     kind: "base64";
     data: string;
     mimeType: string;
+} | {
+    kind: "local";
+    path: string;
+    mimeType: string;
 } | {
     kind: "local-fallback";
     path: string;
@@ -70,6 +74,7 @@ export type VideoProviderCredential = {
     name: string;
 };
 export interface VideoProviderOverrides {
+    provider?: "gemini" | "doubao";
     baseUrl?: string;
     apiKey?: VideoProviderCredential;
     model?: string;

package/dist/llm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAIzB,MAAM,gBAAgB,CAAC;AAmGxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAwIlD,SAAS,4BAA4B,CAAC,IAAkB;IACtD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,EAAE,CAAC;QAC9F,KAAK,mBAAmB,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QACtG,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;QACzF,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;QACnF,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;QACpF,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;QACzF,KAAK,gBAAgB,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;QAC7F,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;QACxF,KAAK,kBAAkB,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;QAC5F,KAAK,gBAAgB,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC3F,KAAK,kBAAkB,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;QACjG,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;IACpF,CAAC;AACH,CAAC;AAYD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAe;IACnB,SAAS,CAAU;IACnB,OAAO,CAAW;IAClB,OAAO,CAAqB;IAC5B,aAAa,CAAuB;IAC7C,QAAQ,CAAS;IACjB,KAAK,CAAa;IAElB,YAAY,IAAkB,EAAE,OAAe,EAAE,UAAoC,EAAE;QACrF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,wBAAwB,CACrC,OAAO,CAAC,cAAc,IAAI,4BAA4B,CAAC,IAAI,CAAC,EAC5D;YACE,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO;YACP,GAAG,OAAO,CAAC,OAAO;YAClB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CACF,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IACnD,CAAC;CACF"}

package/dist/review-agent.js

@@ -1208,6 +1208,67 @@ function spanAddresses(doc, actions) {
   });
 }
 
+// packages/screenplay/dist/references.js
+function references(doc, address, opts = {}) {
+  const offset = opts.offset ?? 0, limit = opts.limit ?? 20, context = opts.context ?? 3;
+  for (const [name, value, minimum] of [["offset", offset, 0], ["limit", limit, 1], ["context", context, 0]]) {
+    if (!Number.isSafeInteger(value) || value < minimum)
+      throw new Error(`${name} must be an integer >= ${minimum}`);
+  }
+  const node = resolve(doc, address);
+  if (node.t !== "asset" && node.t !== "state")
+    throw new Error("references requires an asset or asset/state address; use read for episodes/scenes/actions");
+  const asset = node.asset;
+  const state2 = node.t === "state" ? node.state.id : null;
+  const names = [.../* @__PURE__ */ new Set([asset.id, asset.name, ...asset.aliases])].filter(Boolean);
+  const hits = [];
+  for (const ep of doc.episodes)
+    for (const scene of ep.scenes) {
+      const bindings = [...scene.location ? [scene.location] : [], ...scene.actors, ...scene.props].filter((ref2) => ref2.id === asset.id && (state2 === null || ref2.states.includes(state2)));
+      if (bindings.length)
+        hits.push({ kind: "scene_binding", scene, matched: bindings.flatMap((ref2) => ref2.states) });
+      for (const action of scene.actions) {
+        if (action.speaker?.id === asset.id && (state2 === null || action.speaker.state === state2)) {
+          hits.push({ kind: "speaker", scene, action, matched: [asset.id] });
+        }
+        if (state2 === null) {
+          const matched = names.filter((name) => action.content.includes(name));
+          if (matched.length)
+            hits.push({ kind: "text_mention", scene, action, matched });
+        }
+      }
+    }
+  const end = offset + limit;
+  return {
+    asset_id: asset.id,
+    state_id: state2,
+    total: hits.length,
+    next_offset: end < hits.length ? end : null,
+    items: hits.slice(offset, end).map(({ kind, scene, action, matched }) => {
+      const index = action ? scene.actions.indexOf(action) : -1;
+      const nearby = action ? scene.actions.slice(Math.max(0, index - context), index + context + 1) : [];
+      const gutter = Math.max(0, ...nearby.map((row) => row.anchor.length));
+      return {
+        kind,
+        address: action?.anchor ?? scene.anchor,
+        scene_address: scene.anchor,
+        episode: scene.ep.no,
+        matched,
+        text: [formatSceneHead(doc, scene), ...nearby.map((row) => (row === action ? "> " : "  ") + formatAction(doc, row, gutter))].join("\n")
+      };
+    })
+  };
+}
+function formatReferences(result) {
+  return [
+    `${result.asset_id}${result.state_id === null ? "" : "/" + result.state_id}  ${result.total} references \xB7 showing ${result.items.length}`,
+    "scene_binding=explicit scene presence; speaker=explicit speaker; text_mention=name/alias mention only (not proof of presence).",
+    ...result.items.map((hit) => `${hit.address}  ${hit.kind}  ep=${hit.episode}
+${hit.text}`),
+    result.next_offset === null ? "end" : `Continue: --offset ${result.next_offset}`
+  ].join("\n\n");
+}
+
 // packages/screenplay/dist/tools.js
 var NON_ACTOR_KIND = {
   \u65C1\u767D: "system",
@@ -2376,6 +2437,12 @@ var DOCTRINE = `
 - \u65F6\u95F4\u6233\u662F\u5426\u7F3A\u5931\u3001\u5012\u5E8F\u3001\u8D8A\u754C\u6216\u4EA7\u751F\u8D85\u8FC7 15 \u79D2\u7684\u7A7A\u6863\uFF08\u76F8\u90BB\u540C\u503C\u5408\u6CD5\uFF09\u3002
 - \u591A\u72B6\u6001\u4EBA\u7269\u7684\u76F8\u4F3C\u9020\u578B\u5FC5\u987B\u53D6\u5F97\u4EE3\u8868\u6027\u89C6\u9891\u7A97\u53E3\u540E\u518D\u5224\u65AD\uFF0C\u4E0D\u51ED\u540D\u79F0\u76F4\u63A5\u5408\u5E76\u3002
 
+## \u5F15\u7528\u5B9A\u4F4D
+
+- \u7528 \`refs\` \u6309\u8D44\u4EA7\u6216 \`\u8D44\u4EA7/\u9020\u578B\` \u67E5\u5F53\u524D\u5267\u672C\u7684\u5F15\u7528\uFF0C\u6309\u8FD4\u56DE\u7684 offset \u63D0\u793A\u7EED\u8BFB\uFF1B\u518D\u7528 \`read\` \u770B\u547D\u4E2D\u573A/action \u7684\u4E0A\u4E0B\u6587\uFF0C\`span\` \u5B9A\u4F4D\u89C6\u9891\u7A97\u53E3\u3002
+- \`scene_binding\` \u662F\u573A\u7EA7\u7ED1\u5B9A\uFF0C\`speaker\` \u662F\u8BF4\u8BDD\u5F15\u7528\uFF0C\`text_mention\` \u53EA\u662F\u540D\u5B57/\u522B\u540D/ID \u7684\u6B63\u6587\u63D0\u53CA\uFF1B\u5B83\u4EEC\u90FD\u662F\u5267\u672C\u73B0\u6709\u8BB0\u5F55\uFF0C\u4E0D\u8BC1\u660E\u6807\u7B7E\u6B63\u786E\u6216\u539F\u7247\u5B9E\u9645\u51FA\u573A\u3002\u9020\u578B\u67E5\u8BE2\u53EA\u5339\u914D\u663E\u5F0F\u5F15\u7528\uFF0C\u4E0D\u4ECE\u6B63\u6587\u731C\u9020\u578B\u3002
+- \`refs\` \u53EA\u8BFB\uFF1B\`ref\` \u624D\u4FEE\u6539\u573A\u666F\u7ED1\u5B9A\u3002\u6539\u4EBA\u7269\u6216\u9020\u578B\u5F15\u7528\u540E\u91CD\u65B0\u67E5\u8BE2\uFF0C\u68C0\u67E5\u4FEE\u6539\u7ED3\u679C\u4E0E\u6B8B\u4F59\u5F15\u7528\u3002\u9010\u96C6\u5BA1\u6838\u53EF\u8DE8\u96C6\u8BFB\u53D6\u4E0A\u4E0B\u6587\uFF0C\u4F46\u4E0D\u56E0\u6B64\u6269\u5927\u672C\u96C6\u4FEE\u6539\u8303\u56F4\u3002
+
 ## \u4FEE\u590D\u89C4\u5219
 
 - \u4EBA\u7269\u8BB0\u5F55\u91CD\u590D \u2192 \u5408\u5E76\u753B\u50CF\u4E0E\u5F15\u7528\uFF0C\u518D\u5220\u6389\u5DF2\u65E0\u5F15\u7528\u7684\u90A3\u4E2A\uFF0C\u4FDD\u7559\u66F4\u7A33\u5B9A/\u5F15\u7528\u66F4\u591A\u7684 ID\u3002
@@ -2444,6 +2511,36 @@ import * as path2 from "node:path";
 import { createTool } from "@mastra/core/tools";
 import { z as z2 } from "zod";
 var ADDR = "\u5730\u5740\uFF1A\u96C6 `3`\u3001\u573A `3-2`\u3001\u5355\u6761 `3-2-5`\u3001\u6B63\u5F0F ID\uFF08`acB4xR8p`/`scnQ7mN2v`\uFF09\u3001\u8D44\u4EA7\u540D\u3001\u6216 `<\u8D44\u4EA7>/<\u72B6\u6001>`";
+function createRefsTool(doc) {
+  return createTool({
+    id: "refs",
+    description: "\u53EA\u8BFB\u5B9A\u4F4D\u4EBA\u7269/\u573A\u666F/\u9053\u5177\u6216\u5177\u4F53\u9020\u578B\u7684\u5F15\u7528\u3002\u8FD4\u56DE\u573A\u666F\u7ED1\u5B9A\u3001\u8BF4\u8BDD\u4F4D\u7F6E\u3001\u6B63\u6587\u63D0\u53CA\u53CA\u524D\u540E\u6587\uFF1B\u6B63\u6587\u63D0\u53CA\u4E0D\u662F\u51FA\u573A\u8BC1\u636E\u3002\u53EF\u7528\u8FD4\u56DE\u5730\u5740\u7EE7\u7EED read\uFF0C\u6216 span \u5B9A\u4F4D\u539F\u7247\u7A97\u53E3\u3002",
+    inputSchema: z2.object({
+      addr: z2.string().min(1).describe("\u8D44\u4EA7 ID/\u540D\u5B57/\u522B\u540D\uFF0C\u6216 <\u8D44\u4EA7>/<\u9020\u578B>"),
+      offset: z2.number().int().min(0).optional().describe("\u4ECE\u7B2C\u51E0\u6761\u5F15\u7528\u7EED\u8BFB\uFF0C\u4ECE 0 \u5F00\u59CB"),
+      limit: z2.number().int().min(1).max(200).optional().describe("\u672C\u6279\u5F15\u7528\u6761\u6570\uFF0C\u9ED8\u8BA4 20\uFF1B\u6309\u8FD4\u56DE\u7684 offset \u63D0\u793A\u7EED\u8BFB"),
+      context: z2.number().int().min(0).max(20).optional().describe("\u6B63\u6587\u547D\u4E2D\u524D\u540E\u5404\u51E0\u6761 action\uFF0C\u9ED8\u8BA4 3")
+    }),
+    outputSchema: z2.string(),
+    execute: async ({ addr, ...options }) => formatReferences(references(doc, addr, options))
+  });
+}
+function frameModelOutput(output) {
+  if ("error" in output) return { type: "text", value: output.message };
+  const { images, failed, note } = output;
+  return {
+    type: "content",
+    value: [
+      { type: "text", text: `\u539F\u7247\u9759\u5E27 ${images.map((image) => image.at).join(", ")}` + (note ? `\uFF08${note}\uFF09` : "") + (failed.length ? `
+\u62BD\u5E27\u5931\u8D25\uFF1A${failed.join("; ")}` : "") },
+      ...images.map((image) => ({
+        type: "image-data",
+        data: image.data,
+        mediaType: "image/jpeg"
+      }))
+    ]
+  };
+}
 function newContext(init) {
   return {
     ...init,
@@ -2501,6 +2598,7 @@ function buildTools(ctx) {
       ...input.limit ? { limit: input.limit } : {}
     })
   });
+  tools.refs = createRefsTool(ctx.doc);
   tools.span = createTool({
     id: "span",
     description: "\u628A\u4E00\u6BB5 action \u6362\u7B97\u6210\u96C6\u5185\u89C6\u9891\u65F6\u95F4\u7A97\u53E3\uFF08\u534A\u5F00\u533A\u95F4\uFF09\uFF0C\u9009 watch/frames \u7684\u7A97\u53E3\u9760\u5B83\u3002",
@@ -2670,7 +2768,7 @@ function buildTools(ctx) {
       id: "frames",
       description: "\u62BD\u53D6\u539F\u7247\u82E5\u5E72\u65F6\u523B\u7684\u9759\u5E27\uFF0C\u76F4\u63A5\u8FDB\u4F60\u7684\u4E0A\u4E0B\u6587\u4F9B\u4F60\u81EA\u5DF1\u770B\u3002\u6CA1\u6709\u58F0\u97F3\uFF0C\u4F46\u7CBE\u786E\u4E14\u4FBF\u5B9C\u3002",
       inputSchema: z2.object({
-        timestamps: z2.array(z2.string()).min(1).max(6).describe("\u65F6\u523B\u5217\u8868\uFF0C`M:SS`"),
+        timestamps: z2.array(z2.string()).min(1).max(6).describe('1\u20136 \u4E2A M:SS \u65F6\u523B\u7684 JSON \u6570\u7EC4\uFF1B\u5355\u5E27\u4E5F\u7528\u6570\u7EC4\uFF0C\u4F8B\u5982 ["0:05"]'),
         note: z2.string().optional().describe("\u4F60\u60F3\u5728\u8FD9\u4E9B\u5E27\u91CC\u786E\u8BA4\u4EC0\u4E48")
       }),
       // The frames themselves reach the model through toModelOutput; the plain
@@ -2689,18 +2787,7 @@ function buildTools(ctx) {
         }
         return { images, failed, note: note ?? "" };
       },
-      toModelOutput: ({ images, failed, note }) => ({
-        type: "content",
-        value: [
-          { type: "text", text: `\u539F\u7247\u9759\u5E27 ${images.map((i) => i.at).join(", ")}` + (note ? `\uFF08${note}\uFF09` : "") + (failed.length ? `
-\u62BD\u5E27\u5931\u8D25\uFF1A${failed.join("; ")}` : "") },
-          ...images.map((image) => ({
-            type: "image-data",
-            data: image.data,
-            mimeType: "image/jpeg"
-          }))
-        ]
-      })
+      toModelOutput: (output) => frameModelOutput(output)
     });
   }
   tools.finding = createTool({
@@ -2934,11 +3021,13 @@ export {
   SUBJECT_KINDS,
   anchorOf,
   buildTools,
+  createRefsTool,
   cutClip,
   dispatcher,
   episodeTask,
   episodeVideos,
   ffmpegArgs,
+  frameModelOutput,
   grabFrame,
   neighbourSynopses,
   newContext,