@wix/ditto-codegen-public 1.0.463 → 1.0.465

package/dist/opencode-tools/report-wix-feedback.ts

@@ -0,0 +1,91 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { tool } from "@opencode-ai/plugin";
+
+const execFileAsync = promisify(execFile);
+
+// The endpoint behind @wix/mcp's SupportAndFeedback tool, which the local
+// stdio @wix/mcp doesn't register. Relays to the #mcp-user-feedback Slack
+// channel, attributed to the token's user.
+const FEEDBACK_API_URL = "https://www.wixapis.com/mcp-serverless/v1/feedback";
+const FEEDBACK_TIMEOUT_MS = 15_000;
+
+async function getWixAccessToken(): Promise<string> {
+  const { stdout } = await execFileAsync("wix", ["token", "--json"], {
+    timeout: 30_000,
+  });
+  const { accessToken } = JSON.parse(stdout) as { accessToken?: string };
+  if (!accessToken) {
+    throw new Error("wix token returned empty accessToken");
+  }
+  return accessToken;
+}
+
+function buildProvenance(): string {
+  const lines = [
+    `Source: Codegen running on ${process.env.CODEGEN_ENVIRONMENT ?? "unknown environment"}`,
+    process.env.CODEGEN_JOB_ID && `Codegen job id: ${process.env.CODEGEN_JOB_ID}`,
+    process.env.CODEGEN_PROJECT_ID &&
+      `Project id: ${process.env.CODEGEN_PROJECT_ID}`,
+    process.env.CODEGEN_METASITE_ID &&
+      `Meta site id: ${process.env.CODEGEN_METASITE_ID}`,
+  ];
+  return lines.filter(Boolean).join("\n");
+}
+
+export default tool({
+  description:
+    "Report a problem with Wix docs or the wix-mcp tools to the Wix MCP team. Call it when " +
+    "docs or MCP — not your own code — made the task harder: a search whose top results were " +
+    "off-target, an article or example that is wrong or missing the fields you needed, a " +
+    "method schema that doesn't match the installed SDK types, or an MCP tool error. Include " +
+    "cases you recovered from. Do NOT report your own mistakes or the user's request. Call it " +
+    "at most ONCE per task, covering every friction point you've hit so far.",
+  args: {
+    message: tool.schema
+      .string()
+      .min(1)
+      .describe(
+        "Plain-text report. For each friction point: the tool and exact input (search " +
+          "term, docs URL), what came back, what was wrong or missing, the workaround you " +
+          "used, and what you expected. Then your best guess of where the fault lives " +
+          "(search ranking / docs article or example / method schema / SDK typings / MCP " +
+          "tool) and whether you confirmed it. End with one line naming the most important " +
+          "problem. No secrets or tokens.",
+      ),
+    requestId: tool.schema
+      .string()
+      .optional()
+      .describe(
+        "x-wix-request-id of a failed Wix API call this report relates to, if any.",
+      ),
+  },
+  async execute(args) {
+    const message = [
+      buildProvenance(),
+      args.message,
+      args.requestId && `request id: ${args.requestId}`,
+    ]
+      .filter(Boolean)
+      .join("\n\n");
+
+    try {
+      const response = await fetch(FEEDBACK_API_URL, {
+        method: "POST",
+        headers: {
+          Authorization: await getWixAccessToken(),
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ message }),
+        signal: AbortSignal.timeout(FEEDBACK_TIMEOUT_MS),
+      });
+      if (!response.ok) {
+        return `Failed to send the report (HTTP ${response.status}). Continue your task — do not retry.`;
+      }
+      return "Report sent to the Wix MCP team. Continue your task.";
+    } catch (error) {
+      const reason = error instanceof Error ? error.message : String(error);
+      return `Failed to send the report (${reason}). Continue your task — do not retry.`;
+    }
+  },
+});

package/dist/out.js

@@ -11298,13 +11298,6 @@ var require_CodeGenService = __commonJS({
           metasiteId: ctx.metasiteId ?? "",
           durationMs: ctx.durationMs != null ? String(ctx.durationMs) : void 0
         });
