@wix/agent-skills 1.5.0 → 1.7.0

package/skills/wix-headless/references/commands/install-app.md

@@ -1,42 +0,0 @@
-# Install a Wix app onto a site
-
-Reference for the orchestrator. Invoked from `SKILL.md` Step 2 once per app entry across the loaded packs' `apps[*]`. Can't be a bash script — the install goes through the Wix MCP tool `CallWixSiteAPI`, not over the wire from the local shell.
-
-## Inputs
-
-- `siteId` — from `wix.config.json`.
-- `appName` — e.g. `wix-stores`, `wix-forms`, `wix-blog`. Resolved to `appDefId` via `<SKILL_ROOT>/references/commands/known-apps.json`. Unknown name → fail fast (`"Unknown app: {appName}. Known: [list]. Add it to references/commands/known-apps.json before retrying."`); do not guess.
-- `mcpPrefix` — captured in Step 0 (the discovered Wix MCP prefix; see `<SKILL_ROOT>/references/shared/MCP_PREFIX.md`).
-
-## Call
-
-Wrap in `date -u` captures so timing flows into `run.json.phases[]` as `{ phase: "app-install-{appName}", seconds: <duration> }`.
-
-```
-{mcpPrefix}CallWixSiteAPI
-  siteId:    {siteId}
-  url:       https://www.wixapis.com/apps-installer-service/v1/app-instance/install
-  method:    POST
-  body:      (a JSON object — NOT a string)
-             {
-               "tenant":      { "tenantType": "SITE", "id": "{siteId}" },
-               "appInstance": { "appDefId": "{appDefId}", "enabled": true }
-             }
-  reason:    Install {appName} on the new headless site
-  sourceDocUrl: https://dev.wix.com/docs/api-reference/business-management/app-installation/skills/install-wix-apps
-```
-
-The MCP tool requires explicit `url` / `method` / `body` / `reason` / `sourceDocUrl`. Do NOT pass `endpoint:`. Do NOT stringify `body` — pass it as a JSON object. (The Step 0 MCP bootstrap — see `<SKILL_ROOT>/references/commands/mcp-bootstrap.md` — preloads the `CallWixSiteAPI` schema so the orchestrator and subagents both see the right shape.)
-
-## Strict-then-recover
-
-| Outcome | Action |
-|---|---|
-| 2xx | Done. |
-| 4xx / 5xx with parseable body | Enter recover loop (max 1 retry): `{mcpPrefix}SearchWixRESTDocumentation` for `install app instance`, then `{mcpPrefix}ReadFullDocsMethodSchema` on the top match, then retry with the discovered shape. |
-| Recovery succeeds | Append to `run.json.commandDrift[]`: `{ command: "install-app", primaryError: { status, body }, recoveredWith: { endpoint, bodyPatch }, suggestedFix: "Update references/commands/install-app.md body template" }`. |
-| Both paths fail | Surface the original response body and the doc link to the user. Do not loop further. |
-
-## Why this is a reference doc, not a script
-
-The body shape and the strict-then-recover ladder are the parts that need to stay frozen across runs. Encoding them in a markdown reference the orchestrator reads (instead of a slash command the orchestrator dispatches) keeps the source of truth inside the skill and removes the round-trip through a slash-command shim.

package/skills/wix-headless/references/commands/mcp-bootstrap.md

@@ -1,28 +0,0 @@
-# Pre-load Wix MCP tool schemas (Step 0)
-
-Reference for the orchestrator. Mandatory in Step 0 of the build flow, after the `WixREADME` connectivity probe and before any other Wix MCP call. Loads every Wix MCP tool schema the orchestrator and downstream subagents will use this session, so calls succeed on the first attempt instead of failing once with a schema-validation error and recovering.
-
-## Why this is encoded as a reference doc
-
-The orchestrator skim-reads SETUP.md and can miss dispatch-time footnotes. Without bootstrap, the first `CallWixSiteAPI` (e.g. install Wix Stores) emits `body` as a JSON string because the schema isn't loaded; the MCP tool returns `Expected object, received string`; the orchestrator ToolSearches mid-flow and retries. Pinning the schema-load list here (rather than as a footnote in SETUP.md) makes the step impossible to skip.
-
-## Run
-
-A single `ToolSearch` call. The query lists every Wix MCP tool likely to be invoked from the orchestrator or any subagent during the build:
-
-```
-ToolSearch query: "select:WixREADME,CallWixSiteAPI,SearchWixRESTDocumentation,ReadFullDocsArticle,ReadFullDocsMethodSchema,SearchWixCLIDocumentation,SearchWixSDKDocumentation,SearchWixHeadlessDocumentation,SearchWixWDSDocumentation,SearchBuildAppsDocumentation,BrowseWixRESTDocsMenu"
-```
-
-The schemas all become callable for the rest of the session. Subagents inherit the loaded schemas — no per-agent re-loading is required.
-
-The list is intentionally fixed. Do not edit it dynamically based on the loaded vertical packs; the cost of loading an extra schema is zero, and a fixed list eliminates the "did I skip a schema for this run" failure mode.
-
-## Strict-then-recover
-
-`ToolSearch` itself rarely fails. If it does:
-
-- If the error indicates the Wix MCP server isn't connected (no tools matched any of the names), the connectivity probe in Step 0 should have caught it earlier — surface the error and stop. Tell the user to ensure the Wix MCP server is connected and rerun.
-- For any other `ToolSearch` error, surface verbatim. Do not retry — there is no retryable failure mode for schema loading.
-
-Append timing to `.wix/run.json.phases[]` as `{ phase: "mcp-bootstrap", seconds: <duration> }`. The duration is typically <1 s; record it anyway so any future regression in MCP cold-start cost is visible.