opencaptions 1.2.0 → 1.2.1

package/dist/captions.js

@@ -9,7 +9,7 @@ import { basename, dirname, extname, join, resolve } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { OpenCaptionsError, unwrap, } from "./client.js";
-import { captionLines, setWord, shuffleVariants } from "./engine.js";
+import { captionLines, mergeWords, setWord, shuffleVariants } from "./engine.js";
 import { findLook, LOOKS } from "./looks.js";
 /** How often a job is asked about, in milliseconds. */
 const pollMs = () => Number(process.env.OPENCAPTIONS_POLL_MS) || 1000;
@@ -121,15 +121,17 @@ export async function readTranscript(client, projectId) {
     const lines = await captionLines(project.transcript, project.style_config?.words_per_line ?? 3, project.caption_offset_ms);
     return { lines, words };
 }
-/** Sets words by their index; empty text removes a word. The indices are the ones read before. */
 export async function fixWords(client, projectId, fixes) {
     const project = await getProject(client, projectId);
     if (!project.transcript)
         throw new OpenCaptionsError("This project has no captions yet.");
-    // Last first: removing a word moves the ones after it, never the ones before.
+    // Last first: removing or joining words moves the ones after them, never the ones before.
     let transcript = project.transcript;
     for (const fix of [...fixes].sort((a, b) => b.index - a.index)) {
-        transcript = await setWord(transcript, fix.index, fix.text);
+        transcript =
+            (fix.count ?? 1) > 1
+                ? await mergeWords(transcript, fix.index, fix.count ?? 1, fix.text)
+                : await setWord(transcript, fix.index, fix.text);
     }
     await update(client, projectId, { transcript });
     return fixes.length;

package/dist/engine.js

@@ -36,6 +36,12 @@ export async function setWord(t, index, text) {
     const x = await exports();
     return result(x, x.oc_set_word(...json(x, t), index, ...copyIn(x, encoder.encode(text))));
 }
+/** `count` words from `index` replaced by one word `text`, spanning them all. */
+export async function mergeWords(t, index, count, text) {
+    const x = await exports();
+    const words = copyIn(x, encoder.encode(text));
+    return result(x, x.oc_merge_words(...json(x, t), index, count, ...words));
+}
 /** Deals every word one of `count` looks, or the style's own, as picking such a look does. */
 export async function shuffleVariants(t, count) {
     const x = await exports();

package/dist/mcp.js

@@ -88,7 +88,8 @@ const TOOLS = [
     {
         name: "fix_words",
         description: "Sets words by the index get_transcript gave them, keeping their timing; empty text removes " +
-            "a word. Then save_video writes the video again.",
+            "a word, and count joins that many words into one spanning them all (two words heard for " +
+            "one). Then save_video writes the video again.",
         inputSchema: {
             type: "object",
             properties: {
@@ -97,7 +98,15 @@ const TOOLS = [
                     type: "array",
                     items: {
                         type: "object",
-                        properties: { index: { type: "integer", minimum: 0 }, text: { type: "string" } },
+                        properties: {
+                            index: { type: "integer", minimum: 0 },
+                            text: { type: "string" },
+                            count: {
+                                type: "integer",
+                                minimum: 1,
+                                description: "How many words from index the text replaces, as one word (default 1)",
+                            },
+                        },
                         required: ["index", "text"],
                     },
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencaptions",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Animated word-by-word captions for your videos, from Claude, Cursor or any MCP client, or the command line. Runs on your own OpenCaptions server.",
   "mcpName": "io.github.leogaudin/opencaptions",
   "license": "AGPL-3.0-only",

package/server.json

@@ -9,13 +9,13 @@
     "source": "github",
     "subfolder": "apps/agent"
   },
-  "version": "1.2.0",
+  "version": "1.2.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "opencaptions",
-      "version": "1.2.0",
+      "version": "1.2.1",
       "transport": { "type": "stdio" },
       "packageArguments": [{ "type": "positional", "value": "mcp" }],
       "environmentVariables": [