-        this.handleValidationErrors = async (output, context = {}) => {
-          await this.request((0, http_1.handleValidationErrors)({
-            output,
-            costUsd: context.costUsd,
-            ...this.runContext(context)
-          }));
-        };
         this.handlePluginFailure = async (input) => {
           await this.request((0, http_1.handlePluginFailure)({
             pluginName: input.pluginName,
@@ -11726,6 +11719,7 @@ var require_model_knobs = __commonJS({
     exports2.getSmallModel = getSmallModel;
     exports2.hasModelOverride = hasModelOverride;
     exports2.hasSmallModelOverride = hasSmallModelOverride;
+    exports2.readEnumEnv = readEnumEnv;
     exports2.getReasoningEffort = getReasoningEffort;
     exports2.getSmallReasoningEffort = getSmallReasoningEffort;
     exports2.hasSmallReasoningEffortOverride = hasSmallReasoningEffortOverride;
@@ -11823,7 +11817,7 @@ var require_subagents = __commonJS({
   "dist/opencode-integration/configuration/subagents.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.SUBAGENT_AGENT_NAMES = exports2.WDS_DOCS_SUBAGENT_NAME = exports2.WIX_DOCS_SUBAGENT_NAME = exports2.VALIDATOR_SUBAGENT_NAME = exports2.PRIMARY_AGENT_NAME = void 0;
+    exports2.SUBAGENT_AGENT_NAMES = exports2.VALIDATOR_SUBAGENT_NAME = exports2.PRIMARY_AGENT_NAME = void 0;
     exports2.getAgentConfig = getAgentConfig;
     exports2.getMainAgentModel = getMainAgentModel;
     exports2.getSubagentModel = getSubagentModel;
@@ -11832,13 +11826,7 @@ var require_subagents = __commonJS({
     var model_knobs_1 = require_model_knobs();
     exports2.PRIMARY_AGENT_NAME = "codegen";
     exports2.VALIDATOR_SUBAGENT_NAME = "codegen-validator";
-    exports2.WIX_DOCS_SUBAGENT_NAME = "codegen-wix-docs";
-    exports2.WDS_DOCS_SUBAGENT_NAME = "codegen-wds-docs";
-    exports2.SUBAGENT_AGENT_NAMES = [
-      exports2.VALIDATOR_SUBAGENT_NAME,
-      exports2.WIX_DOCS_SUBAGENT_NAME,
-      exports2.WDS_DOCS_SUBAGENT_NAME
-    ];
+    exports2.SUBAGENT_AGENT_NAMES = [exports2.VALIDATOR_SUBAGENT_NAME];
     var VALIDATOR_DESCRIPTION = `Runs validate (tsc + wix build) and fixes the reported errors, consulting the
 skills or wix-mcp for SDK-shape errors; returns when the build is clean
 or reports what it couldn't fix. Validation step only \u2014 never generates features.`;
@@ -11865,42 +11853,7 @@ unfixed. Work in a bounded number of fix cycles \u2014 if the build isn't conver
 after a few attempts, STOP and return the remaining errors verbatim rather than
 looping; never silence them.
 
-When done, if you fixed any errors or any remain unfixed, write NEEDS_INVESTIGATION
-as the very first line of your response (before the summary).
-Then summarize each error: message, file, root cause, fix. No diffs.
-(NEEDS_INVESTIGATION triggers a team alert to improve codegen for future runs.)`;
-    var WIX_DOCS_DESCRIPTION = `Use ONLY to discover a Wix SDK you don't know and that the skills +
-KNOWN WIX APIS don't cover. Send ONE complete question; returns the import path
-+ exported namespace/method + runtime context + full signature + any required
-scope/permission IDs + any user setup prerequisites (dependent app to install,
-dashboard setting to enable, template to create) + a short usage example (not a
-link). Don't fetch a doc you already identified, and don't split a lookup into
-separate search/signature calls. Read-only.`;
-    var WIX_DOCS_PROMPT = `You research Wix SDK APIs via wix-mcp and report back \u2014 never write app code.
-The caller uses DIRECT imports inside an extension that already supplies
-auth/host: 'import { <namespace> } from "@wix/<pkg>"; await <namespace>.<method>(<optionsObject>)'
-\u2014 describe that form, NEVER a 'createClient'/'wixClient' client. Report the SDK,
-NOT the REST spec: REST names, namespaces, and positional params often differ,
-so verify the method EXISTS as an SDK export. Steps: (1) read the SDK
-introduction ('SearchWixSDKDocumentation' \u2192 'ReadFullDocsArticle') to confirm
-it's the RIGHT API and its runtime context \u2014 backend, the dashboard host, or the
-site/editor host (host modules like @wix/dashboard work ONLY in their own host);
-(2) read 'ReadFullDocsMethodSchema' for the exact exported name and its
-options-object parameters; (3) capture any user SETUP prerequisites the docs
-call out (often a 'Before you begin' section) \u2014 a dependent app that must be
-installed (e.g. Wix Stores, Members Area), a dashboard setting that must be
-enabled (e.g. Automations for back-in-stock notifications), or a template/config
-the user must create first (e.g. a triggered email). Reply with: the import path
-+ exported namespace/method, the runtime context, the full TypeScript signature,
-a short usage example \u2014 never a bare link, never 'as any' or a guessed method \u2014
-and a SETUP STEPS list of the prerequisites from (3) so the main agent can relay
-them to the user (say 'none' if there are none). If the API is limited to one
-context, say so. For a required scope/permission, return the EXACT scope-ID
-string from the docs (never a guessed format); if none is documented, say so.`;
-    var WDS_DOCS_DESCRIPTION = `Use ONLY when building dashboard UI and you need a Wix Design System
-component/prop/example you don't know and the skills don't cover.
-Returns the component name + props + a short usage example. Not for layouts the
-skills already cover. Read-only.`;
+When done, summarize each error: message, file, root cause, fix. No diffs.`;
     var SUBAGENT_DENIED_TOOLS = {
       [
         "task"
@@ -11925,29 +11878,10 @@ skills already cover. Read-only.`;
       [
         "required-permissions"
         /* OpenCodeTool.RequiredPermissions */
-      ]: "deny"
-    };
-    var DOCS_SUBAGENT_DENIED_TOOLS = {
-      ...SUBAGENT_DENIED_TOOLS,
-      [
-        "edit"
-        /* OpenCodeTool.Edit */
-      ]: "deny",
-      [
-        "write"
-        /* OpenCodeTool.Write */
-      ]: "deny",
-      [
-        "batch-write"
-        /* OpenCodeTool.BatchWrite */
-      ]: "deny",
-      [
-        "multi-edit"
-        /* OpenCodeTool.MultiEdit */
       ]: "deny",
       [
-        "validate"
-        /* OpenCodeTool.Validate */
+        "report-wix-feedback"
+        /* OpenCodeTool.ReportWixFeedback */
       ]: "deny"
     };
     var READ_TOOLS = {
@@ -12015,9 +11949,7 @@ skills already cover. Read-only.`;
               /* OpenCodeTool.Task */
             ]: {
               [types_1.PERMISSION_WILDCARD]: "deny",
-              [exports2.VALIDATOR_SUBAGENT_NAME]: "allow",
-              [exports2.WIX_DOCS_SUBAGENT_NAME]: "allow",
-              [exports2.WDS_DOCS_SUBAGENT_NAME]: "allow"
+              [exports2.VALIDATOR_SUBAGENT_NAME]: "allow"
             }
           }
         },
@@ -12046,46 +11978,6 @@ skills already cover. Read-only.`;
             ]: "allow",
             [constants_1.WIX_MCP_SERVER_NAME]: "allow"
           }
-        },
-        [exports2.WIX_DOCS_SUBAGENT_NAME]: {
-          mode: "subagent",
-          ...subagent,
-          steps: 15,
-          description: WIX_DOCS_DESCRIPTION,
-          prompt: WIX_DOCS_PROMPT,
-          permission: {
-            ...DOCS_SUBAGENT_DENIED_TOOLS,
-            ...READ_TOOLS,
-            [
-              "bash"
-              /* OpenCodeTool.Bash */
-            ]: "deny",
-            [
-              "skill"
-              /* OpenCodeTool.Skill */
-            ]: "allow",
-            [constants_1.WIX_MCP_SERVER_NAME]: "allow"
-          }
-        },
-        [exports2.WDS_DOCS_SUBAGENT_NAME]: {
-          mode: "subagent",
-          ...subagent,
-          steps: 15,
-          description: WDS_DOCS_DESCRIPTION,
-          permission: {
-            ...DOCS_SUBAGENT_DENIED_TOOLS,
-            ...READ_TOOLS,
-            // The wix-design-system skill shells out to a script, so bash is needed.
-            [
-              "bash"
-              /* OpenCodeTool.Bash */
-            ]: "allow",
-            [
-              "skill"
-              /* OpenCodeTool.Skill */
-            ]: "allow",
-            [constants_1.WIX_MCP_SERVER_NAME]: "deny"
-          }
         }
       };
     }
@@ -15035,7 +14927,16 @@ var require_codegen_rules = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.buildCodegenRules = buildCodegenRules;
     var shared_rules_1 = require_shared_rules();
-    var CODEGEN_CORE_RULES = `CORE PRINCIPLES:
+    var model_knobs_1 = require_model_knobs();
+    var DELEGATED_VALIDATION = {
+      toolRule: "- `validate` (tsc + build) is run by the `codegen-validator` subagent \u2014 do NOT call it directly; delegate via `task` at step 5.",
+      step: `5. **Validate**: Dispatch ONE \`task({ subagent: "codegen-validator", prompt: "Run validate({ runBuild: true }) \u2014 it typechecks AND builds in a single pass (tsc runs first and fails fast before the build). Fix any errors and re-run until it passes. Pass installDeps: true only if package.json changed and npm install was not already run in this session." })\`. Wait for the subagent to return. Do NOT call \`validate\` directly from the primary agent, and do NOT make a separate tsc-only call first \u2014 the single runBuild pass already fails fast on type errors. VERIFY the subagent actually FINISHED with a clean build: read its returned summary and confirm it converged. If it reports remaining/unresolved errors or was cut off before finishing (e.g. "Maximum steps reached"), do NOT treat it as success \u2014 re-dispatch \`codegen-validator\` to finish the remaining errors before moving on. After the validator confirms a clean build, if you created or modified an EDITOR_REACT_COMPONENT extension in this task, run \`npx wix generate manifest\` via bash (the validator is instructed not to run it, so this is the only run).`
+    };
+    var DIRECT_VALIDATION = {
+      toolRule: "- `validate` (tsc + build) \u2014 you call it yourself at step 5. Do NOT delegate it.",
+      step: `5. **Validate**: Call \`validate({ runBuild: true })\` yourself \u2014 it typechecks AND builds in a single pass (tsc runs first and fails fast before the build). Fix any errors and re-run until it passes. Pass installDeps: true only if package.json changed and npm install was not already run in this session. Do NOT delegate this to a subagent, and do NOT make a separate tsc-only call first \u2014 the single runBuild pass already fails fast on type errors. Do NOT move on until the build is clean. After the build is clean, if you created or modified an EDITOR_REACT_COMPONENT extension in this task, run \`npx wix generate manifest\` via bash (idempotent).`
+    };
+    var buildCoreRules = (validation) => `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.
@@ -15047,15 +14948,14 @@ MINIMIZE TEXT OUTPUT \u2014 CRITICAL:
 - Every text token costs money. Use tools, not words.
 
 TOOL USAGE:
-- \`validate\` (tsc + build) is run by the \`codegen-validator\` subagent \u2014 do NOT call it directly; delegate via \`task\` at step 5.
-- \`task\` delegates to subagents: \`codegen-validator\` (step 5; see step 5 for the exact prompt), \`codegen-wix-docs\` (step 2; to SEARCH/discover an unknown Wix SDK method/shape/scope ID via wix-mcp), \`codegen-wds-docs\` (step 2; to discover WDS components/props you don't know). Docs subagents are for DISCOVERY only \u2014 give them a QUESTION ("which method lists X?"), never a known article URL to fetch.
-  - Each \`task\` round-trip is EXPENSIVE (~90s of subagent startup, regardless of how small the question). So minimize them: ask ONE comprehensive question per API that returns everything you need at once \u2014 method name + FULL call signature + parameter shapes + required scope IDs. NEVER do a broad "find the X SDK" call and then a follow-up "what's the exact signature" call \u2014 that is two ~90s round-trips for one answer. Batch all your unknowns for a domain into a single delegation.
-  - If BOTH docs subagents are needed, fire both \`task\` calls in ONE response (parallel), never serially.
+${validation.toolRule}
 - \`uuid\` to generate UUIDs (supports count param for multiple). Do NOT use bash.
 - \`wix-generate\` to scaffold extensions non-interactively \u2014 prefer over hand-writing boilerplate; pass an array to scaffold several at once. It RETURNS every created file's contents, so trust that and do NOT \`read\`/\`batch-read\` them afterward. On a \`FAILED\` block, fix the params per the error and retry.
 - \`required-permissions\` \u2014 declare the Wix app permissions the generated code needs (when/whether to call: workflow step 6 + PERMISSIONS).
 ${(0, shared_rules_1.buildFileOperationsRules)("fixing type errors")}
-- API discovery (shapes, method signatures, types) \u2014 in this order: (1) loaded skills + KNOWN WIX APIS, if they already cover the API \u2014 if so, do NOT delegate; (2) only when you genuinely don't know which method/API to use, delegate to \`codegen-wix-docs\` (Wix SDK) or \`codegen-wds-docs\` (WDS) to SEARCH for it \u2014 pass the question, not a known article link; the subagent searches AND reads the right schema (\`ReadFullDocsMethodSchema\` is the source of truth for parameter shapes) and returns a summary. Do NOT delegate just to fetch a doc you already identified; (3) grepping \`node_modules\` ONLY as a last resort if the above return nothing \u2014 SDK internals are not a documentation source, and doing it first wastes turns, inflates context, and is unreliable. ENFORCED: after 2 such lookups, further bash inspection of \`node_modules\` Wix/vite/astro internals is rejected.
+- API discovery (shapes, method signatures, types) \u2014 in this order: (1) loaded skills + KNOWN WIX APIS, if they already cover the API; (2) wix-mcp, yourself: \`SearchWixSDKDocumentation\` to find the method, then \`ReadFullDocsMethodSchema\` for its exact exported name, options object, response fields, enum values and scope IDs \u2014 the schema is the source of truth; an article or its examples are not. Model the call on the SDK view, not REST, and use the direct form inside the extension: \`import { <namespace> } from "@wix/<pkg>"; await <namespace>.<method>(<options>)\` \u2014 never \`createClient\`. Note any setup the docs require from the user (an app to install, a dashboard setting to enable) for the final message. For WDS components/props, use the \`wix-design-system\` skill; (3) grepping \`node_modules\` ONLY as a last resort if the above return nothing \u2014 SDK internals are not a documentation source, and doing it first wastes turns, inflates context, and is unreliable.
+- NEVER write a Wix SDK method, field, or enum value you haven't seen in a skill or a method schema.
+- \`report-wix-feedback\` \u2014 report Wix docs / wix-mcp problems to Wix (when: workflow step 7).
 - NEVER run preview, dev, release, or promote commands.
 
 KNOWN WIX APIS (already documented \u2014 do NOT rediscover these from node_modules; for full detail consult the \`wix-app\` skill's references or \`ReadFullDocsMethodSchema\`):
@@ -15064,13 +14964,14 @@ KNOWN WIX APIS (already documented \u2014 do NOT rediscover these from node_modu
 
 IMPLEMENTATION WORKFLOW:
 1. **Plan**: Determine extension types using the \`wix-app\` skill. Generate ALL UUIDs upfront.
-2. **Research**: Load the \`wix-app\` skill per extension type. SKIP this step entirely if the skill + KNOWN WIX APIS cover everything (common for dashboard + data-collection apps). Otherwise delegate ONLY to search for an API you genuinely can't identify \u2014 \`codegen-wix-docs\` (SDK), \`codegen-wds-docs\` (WDS), both in ONE response if both needed; pass each the question, not a known doc link \u2014 and wait for the summaries before building.
+2. **Research**: Load the \`wix-app\` skill per extension type. SKIP this step entirely if the skill + KNOWN WIX APIS cover everything (common for dashboard + data-collection apps). Otherwise look up only the APIs you genuinely can't identify, via wix-mcp (see API discovery).
 3. **Build**: Write files incrementally \u2014 group by logical section, NOT all at once. For complex tasks (300+ total lines across files), split into multiple \`batch-write\` calls. NEVER hold back writing until all code is planned \u2014 write each logical piece as soon as it is ready. Build all extensions before registering.
 4. **Register**: Register all extensions in \`src/extensions.ts\`.
-5. **Validate**: Dispatch ONE \`task({ subagent: "codegen-validator", prompt: "Run validate({ runBuild: true }) \u2014 it typechecks AND builds in a single pass (tsc runs first and fails fast before the build). Fix any errors and re-run until it passes. Pass installDeps: true only if package.json changed and npm install was not already run in this session." })\`. Wait for the subagent to return. Do NOT call \`validate\` directly from the primary agent, and do NOT make a separate tsc-only call first \u2014 the single runBuild pass already fails fast on type errors. VERIFY the subagent actually FINISHED with a clean build: read its returned summary and confirm it converged. If it reports remaining/unresolved errors or was cut off before finishing (e.g. "Maximum steps reached"), do NOT treat it as success \u2014 re-dispatch \`codegen-validator\` to finish the remaining errors before moving on. After the validator confirms a clean build, if you created or modified an EDITOR_REACT_COMPONENT extension in this task, run \`npx wix generate manifest\` via bash (the validator is instructed not to run it, so this is the only run).
+${validation.step}
 6. **Declare permissions**: If the generated code requires Wix app permissions, call \`required-permissions\` ONCE with their SCOPE IDs (see PERMISSIONS below). Skip this step entirely if no permissions are needed.
-7. **Final message**: Your last message is returned to the user as the codegen output \u2014 keep it short and plain (a sentence or two on what the app now does). Do NOT mention permissions/scopes here (see PERMISSIONS) and follow OUTPUT MESSAGE below.
-8. **Stop**: STOP immediately. Do NOT refactor, clean up, or verify.
+7. **Report docs problems**: Skip this step if you already called \`report-wix-feedback\` this run. Otherwise look back at the run: if ANY of these happened, call it ONCE covering all of them: (a) you inspected \`node_modules\` to find a Wix SDK signature, shape, or type because the docs didn't give you one that compiles; (b) the validator fixed a Wix SDK call you wrote from the docs \u2014 read its summary; (c) a doc example, article, or schema contradicted the installed SDK types; (d) a search's top results were off-target, or a wix-mcp tool failed. For each: the docs URL or search term, what it showed, and what actually worked.
+8. **Final message**: Your last message is returned to the user as the codegen output \u2014 keep it short and plain (a sentence or two on what the app now does). Do NOT mention permissions/scopes here (see PERMISSIONS) and follow OUTPUT MESSAGE below.
+9. **Stop**: STOP immediately. Do NOT refactor, clean up, or verify.
 
 FILE CREATION:
 - NEVER rewrite the same file twice. Once written, move on.
@@ -15092,11 +14993,15 @@ When you call \`required-permissions\` (see workflow step 6 for when), use SCOPE
 CRITICAL: Only include permissions you have explicitly seen in the Wix SDK documentation (via MCP or loaded skills) \u2014 NEVER guess or infer a scope ID. If you cannot point to where you saw it, do NOT include it. When in doubt, skip the call entirely. A fabricated scope ID will show an error to the user and confuse them; a missing permission is just a warning the user can fix.
 
 The \`required-permissions\` tool records and surfaces permissions to the user automatically \u2014 NEVER mention permissions/scopes (IDs or names) in your output, or tell the user to grant them.`;
+    function isValidatorSubagentSkipped() {
+      return (0, model_knobs_1.readEnumEnv)("CODEGEN_RULES_NO_VALIDATOR", ["1"]) === "1";
+    }
     function buildCodegenRules(environmentIdentity) {
+      const validation = isValidatorSubagentSkipped() ? DIRECT_VALIDATION : DELEGATED_VALIDATION;
       return [
         (0, shared_rules_1.buildEnvironmentRules)(environmentIdentity),
         shared_rules_1.BOUNDARY_RULES,
-        CODEGEN_CORE_RULES,
+        buildCoreRules(validation),
         shared_rules_1.OUTPUT_MESSAGE_RULES
       ].join("\n\n");
     }
@@ -15382,6 +15287,7 @@ var require_config = __commonJS({
     var rules_writer_12 = require_rules_writer();
     var environments_12 = require_environments();
     var CodeGenService_12 = require_CodeGenService();
+    var job_context_storage_12 = require_job_context_storage();
     exports2.DEFAULT_TIMEOUT_MS = 20 * 60 * 1e3;
     function usesOpenAiProvider() {
       return (0, model_knobs_1.isOpenAiModel)((0, model_knobs_1.getModel)()) || (0, model_knobs_1.isOpenAiModel)((0, model_knobs_1.getSmallModel)());
@@ -15615,7 +15521,11 @@ var require_config = __commonJS({
         OPENCODE_CONFIG_CONTENT: JSON.stringify(config),
         OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS: exports2.DEFAULT_TIMEOUT_MS.toString(),
         OPENCODE_DISABLE_LSP_DOWNLOAD: "true",
-        OPENCODE_DISABLE_FILETIME_CHECK: "true"
+        OPENCODE_DISABLE_FILETIME_CHECK: "true",
+        // Read by the report-wix-feedback tool to tag reports with their run.
+        CODEGEN_PROJECT_ID: projectId,
+        CODEGEN_JOB_ID: job_context_storage_12.jobContextStorage.getStore()?.jobId ?? "",
+        CODEGEN_METASITE_ID: job_context_storage_12.jobContextStorage.getStore()?.metasiteId ?? ""
       };
     }
     function getOpenCodeEnv(projectId, kind) {
@@ -15826,12 +15736,8 @@ var require_parser = __commonJS({
     exports2.parseUsageStats = parseUsageStats;
     exports2.mergeUsageStats = mergeUsageStats;
     exports2.hasSessionError = hasSessionError;
-    exports2.isStepCappedValidatorOutput = isStepCappedValidatorOutput;
-    exports2.shouldReportValidatorOutput = shouldReportValidatorOutput;
-    exports2.parseValidatorTaskOutputs = parseValidatorTaskOutputs;
     exports2.summarizeOpenCodeLine = summarizeOpenCodeLine;
     var types_1 = require_types4();
-    var subagents_1 = require_subagents();
     var subagent_tool_logger_1 = require_subagent_tool_logger();
     function parseRequiredPermissions(output) {
       let permissions = [];
@@ -15958,30 +15864,6 @@ var require_parser = __commonJS({
         ...input.description && { description: truncate(input.description) }
       };
     }
-    var STEP_CAP_RE = /maximum steps reached/i;
-    function isStepCappedValidatorOutput(output) {
-      return STEP_CAP_RE.test(output);
-    }
-    function shouldReportValidatorOutput(output) {
-      return output.includes("NEEDS_INVESTIGATION") || isStepCappedValidatorOutput(output);
-    }
-    function parseValidatorTaskOutputs(stdout) {
-      const outputs = [];
-      for (const line of stdout.split("\n")) {
-        if (!line.trim())
-          continue;
-        const event = (0, types_1.tryParseJson)(line);
-        if (!event || event.type !== "tool_use" || event.part?.tool !== "task" || event.part?.state?.status !== "completed") {
-          continue;
-        }
-        const { title, output, input } = event.part.state;
-        const isValidator = input?.subagent_type === subagents_1.VALIDATOR_SUBAGENT_NAME || title?.includes(subagents_1.VALIDATOR_SUBAGENT_NAME);
-        if (isValidator && output) {
-          outputs.push(output.trim());
-        }
-      }
-      return outputs;
-    }
     function summarizeOpenCodeLine(line) {
       if (line.type !== "tool_use" && line.type !== subagent_tool_logger_1.SUBAGENT_TOOL_EVENT_TYPE) {
         return line;
@@ -16338,9 +16220,7 @@ var require_derived_progress = __commonJS({
     var detect_1 = require_detect();
     var subagents_1 = require_subagents();
     var SUBAGENT_STEPS = {
-      [subagents_1.VALIDATOR_SUBAGENT_NAME]: "Building project",
-      [subagents_1.WIX_DOCS_SUBAGENT_NAME]: "Reading documentation",
-      [subagents_1.WDS_DOCS_SUBAGENT_NAME]: "Reading documentation"
+      [subagents_1.VALIDATOR_SUBAGENT_NAME]: "Building project"
     };
     var REGISTRY_FILE_PATTERN = /(^|\/)extensions\.ts$/;
     var EXTENSION_DEFINITION_PATTERN = /\.extension\.ts$/;
@@ -22748,50 +22628,6 @@ var require_bi_events = __commonJS({
   }
 });
 
-// dist/opencode-integration/slack-reports/validator-outputs.js
-var require_validator_outputs = __commonJS({
-  "dist/opencode-integration/slack-reports/validator-outputs.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.notifyValidatorOutputsToSlack = notifyValidatorOutputsToSlack;
-    var logger_12 = require_logger();
-    var job_context_storage_12 = require_job_context_storage();
-    var codeGenerationService_12 = require_codeGenerationService();
-    var parser_1 = require_parser();
-    async function notifyValidatorOutputsToSlack(stdout, costUsd) {
-      try {
-        const store = job_context_storage_12.jobContextStorage.getStore();
-        const outputs = (0, parser_1.parseValidatorTaskOutputs)(stdout);
-        if (outputs.length === 0)
-          return;
-        const durationMs = store?.flowStartTime ? Date.now() - store.flowStartTime : void 0;
-        const context = {
-          jobId: store?.jobId,
-          metasiteId: store?.metasiteId,
-          costUsd: costUsd > 0 ? costUsd : void 0,
-          durationMs
-        };
-        for (const output of outputs) {
-          if (!(0, parser_1.shouldReportValidatorOutput)(output)) {
-            continue;
-          }
-          try {
-            await codeGenerationService_12.codeGenerationService.handleValidationErrors(output, context);
-          } catch (err) {
-            logger_12.logger.warn("[OpenCode] Failed to report validator output to Slack", {
-              error: err instanceof Error ? err.message : String(err)
-            });
-          }
-        }
-      } catch (err) {
-        logger_12.logger.warn("[OpenCode] Unexpected error in notifyValidatorOutputsToSlack", {
-          error: err instanceof Error ? err.message : String(err)
-        });
-      }
-    }
-  }
-});
-
 // dist/opencode-integration/slack-reports/expensive-run.js
 var require_expensive_run = __commonJS({
   "dist/opencode-integration/slack-reports/expensive-run.js"(exports2) {
@@ -22874,7 +22710,6 @@ var require_opencode_init = __commonJS({
     var inject_created_by_1 = require_inject_created_by();
     var job_payload_1 = require_job_payload2();
     var bi_events_1 = require_bi_events();
-    var validator_outputs_1 = require_validator_outputs();
     var expensive_run_1 = require_expensive_run();
     var pre_run_decision_1 = require_pre_run_decision();
     var environments_12 = require_environments();
@@ -22953,7 +22788,6 @@ var require_opencode_init = __commonJS({
           requiredPermissions: result.requiredPermissions
         });
         if (orchestrator.lastStdout && !(0, model_knobs_1.hasModelOverride)() && !(0, model_knobs_1.hasSmallModelOverride)()) {
-          void (0, validator_outputs_1.notifyValidatorOutputsToSlack)(orchestrator.lastStdout, result.usage.cost);
           void (0, expensive_run_1.notifyExpensiveRunToSlack)({
             usage: result.usage,
             durationMs: Date.now() - flowStartTime,
@@ -23096,7 +22930,6 @@ var require_opencode_iterate = __commonJS({
     var file_changes_1 = require_file_changes();
     var inject_created_by_1 = require_inject_created_by();
     var job_payload_1 = require_job_payload2();
-    var validator_outputs_1 = require_validator_outputs();
     var expensive_run_1 = require_expensive_run();
     var bi_events_1 = require_bi_events();
     var plugins_runtime_1 = require_plugins_runtime();
@@ -23164,7 +22997,6 @@ var require_opencode_iterate = __commonJS({
           requiredPermissions: result.requiredPermissions
         });
         if (iterationOrchestrator.lastStdout && !(0, model_knobs_1.hasModelOverride)() && !(0, model_knobs_1.hasSmallModelOverride)()) {
-          void (0, validator_outputs_1.notifyValidatorOutputsToSlack)(iterationOrchestrator.lastStdout, result.usage.cost);
           void (0, expensive_run_1.notifyExpensiveRunToSlack)({
             usage: result.usage,
             durationMs: Date.now() - flowStartTime,
@@ -23484,7 +23316,6 @@ var require_opencode_fix_git_conflicts = __commonJS({
     var model_knobs_1 = require_model_knobs();
     var file_changes_1 = require_file_changes();
     var job_payload_1 = require_job_payload2();
-    var validator_outputs_1 = require_validator_outputs();
     var expensive_run_1 = require_expensive_run();
     var bi_events_1 = require_bi_events();
     var plugins_runtime_1 = require_plugins_runtime();
@@ -23547,7 +23378,6 @@ var require_opencode_fix_git_conflicts = __commonJS({
           requiredPermissions: result.requiredPermissions
         });
         if (orchestrator.lastStdout && !(0, model_knobs_1.hasModelOverride)() && !(0, model_knobs_1.hasSmallModelOverride)()) {
-          void (0, validator_outputs_1.notifyValidatorOutputsToSlack)(orchestrator.lastStdout, result.usage.cost);
           void (0, expensive_run_1.notifyExpensiveRunToSlack)({
             usage: result.usage,
             durationMs: Date.now() - flowStartTime,
@@ -23997,6 +23827,95 @@ var require_tools_writer = __commonJS({
   }
 });
 
+// dist/opencode-integration/plugins/docs-feedback-nudge.js
+var require_docs_feedback_nudge = __commonJS({
+  "dist/opencode-integration/plugins/docs-feedback-nudge.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.DOCS_FEEDBACK_NUDGE_FILENAME = exports2.REPORT_SENT_PREFIX = exports2.COMPILE_FAILURE_NOTE = exports2.VALIDATOR_NOTE = exports2.SDK_INTERNALS_NOTE = exports2.WIX_SDK_INTERNALS_RE = void 0;
+    exports2.buildDocsFeedbackNudgeSource = buildDocsFeedbackNudgeSource;
+    exports2.writeDocsFeedbackNudgePlugin = writeDocsFeedbackNudgePlugin;
+    var write_plugin_1 = require_write_plugin();
+    var subagents_1 = require_subagents();
+    exports2.WIX_SDK_INTERNALS_RE = /node_modules\/@wix\/(?!patterns\b|design-system\b)[\w-]+/;
+    exports2.SDK_INTERNALS_NOTE = "Docs check: you are reading Wix SDK internals. If it's because the docs didn't give you a signature, shape, or type that compiles, call `report-wix-feedback` once you have the answer \u2014 with the docs URL or search term you used, what it showed, and what you found here.";
+    exports2.VALIDATOR_NOTE = "Docs check: if the validator fixed a Wix SDK call you wrote from a doc example, article, or schema, call `report-wix-feedback` now \u2014 with the docs URL, what it showed, and what the validator changed it to.";
+    exports2.COMPILE_FAILURE_NOTE = "Docs check: if a failure above is in a Wix SDK call you wrote from a doc example, article, or schema, call `report-wix-feedback` once you've fixed it \u2014 with the docs URL, what it showed, and what actually compiled.";
+    exports2.REPORT_SENT_PREFIX = "Report sent";
+    exports2.DOCS_FEEDBACK_NUDGE_FILENAME = "docs-feedback-nudge.ts";
+    function buildDocsFeedbackNudgeSource() {
+      return `// Generated by @wix/ditto-codegen (docs-feedback-nudge). Do not edit.
+const WIX_SDK_INTERNALS_RE = /${exports2.WIX_SDK_INTERNALS_RE.source}/;
+const NOTES = {
+  sdkInternals: ${JSON.stringify(exports2.SDK_INTERNALS_NOTE)},
+  validator: ${JSON.stringify(exports2.VALIDATOR_NOTE)},
+  compileFailure: ${JSON.stringify(exports2.COMPILE_FAILURE_NOTE)},
+};
+const REPORT_SENT_PREFIX = ${JSON.stringify(exports2.REPORT_SENT_PREFIX)};
+const LOOKUP_TOOLS = new Set([
+  "${"bash"}",
+  "${"read"}",
+  "${"batch-read"}",
+  "${"grep"}",
+  "${"glob"}",
+]);
+
+function noteKind(input, result) {
+  const args = input.args ?? {};
+  if (LOOKUP_TOOLS.has(input.tool) && WIX_SDK_INTERNALS_RE.test(JSON.stringify(args))) {
+    return "sdkInternals";
+  }
+  if (input.tool === "${"task"}" && args.subagent_type === "${subagents_1.VALIDATOR_SUBAGENT_NAME}") {
+    return "validator";
+  }
+  if (input.tool === "${"validate"}" && result.startsWith("FAILED")) {
+    return "compileFailure";
+  }
+  return null;
+}
+
+export const DocsFeedbackNudge = async () => {
+  const childSessions = new Set();
+  const reported = new Set();
+  const nudged = new Set();
+
+  return {
+    event: async ({ event }) => {
+      const info = event?.properties?.info;
+      if (
+        (event?.type === "session.created" || event?.type === "session.updated") &&
+        info?.parentID
+      ) {
+        childSessions.add(info.id);
+      }
+      if (event?.type === "message.updated" && info?.agent === "${subagents_1.VALIDATOR_SUBAGENT_NAME}") {
+        childSessions.add(event.properties.sessionID ?? info.sessionID);
+      }
+    },
+    "tool.execute.after": async (input, output) => {
+      const sessionID = input.sessionID;
+      if (childSessions.has(sessionID) || typeof output.output !== "string") return;
+      if (input.tool === "${"report-wix-feedback"}") {
+        if (output.output.startsWith(REPORT_SENT_PREFIX)) reported.add(sessionID);
+        return;
+      }
+      if (reported.has(sessionID)) return;
+
+      const kind = noteKind(input, output.output);
+      if (!kind || nudged.has(sessionID + ":" + kind)) return;
+      nudged.add(sessionID + ":" + kind);
+      output.output = output.output + "\\n\\n" + NOTES[kind];
+    },
+  };
+};
+`;
+    }
+    async function writeDocsFeedbackNudgePlugin() {
+      await (0, write_plugin_1.writeGeneratedPlugin)(exports2.DOCS_FEEDBACK_NUDGE_FILENAME, buildDocsFeedbackNudgeSource());
+    }
+  }
+});
+
 // dist/opencode-integration/plugins/generated-files-guard.js
 var require_generated_files_guard = __commonJS({
   "dist/opencode-integration/plugins/generated-files-guard.js"(exports2) {
@@ -24320,6 +24239,7 @@ var require_plugins3 = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.validateToolPolicies = void 0;
     exports2.writeGeneratedPlugins = writeGeneratedPlugins;
+    var docs_feedback_nudge_1 = require_docs_feedback_nudge();
     var generated_files_guard_1 = require_generated_files_guard();
     var subagent_tool_logger_1 = require_subagent_tool_logger();
     var tool_policies_1 = require_tool_policies3();
@@ -24329,6 +24249,7 @@ var require_plugins3 = __commonJS({
     } });
     async function writeGeneratedPlugins(toolPolicies) {
       await Promise.all([
+        (0, docs_feedback_nudge_1.writeDocsFeedbackNudgePlugin)(),
         (0, generated_files_guard_1.writeGeneratedFilesGuardPlugin)(),
         (0, subagent_tool_logger_1.writeSubagentToolLoggerPlugin)(),
         (0, tool_policies_1.writeToolPoliciesPlugin)(toolPolicies)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.463",
+  "version": "1.0.465",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -29,5 +29,5 @@
     "esbuild": "^0.27.2",
     "vitest": "^4.0.16"
   },
-  "falconPackageHash": "4b4c9bb0574e94bfd5df434744eef2f05f876dbd9776e8d6616a3fc5"
+  "falconPackageHash": "175eef2c2268c965ea1b16a42224fac32fe17587e762719c5ed06a1b"
 }