@wix/ditto-codegen-public 1.0.327 → 1.0.329

package/dist/opencode-tools/multi-edit.ts

@@ -0,0 +1,62 @@
+import { tool } from "@opencode-ai/plugin";
+import { readFile, writeFile } from "fs/promises";
+import { join, isAbsolute } from "path";
+
+export default tool({
+  description:
+    "Apply multiple find-and-replace edits across one or more files in a single call. " +
+    "Use this instead of calling edit multiple times. Each edit replaces oldString with newString " +
+    "in the named file. If oldString appears more than once and replaceAll is false, the edit fails — " +
+    "include more context in oldString to make it unique, or set replaceAll: true.",
+  args: {
+    edits: tool.schema
+      .array(
+        tool.schema.object({
+          path: tool.schema
+            .string()
+            .describe("File path relative to project root"),
+          oldString: tool.schema
+            .string()
+            .min(1)
+            .describe("Exact string to find. Must be unique unless replaceAll is true."),
+          newString: tool.schema.string().describe("Replacement string"),
+          replaceAll: tool.schema
+            .boolean()
+            .optional()
+            .describe("Replace every occurrence (default: false)"),
+        }),
+      )
+      .describe("Array of edits to apply in order"),
+  },
+  async execute(args, context) {
+    const results: string[] = [];
+    for (const e of args.edits) {
+      const fullPath = isAbsolute(e.path)
+        ? e.path
+        : join(context.directory, e.path);
+      try {
+        const content = await readFile(fullPath, "utf-8");
+        const occurrences = content.split(e.oldString).length - 1;
+        if (occurrences === 0) {
+          results.push(`FAILED: ${e.path} - oldString not found`);
+          continue;
+        }
+        if (occurrences > 1 && !e.replaceAll) {
+          results.push(
+            `FAILED: ${e.path} - oldString appears ${occurrences} times; pass replaceAll: true or include more surrounding context`,
+          );
+          continue;
+        }
+        const updated = e.replaceAll
+          ? content.split(e.oldString).join(e.newString)
+          : content.replace(e.oldString, e.newString);
+        await writeFile(fullPath, updated, "utf-8");
+        results.push(`OK: ${e.path}`);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        results.push(`FAILED: ${e.path} - ${msg}`);
+      }
+    }
+    return results.join("\n");
+  },
+});

package/dist/out.js

