@wix/ditto-codegen-public 1.0.347 → 1.0.349

package/assets/commit-message-rule.md

@@ -0,0 +1,2 @@
+COMMIT MESSAGE:
+First thing, before writing any code, call the `set-commit-message` tool. See its description for format and length.

package/assets/set-commit-message.ts

@@ -0,0 +1,23 @@
+import { tool } from "@opencode-ai/plugin";
+
+export default tool({
+  description:
+    "Set the commit message for this codegen run. The message becomes the " +
+    "subject of a real `git commit -m` for the run, visible to " +
+    "non-technical users in their checkpoint history. Call this once, as " +
+    "the first thing you do, before writing any code.",
+  args: {
+    commitMessage: tool.schema
+      .string()
+      .min(1)
+      .describe(
+        "One-line summary of the user's request. " +
+          'Imperative mood (e.g. "Add", "Fix", "Update"). ' +
+          "No trailing period, no quotes, no prefix. " +
+          "Ideally under 150 characters.",
+      ),
+  },
+  async execute(args) {
+    return `Commit message set: ${args.commitMessage}`;
+  },
+});

package/dist/out.js

@@ -10930,9 +10930,9 @@ var require_generation = __commonJS({
   }
 });
 
-// ../codegen-types/dist/types/user-decision.js
-var require_user_decision = __commonJS({
-  "../codegen-types/dist/types/user-decision.js"(exports2) {
+// ../codegen-types/dist/types/decision.js
+var require_decision = __commonJS({
+  "../codegen-types/dist/types/decision.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
   }
@@ -10946,9 +10946,9 @@ var require_environment = __commonJS({
   }
 });
 
-// ../codegen-types/dist/types/hooks.js
-var require_hooks = __commonJS({
-  "../codegen-types/dist/types/hooks.js"(exports2) {
+// ../codegen-types/dist/types/plugins.js
+var require_plugins2 = __commonJS({
+  "../codegen-types/dist/types/plugins.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
   }
@@ -11012,9 +11012,9 @@ var require_dist4 = __commonJS({
     __exportStar2(require_status(), exports2);
     __exportStar2(require_task(), exports2);
     __exportStar2(require_generation(), exports2);
-    __exportStar2(require_user_decision(), exports2);
+    __exportStar2(require_decision(), exports2);
     __exportStar2(require_environment(), exports2);
-    __exportStar2(require_hooks(), exports2);
+    __exportStar2(require_plugins2(), exports2);
     __exportStar2(require_job_payload(), exports2);
     __exportStar2(require_logger2(), exports2);
     __exportStar2(require_ai(), exports2);
@@ -11492,250 +11492,11 @@ var require_dist5 = __commonJS({
       codegenRules: [],
       askRules: [],
       decisionCheckers: [],
-      hooks: []
+      plugins: []
     };
   }
 });
 
-// ../codegen-studio-2-config/dist/site-data-layer-rules.js
-var require_site_data_layer_rules = __commonJS({
-  "../codegen-studio-2-config/dist/site-data-layer-rules.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.SITE_DATA_LAYER_RULES = void 0;
-    exports2.SITE_DATA_LAYER_RULES = `# Site Data Layer Rules
-
-The agent operates on a live Wix site (METASITE_ID is in your prompt context).
-
-For any persistent-data need \u2014 CMS collections, content tables, schemas, data models, or databases that store items \u2014 use the \`wix-site-data-collection\` skill.
-
-The \`wix-app\` skill remains the right tool for surrounding extensions (dashboard pages, modals, widgets); only the data layer is overridden. A Wix CLI data collection extension will NOT work here \u2014 it only provisions on app install, but this is a live site that already exists. Use the \`wix-site-data-collection\` skill to discover the existing collections on the site and wire your code against them.
-
-DO NOT write any code relating to Wix CLI data extensions \u2014 for example, do not generate \`src/extensions/data/extensions.ts\`.`;
-  }
-});
-
-// ../codegen-studio-2-config/dist/index.js
-var require_dist6 = __commonJS({
-  "../codegen-studio-2-config/dist/index.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.studio2CodegenConfig = void 0;
-    var site_data_layer_rules_1 = require_site_data_layer_rules();
-    exports2.studio2CodegenConfig = {
-      codegenRules: [
-        { filename: "site-data-layer-rules.md", content: site_data_layer_rules_1.SITE_DATA_LAYER_RULES }
-      ],
-      askRules: [],
-      decisionCheckers: [],
-      hooks: []
-    };
-  }
-});
-
-// dist/opencode-integration/rules/codegen-rules.js
-var require_codegen_rules = __commonJS({
-  "dist/opencode-integration/rules/codegen-rules.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.CODEGEN_RULES = void 0;
-    exports2.CODEGEN_RULES = `CORE PRINCIPLES:
-- Do NOT invent or assume new types, modules, functions, props, events, or imports.
-- NEVER use mocks, placeholders, debugging, or TODOs in any code.
-- ALWAYS implement complete, production-ready functionality.
-- Do NOT create test files or test code. Tests are out of scope for code generation.
-
-MINIMIZE TEXT OUTPUT \u2014 CRITICAL:
-- Do NOT narrate your actions. No "Let me now...", "Perfect!", "Now I'll...", "Excellent!", "Great!".
-- Do NOT explain what you just did. The tool output speaks for itself.
-- Do NOT read back files you just wrote. Trust the write succeeded.
-- Every text token costs money. Use tools, not words.
-
-TOOL USAGE:
-- \`progress\` to mark a step done. Call it ONCE per completed step, in the SAME response as the tool calls that did the work \u2014 never dedicate a separate turn to it. Report progress at EVERY meaningful milestone. Keep descriptions SHORT \u2014 mention the extension type but no file names, counts, namespaces, or other specifics. Examples:
-  - "Planning extensions"
-  - "Reading documentation"
-  - "Creating dashboard page"
-  - "Creating service plugin"
-  - "Creating data collection"
-  - "Registering extensions"
-  - "Running type checks"
-  - "Building project"
-- \`validate\` for all validation (tsc + build).
-- \`uuid\` to generate UUIDs (supports count param for multiple). Do NOT use bash.
-- 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.
-- To discover API shapes, method signatures, or type definitions: ALWAYS try \`SearchWixSDKDocumentation\` or \`ReadFullDocsMethodSchema\` via wix-mcp first. ONLY fall back to grepping \`node_modules\` if the MCP tools return no useful results. Grepping \`node_modules\` as a first resort wastes turns, inflates context, and produces unreliable results \u2014 SDK internals are not a documentation source.
-- NEVER run preview, dev, release, or promote commands.
-
-IMPLEMENTATION WORKFLOW:
-1. **Plan**: Determine extension types using the \`wix-app\` skill. Generate ALL UUIDs upfront. Include a \`progress\` call (e.g. "Planning extensions").
-2. **Research**: Load relevant SDK docs and skills for each extension type. Include a \`progress\` call (e.g. "Reading documentation").
-3. **Build**: Create every extension file in a SINGLE \`batch-write\` call. Build all extensions before registering. Include one \`progress\` call per extension type (e.g. "Creating dashboard page", "Creating service plugin").
-4. **Register**: Register all extensions in \`src/extensions.ts\`. Include a \`progress\` call (e.g. "Registering extensions").
-5. **Validate**: Run \`validate\` (typecheck only). Fix any errors and re-validate until tsc passes. Include a \`progress\` call (e.g. "Running type checks"). 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). Include a \`progress\` call (e.g. "Building project").
-6. **Stop**: STOP immediately. Do NOT refactor, clean up, or verify.
-
-EFFICIENCY:
-- 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.
-- Keep each file under 200 lines. Split into types.ts, utils.ts if needed.
-- Do NOT output comments in code unless they explain non-obvious logic.
-
-TYPESCRIPT:
-- The project enables \`verbatimModuleSyntax\`. Type-only imports MUST use \`import type\`.
-
-PERMISSIONS:
-At the end of your response, output the required Wix app permissions as a JSON block.
-Use SCOPE ID format (not human-readable names). Examples:
-- \`@wix/data\` read \u2192 "SCOPE.DC-DATA.READ", write \u2192 "SCOPE.DC-DATA.WRITE"
-- Embedded scripts \u2192 "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
-
-CRITICAL: Only include permissions that you have explicitly seen in the Wix SDK documentation (via MCP or loaded skills). NEVER guess or fabricate permission scope IDs. If you are unsure which permission a feature requires, look it up in the docs first. Omitting a permission is better than inventing one that does not exist.
-
-\`\`\`json:required-permissions
-["SCOPE.DC-DATA.READ", "SCOPE.DC-DATA.WRITE"]
-\`\`\`
-
-If no permissions are required, output an empty array:
-\`\`\`json:required-permissions
-[]
-\`\`\``;
-  }
-});
-
-// dist/opencode-integration/rules/ask-rules.js
-var require_ask_rules = __commonJS({
-  "dist/opencode-integration/rules/ask-rules.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.ASK_RULES = void 0;
-    exports2.ASK_RULES = `CORE PRINCIPLES:
-- You are a READ-ONLY assistant. You MUST NOT modify, create, or delete any files.
-- Your job is to answer questions about the codebase and Wix platform by reading code and fetching documentation.
-- Use the read tool to explore the codebase and find relevant code.
-- Use the wix-mcp tools to fetch Wix SDK/API documentation when needed.
-- Provide clear, accurate, and well-structured answers.
-
-TOOL USAGE:
-- \`progress\` to mark a step done. Call it ONCE per completed step, in the SAME response as the tool calls that did the work. Examples:
-  - "Reading codebase"
-  - "Looking up documentation"
-  - "Analyzing code"
-
-IMPORTANT INSTRUCTIONS:
-1. Do NOT edit, write, or create any files.
-2. Do NOT run any bash commands.
-3. READ the codebase to understand the code structure and find answers.
-4. Use MCP tools to look up Wix documentation when the question involves Wix APIs, SDKs, or platform features.
-5. If you cannot find a definitive answer, say so clearly and explain what you found.`;
-  }
-});
-
-// dist/job-decision-manager.js
-var require_job_decision_manager = __commonJS({
-  "dist/job-decision-manager.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.UserDecisionCancelledError = void 0;
-    exports2.pauseForUserDecision = pauseForUserDecision;
-    exports2.askJobChoice = askJobChoice;
-    exports2.askJobConfirmation = askJobConfirmation;
-    var types_1 = require_types_impl();
-    var codeGenerationService_12 = require_codeGenerationService();
-    var CodeGenService_12 = require_CodeGenService();
-    var logger_12 = require_logger();
-    var DECISION_POLL_INTERVAL_MS = 2e3;
-    var UserDecisionCancelledError = class extends Error {
-      constructor(jobId, decisionId) {
-        super(`User decision ${decisionId} cancelled for job ${jobId}`);
-        this.jobId = jobId;
-        this.decisionId = decisionId;
-        this.name = "UserDecisionCancelledError";
-      }
-    };
-    exports2.UserDecisionCancelledError = UserDecisionCancelledError;
-    async function pauseForUserDecision(jobId, request) {
-      const decisionId = crypto.randomUUID();
-      const userDecision = {
-        id: decisionId,
-        request: {
-          ...request,
-          requestedAt: /* @__PURE__ */ new Date()
-        }
-      };
-      await codeGenerationService_12.codeGenerationService.updateJobWithPendingDecision(jobId, userDecision);
-      logger_12.logger.info("[JobDecision] Paused for user input", {
-        question: request.question
-      });
-      const startTime = Date.now();
-      const response = await pollForJobDecisionResponse(jobId, decisionId);
-      const durationMs = Date.now() - startTime;
-      await codeGenerationService_12.codeGenerationService.resumeJobFromDecision(jobId);
-      logger_12.logger.info("[JobDecision] Resumed after user decision", {
-        selectedOptionId: response.selectedOptionId,
-        durationMs
-      });
-      return response;
-    }
-    async function pollForJobDecisionResponse(jobId, decisionId) {
-      logger_12.logger.info("[JobDecision] Polling for user decision response", {
-        decisionId
-      });
-      while (true) {
-        const job = await codeGenerationService_12.codeGenerationService.getJob(jobId);
-        if (!job) {
-          throw new Error(`Job ${jobId} not found`);
-        }
-        if (job.status === CodeGenService_12.Status.CANCELLED || job.status === CodeGenService_12.Status.PENDING_CANCEL) {
-          logger_12.logger.warn("[JobDecision] Job cancelled while waiting for user decision", { decisionId });
-          throw new UserDecisionCancelledError(jobId, decisionId);
-        }
-        const decision = job.pendingUserDecisions?.find((d) => d.id === decisionId) ?? job.userDecisionHistory?.find((d) => d.id === decisionId);
-        if (decision?.response?.selectedOptionId) {
-          return {
-            selectedOptionId: decision.response.selectedOptionId,
-            respondedAt: decision.response.respondedAt ?? /* @__PURE__ */ new Date()
-          };
-        }
-        await new Promise((resolve) => setTimeout(resolve, DECISION_POLL_INTERVAL_MS));
-      }
-    }
-    async function askJobChoice(jobId, question, options, context) {
-      const response = await pauseForUserDecision(jobId, {
-        question,
-        questionType: types_1.UserDecisionQuestionType.UI_COMPONENT_TYPE,
-        options,
-        context
-      });
-      if (!response.selectedOptionId) {
-        throw new Error("No option selected in user decision response");
-      }
-      return response.selectedOptionId;
-    }
-    async function askJobConfirmation(jobId, question, context) {
-      const response = await pauseForUserDecision(jobId, {
-        question,
-        questionType: types_1.UserDecisionQuestionType.UI_COMPONENT_TYPE,
-        options: [
-          { id: "yes", label: "Yes" },
-          { id: "no", label: "No" }
-        ],
-        context
-      });
-      return response.selectedOptionId === "yes";
-    }
-  }
-});
-
 // ../../node_modules/@wix/ambassador-code-studio-orchestrator-v1-project/cjs/build/http.impl.js
 var require_http_impl2 = __commonJS({
   "../../node_modules/@wix/ambassador-code-studio-orchestrator-v1-project/cjs/build/http.impl.js"(exports2) {
@@ -12092,165 +11853,47 @@ var require_http_impl2 = __commonJS({
   }
 });
 
-// dist/utils.js
-var require_utils9 = __commonJS({
-  "dist/utils.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.serializeError = serializeError;
-    exports2.updateAllRunningTasks = updateAllRunningTasks;
-    var types_1 = require_types_impl();
-    var codeGenerationService_12 = require_codeGenerationService();
-    function serializeError(error) {
-      if (error instanceof Error) {
-        const base = {
-          name: error.name,
-          message: error.message,
-          stack: error.stack
-        };
-        const anyErr = error;
-        for (const key in anyErr) {
-          if (!(key in base)) {
-            try {
-              base[key] = anyErr[key];
-            } catch {
-            }
-          }
-        }
-        const withCause = error;
-        if (withCause && "cause" in withCause) {
-          base.cause = withCause.cause;
-        }
-        const maybeHttp = error;
-        if (maybeHttp?.response?.data !== void 0)
-          base.data = maybeHttp.response.data;
-        if (maybeHttp?.code !== void 0)
-          base.code = maybeHttp.code;
-        if (maybeHttp?.details !== void 0)
-          base.details = maybeHttp.details;
-        return base;
-      }
-      if (typeof error === "object" && error !== null) {
-        try {
-          return JSON.parse(JSON.stringify(error));
-        } catch {
-          return { message: String(error) };
-        }
-      }
-      return { message: String(error) };
-    }
-    async function updateAllRunningTasks(jobId, status, error) {
-      const job = await codeGenerationService_12.codeGenerationService.getJob(jobId);
-      const tasks = (job?.tasks ?? []).filter((task) => task.status === types_1.Status.RUNNING || task.status === types_1.Status.PENDING) || [];
-      for (const task of tasks) {
-        if (!task.id)
-          continue;
-        await codeGenerationService_12.codeGenerationService.updateTask(jobId, task.id, status, error ? { error: serializeError(error) } : {});
-      }
-    }
-  }
-});
-
-// dist/flows/codegen-flow-helpers.js
-var require_codegen_flow_helpers = __commonJS({
-  "dist/flows/codegen-flow-helpers.js"(exports2) {
-    "use strict";
-    var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
-      return mod && mod.__esModule ? mod : { "default": mod };
-    };
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.updateJobPayload = updateJobPayload;
-    exports2.updateParentTaskStatus = updateParentTaskStatus;
-    exports2.getOutputPath = getOutputPath;
-    var path_1 = __importDefault2(require("path"));
-    var codeGenerationService_12 = require_codeGenerationService();
-    var utils_1 = require_utils9();
-    var DEFAULT_OUTPUT_PATH = "generated-app";
-    async function updateJobPayload(jobContext, payload) {
-      await codeGenerationService_12.codeGenerationService.updateJob(jobContext.jobId, payload);
-    }
-    async function updateParentTaskStatus(jobContext, status, error) {
-      await codeGenerationService_12.codeGenerationService.updateTask(jobContext.jobId, jobContext.taskId, status, error ? { error: (0, utils_1.serializeError)(error) } : {});
-    }
-    function getOutputPath() {
-      const outputDir = process.env.OUTPUT_PATH || DEFAULT_OUTPUT_PATH;
-      return outputDir.startsWith("/") ? outputDir : path_1.default.join(process.cwd(), outputDir);
-    }
-  }
-});
-
-// dist/environments/hooks/checkpoint.js
+// ../codegen-checkpoint-plugin/dist/checkpoint.js
 var require_checkpoint = __commonJS({
-  "dist/environments/hooks/checkpoint.js"(exports2) {
+  "../codegen-checkpoint-plugin/dist/checkpoint.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.checkpointHookFactory = void 0;
+    exports2.checkpointPluginFactory = void 0;
+    var fs_1 = require("fs");
+    var path_1 = require("path");
     var http_1 = require_http_impl2();
     var http_client_1 = require_index_node();
-    var logger_12 = require_logger();
-    var codegen_flow_helpers_12 = require_codegen_flow_helpers();
-    var config_12 = require_config();
-    var wixTokenRefresh_1 = require_wixTokenRefresh();
     var FALLBACK_COMMIT_MESSAGE = "Auto-save";
     var EML_MARKER = "generate-eml.ts";
     var SET_COMMIT_MESSAGE_TOOL = "set-commit-message";
     var MAX_COMMIT_MESSAGE_LENGTH = 1e3;
     var TRUNCATION_SUFFIX = "\u2026";
+    var ASSETS_DIR = (0, path_1.join)(__dirname, "..", "assets");
+    var readAsset = (name) => (0, fs_1.readFileSync)((0, path_1.join)(ASSETS_DIR, name), "utf-8");
+    var buildCheckpointRules = () => [
+      {
+        filename: "checkpoint-commit-message.md",
+        content: readAsset("commit-message-rule.md")
+      }
+    ];
+    var buildCheckpointTools = () => [
+      {
+        filename: "set-commit-message.ts",
+        source: readAsset("set-commit-message.ts")
+      }
+    ];
     var truncateCommitMessage = (message) => {
       if (message.length <= MAX_COMMIT_MESSAGE_LENGTH)
         return message;
       return message.slice(0, MAX_COMMIT_MESSAGE_LENGTH - TRUNCATION_SUFFIX.length) + TRUNCATION_SUFFIX;
     };
-    var orchestratorHttpClient = (0, http_client_1.createHttpClient)({
-      baseURL: "https://editor.wix.com"
-    });
-    var withAuth = (req) => {
-      const authHeader = {
-        authorization: `Bearer ${process.env.WIX_ACCESS_TOKEN}`
-      };
-      if (typeof req === "function") {
-        return (ctx) => {
-          const r = req(ctx);
-          return { ...r, headers: { ...r.headers ?? {}, ...authHeader } };
-        };
-      }
-      return { ...req, headers: { ...req.headers ?? {}, ...authHeader } };
-    };
-    var isUnauthorized = (error) => {
-      if (!http_client_1.HttpClient.isHttpError(error))
-        return false;
-      if (orchestratorHttpClient.isCancel(error))
-        return false;
-      return error.response?.status === 401;
-    };
-    var refreshAndPropagate = async () => {
-      const token = await (0, wixTokenRefresh_1.refreshWixAccessToken)();
-      (0, config_12.setCurrentAccessToken)(token);
-    };
-    var requestWithRefresh = async (req) => {
-      try {
-        return await orchestratorHttpClient.request(withAuth(req));
-      } catch (err) {
-        if (!isUnauthorized(err))
-          throw err;
-        logger_12.logger.warn("[Checkpoint] 401 received, refreshing token and retrying once");
-        await refreshAndPropagate();
-        return await orchestratorHttpClient.request(withAuth(req));
-      }
-    };
-    var callCreateCheckpoint = async (appId, commitMessage) => {
-      const resp = await requestWithRefresh((0, http_1.createCheckpoint)({
+    var callCreateCheckpoint = async (client, appId, commitMessage) => {
+      const resp = await client.request((0, http_1.createCheckpoint)({
         appId,
         commitMessage: truncateCommitMessage(commitMessage)
       }));
       return { checkpointId: resp.data?.checkpointId };
     };
-    var readBashCommand = (input) => {
-      if (typeof input !== "object" || input === null)
-        return void 0;
-      const value = input.command;
-      return typeof value === "string" ? value : void 0;
-    };
     var readToolCommitMessage = (input) => {
       if (typeof input !== "object" || input === null)
         return void 0;
@@ -12260,25 +11903,38 @@ var require_checkpoint = __commonJS({
       const trimmed = value.trim();
       return trimmed.length > 0 ? trimmed : void 0;
     };
-    var checkpointHookFactory = (ctx) => {
+    var readBashCommand = (input) => {
+      if (typeof input !== "object" || input === null)
+        return void 0;
+      const value = input.command;
+      return typeof value === "string" ? value : void 0;
+    };
+    var checkpointPluginFactory = (ctx) => {
+      const { host, job } = ctx;
+      const orchestratorHttpClient = (0, http_client_1.createHttpClient)({
+        baseURL: "https://editor.wix.com",
+        headers: { Authorization: `Bearer ${host.auth.getAccessToken() ?? ""}` }
+      });
       let outcome;
       let capturedCommitMessage;
       const commitCheckpoint = async (commitMessage) => {
+        if (!job)
+          return;
         try {
-          const { checkpointId } = await callCreateCheckpoint(ctx.projectId, commitMessage);
+          const { checkpointId } = await callCreateCheckpoint(orchestratorHttpClient, job.projectId, commitMessage);
           outcome = { status: "created", checkpointId };
           if (checkpointId) {
-            await (0, codegen_flow_helpers_12.updateJobPayload)({ jobId: ctx.jobId, taskId: ctx.taskId }, { checkpointId });
+            await host.jobs.updatePayload({ jobId: job.jobId, taskId: job.taskId }, { checkpointId });
           }
-          logger_12.logger.info("[Checkpoint] created", {
-            projectId: ctx.projectId,
+          host.logger.info("[Checkpoint] created", {
+            projectId: job.projectId,
             checkpointId,
             commitMessage
           });
         } catch (error) {
           outcome = { status: "failed", error };
-          logger_12.logger.error("[Checkpoint] create failed", {
-            projectId: ctx.projectId,
+          host.logger.error("[Checkpoint] create failed", {
+            projectId: job.projectId,
             error: error instanceof Error ? error.message : String(error)
           });
           throw error;
@@ -12286,10 +11942,12 @@ var require_checkpoint = __commonJS({
       };
       return {
         name: "checkpoint",
-        // The agent calls `set-commit-message` (a deterministic opencode tool)
-        // as the first thing it does. We capture the value here. Then later,
-        // when the EML script runs (mid-flow), we use the captured value for
-        // the early checkpoint.
+        rules: buildCheckpointRules(),
+        tools: buildCheckpointTools(),
+        // The agent calls `set-commit-message` (registered as a host tool from
+        // the plugin's `tools` field) as the first thing it does. We capture
+        // the value here. Then later, when the EML script runs (mid-flow), we
+        // use the captured value for the early checkpoint.
         async onToolUse({ tool, state }) {
           if (state.status === "error")
             return;
@@ -12314,97 +11972,279 @@ var require_checkpoint = __commonJS({
         },
         // Flow-end fallback: only fires if onToolUse didn't already create the
         // checkpoint. Re-throws an earlier failure so the task is marked failed.
-        async onFlowEnd({ failed }) {
+        async onFlowEnd({ codegenFailed }) {
           if (outcome?.status === "failed")
             throw outcome.error;
           if (outcome?.status === "created")
             return;
-          if (failed)
+          if (codegenFailed)
             return;
           const commitMessage = capturedCommitMessage ?? FALLBACK_COMMIT_MESSAGE;
           await commitCheckpoint(commitMessage);
         }
       };
     };
-    exports2.checkpointHookFactory = checkpointHookFactory;
+    exports2.checkpointPluginFactory = checkpointPluginFactory;
+  }
+});
+
+// ../codegen-checkpoint-plugin/dist/index.js
+var require_dist6 = __commonJS({
+  "../codegen-checkpoint-plugin/dist/index.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.checkpointPluginFactory = void 0;
+    var checkpoint_1 = require_checkpoint();
+    Object.defineProperty(exports2, "checkpointPluginFactory", { enumerable: true, get: function() {
+      return checkpoint_1.checkpointPluginFactory;
+    } });
+  }
+});
+
+// ../codegen-studio-2-config/dist/site-data-layer-rules.js
+var require_site_data_layer_rules = __commonJS({
+  "../codegen-studio-2-config/dist/site-data-layer-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.SITE_DATA_LAYER_RULES = void 0;
+    exports2.SITE_DATA_LAYER_RULES = `# Site Data Layer Rules
+
+The agent operates on a live Wix site (METASITE_ID is in your prompt context).
+
+For any persistent-data need \u2014 CMS collections, content tables, schemas, data models, or databases that store items \u2014 use the \`wix-site-data-collection\` skill.
+
+The \`wix-app\` skill remains the right tool for surrounding extensions (dashboard pages, modals, widgets); only the data layer is overridden. A Wix CLI data collection extension will NOT work here \u2014 it only provisions on app install, but this is a live site that already exists. Use the \`wix-site-data-collection\` skill to discover the existing collections on the site and wire your code against them.
+
+DO NOT write any code relating to Wix CLI data extensions \u2014 for example, do not generate \`src/extensions/data/extensions.ts\`.`;
+  }
+});
+
+// ../codegen-studio-2-config/dist/index.js
+var require_dist7 = __commonJS({
+  "../codegen-studio-2-config/dist/index.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.studio2CodegenConfig = void 0;
+    var codegen_checkpoint_plugin_1 = require_dist6();
+    var site_data_layer_rules_1 = require_site_data_layer_rules();
+    exports2.studio2CodegenConfig = {
+      codegenRules: [
+        { filename: "site-data-layer-rules.md", content: site_data_layer_rules_1.SITE_DATA_LAYER_RULES }
+      ],
+      askRules: [],
+      decisionCheckers: [],
+      plugins: [codegen_checkpoint_plugin_1.checkpointPluginFactory]
+    };
+  }
+});
+
+// dist/opencode-integration/rules/codegen-rules.js
+var require_codegen_rules = __commonJS({
+  "dist/opencode-integration/rules/codegen-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.CODEGEN_RULES = void 0;
+    exports2.CODEGEN_RULES = `CORE PRINCIPLES:
+- Do NOT invent or assume new types, modules, functions, props, events, or imports.
+- NEVER use mocks, placeholders, debugging, or TODOs in any code.
+- ALWAYS implement complete, production-ready functionality.
+- Do NOT create test files or test code. Tests are out of scope for code generation.
+
+MINIMIZE TEXT OUTPUT \u2014 CRITICAL:
+- Do NOT narrate your actions. No "Let me now...", "Perfect!", "Now I'll...", "Excellent!", "Great!".
+- Do NOT explain what you just did. The tool output speaks for itself.
+- Do NOT read back files you just wrote. Trust the write succeeded.
+- Every text token costs money. Use tools, not words.
+
+TOOL USAGE:
+- \`progress\` to mark a step done. Call it ONCE per completed step, in the SAME response as the tool calls that did the work \u2014 never dedicate a separate turn to it. Report progress at EVERY meaningful milestone. Keep descriptions SHORT \u2014 mention the extension type but no file names, counts, namespaces, or other specifics. Examples:
+  - "Planning extensions"
+  - "Reading documentation"
+  - "Creating dashboard page"
+  - "Creating service plugin"
+  - "Creating data collection"
+  - "Registering extensions"
+  - "Running type checks"
+  - "Building project"
+- \`validate\` for all validation (tsc + build).
+- \`uuid\` to generate UUIDs (supports count param for multiple). Do NOT use bash.
+- 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.
+- To discover API shapes, method signatures, or type definitions: ALWAYS try \`SearchWixSDKDocumentation\` or \`ReadFullDocsMethodSchema\` via wix-mcp first. ONLY fall back to grepping \`node_modules\` if the MCP tools return no useful results. Grepping \`node_modules\` as a first resort wastes turns, inflates context, and produces unreliable results \u2014 SDK internals are not a documentation source.
+- NEVER run preview, dev, release, or promote commands.
+
+IMPLEMENTATION WORKFLOW:
+1. **Plan**: Determine extension types using the \`wix-app\` skill. Generate ALL UUIDs upfront. Include a \`progress\` call (e.g. "Planning extensions").
+2. **Research**: Load relevant SDK docs and skills for each extension type. Include a \`progress\` call (e.g. "Reading documentation").
+3. **Build**: Create every extension file in a SINGLE \`batch-write\` call. Build all extensions before registering. Include one \`progress\` call per extension type (e.g. "Creating dashboard page", "Creating service plugin").
+4. **Register**: Register all extensions in \`src/extensions.ts\`. Include a \`progress\` call (e.g. "Registering extensions").
+5. **Validate**: Run \`validate\` (typecheck only). Fix any errors and re-validate until tsc passes. Include a \`progress\` call (e.g. "Running type checks"). 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). Include a \`progress\` call (e.g. "Building project").
+6. **Stop**: STOP immediately. Do NOT refactor, clean up, or verify.
+
+EFFICIENCY:
+- 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.
+- Keep each file under 200 lines. Split into types.ts, utils.ts if needed.
+- Do NOT output comments in code unless they explain non-obvious logic.
+
+TYPESCRIPT:
+- The project enables \`verbatimModuleSyntax\`. Type-only imports MUST use \`import type\`.
+
+PERMISSIONS:
+At the end of your response, output the required Wix app permissions as a JSON block.
+Use SCOPE ID format (not human-readable names). Examples:
+- \`@wix/data\` read \u2192 "SCOPE.DC-DATA.READ", write \u2192 "SCOPE.DC-DATA.WRITE"
+- Embedded scripts \u2192 "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
+
+CRITICAL: Only include permissions that you have explicitly seen in the Wix SDK documentation (via MCP or loaded skills). NEVER guess or fabricate permission scope IDs. If you are unsure which permission a feature requires, look it up in the docs first. Omitting a permission is better than inventing one that does not exist.
+
+\`\`\`json:required-permissions
+["SCOPE.DC-DATA.READ", "SCOPE.DC-DATA.WRITE"]
+\`\`\`
+
+If no permissions are required, output an empty array:
+\`\`\`json:required-permissions
+[]
+\`\`\``;
   }
 });
 
-// dist/environments/hooks/checkpoint-rules.js
-var require_checkpoint_rules = __commonJS({
-  "dist/environments/hooks/checkpoint-rules.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.CHECKPOINT_COMMIT_MESSAGE_RULES = void 0;
-    exports2.CHECKPOINT_COMMIT_MESSAGE_RULES = `COMMIT MESSAGE:
-First thing, before writing any code, call the \`set-commit-message\` tool. See its description for format and length.`;
+// dist/opencode-integration/rules/ask-rules.js
+var require_ask_rules = __commonJS({
+  "dist/opencode-integration/rules/ask-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ASK_RULES = void 0;
+    exports2.ASK_RULES = `CORE PRINCIPLES:
+- You are a READ-ONLY assistant. You MUST NOT modify, create, or delete any files.
+- Your job is to answer questions about the codebase and Wix platform by reading code and fetching documentation.
+- Use the read tool to explore the codebase and find relevant code.
+- Use the wix-mcp tools to fetch Wix SDK/API documentation when needed.
+- Provide clear, accurate, and well-structured answers.
+
+TOOL USAGE:
+- \`progress\` to mark a step done. Call it ONCE per completed step, in the SAME response as the tool calls that did the work. Examples:
+  - "Reading codebase"
+  - "Looking up documentation"
+  - "Analyzing code"
+
+IMPORTANT INSTRUCTIONS:
+1. Do NOT edit, write, or create any files.
+2. Do NOT run any bash commands.
+3. READ the codebase to understand the code structure and find answers.
+4. Use MCP tools to look up Wix documentation when the question involves Wix APIs, SDKs, or platform features.
+5. If you cannot find a definitive answer, say so clearly and explain what you found.
+
+DEBUGGING GUIDANCE:
+- A preview/dev server is ALREADY running in this environment. NEVER recommend \`wix dev\`, \`wix preview\`, \`npx wix dev\`, or \`npx wix preview\`. Starting another server conflicts with and breaks the one already running, costing the user their work.
+- When asked how to debug the app, view logs, or inspect errors/network requests, recommend ONLY approaches that are safe alongside the running server:
+  - Browser DevTools: the Console, Network, and Sources tabs.
+  - \`console.log\` statements, then read the output in the already-running server logs.
+  - Inspecting network requests in the browser, without starting a new server.`;
   }
 });
 
-// dist/environments/hooks/run-hooks.js
-var require_run_hooks = __commonJS({
-  "dist/environments/hooks/run-hooks.js"(exports2) {
+// dist/job-decision-manager.js
+var require_job_decision_manager = __commonJS({
+  "dist/job-decision-manager.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.getActiveHooks = getActiveHooks;
-    exports2.runOnToolUse = runOnToolUse;
-    exports2.runOnFlowEnd = runOnFlowEnd;
+    exports2.UserDecisionCancelledError = void 0;
+    exports2.pauseForUserDecision = pauseForUserDecision;
+    exports2.askJobChoice = askJobChoice;
+    exports2.askJobConfirmation = askJobConfirmation;
+    var types_1 = require_types_impl();
+    var codeGenerationService_12 = require_codeGenerationService();
+    var CodeGenService_12 = require_CodeGenService();
     var logger_12 = require_logger();
-    var job_context_storage_12 = require_job_context_storage();
-    function getActiveHooks() {
-      return job_context_storage_12.jobContextStorage.getStore()?.hooks ?? [];
+    var DECISION_POLL_INTERVAL_MS = 2e3;
+    var UserDecisionCancelledError = class extends Error {
+      constructor(jobId, decisionId) {
+        super(`User decision ${decisionId} cancelled for job ${jobId}`);
+        this.jobId = jobId;
+        this.decisionId = decisionId;
+        this.name = "UserDecisionCancelledError";
+      }
+    };
+    exports2.UserDecisionCancelledError = UserDecisionCancelledError;
+    async function pauseForUserDecision(jobId, request) {
+      const decisionId = crypto.randomUUID();
+      const userDecision = {
+        id: decisionId,
+        request: {
+          ...request,
+          requestedAt: /* @__PURE__ */ new Date()
+        }
+      };
+      await codeGenerationService_12.codeGenerationService.updateJobWithPendingDecision(jobId, userDecision);
+      logger_12.logger.info("[JobDecision] Paused for user input", {
+        question: request.question
+      });
+      const startTime = Date.now();
+      const response = await pollForJobDecisionResponse(jobId, decisionId);
+      const durationMs = Date.now() - startTime;
+      await codeGenerationService_12.codeGenerationService.resumeJobFromDecision(jobId);
+      logger_12.logger.info("[JobDecision] Resumed after user decision", {
+        selectedOptionId: response.selectedOptionId,
+        durationMs
+      });
+      return response;
     }
-    async function runOnToolUse(hooks, event) {
-      for (const hook of hooks) {
-        if (!hook.onToolUse)
-          continue;
-        try {
-          await hook.onToolUse(event);
-        } catch (error) {
-          logger_12.logger.error("[Hook] onToolUse failed", {
-            hook: hook.name,
-            error: error instanceof Error ? error.message : String(error)
-          });
+    async function pollForJobDecisionResponse(jobId, decisionId) {
+      logger_12.logger.info("[JobDecision] Polling for user decision response", {
+        decisionId
+      });
+      while (true) {
+        const job = await codeGenerationService_12.codeGenerationService.getJob(jobId);
+        if (!job) {
+          throw new Error(`Job ${jobId} not found`);
+        }
+        if (job.status === CodeGenService_12.Status.CANCELLED || job.status === CodeGenService_12.Status.PENDING_CANCEL) {
+          logger_12.logger.warn("[JobDecision] Job cancelled while waiting for user decision", { decisionId });
+          throw new UserDecisionCancelledError(jobId, decisionId);
+        }
+        const decision = job.pendingUserDecisions?.find((d) => d.id === decisionId) ?? job.userDecisionHistory?.find((d) => d.id === decisionId);
+        if (decision?.response?.selectedOptionId) {
+          return {
+            selectedOptionId: decision.response.selectedOptionId,
+            respondedAt: decision.response.respondedAt ?? /* @__PURE__ */ new Date()
+          };
         }
+        await new Promise((resolve) => setTimeout(resolve, DECISION_POLL_INTERVAL_MS));
       }
     }
-    async function runOnFlowEnd(hooks, ctx) {
-      for (const hook of hooks) {
-        if (!hook.onFlowEnd)
-          continue;
-        try {
-          await hook.onFlowEnd(ctx);
-        } catch (hookError) {
-          if (ctx.failed) {
-            logger_12.logger.error("[Hook] onFlowEnd failed after flow failure", {
-              hook: hook.name,
-              error: hookError instanceof Error ? hookError.message : String(hookError)
-            });
-            continue;
-          }
-          throw hookError;
-        }
+    async function askJobChoice(jobId, question, options, context) {
+      const response = await pauseForUserDecision(jobId, {
+        question,
+        questionType: types_1.UserDecisionQuestionType.UI_COMPONENT_TYPE,
+        options,
+        context
+      });
+      if (!response.selectedOptionId) {
+        throw new Error("No option selected in user decision response");
       }
+      return response.selectedOptionId;
+    }
+    async function askJobConfirmation(jobId, question, context) {
+      const response = await pauseForUserDecision(jobId, {
+        question,
+        questionType: types_1.UserDecisionQuestionType.UI_COMPONENT_TYPE,
+        options: [
+          { id: "yes", label: "Yes" },
+          { id: "no", label: "No" }
+        ],
+        context
+      });
+      return response.selectedOptionId === "yes";
     }
-  }
-});
-
-// dist/environments/hooks/index.js
-var require_hooks2 = __commonJS({
-  "dist/environments/hooks/index.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.runOnFlowEnd = exports2.runOnToolUse = exports2.getActiveHooks = void 0;
-    var run_hooks_1 = require_run_hooks();
-    Object.defineProperty(exports2, "getActiveHooks", { enumerable: true, get: function() {
-      return run_hooks_1.getActiveHooks;
-    } });
-    Object.defineProperty(exports2, "runOnToolUse", { enumerable: true, get: function() {
-      return run_hooks_1.runOnToolUse;
-    } });
-    Object.defineProperty(exports2, "runOnFlowEnd", { enumerable: true, get: function() {
-      return run_hooks_1.runOnFlowEnd;
-    } });
   }
 });
 
@@ -12413,21 +12253,14 @@ var require_environments = __commonJS({
   "dist/environments/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.getActiveHooks = void 0;
     exports2.getCodegenEnvironmentConfig = getCodegenEnvironmentConfig;
     var types_1 = require_types_impl();
     var codegen_app_builder_config_1 = require_dist5();
-    var codegen_studio_2_config_1 = require_dist6();
+    var codegen_studio_2_config_1 = require_dist7();
     var codegen_rules_1 = require_codegen_rules();
     var ask_rules_1 = require_ask_rules();
     var job_decision_manager_1 = require_job_decision_manager();
     var logger_12 = require_logger();
-    var checkpoint_1 = require_checkpoint();
-    var checkpoint_rules_1 = require_checkpoint_rules();
-    var hooks_1 = require_hooks2();
-    Object.defineProperty(exports2, "getActiveHooks", { enumerable: true, get: function() {
-      return hooks_1.getActiveHooks;
-    } });
     var SHARED_CODEGEN_RULE = {
       filename: "codegen-instructions.md",
       content: codegen_rules_1.CODEGEN_RULES
@@ -12444,18 +12277,7 @@ var require_environments = __commonJS({
     function getCodegenEnvironmentConfig() {
       switch (process.env.CODEGEN_ENVIRONMENT) {
         case types_1.Environment.STUDIO_2:
-          return withSharedRules({
-            ...codegen_studio_2_config_1.studio2CodegenConfig,
-            codegenRules: [
-              {
-                filename: "checkpoint-commit-message.md",
-                content: checkpoint_rules_1.CHECKPOINT_COMMIT_MESSAGE_RULES
-              },
-              ...codegen_studio_2_config_1.studio2CodegenConfig.codegenRules
-            ],
-            hooks: [checkpoint_1.checkpointHookFactory],
-            tools: ["set-commit-message.ts"]
-          });
+          return withSharedRules(codegen_studio_2_config_1.studio2CodegenConfig);
         case types_1.Environment.APP_BUILDER:
         default:
           return withSharedRules({
@@ -12989,6 +12811,54 @@ var require_progress_handler = __commonJS({
   }
 });
 
+// dist/plugins-runtime.js
+var require_plugins_runtime = __commonJS({
+  "dist/plugins-runtime.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getActivePlugins = getActivePlugins;
+    exports2.runOnToolUse = runOnToolUse;
+    exports2.runOnFlowEnd = runOnFlowEnd;
+    var job_context_storage_12 = require_job_context_storage();
+    function getActivePlugins() {
+      return job_context_storage_12.jobContextStorage.getStore()?.plugins ?? [];
+    }
+    var errorMessage = (error) => error instanceof Error ? error.message : String(error);
+    async function runOnToolUse(plugins, event, logger) {
+      for (const plugin of plugins) {
+        if (!plugin.onToolUse)
+          continue;
+        try {
+          await plugin.onToolUse(event);
+        } catch (error) {
+          logger.error("[Plugin] onToolUse failed", {
+            plugin: plugin.name,
+            error: errorMessage(error)
+          });
+        }
+      }
+    }
+    async function runOnFlowEnd(plugins, ctx, logger) {
+      logger.info("[Plugin] Running onFlowEnd", {
+        plugins: plugins.map((plugin) => plugin.name),
+        codegenFailed: ctx.codegenFailed
+      });
+      for (const plugin of plugins) {
+        if (!plugin.onFlowEnd)
+          continue;
+        try {
+          await plugin.onFlowEnd(ctx);
+        } catch (pluginError) {
+          logger.error("[Plugin] onFlowEnd failed", {
+            plugin: plugin.name,
+            error: errorMessage(pluginError)
+          });
+        }
+      }
+    }
+  }
+});
+
 // dist/opencode-integration/task-tracker/task-tracker.js
 var require_task_tracker = __commonJS({
   "dist/opencode-integration/task-tracker/task-tracker.js"(exports2) {
@@ -12999,7 +12869,7 @@ var require_task_tracker = __commonJS({
     var types_1 = require_types4();
     var logger_12 = require_logger();
     var progress_handler_1 = require_progress_handler();
-    var hooks_1 = require_hooks2();
+    var plugins_runtime_1 = require_plugins_runtime();
     var OpenCodeTaskTracker = class {
       constructor(workingDirectory) {
         this.skillsUsed = /* @__PURE__ */ new Set();
@@ -13043,7 +12913,7 @@ var require_task_tracker = __commonJS({
         if (tool === "progress") {
           void this.progressHandler.handle(state, this.handlerContext);
         }
-        await (0, hooks_1.runOnToolUse)((0, hooks_1.getActiveHooks)(), { tool, state });
+        await (0, plugins_runtime_1.runOnToolUse)((0, plugins_runtime_1.getActivePlugins)(), { tool, state }, logger_12.logger);
       }
       handleSkillEvent(state) {
         const skillName = state.title?.replace("Loaded skill: ", "") || "unknown";
@@ -13637,6 +13507,93 @@ var require_OpenCodeOrchestrator = __commonJS({
   }
 });
 
+// dist/utils.js
+var require_utils9 = __commonJS({
+  "dist/utils.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.serializeError = serializeError;
+    exports2.updateAllRunningTasks = updateAllRunningTasks;
+    var types_1 = require_types_impl();
+    var codeGenerationService_12 = require_codeGenerationService();
+    function serializeError(error) {
+      if (error instanceof Error) {
+        const base = {
+          name: error.name,
+          message: error.message,
+          stack: error.stack
+        };
+        const anyErr = error;
+        for (const key in anyErr) {
+          if (!(key in base)) {
+            try {
+              base[key] = anyErr[key];
+            } catch {
+            }
+          }
+        }
+        const withCause = error;
+        if (withCause && "cause" in withCause) {
+          base.cause = withCause.cause;
+        }
+        const maybeHttp = error;
+        if (maybeHttp?.response?.data !== void 0)
+          base.data = maybeHttp.response.data;
+        if (maybeHttp?.code !== void 0)
+          base.code = maybeHttp.code;
+        if (maybeHttp?.details !== void 0)
+          base.details = maybeHttp.details;
+        return base;
+      }
+      if (typeof error === "object" && error !== null) {
+        try {
+          return JSON.parse(JSON.stringify(error));
+        } catch {
+          return { message: String(error) };
+        }
+      }
+      return { message: String(error) };
+    }
+    async function updateAllRunningTasks(jobId, status, error) {
+      const job = await codeGenerationService_12.codeGenerationService.getJob(jobId);
+      const tasks = (job?.tasks ?? []).filter((task) => task.status === types_1.Status.RUNNING || task.status === types_1.Status.PENDING) || [];
+      for (const task of tasks) {
+        if (!task.id)
+          continue;
+        await codeGenerationService_12.codeGenerationService.updateTask(jobId, task.id, status, error ? { error: serializeError(error) } : {});
+      }
+    }
+  }
+});
+
+// dist/flows/codegen-flow-helpers.js
+var require_codegen_flow_helpers = __commonJS({
+  "dist/flows/codegen-flow-helpers.js"(exports2) {
+    "use strict";
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.updateJobPayload = updateJobPayload;
+    exports2.updateParentTaskStatus = updateParentTaskStatus;
+    exports2.getOutputPath = getOutputPath;
+    var path_1 = __importDefault2(require("path"));
+    var codeGenerationService_12 = require_codeGenerationService();
+    var utils_1 = require_utils9();
+    var DEFAULT_OUTPUT_PATH = "generated-app";
+    async function updateJobPayload(jobContext, payload) {
+      await codeGenerationService_12.codeGenerationService.updateJob(jobContext.jobId, payload);
+    }
+    async function updateParentTaskStatus(jobContext, status, error) {
+      await codeGenerationService_12.codeGenerationService.updateTask(jobContext.jobId, jobContext.taskId, status, error ? { error: (0, utils_1.serializeError)(error) } : {});
+    }
+    function getOutputPath() {
+      const outputDir = process.env.OUTPUT_PATH || DEFAULT_OUTPUT_PATH;
+      return outputDir.startsWith("/") ? outputDir : path_1.default.join(process.cwd(), outputDir);
+    }
+  }
+});
+
 // dist/flows/agent-io.js
 var require_agent_io = __commonJS({
   "dist/flows/agent-io.js"(exports2) {
@@ -15940,7 +15897,7 @@ var require_bi_logger_factory = __commonJS({
 });
 
 // ../../node_modules/@wix/wix-bi-logger-client/dist/index.js
-var require_dist7 = __commonJS({
+var require_dist8 = __commonJS({
   "../../node_modules/@wix/wix-bi-logger-client/dist/index.js"(exports2, module2) {
     "use strict";
     var BiLoggerClientFactory = require_bi_logger_factory();
@@ -18540,7 +18497,7 @@ var require_src2 = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.StandaloneNodeLogger = void 0;
     var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-    var wix_bi_logger_client_1 = tslib_1.__importDefault(require_dist7());
+    var wix_bi_logger_client_1 = tslib_1.__importDefault(require_dist8());
     var http_client_1 = require_index_node2();
     var defaultOptions = {
       baseUrl: process.env.BI_BASE_URL || "https://frog.wix.com",
@@ -18786,7 +18743,7 @@ var require_opencode_init = __commonJS({
     var biEvents_1 = require_biEvents();
     var pre_run_decision_1 = require_pre_run_decision();
     var environments_12 = require_environments();
-    var hooks_1 = require_hooks2();
+    var plugins_runtime_1 = require_plugins_runtime();
     var runOpencodeInitFlow = async (blueprint, history, agentData) => {
       const store = job_context_storage_12.jobContextStorage.getStore();
       if (!store?.jobId || !store?.taskId) {
@@ -18900,10 +18857,7 @@ var require_opencode_init = __commonJS({
           error: error instanceof Error ? error.message : String(error)
         });
       } finally {
-        await (0, hooks_1.runOnFlowEnd)((0, hooks_1.getActiveHooks)(), {
-          failed: caughtError !== void 0,
-          error: caughtError
-        });
+        await (0, plugins_runtime_1.runOnFlowEnd)((0, plugins_runtime_1.getActivePlugins)(), { codegenFailed: caughtError !== void 0, codegenError: caughtError }, logger_12.logger);
       }
     };
     exports2.runOpencodeInitFlow = runOpencodeInitFlow;
@@ -18982,7 +18936,7 @@ var require_opencode_iterate = __commonJS({
     var inject_created_by_1 = require_inject_created_by();
     var collect_extensions_created_1 = require_collect_extensions_created();
     var biEvents_1 = require_biEvents();
-    var hooks_1 = require_hooks2();
+    var plugins_runtime_1 = require_plugins_runtime();
     var runOpencodeIterateFlow = async (chatHistory, agentData) => {
       const store = job_context_storage_12.jobContextStorage.getStore();
       if (!store?.jobId || !store?.taskId) {
@@ -19086,10 +19040,7 @@ var require_opencode_iterate = __commonJS({
           error: error instanceof Error ? error.message : String(error)
         });
       } finally {
-        await (0, hooks_1.runOnFlowEnd)((0, hooks_1.getActiveHooks)(), {
-          failed: caughtError !== void 0,
-          error: caughtError
-        });
+        await (0, plugins_runtime_1.runOnFlowEnd)((0, plugins_runtime_1.getActivePlugins)(), { codegenFailed: caughtError !== void 0, codegenError: caughtError }, logger_12.logger);
       }
     };
     exports2.runOpencodeIterateFlow = runOpencodeIterateFlow;
@@ -19506,28 +19457,70 @@ var require_tools_writer = __commonJS({
     var os_1 = require("os");
     var path_1 = require("path");
     var logger_12 = require_logger();
-    var environments_12 = require_environments();
     var GLOBAL_TOOLS_DIR = (0, path_1.join)((0, os_1.homedir)(), ".config", "opencode", "tools");
     var OPENCODE_TOOLS_DIR = (0, path_1.join)(__dirname, "opencode-tools");
-    var ENV_TOOLS_DIR = (0, path_1.join)(OPENCODE_TOOLS_DIR, "env-tools");
-    async function writeToolFiles() {
+    async function writeToolFiles(pluginTools = []) {
       await (0, promises_1.mkdir)(GLOBAL_TOOLS_DIR, { recursive: true });
       const entries = await (0, promises_1.readdir)(OPENCODE_TOOLS_DIR);
       const alwaysOnTools = entries.filter((f) => f.endsWith(".ts"));
-      const envTools = (0, environments_12.getCodegenEnvironmentConfig)().tools ?? [];
       await Promise.all([
         ...alwaysOnTools.map((file) => (0, promises_1.copyFile)((0, path_1.join)(OPENCODE_TOOLS_DIR, file), (0, path_1.join)(GLOBAL_TOOLS_DIR, file))),
-        ...envTools.map((file) => (0, promises_1.copyFile)((0, path_1.join)(ENV_TOOLS_DIR, file), (0, path_1.join)(GLOBAL_TOOLS_DIR, file)))
+        ...pluginTools.map((tool) => (0, promises_1.writeFile)((0, path_1.join)(GLOBAL_TOOLS_DIR, tool.filename), tool.source, "utf-8"))
       ]);
       logger_12.logger.info("[OpenCode] Wrote global tool files", {
         targetDir: GLOBAL_TOOLS_DIR,
         alwaysOnTools,
-        envTools
+        pluginTools: pluginTools.map((t) => t.filename)
       });
     }
   }
 });
 
+// dist/plugin-host.js
+var require_plugin_host = __commonJS({
+  "dist/plugin-host.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.buildPluginHost = void 0;
+    var logger_12 = require_logger();
+    var codegen_flow_helpers_12 = require_codegen_flow_helpers();
+    var config_12 = require_config();
+    var buildPluginHost = () => ({
+      logger: logger_12.logger,
+      jobs: {
+        updatePayload: codegen_flow_helpers_12.updateJobPayload
+      },
+      auth: {
+        getAccessToken: config_12.getCurrentAccessToken
+      }
+    });
+    exports2.buildPluginHost = buildPluginHost;
+  }
+});
+
+// dist/plugin-artifacts.js
+var require_plugin_artifacts = __commonJS({
+  "dist/plugin-artifacts.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.collectPluginArtifacts = collectPluginArtifacts;
+    var plugin_host_12 = require_plugin_host();
+    function collectPluginArtifacts(envConfig) {
+      const rules = [];
+      const tools = [];
+      const host = (0, plugin_host_12.buildPluginHost)();
+      for (const factory of envConfig.plugins) {
+        const plugin = factory({ host });
+        if (plugin.rules)
+          rules.push(...plugin.rules);
+        if (plugin.tools)
+          tools.push(...plugin.tools);
+      }
+      return { rules, tools };
+    }
+  }
+});
+
 // dist/index.js
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processJob = processJob;
@@ -19547,8 +19540,10 @@ var logger_1 = require_logger();
 var skills_installer_1 = require_skills_installer();
 var rules_writer_1 = require_rules_writer();
 var tools_writer_1 = require_tools_writer();
+var plugin_artifacts_1 = require_plugin_artifacts();
 var config_1 = require_config();
 var environments_1 = require_environments();
+var plugin_host_1 = require_plugin_host();
 var sessionId = process.env.CODEGEN_SESSION_ID || (0, crypto_1.randomUUID)();
 process.env.CODEGEN_SESSION_ID = sessionId;
 (0, logger_1.initLogger)(sessionId);
@@ -19598,11 +19593,12 @@ var alwaysOnLoop = async () => {
 };
 async function initOpenCode() {
   const envConfig = (0, environments_1.getCodegenEnvironmentConfig)();
+  const pluginArtifacts = (0, plugin_artifacts_1.collectPluginArtifacts)(envConfig);
   await Promise.all([
-    (0, rules_writer_1.writeRuleFiles)(envConfig.codegenRules),
+    (0, rules_writer_1.writeRuleFiles)([...envConfig.codegenRules, ...pluginArtifacts.rules]),
     (0, rules_writer_1.writeRuleFiles)(envConfig.askRules),
     (0, skills_installer_1.installSkills)((0, codegen_flow_helpers_1.getOutputPath)(), logger_1.logger),
-    (0, tools_writer_1.writeToolFiles)()
+    (0, tools_writer_1.writeToolFiles)(pluginArtifacts.tools)
   ]);
 }
 async function main(ctx) {
@@ -19618,17 +19614,21 @@ async function main(ctx) {
 var getFirstTask = (job) => {
   return job.tasks?.[0];
 };
-function buildHooksForTask(jobId, taskId, kind, payload) {
+function buildPluginsForTask(jobId, taskId, kind, payload) {
   if (kind !== CodeGenService_1.TaskKind.INIT_CODEGEN && kind !== CodeGenService_1.TaskKind.ITERATE_CODEGEN) {
     return void 0;
   }
   const userInput = extractUserInput(kind, payload);
-  return (0, environments_1.getCodegenEnvironmentConfig)().hooks.map((factory) => factory({
-    projectId: context_1.ctx.projectId,
-    jobId,
-    taskId,
-    kind,
-    userInput
+  const host = (0, plugin_host_1.buildPluginHost)();
+  return (0, environments_1.getCodegenEnvironmentConfig)().plugins.map((factory) => factory({
+    host,
+    job: {
+      projectId: context_1.ctx.projectId,
+      jobId,
+      taskId,
+      kind,
+      userInput
+    }
   }));
 }
 function extractUserInput(kind, payload) {
@@ -19656,8 +19656,8 @@ async function processJob(job) {
     return;
   }
   const payload = task.payload ?? {};
-  const hooks = buildHooksForTask(jobId, task.id, task.kind, payload);
-  await job_context_storage_1.jobContextStorage.run({ jobId, taskId: task.id, kind: task.kind, hooks }, async () => {
+  const plugins = buildPluginsForTask(jobId, task.id, task.kind, payload);
+  await job_context_storage_1.jobContextStorage.run({ jobId, taskId: task.id, kind: task.kind, plugins }, async () => {
     logger_1.logger.info("[Job] Start processing", { taskKind: task.kind });
     context_1.ctx.setJobStatus(jobId, CodeGenService_1.Status.RUNNING);
     logger_1.logger.info("[Job] Marked job RUNNING", { initTaskId: task.id });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.347",
+  "version": "1.0.349",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -8,7 +8,8 @@
   },
   "bin": "dist/out.js",
   "files": [
-    "dist"
+    "dist",
+    "assets"
   ],
   "dependencies": {
     "esbuild": "^0.27.2"
@@ -28,5 +29,5 @@
     "esbuild": "^0.27.2",
     "vitest": "^4.0.16"
   },
-  "falconPackageHash": "08231ee565611b4b7a817e282b1afc9a2c80d4e437af9683d13fa37c"
+  "falconPackageHash": "7bf8f9326f7820f00099545cc4aebcdd29a5edecaf96fb1f3cbd53c3"
 }