@buoy-gg/agent-core 7.0.40 → 7.0.42

package/lib/commonjs/catalog/catalog.types.g.js

@@ -1,44 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.CATALOG_ACTIONS = void 0;
-/**
- * GENERATED by scripts/gen-agent-catalog.mjs — do not edit.
- * Source: packages/agent-core/src/catalog/catalog.source.json
- *
- * The catalog's tool ids and action names as types, so a wrong name fails
- * at compile time. `catalog.g.ts` carries the data.
- *
- * 24 Buoy tools, 196 actions.
- */
-
-/** Action names per tool — the runtime mirror of {@link CatalogActionMap}. */
-const CATALOG_ACTIONS = exports.CATALOG_ACTIONS = {
-  "env": ["getSnapshot"],
-  "console": ["getSnapshot", "clearEntries"],
-  "sentry": ["getSnapshot", "clearEnvelopes"],
-  "jotai": ["listAtoms", "getAtomValue", "getChangeDetail", "setAtom", "clearEvents"],
-  "route-events": ["getSnapshot", "getCurrentRoute", "navigate", "stackGoBack", "stackNavigateToIndex", "stackPopToIndex", "stackPopToTop", "clearEvents"],
-  "debug-borders": ["cycleMode", "setMode"],
-  "zustand": ["listStores", "getStoreState", "getChangeDetail", "setState", "rehydrate", "clearEvents"],
-  "redux": ["getState", "getActionDetail", "dispatch", "clearEvents"],
-  "impersonate": ["searchUsers", "startImpersonation", "stopImpersonation", "pauseImpersonation", "resumeImpersonation", "updateSettings", "removeFromHistory", "clearHistory"],
-  "query": ["listQueries", "getQueryData", "refetch", "invalidate", "reset", "remove", "setQueryData", "triggerError", "restoreError", "triggerLoading", "restoreLoading", "clearQueryCache", "clearMutationCache", "setOnline"],
-  "events": ["exportEvents", "setEnabledSources", "clearEvents"],
-  "network": ["getSnapshot", "getCaptureStatus", "getEventBody", "setPinned", "setSaved", "removeSavedRecord", "clearSavedRequests", "clearPinnedRequests", "clearEvents", "listOverrideRules", "getOverrideRuleBody", "debugOverrides", "upsertOverrideRule", "setOverrideRuleEnabled", "setOverridesEnabled", "deleteOverrideRule", "clearOverrideRules", "getNetworkConditions", "setNetworkConditions"],
-  "js-top": ["sample", "getOriginDetail", "setEnabled", "pause", "resume", "clear"],
-  "app": ["ping", "reloadApp"],
-  "time-machine": ["list", "capture", "captureBaseline", "wipeAll", "restore", "preview", "inspect", "delete", "rename", "duplicate", "setExclusions", "setScope", "setRestoreRoute"],
-  "storage": ["async.getAllKeys", "async.multiGet", "async.getItem", "async.setItem", "async.removeItem", "async.multiRemove", "async.multiSet", "async.clear", "clearAppStorage", "getEventDetail", "clearEvents", "timeTravel.undo", "timeTravel.jump", "mmkv.snapshot", "mmkv.get", "mmkv.set", "mmkv.remove", "secure.keys", "secure.snapshot", "secure.get", "secure.set", "secure.delete"],
-  "highlight-updates": ["describeScreen", "tapElement", "waitFor", "beginMeasurement", "endMeasurement", "locateComponent", "getRenderDetail", "setEnabled", "toggle", "setSilentTracking", "toggleFreeze", "setSpotlight", "clearRenderCounts"],
-  "scenarios": ["listScenarios", "getScenario", "save", "acceptDraft", "discardDraft", "preview", "run", "deactivate", "delete", "setFolder", "listFolders", "getActive", "export"],
-  "perf-monitor": ["setEnabled", "startRecording", "stopRecording", "savePending", "discardPending", "mark", "startAutomation", "cancelAutomation", "acknowledgeAutomation", "refreshIndex", "getAutomationConfig", "setAutomationConfig", "loadReport", "deleteReport", "deleteBatch", "clearAll"],
-  "assets": ["list", "getDetail", "rescan", "measureSizes", "saveBaseline", "clearBaseline", "getDiff", "clearRecords", "getScanStatus"],
-  "tv-remote": ["arm", "getEventsSince", "setMenuCapture", "disarm", "clear"],
-  "focus-inspector": ["rescan", "focusElement", "setTracking", "clearHistory"],
-  "images": ["list", "getDetail", "getCaptureStatus", "retry", "flash", "proveSavings", "setOverride", "clearOverride", "setNetworkMode", "setBlankImages", "hardReload", "evictDisk", "massAction", "clearRecords", "clearExpoCaches"],
-  "ask-buoy": ["listChanges", "undoAll", "retrieve", "openProcedure"]
-};
-//# sourceMappingURL=catalog.types.g.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.CATALOG_ACTIONS=void 0;const CATALOG_ACTIONS=exports.CATALOG_ACTIONS={"env":["getSnapshot"],"console":["getSnapshot","clearEntries"],"sentry":["getSnapshot","clearEnvelopes"],"jotai":["listAtoms","getAtomValue","getChangeDetail","setAtom","clearEvents"],"route-events":["getSnapshot","getCurrentRoute","navigate","stackGoBack","stackNavigateToIndex","stackPopToIndex","stackPopToTop","clearEvents"],"debug-borders":["cycleMode","setMode"],"zustand":["listStores","getStoreState","getChangeDetail","setState","rehydrate","clearEvents"],"redux":["getState","getActionDetail","dispatch","clearEvents"],"impersonate":["searchUsers","startImpersonation","stopImpersonation","pauseImpersonation","resumeImpersonation","updateSettings","removeFromHistory","clearHistory"],"query":["listQueries","getQueryData","refetch","invalidate","reset","remove","setQueryData","triggerError","restoreError","triggerLoading","restoreLoading","clearQueryCache","clearMutationCache","setOnline"],"events":["exportEvents","setEnabledSources","clearEvents"],"network":["getSnapshot","getCaptureStatus","getEventBody","setPinned","setSaved","removeSavedRecord","clearSavedRequests","clearPinnedRequests","clearEvents","listOverrideRules","getOverrideRuleBody","debugOverrides","upsertOverrideRule","setOverrideRuleEnabled","setOverridesEnabled","deleteOverrideRule","clearOverrideRules","getNetworkConditions","setNetworkConditions"],"js-top":["sample","getOriginDetail","setEnabled","pause","resume","clear"],"app":["ping","reloadApp"],"time-machine":["list","capture","captureBaseline","wipeAll","restore","preview","inspect","delete","rename","duplicate","setExclusions","setScope","setRestoreRoute"],"clock":["getState","setTime","shift","freeze","resume","setRate","reset","updateSettings","jumpToTokenExpiry","failNextRequest","stopTokenCheck"],"storage":["getRequiredKeys","async.getAllKeys","async.multiGet","async.getItem","async.setItem","async.removeItem","async.multiRemove","async.multiSet","async.clear","clearAppStorage","getEventDetail","clearEvents","timeTravel.undo","timeTravel.jump","mmkv.snapshot","mmkv.get","mmkv.set","mmkv.remove","secure.keys","secure.snapshot","secure.get","secure.set","secure.delete"],"highlight-updates":["describeScreen","tapElement","waitFor","beginMeasurement","endMeasurement","locateComponent","getRenderDetail","setEnabled","toggle","setSilentTracking","toggleFreeze","setSpotlight","clearRenderCounts","startTouchCapture","stopTouchCapture","clearTouchCapture","readTouchCapture"],"scenarios":["listScenarios","getScenario","save","acceptDraft","discardDraft","preview","run","deactivate","delete","setFolder","listFolders","getActive","export"],"perf-monitor":["setEnabled","startRecording","stopRecording","savePending","discardPending","mark","startAutomation","cancelAutomation","acknowledgeAutomation","refreshIndex","getAutomationConfig","setAutomationConfig","loadReport","deleteReport","deleteBatch","clearAll"],"assets":["list","getDetail","rescan","measureSizes","saveBaseline","clearBaseline","getDiff","clearRecords","getScanStatus"],"tv-remote":["arm","getEventsSince","setMenuCapture","disarm","clear"],"focus-inspector":["rescan","focusElement","setTracking","clearHistory"],"images":["list","getDetail","getCaptureStatus","retry","flash","proveSavings","setOverride","clearOverride","setNetworkMode","setBlankImages","hardReload","evictDisk","massAction","clearRecords","clearExpoCaches"],"ask-buoy":["listChanges","undoAll","retrieve","openProcedure"],"push-notifications":["getSnapshot","getCapabilities","getEvent","getPermissions","listPresented","refreshToken","setCaptureSession","clearCapturedEvents","scheduleLocal"],"image-overlay":["getSnapshot","listTargets","selectTarget","loadImage","setSettings","fitToScreen","resetSettings","remove"]};

