@wix/ditto-codegen-public 1.0.326 → 1.0.328

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/opencode-tools/validate.ts

@@ -2,14 +2,25 @@ import { tool } from "@opencode-ai/plugin";
 
 export default tool({
   description:
-    "Run full project validation: install deps (if needed), TypeScript check, and build. " +
+    "Run project validation: TypeScript check by default, optionally a full build. " +
     "Use this instead of running npm install, tsc, and wix build separately.",
   args: {
     installDeps: tool.schema
       .boolean()
       .optional()
       .describe(
-        "Run npm install first (default: false, set true if you added new deps)",
+        "Default false. Only set true when package.json changed in this iteration " +
+          "(added, removed, or upgraded a dependency). node_modules is pre-populated " +
+          "in the image, so installs are unnecessary otherwise.",
+      ),
+    runBuild: tool.schema
+      .boolean()
+      .optional()
+      .describe(
+        "Default false. Set true ONLY on the final validation pass after tsc " +
+          "succeeds to run `wix build` and verify the project builds end-to-end. " +
+          "`wix build` is slow (~20s); omitting it on intermediate iterations keeps " +
+          "the edit-validate loop fast.",
       ),
   },
   async execute(args, context) {
@@ -17,7 +28,10 @@ export default tool({
     const cwd = context.directory;
 
     if (args.installDeps) {
-      const install = await Bun.$`npm install`.cwd(cwd).nothrow().quiet();
+      const install = await Bun.$`npm install --no-audit --no-fund`
+        .cwd(cwd)
+        .nothrow()
+        .quiet();
       if (install.exitCode !== 0) {
         return `FAILED at npm install (exit ${install.exitCode}):\n${install.stderr.toString()}`;
       }
@@ -35,6 +49,11 @@ export default tool({
     }
     steps.push("tsc --noEmit: OK");
 
+    if (!args.runBuild) {
+      steps.push("wix build: skipped (pass runBuild: true to verify build)");
+      return steps.join("\n");
+    }
+
     const build = await Bun.$`npx wix build`.cwd(cwd).nothrow().quiet();
     if (build.exitCode !== 0) {
       return [

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\` with installDeps: true ONCE. Fix any errors and re-validate.
+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 {
@@ -13675,9 +13695,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 +13704,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.326",
+  "version": "1.0.328",
   "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": "35b73cd33bb1d9ab6fff654100df272cce16132bcd553c0b645154a5"
+  "falconPackageHash": "ed409314fc563dc19a80a0ebec8e4d38b6300689696888f753f8e26d"
 }