@buoy-gg/agent-core 7.0.33

package/lib/commonjs/catalog/snapshotReads.js

@@ -0,0 +1,256 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SNAPSHOT_ACTION = void 0;
+exports.projectSnapshot = projectSnapshot;
+var _redact = require("../policy/redact");
+/**
+ * The other half of Buoy's read surface.
+ *
+ * Every Buoy adapter answers in two ways, and only one of them is an action.
+ * `listQueries`, `async.getAllKeys` and `getState` are actions; console
+ * entries, network events, the route sitemap and the env table are NOT — they
+ * exist only inside the adapter's `getSnapshot`, which the sync layer polls and
+ * puts on the wire for MCP's `get_snapshot` / `get_console` /
+ * `get_network_requests` / `get_routes`.
+ *
+ * `dispatchToolAction` reaches only the first half. So an agent driving tools
+ * on the device could read storage, stores and the query cache, and was blind
+ * to the app's logs, its HTTP traffic, its routes and its environment — the
+ * four things a QA person is most likely to ask about, and two of which the
+ * empty state advertises as suggestions. The catalog even tells the model to
+ * "use get_console", which is an MCP tool that does not exist on this path.
+ *
+ * This module closes that half. `getSnapshot` is a RESERVED action name: the
+ * engine intercepts it before dispatch and routes it to the registry's
+ * snapshot reader instead.
+ *
+ * WHY THE PROJECTIONS. A raw snapshot is the heaviest payload in the system —
+ * measured at ~1.1KB per console entry with up to 1000 retained, and network
+ * events carry bodies. Handing that to a token-metered model truncated at 24K
+ * chars produces a torn JSON object and a wasted turn. Each projector here
+ * does what the matching MCP tool does: newest-first, filtered, and only the
+ * fields worth spending tokens on. Bodies stay behind `network.getEventBody`,
+ * which already exists.
+ */
+
+/** Reserved action name. Not a real adapter action anywhere. */
+const SNAPSHOT_ACTION = exports.SNAPSHOT_ACTION = "getSnapshot";
+const SEVERITY = {
+  verbose: 0,
+  debug: 0,
+  trace: 0,
+  log: 1,
+  info: 1,
+  warn: 2,
+  warning: 2,
+  error: 3
+};
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function rec(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function num(value, fallback) {
+  return typeof value === "number" && value > 0 ? value : fallback;
+}
+
+/** Newest N, matching the way every Buoy store appends. */
+function tail(items, limit) {
+  return items.length <= limit ? items : items.slice(items.length - limit);
+}
+function projectConsole(payload, params) {
+  const entries = asArray(rec(payload).entries);
+  const minSeverity = typeof params.level === "string" ? SEVERITY[params.level] ?? 0 : 0;
+  const pattern = typeof params.pattern === "string" ? params.pattern.toLowerCase() : undefined;
+  const matched = entries.filter(raw => {
+    const e = rec(raw);
+    const level = String(e.level ?? "log");
+    if ((SEVERITY[level] ?? 1) < minSeverity) return false;
+    if (!pattern) return true;
+    return String(e.message ?? "").toLowerCase().includes(pattern);
+  });
+  const shown = tail(matched, num(params.limit, 40));
+  return {
+    totalCaptured: entries.length,
+    shown: shown.length,
+    // Pre-rendered message only. Full args and stacks stay on the device;
+    // `get_snapshot('console')` is the MCP escape hatch and has no equivalent
+    // here on purpose — it is the payload that blows the prompt.
+    entries: shown.map(raw => {
+      const e = rec(raw);
+      return {
+        at: e.timestamp,
+        level: e.level,
+        message: e.message
+      };
+    })
+  };
+}
+function projectNetwork(payload, params) {
+  const p = rec(payload);
+  // The agent's own POSTs to the model endpoint are dropped HERE, not only by
+  // the engine's later pass, so the counts the model is given match the rows
+  // it is given. Reporting "4 requests" above a list of 3 is its own small lie.
+  const events = asArray(p.events).filter(raw => !(0, _redact.isSelfTraffic)(rec(raw).url));
+  const failedOnly = params.failedOnly === true;
+  const pattern = typeof params.pattern === "string" ? params.pattern.toLowerCase() : undefined;
+  const matched = events.filter(raw => {
+    const e = rec(raw);
+    const status = typeof e.status === "number" ? e.status : undefined;
+    if (failedOnly && !(e.error || status !== undefined && status >= 400)) return false;
+    if (!pattern) return true;
+    return String(e.url ?? "").toLowerCase().includes(pattern);
+  });
+  const shown = tail(matched, num(params.limit, 25));
+  return {
+    totalCaptured: events.length,
+    shown: shown.length,
+    // No bodies. `network.getEventBody` fetches one on demand, which is the
+    // difference between a readable list and a truncated blob.
+    requests: shown.map(raw => {
+      const e = rec(raw);
+      return {
+        id: e.id,
+        method: e.method,
+        url: e.url,
+        status: e.status,
+        durationMs: e.duration,
+        error: e.error,
+        // An override rule served this response. Carried through so neither
+        // the model nor the receipt can present mocked data as live.
+        overridden: e.override ? true : undefined
+      };
+    }),
+    hint: "Read one response with network.getEventBody({ id })."
+  };
+}
+
+/**
+ * The sitemap arrives as a NESTED RouteInfo tree, not a list. A model asked
+ * "what screens exist" needs the leaf paths, so flatten and keep the paths.
+ */
+function flattenRoutes(nodes, out = [], cap = 80) {
+  for (const raw of asArray(nodes)) {
+    if (out.length >= cap) break;
+    const node = rec(raw);
+    if (node.isInternal !== true && typeof node.path === "string") out.push(node.path);
+    flattenRoutes(node.children, out, cap);
+  }
+  return out;
+}
+function projectRoutes(payload, params) {
+  const p = rec(payload);
+  const sitemap = rec(p.sitemap);
+
+  // Route events are stored newest-FIRST, and a stack item's screen path is
+  // `pathname` (`path` does not exist on it). Getting either wrong is not a
+  // crash, it is a confident wrong answer: an early version of this read told
+  // the user they were on the Pokedex while the shop was on screen.
+  const stackRaw = asArray(p.stack).map(rec);
+  const eventsRaw = asArray(p.events).map(rec);
+  const stack = stackRaw.map(s => ({
+    name: s.name,
+    path: s.pathname,
+    focused: s.isFocused === true ? true : undefined
+  }));
+  const recentNavigations = eventsRaw.slice(0, num(params.limit, 15)).map(e => ({
+    at: e.timestamp,
+    from: e.previousPathname,
+    to: e.pathname
+  }));
+
+  // Mirrors the adapter's own `getCurrentRoute`: the newest navigation event
+  // wins, and with no history yet — a freshly launched app — the FOCUSED stack
+  // item does, which is not always the last one in the array.
+  const focused = stackRaw.find(s => s.isFocused === true) ?? stackRaw[stackRaw.length - 1];
+  const currentRoute = eventsRaw.length ? {
+    path: eventsRaw[0].pathname,
+    source: "event"
+  } : typeof focused?.pathname === "string" ? {
+    path: focused.pathname,
+    source: "stack"
+  } : undefined;
+  return {
+    currentRoute,
+    stack,
+    routes: flattenRoutes(sitemap.routes),
+    sitemapSource: sitemap.source,
+    recentNavigations
+  };
+}
+function projectEnv(payload) {
+  const p = rec(payload);
+  return {
+    env: p.env ?? p.variables,
+    requiredEnvVars: p.requiredEnvVars
+  };
+}
+
+/**
+ * Sentry envelopes are the fattest payloads any Buoy tool captures (a single
+ * event with breadcrumbs is tens of KB), so only the item SUMMARIES travel —
+ * the one-line human read the adapter already computes. The status field is
+ * load-bearing: an empty list with "sdk-not-found" means the app has no
+ * Sentry client, which is a different answer from "nothing errored".
+ */
+function projectSentry(payload, params) {
+  const p = rec(payload);
+  const envelopes = asArray(p.envelopes).map(rec);
+  const typeFilter = typeof params.type === "string" ? params.type : undefined;
+  const pattern = typeof params.pattern === "string" ? params.pattern.toLowerCase() : undefined;
+  const matched = envelopes.filter(e => {
+    const items = asArray(e.items).map(rec);
+    if (typeFilter && !items.some(i => i.type === typeFilter)) return false;
+    if (!pattern) return true;
+    return items.some(i => String(i.summary ?? "").toLowerCase().includes(pattern));
+  });
+  const shown = tail(matched, num(params.limit, 10));
+  return {
+    status: p.status,
+    totalCaptured: envelopes.length,
+    shown: shown.length,
+    envelopes: shown.map(e => ({
+      id: e.id,
+      at: e.timestamp,
+      origin: e.origin,
+      eventId: e.eventId,
+      totalBytes: e.totalBytes,
+      items: asArray(e.items).map(raw => {
+        const i = rec(raw);
+        return {
+          type: i.type,
+          summary: i.summary,
+          spanCount: i.spanCount,
+          bytes: i.bytes
+        };
+      })
+    })),
+    hint: "For crash stack traces, console's [FATAL] entries carry the component stacks."
+  };
+}
+
+/**
+ * Trim one snapshot to something worth sending. Unknown tools pass through —
+ * the engine's 24K truncation is still the backstop.
+ */
+function projectSnapshot(toolId, payload, params = {}) {
+  switch (toolId) {
+    case "console":
+      return projectConsole(payload, params);
+    case "network":
+      return projectNetwork(payload, params);
+    case "route-events":
+      return projectRoutes(payload, params);
+    case "env":
+      return projectEnv(payload);
+    case "sentry":
+      return projectSentry(payload, params);
+    default:
+      return payload;
+  }
+}
+//# sourceMappingURL=snapshotReads.js.map

package/lib/commonjs/catalog/snapshotReads.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_redact","require","SNAPSHOT_ACTION","exports","SEVERITY","verbose","debug","trace","log","info","warn","warning","error","asArray","value","Array","isArray","rec","num","fallback","tail","items","limit","length","slice","projectConsole","payload","params","entries","minSeverity","level","pattern","toLowerCase","undefined","matched","filter","raw","e","String","message","includes","shown","totalCaptured","map","at","timestamp","projectNetwork","p","events","isSelfTraffic","url","failedOnly","status","requests","id","method","durationMs","duration","overridden","override","hint","flattenRoutes","nodes","out","cap","node","isInternal","path","push","children","projectRoutes","sitemap","stackRaw","stack","eventsRaw","s","name","pathname","focused","isFocused","recentNavigations","from","previousPathname","to","find","currentRoute","source","routes","sitemapSource","projectEnv","env","variables","requiredEnvVars","projectSentry","envelopes","typeFilter","type","some","i","summary","origin","eventId","totalBytes","spanCount","bytes","projectSnapshot","toolId"],"sourceRoot":"../../../src","sources":["catalog/snapshotReads.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/catalog/toProviderTools.js

@@ -0,0 +1,107 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.fromProviderToolName = fromProviderToolName;
+exports.toProviderToolName = toProviderToolName;
+exports.toProviderTools = toProviderTools;
+/**
+ * Catalog -> provider tool definitions.
+ *
+ * WHY ONE TOOL PER BUOY TOOL, NOT ONE PER ACTION: tool-selection accuracy
+ * degrades past roughly 30-50 tools. Buoy has ~179 actions across 22 tools, so
+ * a 1:1 mapping is far past the point where the model starts picking wrong.
+ * Each Buoy tool therefore becomes ONE provider tool whose `action` property is
+ * an enum, with the per-action summaries folded into that enum's description.
+ *
+ * `params` stays an open object at the provider boundary — a discriminated
+ * union across 179 branches is unusable by any model and unreadable by a human.
+ * The real per-action schema is enforced one layer in, by `validateParams`,
+ * which returns a structured error the model can correct on the next turn.
+ * That is strictly stronger than the MCP server's `z.record(z.unknown())`,
+ * which validates nothing.
+ */
+
+/** Provider-agnostic tool definition; the adapters reshape it per protocol. */
+
+/**
+ * Both Anthropic and OpenAI cap tool names at `[a-zA-Z0-9_-]`, so Buoy's
+ * dashed ids survive but the `custom:<id>` sync namespace does not. Anthropic's
+ * docs say 64 chars while its reference schema says 128 — we code to 64.
+ */
+const MAX_TOOL_NAME = 64;
+function toProviderToolName(toolId) {
+  return `buoy_${toolId.replace(/[^a-zA-Z0-9_-]/g, "_")}`.slice(0, MAX_TOOL_NAME);
+}
+
+/** Reverse of {@link toProviderToolName}, resolved against the live catalog. */
+function fromProviderToolName(name, catalog) {
+  return catalog.find(t => toProviderToolName(t.toolId) === name)?.toolId;
+}
+
+/**
+ * One line per action, in the `action` enum's description. This is where the
+ * model actually learns what each action does, so it carries the effect and
+ * the release caveat inline rather than hiding them in a separate field the
+ * model never sees.
+ */
+function actionLine(a, isRelease) {
+  const bits = [`${a.action} — ${a.summary}`];
+  if (a.effect === "destructive") bits.push("[DESTRUCTIVE]");else if (a.effect === "write") bits.push("[changes state]");
+  if (isRelease && a.release !== "works") {
+    bits.push(`[UNAVAILABLE in this build: ${a.release}]`);
+  }
+  if (a.requires?.length) bits.push(`[needs: ${a.requires.join(", ")}]`);
+  return bits.join(" ");
+}
+function toProviderTools(catalog, opts = {}) {
+  const {
+    availableToolIds,
+    availableActions,
+    isRelease = false,
+    hideUnavailable = false
+  } = opts;
+  const tools = [];
+  for (const tool of catalog) {
+    if (availableToolIds && !availableToolIds.includes(tool.toolId)) continue;
+    const live = availableActions?.[tool.toolId];
+    let actions = live ? tool.actions.filter(a => live.includes(a.action)) : tool.actions;
+    if (isRelease && hideUnavailable) {
+      actions = actions.filter(a => a.release === "works");
+    }
+    if (actions.length === 0) continue;
+    const desc = [tool.summary, tool.unavailableWhen ? `Unavailable when: ${tool.unavailableWhen}` : "", "",
+    // These prose lines look like the expensive part of the catalog and are
+    // the CHEAPEST part of it. Measured against a real tokenizer (fal ->
+    // gpt-4o-mini): the whole catalog is 79,601 chars but only 7,902 tokens
+    // — 10.1 chars/token, because English prose is what BPE compresses best.
+    // An index that replaced these lines with a bare list of action names
+    // sent 48% fewer characters and cost MORE tokens (7,986), since dotted
+    // camelCase identifiers tokenize at ~5 chars/token. Do not "shrink" this
+    // by counting characters; measure tokens or leave it alone.
+    "Actions:", ...actions.map(a => `- ${actionLine(a, isRelease)}`)].filter(Boolean).join("\n");
+    tools.push({
+      name: toProviderToolName(tool.toolId),
+      description: desc,
+      inputSchema: {
+        type: "object",
+        properties: {
+          action: {
+            type: "string",
+            enum: actions.map(a => a.action),
+            description: "Which action to run. See the list in this tool's description."
+          },
+          params: {
+            type: "object",
+            description: "Arguments for the action. The shape depends on `action`; if you get it wrong the error will tell you the expected schema."
+          }
+        },
+        required: ["action"],
+        additionalProperties: false
+      }
+    });
+  }
+  return tools;
+}
+//# sourceMappingURL=toProviderTools.js.map

package/lib/commonjs/catalog/toProviderTools.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_TOOL_NAME","toProviderToolName","toolId","replace","slice","fromProviderToolName","name","catalog","find","t","actionLine","a","isRelease","bits","action","summary","effect","push","release","requires","length","join","toProviderTools","opts","availableToolIds","availableActions","hideUnavailable","tools","tool","includes","live","actions","filter","desc","unavailableWhen","map","Boolean","description","inputSchema","type","properties","enum","params","required","additionalProperties"],"sourceRoot":"../../../src","sources":["catalog/toProviderTools.ts"],"mappings":";;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAYA;AACA;AACA;AACA;AACA;AACA,MAAMA,aAAa,GAAG,EAAE;AAEjB,SAASC,kBAAkBA,CAACC,MAAc,EAAU;EACzD,OAAO,QAAQA,MAAM,CAACC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAACC,KAAK,CAAC,CAAC,EAAEJ,aAAa,CAAC;AACjF;;AAEA;AACO,SAASK,oBAAoBA,CAClCC,IAAY,EACZC,OAAyB,EACL;EACpB,OAAOA,OAAO,CAACC,IAAI,CAAEC,CAAC,IAAKR,kBAAkB,CAACQ,CAAC,CAACP,MAAM,CAAC,KAAKI,IAAI,CAAC,EAAEJ,MAAM;AAC3E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASQ,UAAUA,CAACC,CAAmB,EAAEC,SAAkB,EAAU;EACnE,MAAMC,IAAc,GAAG,CAAC,GAAGF,CAAC,CAACG,MAAM,MAAMH,CAAC,CAACI,OAAO,EAAE,CAAC;EACrD,IAAIJ,CAAC,CAACK,MAAM,KAAK,aAAa,EAAEH,IAAI,CAACI,IAAI,CAAC,eAAe,CAAC,CAAC,KACtD,IAAIN,CAAC,CAACK,MAAM,KAAK,OAAO,EAAEH,IAAI,CAACI,IAAI,CAAC,iBAAiB,CAAC;EAC3D,IAAIL,SAAS,IAAID,CAAC,CAACO,OAAO,KAAK,OAAO,EAAE;IACtCL,IAAI,CAACI,IAAI,CAAC,+BAA+BN,CAAC,CAACO,OAAO,GAAG,CAAC;EACxD;EACA,IAAIP,CAAC,CAACQ,QAAQ,EAAEC,MAAM,EAAEP,IAAI,CAACI,IAAI,CAAC,WAAWN,CAAC,CAACQ,QAAQ,CAACE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;EACtE,OAAOR,IAAI,CAACQ,IAAI,CAAC,GAAG,CAAC;AACvB;AAsBO,SAASC,eAAeA,CAC7Bf,OAAyB,EACzBgB,IAA4B,GAAG,CAAC,CAAC,EACjB;EAChB,MAAM;IACJC,gBAAgB;IAChBC,gBAAgB;IAChBb,SAAS,GAAG,KAAK;IACjBc,eAAe,GAAG;EACpB,CAAC,GAAGH,IAAI;EAER,MAAMI,KAAqB,GAAG,EAAE;EAEhC,KAAK,MAAMC,IAAI,IAAIrB,OAAO,EAAE;IAC1B,IAAIiB,gBAAgB,IAAI,CAACA,gBAAgB,CAACK,QAAQ,CAACD,IAAI,CAAC1B,MAAM,CAAC,EAAE;IAEjE,MAAM4B,IAAI,GAAGL,gBAAgB,GAAGG,IAAI,CAAC1B,MAAM,CAAC;IAC5C,IAAI6B,OAAO,GAAGD,IAAI,GACdF,IAAI,CAACG,OAAO,CAACC,MAAM,CAAErB,CAAC,IAAKmB,IAAI,CAACD,QAAQ,CAAClB,CAAC,CAACG,MAAM,CAAC,CAAC,GACnDc,IAAI,CAACG,OAAO;IAEhB,IAAInB,SAAS,IAAIc,eAAe,EAAE;MAChCK,OAAO,GAAGA,OAAO,CAACC,MAAM,CAAErB,CAAC,IAAKA,CAAC,CAACO,OAAO,KAAK,OAAO,CAAC;IACxD;IACA,IAAIa,OAAO,CAACX,MAAM,KAAK,CAAC,EAAE;IAE1B,MAAMa,IAAI,GAAG,CACXL,IAAI,CAACb,OAAO,EACZa,IAAI,CAACM,eAAe,GAAG,qBAAqBN,IAAI,CAACM,eAAe,EAAE,GAAG,EAAE,EACvE,EAAE;IACF;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,UAAU,EACV,GAAGH,OAAO,CAACI,GAAG,CAAExB,CAAC,IAAK,KAAKD,UAAU,CAACC,CAAC,EAAEC,SAAS,CAAC,EAAE,CAAC,CACvD,CACEoB,MAAM,CAACI,OAAO,CAAC,CACff,IAAI,CAAC,IAAI,CAAC;IAEbM,KAAK,CAACV,IAAI,CAAC;MACTX,IAAI,EAAEL,kBAAkB,CAAC2B,IAAI,CAAC1B,MAAM,CAAC;MACrCmC,WAAW,EAAEJ,IAAI;MACjBK,WAAW,EAAE;QACXC,IAAI,EAAE,QAAQ;QACdC,UAAU,EAAE;UACV1B,MAAM,EAAE;YACNyB,IAAI,EAAE,QAAQ;YACdE,IAAI,EAAEV,OAAO,CAACI,GAAG,CAAExB,CAAC,IAAKA,CAAC,CAACG,MAAM,CAAC;YAClCuB,WAAW,EAAE;UACf,CAAC;UACDK,MAAM,EAAE;YACNH,IAAI,EAAE,QAAQ;YACdF,WAAW,EACT;UACJ;QACF,CAAC;QACDM,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpBC,oBAAoB,EAAE;MACxB;IACF,CAAC,CAAC;EACJ;EAEA,OAAOjB,KAAK;AACd","ignoreList":[]}

package/lib/commonjs/catalog/validateParams.js

@@ -0,0 +1,129 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyDefaults = applyDefaults;
+exports.validateParams = validateParams;
+/**
+ * A deliberately small JSON Schema validator.
+ *
+ * Buoy's adapters validate nothing — every handler takes `params?: unknown` and
+ * hand-casts (`(params as { id?: string })?.id`), so a wrong shape becomes an
+ * undefined read, and an LLM omitting an optional flag can do real damage:
+ * `zustand.setState` defaults `replace ?? true`, so calling it without
+ * `replace` REPLACES the entire store rather than merging it.
+ *
+ * So the agent validates before it dispatches. The point is not spec
+ * compliance — it is that a rejection comes back to the model as a readable
+ * error naming the expected schema, which it can fix on the next turn. That is
+ * why this covers exactly the subset `JsonSchema` describes and nothing more:
+ * a rule the validator silently skips is a rule that isn't enforced.
+ */
+
+function typeOf(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array";
+  return typeof v;
+}
+function checkType(value, type) {
+  switch (type) {
+    case "integer":
+      return typeof value === "number" && Number.isInteger(value);
+    case "number":
+      return typeof value === "number" && Number.isFinite(value);
+    case "null":
+      return value === null;
+    case "array":
+      return Array.isArray(value);
+    case "object":
+      return typeOf(value) === "object";
+    default:
+      return typeof value === type;
+  }
+}
+function validate(value, schema, path, errors) {
+  if (schema.anyOf?.length) {
+    const anyOk = schema.anyOf.some(s => {
+      const sub = [];
+      validate(value, s, path, sub);
+      return sub.length === 0;
+    });
+    if (!anyOk) {
+      const kinds = schema.anyOf.map(s => s.type ?? "?").join(" | ");
+      errors.push(`${path}: expected ${kinds}, got ${typeOf(value)}`);
+    }
+    return;
+  }
+  if (schema.type && !checkType(value, schema.type)) {
+    errors.push(`${path}: expected ${schema.type}, got ${typeOf(value)}`);
+    return;
+  }
+  if (schema.enum && !schema.enum.includes(value)) {
+    errors.push(`${path}: expected one of ${schema.enum.map(e => JSON.stringify(e)).join(", ")}, got ${JSON.stringify(value)}`);
+    return;
+  }
+  if (schema.type === "array" && Array.isArray(value)) {
+    if (schema.minItems !== undefined && value.length < schema.minItems) {
+      errors.push(`${path}: expected at least ${schema.minItems} item(s), got ${value.length}`);
+    }
+    if (schema.maxItems !== undefined && value.length > schema.maxItems) {
+      errors.push(`${path}: expected at most ${schema.maxItems} item(s), got ${value.length}`);
+    }
+    if (schema.items) {
+      value.forEach((item, i) => validate(item, schema.items, `${path}[${i}]`, errors));
+    }
+    return;
+  }
+  if (schema.type === "object" && typeOf(value) === "object") {
+    const obj = value;
+    for (const key of schema.required ?? []) {
+      if (obj[key] === undefined) errors.push(`${path}.${key}: required`);
+    }
+    if (schema.properties) {
+      for (const [key, sub] of Object.entries(schema.properties)) {
+        if (obj[key] !== undefined) validate(obj[key], sub, `${path}.${key}`, errors);
+      }
+      // Only flag unknown keys when the schema says so. Several adapters read
+      // params they never documented, and rejecting an extra key the handler
+      // happens to use would break a call that would have worked.
+      if (schema.additionalProperties === false) {
+        const known = new Set(Object.keys(schema.properties));
+        for (const key of Object.keys(obj)) {
+          if (!known.has(key)) errors.push(`${path}.${key}: unexpected property`);
+        }
+      }
+    }
+  }
+}
+function validateParams(params, schema) {
+  const errors = [];
+  // A no-param action called with nothing is the common case, not an error.
+  const value = params === undefined || params === null ? {} : params;
+  validate(value, schema, "params", errors);
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+/**
+ * Fill in documented defaults the model left out.
+ *
+ * This is the counter-measure to the omitted-flag class of bug. Several Buoy
+ * actions invert the usual assumption — `focus-inspector.setTracking` reads
+ * `params?.enabled !== false`, so calling it with `{}` turns tracking ON — and
+ * the catalog records the real default. Applying it explicitly means the model
+ * omitting a flag produces the documented behaviour rather than the accidental
+ * one.
+ */
+function applyDefaults(params, schema) {
+  const out = typeOf(params) === "object" ? {
+    ...params
+  } : {};
+  for (const [key, sub] of Object.entries(schema.properties ?? {})) {
+    if (out[key] === undefined && sub.default !== undefined) out[key] = sub.default;
+  }
+  return out;
+}
+//# sourceMappingURL=validateParams.js.map

package/lib/commonjs/catalog/validateParams.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["typeOf","v","Array","isArray","checkType","value","type","Number","isInteger","isFinite","validate","schema","path","errors","anyOf","length","anyOk","some","s","sub","kinds","map","join","push","enum","includes","e","JSON","stringify","minItems","undefined","maxItems","items","forEach","item","i","obj","key","required","properties","Object","entries","additionalProperties","known","Set","keys","has","validateParams","params","ok","applyDefaults","out","default"],"sourceRoot":"../../../src","sources":["catalog/validateParams.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/context/buildContextPack.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildContextDigest = buildContextDigest;
+var _snapshotReads = require("../catalog/snapshotReads");
+/**
+ * The grounding digest — "here is what this app looks like".
+ *
+ * Composed entirely from readers that already exist. Most Buoy adapters ship a
+ * compact action written explicitly for a remote driver (`listQueries`,
+ * `listStores`, `listAtoms`, `getState`, `async.getAllKeys`), and those are
+ * exactly the right size: measured on a live idle device the whole digest is
+ * ~5.7KB (~1.5K tokens) covering routes, env, query keys, redux slices,
+ * zustand stores, jotai atoms, storage keys and API hosts.
+ *
+ * What this does NOT do, and why:
+ * - No `getSnapshot('query')`. It returns the full dehydrated cache — 8.3KB for
+ *   ten queries in that same measurement, growing with every cached payload.
+ *   `listQueries` covers the same ground in 1.8KB.
+ * - No console. It is the fattest payload in the system at ~1.1KB per entry
+ *   with up to 1000 retained; a naive "include recent logs" is a 1MB prompt.
+ * - No values, only shapes and keys. `includeValues`/`includeData` are
+ *   unbounded on the action path — no adapter applies a size guard — and the
+ *   whole point of the digest is to tell the model where to look, not to
+ *   pre-fetch everything it might want.
+ */
+
+/** Per-probe budget. A slow tool must not hold up the first message. */
+const PROBE_TIMEOUT_MS = 2500;
+const list = value => Array.isArray(value) ? value : Array.isArray(value?.items) ? value.items : [];
+const names = (value, keys, cap = 40) => list(value).slice(0, cap).map(item => {
+  if (!item || typeof item !== "object") return item;
+  const rec = item;
+  for (const k of keys) {
+    if (rec[k] !== undefined) return rec[k];
+  }
+  return rec.id ?? rec.name ?? rec.key;
+});
+const PROBES = [{
+  // `getSitemap` was never an action — the sitemap lives in the adapter's
+  // snapshot, so this probe could only ever have been filtered out or
+  // thrown. Same for env below.
+  key: "routes",
+  toolId: "route-events",
+  action: _snapshotReads.SNAPSHOT_ACTION,
+  // projectSnapshot already flattened the nested route tree to paths.
+  shape: v => list(v?.routes).slice(0, 60)
+}, {
+  key: "queryKeys",
+  toolId: "query",
+  action: "listQueries",
+  shape: v => names(v, ["queryHash", "queryKey", "key"], 40)
+}, {
+  key: "reduxSlices",
+  toolId: "redux",
+  action: "getState",
+  params: {
+    includeValues: false
+  },
+  shape: v => v && typeof v === "object" ? Object.keys(v.state ?? v).slice(0, 40) : v
+}, {
+  // Carries `persists to <key>` for persisted stores. That mapping is the
+  // only way the model can tell that an innocent-looking storage key is
+  // actually a hydrated store's saved copy — write the key directly and the
+  // screen does not change, then the store overwrites you. `listStores`
+  // already reports `persistName`; nothing else surfaces it.
+  key: "zustandStores",
+  toolId: "zustand",
+  action: "listStores",
+  // Structured, not a display string: `session` reads `persistsTo` back out
+  // to build the owner map the engine uses at dispatch time, and the digest
+  // is JSON-stringified into the prompt anyway, so the model loses nothing.
+  shape: v => list(v?.stores ?? v).slice(0, 30).map(raw => {
+    const s = raw ?? {};
+    const name = typeof s.name === "string" ? s.name : s.id;
+    return typeof s.persistName === "string" ? {
+      name,
+      persistsTo: s.persistName
+    } : {
+      name
+    };
+  })
+}, {
+  key: "jotaiAtoms",
+  toolId: "jotai",
+  action: "listAtoms",
+  shape: v => names(v, ["debugLabel", "label", "id"], 40)
+}, {
+  key: "storageKeys",
+  toolId: "storage",
+  action: "async.getAllKeys",
+  shape: v => list(v).slice(0, 60)
+}, {
+  key: "env",
+  toolId: "env",
+  action: _snapshotReads.SNAPSHOT_ACTION,
+  // Names only. Env values are baked into the bundle and can hold anything
+  // the app author put in an EXPO_PUBLIC_ var, so the digest lists the keys
+  // and leaves reading a value to an explicit ask.
+  shape: v => {
+    const env = v?.env;
+    return env && typeof env === "object" ? Object.keys(env).slice(0, 40) : undefined;
+  }
+}];
+async function withTimeout(p, ms) {
+  return await Promise.race([p.catch(() => undefined), new Promise(resolve => setTimeout(() => resolve(undefined), ms))]);
+}
+async function buildContextDigest({
+  dispatch,
+  readSnapshot,
+  availableToolIds,
+  availableActions
+}) {
+  const runnable = PROBES.filter(p => {
+    if (!availableToolIds.includes(p.toolId)) return false;
+    const actions = availableActions?.[p.toolId];
+    return !actions || actions.includes(p.action);
+  });
+
+  // All at once — these are independent reads and the first message should not
+  // wait on the slowest one twice over.
+  const settled = await Promise.all(runnable.map(async probe => {
+    const read = probe.action === _snapshotReads.SNAPSHOT_ACTION ? readSnapshot ? Promise.resolve(readSnapshot(probe.toolId)).then(payload => (0, _snapshotReads.projectSnapshot)(probe.toolId, payload)) : Promise.resolve(undefined) : Promise.resolve(dispatch(probe.toolId, probe.action, probe.params));
+    const value = await withTimeout(read, PROBE_TIMEOUT_MS);
+    if (value === undefined) return [probe.key, undefined];
+    try {
+      return [probe.key, probe.shape(value)];
+    } catch {
+      return [probe.key, undefined];
+    }
+  }));
+  const digest = {};
+  for (const [key, value] of settled) {
+    const empty = value === undefined || value === null || Array.isArray(value) && value.length === 0;
+    if (!empty) digest[key] = value;
+  }
+  return digest;
+}
+//# sourceMappingURL=buildContextPack.js.map