package/lib/commonjs/catalog/normalizeParams.js

@@ -1,333 +1,3 @@
-"use strict";
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.aliasNote=aliasNote;exports.hashQueryKey=hashQueryKey;exports.normalizeParams=normalizeParams;const isPlainObject=r=>!!r&&typeof r==="object"&&!Array.isArray(r);function hashQueryKey(r){return JSON.stringify(r,(e,t)=>isPlainObject(t)?Object.keys(t).sort().reduce((a,i)=>{a[i]=t[i];return a},{}):t)}function alias(r,e,t,a){if(r[t]!==void 0||r[e]===void 0)return false;r[t]=r[e];delete r[e];a.push(`Accepted \`${e}\` as \`${t}\` \u2014 the parameter is named \`${t}\`.`);return true}const QUERY_HASH_ACTIONS=new Set(["getQueryData","refetch","invalidate","reset","remove","triggerError","restoreError","triggerLoading","restoreLoading"]);const RULE_FIELDS=["id","urlPattern","enabled","name","methods","kind","status","statusText","headers","body","bodyPatch","bodyPath","bodyValue","failKind","delayMs","times","alternate","force","bodyOmitted"];function normalizeQuery(r,e,t){if(QUERY_HASH_ACTIONS.has(r)&&e.queryHash===void 0){const a=isPlainObject(e.filters)?e.filters:void 0;const i=e.queryKey??e.key??e.hash??a?.queryKey??a?.queryHash;if(Array.isArray(i)){e.queryHash=hashQueryKey(i);t.push(`Accepted the queryKey array as the query's hash (${e.queryHash}) \u2014 the parameter is \`queryHash\`, the string from listQueries.`)}else if(typeof i==="string"){e.queryHash=i;t.push(`Accepted it as \`queryHash\` \u2014 that is the parameter name.`)}delete e.queryKey;delete e.key;delete e.hash;delete e.filters}if(r==="setQueryData"){if(isPlainObject(e.data)){for(const a of["merge","force"]){if(typeof e.data[a]==="boolean"&&e[a]===void 0){e[a]=e.data[a];delete e.data[a];t.push(`Moved \`${a}\` out of \`data\` to the top level \u2014 it is a write flag, not part of the value.`)}}}alias(e,"newData","data",t)||e.path===void 0&&alias(e,"value","data",t)||alias(e,"patch","data",t);if(e.queryKey===void 0&&typeof e.queryHash==="string"){try{const a=JSON.parse(e.queryHash);if(Array.isArray(a)){e.queryKey=a;t.push("Accepted the queryHash as the key \u2014 setQueryData takes `queryKey`, the array.")}}catch{}}if(e.patch!==void 0||e.merge===void 0){if(t.some(a=>a.includes("`patch`")))e.merge=true}}}function normalizeNetwork(r,e,t){if(r==="getEventBody"||r==="setPinned"||r==="setSaved"){alias(e,"requestId","id",t)||alias(e,"eventId","id",t)}if(r==="deleteOverrideRule"||r==="setOverrideRuleEnabled"||r==="getOverrideRuleBody"){alias(e,"ruleId","id",t)}if(r==="upsertOverrideRule"){const a=isPlainObject(e.rule)?{...e.rule}:{};if(e.fromRequestId===void 0&&typeof a.fromRequestId==="string"){e.fromRequestId=a.fromRequestId;t.push("Accepted `rule.fromRequestId` \u2014 it is a top-level parameter, beside `rule`.")}delete a.fromRequestId;unwrapRuleSections(a,t);ruleIntentWords(e,a,t);const i=[];for(const d of RULE_FIELDS){if(e[d]!==void 0&&a[d]===void 0){a[d]=e[d];i.push(d)}delete e[d]}if(i.length)t.push(`Accepted ${i.map(d=>`\`${d}\``).join(", ")} at the top level \u2014 rule fields belong inside \`rule\`.`);if(Object.keys(a).length)e.rule=a}}function unwrapRuleSections(r,e){for(const[t,a]of[["match",["urlPattern","methods","method","url","pattern","urlContains","contains"]],["response",["status","statusText","body","headers","bodyPatch"]]]){const i=r[t];if(!isPlainObject(i))continue;const d=[];for(const s of a){if(i[s]===void 0)continue;const n=s==="method"?"methods":s==="url"||s==="pattern"||s==="urlContains"||s==="contains"?"urlPattern":s;if(r[n]!==void 0)continue;r[n]=n==="methods"&&!Array.isArray(i[s])?[i[s]]:i[s];delete i[s];d.push(s)}if(!d.length)continue;if(!Object.keys(i).length)delete r[t];e.push(`Read \`rule.${t}.{${d.join(", ")}}\` as top-level rule fields \u2014 this rule is flat, unlike msw/nock-style mocks.`)}}function ruleIntentWords(r,e,t){if(e.bodyPath===void 0&&typeof e.path==="string"){e.bodyPath=e.path;if(e.bodyValue===void 0&&e.value!==void 0)e.bodyValue=e.value;delete e.path;delete e.value;t.push("Read `path`/`value` as `bodyPath`/`bodyValue` \u2014 on a rule they address the response body.")}const a=s=>e[s]!==void 0?e[s]:r[s];const i=s=>{delete e[s];delete r[s]};const d=a("mode");if(typeof d==="string"&&["respond","fail","delay"].includes(d)&&e.kind===void 0){e.kind=d;t.push(`Read \`mode: "${d}"\` as \`kind: "${d}"\`.`)}i("mode");if(a("fail")===true&&e.kind===void 0){e.kind="fail";t.push('Read `fail: true` as `kind: "fail"` \u2014 a transport failure, as if offline.')}i("fail");if(a("failOnce")===true){if(e.kind===void 0)e.kind="fail";if(e.times===void 0)e.times=1;t.push('Read `failOnce: true` as `kind: "fail"` with `times: 1` \u2014 it fires once, then the rule disables itself.')}i("failOnce");if(a("once")===true&&e.times===void 0){e.times=1;t.push("Read `once: true` as `times: 1` \u2014 the rule auto-disables after one match.")}i("once");for(const s of["maxHits","hits","count","maxTimes","applyTimes"]){const n=a(s);if(typeof n==="number"&&Number.isFinite(n)&&n>0&&e.times===void 0){e.times=n;t.push(`Read \`${s}: ${n}\` as \`times: ${n}\` \u2014 the rule auto-disables after ${n} match(es).`)}i(s)}}function normalizeZustand(r,e,t){alias(e,"name","storeName",t)||alias(e,"store","storeName",t);if(r==="setState"){alias(e,"statePatch","state",t)||alias(e,"partial","state",t)||alias(e,"patch","state",t)||alias(e,"newState","state",t)||alias(e,"nextState","state",t)||e.path===void 0&&alias(e,"value","state",t);if(e.replace===void 0){e.replace=false;t.push("Applied replace:false (merge) \u2014 a store keeps action functions that can't be re-sent, and replacing would wipe them (the buttons that call them would then crash). Send replace:true only to deliberately reset the whole store.")}}}function normalizeRoutes(r,e,t){if(r==="navigate"){alias(e,"route","path",t)||alias(e,"to","path",t)||alias(e,"url","path",t)||alias(e,"pathname","path",t)}}function normalizeParams(r,e,t){const a={...t};const i=[];switch(r){case"query":normalizeQuery(e,a,i);break;case"network":normalizeNetwork(e,a,i);break;case"zustand":normalizeZustand(e,a,i);break;case"route-events":normalizeRoutes(e,a,i);break;default:break}return{params:a,notes:i}}function aliasNote(r){return r.length?`
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.aliasNote = aliasNote;
-exports.hashQueryKey = hashQueryKey;
-exports.normalizeParams = normalizeParams;
-/**
- * Parameter aliases — accept what models actually send.
- *
- * The provider sees ONE tool per Buoy tool with `params` as an open object
- * (see toProviderTools.ts), so the per-action parameter names live in prose
- * and every model has to reproduce them from memory. A sweep of 18 models
- * against the live app showed the same handful of misses over and over, on
- * cheap models AND on gpt-5 and Gemini 2.5 Pro:
- *
- *   queryKey: [...]   where the action wants queryHash   (by far the #1 miss —
- *                     the RIGHT NOW block shows keys as arrays, and
- *                     setQueryData takes queryKey, so the model reuses it)
- *   requestId         where network.getEventBody wants id
- *   newState/patch    where zustand.setState wants state
- *   name              where zustand wants storeName
- *   bodyPatch/body/…  at the top level of upsertOverrideRule instead of inside `rule`
- *
- * A validation error names the right field, but a cheap model repeats the same
- * wrong call or gives up, and the user sees "nothing happened". Every one of
- * these is mechanically unambiguous, so it is fixed HERE, before validation,
- * and the result carries a one-line note so the model learns the real name
- * without failing the call. Nothing here guesses: an alias only fires when the
- * canonical field is absent and the alias is present.
- */
-
-const isPlainObject = v => !!v && typeof v === "object" && !Array.isArray(v);
-
-/**
- * TanStack's default `hashKey`: JSON.stringify with plain-object keys sorted,
- * so `["todos", {page:1, sort:"a"}]` hashes the same whatever order the model
- * wrote the object in.
- */
-function hashQueryKey(key) {
-  return JSON.stringify(key, (_, val) => isPlainObject(val) ? Object.keys(val).sort().reduce((acc, k) => {
-    acc[k] = val[k];
-    return acc;
-  }, {}) : val);
-}
-
-/** Rename `from` to `to` when `to` is absent and `from` is present. */
-function alias(p, from, to, notes) {
-  if (p[to] !== undefined || p[from] === undefined) return false;
-  p[to] = p[from];
-  delete p[from];
-  notes.push(`Accepted \`${from}\` as \`${to}\` — the parameter is named \`${to}\`.`);
-  return true;
-}
-const QUERY_HASH_ACTIONS = new Set(["getQueryData", "refetch", "invalidate", "reset", "remove", "triggerError", "restoreError", "triggerLoading", "restoreLoading"]);
-
-/** Fields that belong inside `rule` for network.upsertOverrideRule. */
-const RULE_FIELDS = ["id", "urlPattern", "enabled", "name", "methods", "kind", "status", "statusText", "headers", "body", "bodyPatch", "bodyPath", "bodyValue", "failKind", "delayMs", "times", "alternate", "force", "bodyOmitted"];
-function normalizeQuery(action, p, notes) {
-  if (QUERY_HASH_ACTIONS.has(action) && p.queryHash === undefined) {
-    // `filters: { queryKey }` — the TanStack client-API shape.
-    const filters = isPlainObject(p.filters) ? p.filters : undefined;
-    const key = p.queryKey ?? p.key ?? p.hash ?? filters?.queryKey ?? filters?.queryHash;
-    if (Array.isArray(key)) {
-      p.queryHash = hashQueryKey(key);
-      notes.push(`Accepted the queryKey array as the query's hash (${p.queryHash}) — the parameter is \`queryHash\`, the string from listQueries.`);
-    } else if (typeof key === "string") {
-      // A hash string under another name, or a loose "a,b,c" spelling the
-      // adapter resolves against the live cache.
-      p.queryHash = key;
-      notes.push(`Accepted it as \`queryHash\` — that is the parameter name.`);
-    }
-    delete p.queryKey;
-    delete p.key;
-    delete p.hash;
-    delete p.filters;
-  }
-  if (action === "setQueryData") {
-    // Models routinely tuck the write FLAGS inside `data` — `data: {item:{…},
-    // merge:true}` — which turns a merge into a replace and leaves a junk
-    // `merge`/`force` key in the cache. Lift a boolean flag out of `data` to
-    // the top level when the top level doesn't already set it. Guarded to
-    // booleans so a real data field named "merge" is never disturbed.
-    if (isPlainObject(p.data)) {
-      for (const flag of ["merge", "force"]) {
-        if (typeof p.data[flag] === "boolean" && p[flag] === undefined) {
-          p[flag] = p.data[flag];
-          delete p.data[flag];
-          notes.push(`Moved \`${flag}\` out of \`data\` to the top level — it is a write flag, not part of the value.`);
-        }
-      }
-    }
-    // `value` normally means "the patch, spelled differently". But alongside
-    // `path` it means the OPPOSITE — the single value that path is set to — so
-    // rewriting it there would turn `path:"item.name", value:"x"` into a
-    // top-level patch of `"x"`, silently. Only the path form reserves it.
-    alias(p, "newData", "data", notes) || p.path === undefined && alias(p, "value", "data", notes) || alias(p, "patch", "data", notes);
-    if (p.queryKey === undefined && typeof p.queryHash === "string") {
-      try {
-        const parsed = JSON.parse(p.queryHash);
-        if (Array.isArray(parsed)) {
-          p.queryKey = parsed;
-          notes.push("Accepted the queryHash as the key — setQueryData takes `queryKey`, the array.");
-        }
-      } catch {
-        /* leave it; validation will say what is missing */
-      }
-    }
-    if (p.patch !== undefined || p.merge === undefined) {
-      // A caller that said "patch" meant merge.
-      if (notes.some(n => n.includes("`patch`"))) p.merge = true;
-    }
-  }
-}
-function normalizeNetwork(action, p, notes) {
-  if (action === "getEventBody" || action === "setPinned" || action === "setSaved") {
-    alias(p, "requestId", "id", notes) || alias(p, "eventId", "id", notes);
-  }
-  if (action === "deleteOverrideRule" || action === "setOverrideRuleEnabled" || action === "getOverrideRuleBody") {
-    alias(p, "ruleId", "id", notes);
-  }
-  if (action === "upsertOverrideRule") {
-    const rule = isPlainObject(p.rule) ? {
-      ...p.rule
-    } : {};
-    // fromRequestId is a TOP-LEVEL field; models tuck it into the rule.
-    if (p.fromRequestId === undefined && typeof rule.fromRequestId === "string") {
-      p.fromRequestId = rule.fromRequestId;
-      notes.push("Accepted `rule.fromRequestId` — it is a top-level parameter, beside `rule`.");
-    }
-    delete rule.fromRequestId;
-    unwrapRuleSections(rule, notes);
-    ruleIntentWords(p, rule, notes);
-    // Rule fields sent flat at the top level move inside `rule`.
-    const moved = [];
-    for (const f of RULE_FIELDS) {
-      if (p[f] !== undefined && rule[f] === undefined) {
-        rule[f] = p[f];
-        moved.push(f);
-      }
-      delete p[f];
-    }
-    if (moved.length) notes.push(`Accepted ${moved.map(f => `\`${f}\``).join(", ")} at the top level — rule fields belong inside \`rule\`.`);
-    if (Object.keys(rule).length) p.rule = rule;
-  }
-}
-
-/**
- * Flatten the `match` / `response` wrappers models borrow from other mocking
- * libraries.
- *
- * Our rule is flat — `{urlPattern, methods, status, body, times}`. Nearly every
- * HTTP-mocking library a model has read is not: msw, nock and WireMock all group
- * the matcher and the reply into separate objects. So a model that has never
- * seen our schema (and it has not — `params` is an unconstrained object) writes
- * the convention it knows. Measured: Claude sent
- * `{times: 1, match: {method, urlPattern}, response: {status, body}}` — every
- * value correct, in the shape the rest of the world uses.
- *
- * Only these two wrapper names, and only fields that are really ours: an
- * unrecognised key inside one is left where it is rather than hoisted, so this
- * cannot quietly invent a rule field that does not exist.
- */
-function unwrapRuleSections(rule, notes) {
-  for (const [wrapper, fields] of [["match", ["urlPattern", "methods", "method", "url", "pattern", "urlContains", "contains"]], ["response", ["status", "statusText", "body", "headers", "bodyPatch"]]]) {
-    const inner = rule[wrapper];
-    if (!isPlainObject(inner)) continue;
-    const moved = [];
-    for (const f of fields) {
-      if (inner[f] === undefined) continue;
-      // `method` and `url` are that library's spelling of ours.
-      const target = f === "method" ? "methods" : f === "url" || f === "pattern" || f === "urlContains" || f === "contains" ? "urlPattern" : f;
-      if (rule[target] !== undefined) continue;
-      rule[target] = target === "methods" && !Array.isArray(inner[f]) ? [inner[f]] : inner[f];
-      delete inner[f];
-      moved.push(f);
-    }
-    if (!moved.length) continue;
-    // Everything recognised moved out; drop the wrapper only if nothing is left,
-    // so a leftover key still surfaces as a schema error rather than vanishing.
-    if (!Object.keys(inner).length) delete rule[wrapper];
-    notes.push(`Read \`rule.${wrapper}.{${moved.join(", ")}}\` as top-level rule fields — this rule is flat, unlike msw/nock-style mocks.`);
-  }
-}
-
-/**
- * The words models reach for when describing an override rule, mapped to the
- * fields the rule actually has.
- *
- * MEASURED, not invented. On `api-sim/next-call-fails-once` — "make the next
- * menu request fail, just the next one" — every model that acted picked the
- * right tool and explained the right reason, then wrote the rule like this:
- *
- *   grok    ×3   {fail: true, once: true}
- *   composer     {fail: true}  and  {maxHits: 1, fail: true}
- *   opus         {status: 500, enabled: true}
- *
- * The schema wants `{kind: "fail", times: 1}`. Ten of fourteen attempts on that
- * case graded `acceptable` rather than `best` for no reason except this — the
- * budget was expressed as `once`/`maxHits` and silently dropped, leaving a rule
- * that never expires.
- *
- * It is NOT a missing instruction. `times` is documented as "Use 1 for 'make the
- * next call fail' so it cannot linger" — very nearly the user's own sentence —
- * and every model read past it. That is the same finding as the nesting-depth
- * work: the fix has to be structural, not a better sentence.
- *
- * Each mapping only ever makes a rule NARROWER (a budget where there was none,
- * a transport failure where the kind was unstated), so a misread costs a rule
- * that stops too early rather than one that runs forever.
- */
-function ruleIntentWords(p, rule, notes) {
-  // `path`/`value` is what the state tools call this, and a model that learned
-  // it on `zustand.setState` or `query.setQueryData` writes the same words here.
-  // A rule has no other meaning for either name, so accept them.
-  if (rule.bodyPath === undefined && typeof rule.path === "string") {
-    rule.bodyPath = rule.path;
-    if (rule.bodyValue === undefined && rule.value !== undefined) rule.bodyValue = rule.value;
-    delete rule.path;
-    delete rule.value;
-    notes.push("Read `path`/`value` as `bodyPath`/`bodyValue` — on a rule they address the response body.");
-  }
-  const read = key => rule[key] !== undefined ? rule[key] : p[key];
-  const drop = key => {
-    delete rule[key];
-    delete p[key];
-  };
-
-  // `mode` is the other library's name for `kind`, and models use it verbatim:
-  // measured on `api-sim/api-down`, alongside `match.urlContains`.
-  const mode = read("mode");
-  if (typeof mode === "string" && ["respond", "fail", "delay"].includes(mode) && rule.kind === undefined) {
-    rule.kind = mode;
-    notes.push(`Read \`mode: "${mode}"\` as \`kind: "${mode}"\`.`);
-  }
-  drop("mode");
-
-  // "fail" as a flag, rather than kind:"fail".
-  if (read("fail") === true && rule.kind === undefined) {
-    rule.kind = "fail";
-    notes.push("Read `fail: true` as `kind: \"fail\"` — a transport failure, as if offline.");
-  }
-  drop("fail");
-
-  // "just once" / "only the next one", in the several ways it gets written.
-  if (read("failOnce") === true) {
-    if (rule.kind === undefined) rule.kind = "fail";
-    if (rule.times === undefined) rule.times = 1;
-    notes.push("Read `failOnce: true` as `kind: \"fail\"` with `times: 1` — it fires once, then the rule disables itself.");
-  }
-  drop("failOnce");
-  if (read("once") === true && rule.times === undefined) {
-    rule.times = 1;
-    notes.push("Read `once: true` as `times: 1` — the rule auto-disables after one match.");
-  }
-  drop("once");
-
-  // A numeric budget under any of its other names. `limit` is deliberately NOT
-  // here: it means "how many to list" on half the actions in this catalog, and
-  // a wrong guess about a budget is a rule that stops early on a request the
-  // caller still needed.
-  for (const key of ["maxHits", "hits", "count", "maxTimes", "applyTimes"]) {
-    const v = read(key);
-    if (typeof v === "number" && Number.isFinite(v) && v > 0 && rule.times === undefined) {
-      rule.times = v;
-      notes.push(`Read \`${key}: ${v}\` as \`times: ${v}\` — the rule auto-disables after ${v} match(es).`);
-    }
-    drop(key);
-  }
-}
-function normalizeZustand(action, p, notes) {
-  alias(p, "name", "storeName", notes) || alias(p, "store", "storeName", notes);
-  if (action === "setState") {
-    alias(p, "statePatch", "state", notes) || alias(p, "partial", "state", notes) || alias(p, "patch", "state", notes) || alias(p, "newState", "state", notes) || alias(p, "nextState", "state", notes) ||
-    // See the same guard on setQueryData: with `path`, `value` is the value
-    // being set, not another spelling of the patch.
-    p.path === undefined && alias(p, "value", "state", notes);
-    // ALWAYS merge, never replace, unless the caller explicitly said replace.
-    // The adapter defaults replace:true, which throws away everything not sent
-    // — including the store's ACTION FUNCTIONS (setQty, removeLine, …), which
-    // can't cross the JSON wire, so a remote caller never has them to re-send.
-    // The data then looks right but the buttons that call those methods crash.
-    // A merge (replace:false) shallow-merges the fields sent and keeps the
-    // functions and untouched keys intact.
-    if (p.replace === undefined) {
-      p.replace = false;
-      notes.push("Applied replace:false (merge) — a store keeps action functions that can't be re-sent, and replacing would wipe them (the buttons that call them would then crash). Send replace:true only to deliberately reset the whole store.");
-    }
-  }
-}
-function normalizeRoutes(action, p, notes) {
-  if (action === "navigate") {
-    alias(p, "route", "path", notes) || alias(p, "to", "path", notes) || alias(p, "url", "path", notes) || alias(p, "pathname", "path", notes);
-  }
-}
-
-/**
- * Fix the unambiguous parameter-name misses before validation. Returns the
- * same object shape validation expects plus the notes to append to the result.
- */
-function normalizeParams(toolId, action, raw) {
-  const p = {
-    ...raw
-  };
-  const notes = [];
-  switch (toolId) {
-    case "query":
-      normalizeQuery(action, p, notes);
-      break;
-    case "network":
-      normalizeNetwork(action, p, notes);
-      break;
-    case "zustand":
-      normalizeZustand(action, p, notes);
-      break;
-    case "route-events":
-      normalizeRoutes(action, p, notes);
-      break;
-    default:
-      break;
-  }
-  return {
-    params: p,
-    notes
-  };
-}
-
-/** The one-line trailer appended to a tool result when aliases fired. */
-function aliasNote(notes) {
-  return notes.length ? `\n\n[Buoy] ${notes.join(" ")}` : "";
-}
-//# sourceMappingURL=normalizeParams.js.map
+[Buoy] ${r.join(" ")}`:""}

package/lib/commonjs/catalog/signature.js

@@ -1,68 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.paramsLine = paramsLine;
-exports.signature = signature;
-/**
- * Rendering a JSON Schema as the one-line signature a model reads.
- *
- * Lifted out of `blocks/uiTool.ts`, where it was written for `buoy_ui` and
- * where its own comment records the result that justifies using it everywhere:
- *
- *   > `uiProviderTool` used to send `params: { type: "object" }` and 26 lines
- *   > of prose about what each kind is FOR — and not one field name. The model
- *   > was being asked to guess `images` vs `items` and `chips` vs `options`,
- *   > and it guessed wrong three rounds running.
- *
- * The other 24 tools still send exactly that: an open `params` object and a
- * sentence promising the error will explain the shape. `normalizeParams.ts`
- * exists to catch the five misses that produced most often. This renders the
- * field names instead, from the SAME schema `validateParams` enforces, so what
- * the model reads can never drift from what the validator accepts.
- */
-
-/** `{ url*, alt?, caption? }` — `*` marks required. */
-function signature(schema, depth = 0) {
-  if (!schema || typeof schema !== "object") return "any";
-  const s = schema;
-  if (Array.isArray(s.anyOf)) {
-    return s.anyOf.map(b => signature(b, depth)).join(" | ");
-  }
-  if (s.type === "array") {
-    const cap = typeof s.maxItems === "number" ? ` ≤${s.maxItems}` : "";
-    return `[${signature(s.items, depth + 1)}${cap}]`;
-  }
-  if (s.type === "object" || s.properties) {
-    const props = s.properties ?? {};
-    const names = Object.keys(props);
-    if (!names.length) return "{…}";
-    // Three levels is every field a model has to name; below that lives the
-    // action's `dispatch`, which the prose already describes.
-    if (depth >= 3) return "{…}";
-    const required = new Set(s.required ?? []);
-    const fields = names.map(name => {
-      const inner = signature(props[name], depth + 1);
-      const mark = required.has(name) ? "*" : "";
-      return inner === "any" ? `${name}${mark}` : `${name}${mark}: ${inner}`;
-    });
-    return `{ ${fields.join(", ")} }`;
-  }
-  if (Array.isArray(s.enum)) return s.enum.map(v => `"${String(v)}"`).join("|");
-  return typeof s.type === "string" ? s.type : "any";
-}
-
-/**
- * The `params:` line under an action, or "" when the action takes none.
- *
- * Actions with no declared properties (71 of 192) get nothing rather than an
- * empty `{}` — a line that says the action takes no arguments is already said
- * by its absence, and 71 of them would be pure noise.
- */
-function paramsLine(schema) {
-  const props = schema?.properties;
-  if (!props || Object.keys(props).length === 0) return "";
-  return `params: ${signature(schema)}`;
-}
-//# sourceMappingURL=signature.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.paramsLine=paramsLine;exports.signature=signature;function signature(n,t=0){if(!n||typeof n!=="object")return"any";const r=n;if(Array.isArray(r.anyOf)){return r.anyOf.map(e=>signature(e,t)).join(" | ")}if(r.type==="array"){const e=typeof r.maxItems==="number"?` \u2264${r.maxItems}`:"";return`[${signature(r.items,t+1)}${e}]`}if(r.type==="object"||r.properties){const e=r.properties??{};const i=Object.keys(e);if(!i.length)return"{\u2026}";if(t>=3)return"{\u2026}";const u=new Set(r.required??[]);const a=i.map(s=>{const o=signature(e[s],t+1);const p=u.has(s)?"*":"";return o==="any"?`${s}${p}`:`${s}${p}: ${o}`});return`{ ${a.join(", ")} }`}if(Array.isArray(r.enum))return r.enum.map(e=>`"${String(e)}"`).join("|");return typeof r.type==="string"?r.type:"any"}function paramsLine(n){const t=n?.properties;if(!t||Object.keys(t).length===0)return"";return`params: ${signature(n)}`}