@@ -11701,7 +11701,8 @@ var require_constants5 = __commonJS({
     exports2.WRITE_TOOLS = /* @__PURE__ */ new Set([
       "write",
       "edit",
-      "batch-write"
+      "batch-write",
+      "multi-edit"
     ]);
     exports2.BUILDER_TO_EXTENSION_LABEL = {
       dashboardPage: "dashboard page",
@@ -11867,23 +11868,25 @@ MINIMIZE TEXT OUTPUT \u2014 CRITICAL:
 TOOL USAGE:
 - \`validate\` for all validation (tsc + build).
 - \`uuid\` to generate UUIDs (supports count param for multiple). Do NOT use bash.
-- \`batch-write\` to create new files. NEVER use \`write\` for new files (corrupts newlines).
-- \`batch-read\` to read multiple files at once.
-- \`multiedit\` to apply multiple edits across files. Use \`edit\` only for a single edit to one file.
+- File operations \u2014 pick the BATCH tool whenever you have 2+ files; the single-file variants are 5\u201310\xD7 slower:
+  - \`batch-write\` to create N new files in one call. NEVER call \`write\` more than once per turn \u2014 use batch-write instead. \`write\` is reserved for single-file creation.
+  - \`batch-read\` to read N files in one call. NEVER call \`read\` more than once per turn \u2014 use batch-read instead.
+  - \`multi-edit\` to apply N find-and-replace edits across one or more files in one call. NEVER call \`edit\` more than once per turn \u2014 use multi-edit instead. \`edit\` is reserved for a single edit to one file.
+- For tools where no batch variant exists (e.g. \`grep\`, \`glob\`), still emit MULTIPLE \`tool_use\` blocks in a SINGLE response when the calls are independent. Sequential turns waste a model round-trip per call.
 - Before calling MCP tools, check if loaded skills already cover the API. Only use MCP for gaps.
 - When using MCP to look up a Wix SDK method, ALWAYS call \`ReadFullDocsMethodSchema\` (not just \`ReadFullDocsArticle\`). The schema is the source of truth for parameter shapes. Code examples in docs may use incorrect call signatures.
 - NEVER run preview, dev, release, or promote commands.
 
 IMPLEMENTATION WORKFLOW:
 1. **Plan**: Determine extension types using the \`wix-app\` skill. Generate ALL UUIDs upfront.
-2. **Build**: Create each extension using \`batch-write\`. Build all extensions before registering.
+2. **Build**: Create every extension file in a SINGLE \`batch-write\` call. Build all extensions before registering.
 3. **Register**: Register all extensions in \`src/extensions.ts\`.
 4. **Validate**: Run \`validate\` (typecheck only). Fix any errors and re-validate until tsc passes. Then run \`validate({ runBuild: true })\` ONCE to verify the build. Pass \`installDeps: true\` ONLY when you added a new dependency to package.json in this iteration; otherwise omit it (node_modules is pre-installed).
 5. **Stop**: Once validation passes, STOP. Do NOT refactor, clean up, or verify.
 
 EFFICIENCY:
-- Batch ALL tool calls that can run in parallel into the same step.
-- Use \`multiedit\` to fix multiple errors at once.
+- Always prefer the BATCH variant: \`batch-write\` over multiple \`write\`s, \`batch-read\` over multiple \`read\`s, \`multi-edit\` over multiple \`edit\`s.
+- When fixing type errors across N files, use ONE \`multi-edit\` call with all N edits.
 
 FILE CREATION:
 - NEVER rewrite the same file twice. Once written, move on.
@@ -13027,6 +13030,10 @@ var require_config = __commonJS({
             "batch-write"
             /* OpenCodeTool.BatchWrite */
           ]: "deny",
+          [
+            "multi-edit"
+            /* OpenCodeTool.MultiEdit */
+          ]: "deny",
           [
             "validate"
             /* OpenCodeTool.Validate */
@@ -13148,6 +13155,16 @@ var require_parser = __commonJS({
         }
         const tool = event.part.tool;
         const metadata = event.part.state.metadata;
+        if (tool === "batch-write") {
+          for (const f of event.part.state.input?.files ?? []) {
+            addFileChange(f.path, ditto_codegen_types_12.ExtensionGenerationOperation.INSERT);
+          }
+        }
+        if (tool === "multi-edit") {
+          for (const e of event.part.state.input?.edits ?? []) {
+            addFileChange(e.path, ditto_codegen_types_12.ExtensionGenerationOperation.EDIT);
+          }
+        }
         const operation = (0, constants_1.resolveFileOperation)(tool, metadata);
         if (operation) {
           const filePath = event.part.state.input?.filePath;
@@ -13259,6 +13276,9 @@ var require_parser = __commonJS({
       if (input.files) {
         return { files: input.files.map(({ path }) => ({ path })) };
       }
+      if (input.edits) {
+        return { edits: input.edits.map(({ path }) => ({ path })) };
+      }
       if (input.filePath)
         return { filePath: input.filePath };
       return {
@@ -13369,7 +13389,8 @@ var require_extension_handler = __commonJS({
           files: extensionFiles.map((f) => ({
             path: f.path,
             operation: f.operation
-          }))
+          })),
+          extensionType: tracked.extensionType
         }
       };
     }
@@ -13399,7 +13420,7 @@ var require_extension_handler = __commonJS({
         if (!this.extensionTypesByPath.has(normalizedPath)) {
           this.extensionTypesByPath.set(normalizedPath, extension.extensionType);
           await (0, init_task_1.completeInitTask)(ctx);
-          await this.createExtensionTask(normalizedPath, extension.label, filePath, ctx);
+          await this.createExtensionTask(normalizedPath, extension.label, extension.extensionType, filePath, ctx);
         }
         if (!isCompleted)
           return;
@@ -13433,12 +13454,12 @@ var require_extension_handler = __commonJS({
         }
       }
       /** Registers a RUNNING sub-task in the job service for a detected extension. */
-      async createExtensionTask(normalizedPath, extensionType, originalPath, ctx) {
+      async createExtensionTask(normalizedPath, extensionLabel, extensionType, originalPath, ctx) {
         const jobContext = ctx.getJobContext();
         if (!jobContext)
           return;
         const extensionName = (0, constants_1.extractExtensionName)(originalPath);
-        const description = `Creating ${extensionName} ${extensionType}`;
+        const description = `Creating ${extensionName} ${extensionLabel}`;
         const extensionKey = `ext-${normalizedPath}`;
         const taskId = (0, crypto_12.randomUUID)();
         const extensionFolder = normalizedPath.substring(0, normalizedPath.lastIndexOf("/") + 1);
@@ -13446,7 +13467,8 @@ var require_extension_handler = __commonJS({
           taskId,
           description,
           status: ditto_codegen_types_12.Status.RUNNING,
-          extensionFolder
+          extensionFolder,
+          extensionType
         };
         ctx.trackedTasks.set(extensionKey, tracked);
         try {
@@ -13675,9 +13697,8 @@ var require_task_tracker = __commonJS({
       }
       async handleWriteEvent(tool, state) {
         const isCompleted = state.status === "completed";
-        const fileStates = tool === "batch-write" ? this.expandBatchWrite(state) : [state];
-        const effectiveTool = tool === "batch-write" ? "write" : tool;
-        for (const fileState of fileStates) {
+        const expanded = this.expandWriteEvent(tool, state);
+        for (const { state: fileState, effectiveTool } of expanded) {
           if (isCompleted) {
             this.trackFileChange(effectiveTool, fileState);
           }
@@ -13685,12 +13706,35 @@ var require_task_tracker = __commonJS({
           await this.extensionHandler.handle(effectiveTool, fileState, ctx);
         }
       }
-      expandBatchWrite(state) {
-        return (state.input?.files ?? []).map((f) => ({
-          status: state.status,
-          input: { filePath: f.path, content: f.content },
-          metadata: { exists: false }
-        }));
+      /**
+       * Expands a write-family tool event into per-file synthetic states so the
+       * downstream extension/file-change collectors can stay tool-agnostic:
+       *   batch-write → N synthetic Write states (INSERT, exists=false)
+       *   multi-edit  → N synthetic Edit states (EDIT)
+       *   write/edit  → passed through unchanged
+       */
+      expandWriteEvent(tool, state) {
+        if (tool === "batch-write") {
+          return (state.input?.files ?? []).map((f) => ({
+            state: {
+              status: state.status,
+              input: { filePath: f.path, content: f.content },
+              metadata: { exists: false }
+            },
+            effectiveTool: "write"
+          }));
+        }
+        if (tool === "multi-edit") {
+          return (state.input?.edits ?? []).map((e) => ({
+            state: {
+              status: state.status,
+              input: { filePath: e.path, new_string: e.newString },
+              metadata: { exists: true }
+            },
+            effectiveTool: "edit"
+          }));
+        }
+        return [{ state, effectiveTool: tool }];
       }
       trackFileChange(tool, state) {
         const filePath = state.input?.filePath || state.title;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.327",
+  "version": "1.0.329",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -28,5 +28,5 @@
     "esbuild": "^0.27.2",
     "vitest": "^4.0.16"
   },
-  "falconPackageHash": "9a805eff0a678722d7889d0105313ad61c44e1c48cbc5d1ec0009099"
+  "falconPackageHash": "27be60515add05720642903acc4d87771920b49663a972e4bc664868"
 }