@buoy-gg/agent-core 7.0.36 → 7.0.38

package/lib/module/engine/retrieve.js

@@ -0,0 +1,210 @@
+"use strict";
+
+/**
+ * `ask-buoy.retrieve` — read part of a kept result back. See evidence.ts.
+ *
+ * Four ways in, chosen so the model never needs the whole thing again:
+ *
+ * - nothing but `ref`   → the SHAPE: top-level keys with type and size, so the
+ *                          next call can name a path. Handing back the full
+ *                          text would only hit the same cap that cut it.
+ * - `path`              → the value at a dotted / slash path ("stats.0.base_stat",
+ *                          "/moves/3/move/name"). Arrays index by number.
+ * - `slice: [a, b]`     → a window: items of an array, characters of a string.
+ *                          Combines with `path`.
+ * - `pattern`           → a literal, case-insensitive substring search over the
+ *                          pretty-printed text; matching lines with
+ *                          `contextLines` (default 2) around each. Not a regex:
+ *                          a model that means "height" should not have to
+ *                          escape anything, and an executable pattern over a
+ *                          store of app data is a surface nobody asked for.
+ *
+ * Every result is capped at the same size as any other tool result, and the
+ * engine never stashes a retrieve result — a retrieve of a retrieve is a loop.
+ */
+
+const MAX_MATCHES = 20;
+const MAX_SHAPE_KEYS = 60;
+const DEFAULT_CONTEXT_LINES = 2;
+export function retrieveEvidence(store, params) {
+  if (!store) {
+    return {
+      ok: false,
+      error: "There is no evidence store in this session, so earlier results cannot be re-read. Call the tool again for the current value."
+    };
+  }
+  const entry = store.get(params.ref);
+  if (!entry) {
+    return store.wasEvicted(params.ref) ? {
+      ok: false,
+      error: `${params.ref} was kept but has since been evicted to make room (the store holds the most recent ~4 MB of results). Call the tool again for the current value.`
+    } : {
+      ok: false,
+      error: `No result with ref ${params.ref}. Refs look like ev_12 and appear in [truncated — …] and [earlier result — …] markers.`
+    };
+  }
+  const meta = {
+    ref: entry.ref,
+    from: `${entry.toolId}.${entry.action}`,
+    capturedAt: new Date(entry.capturedAt).toISOString(),
+    totalChars: entry.text.length
+  };
+  let parsed;
+  let isJson = true;
+  try {
+    parsed = JSON.parse(entry.text);
+  } catch {
+    isJson = false;
+  }
+  if (params.pattern !== undefined && params.pattern !== "") {
+    return {
+      ...meta,
+      ...search(isJson ? JSON.stringify(parsed, null, 1) : entry.text, params.pattern, params.contextLines ?? DEFAULT_CONTEXT_LINES)
+    };
+  }
+  if (!isJson) {
+    const text = params.slice ? entry.text.slice(params.slice[0], params.slice[1]) : entry.text;
+    return {
+      ...meta,
+      text
+    };
+  }
+  let value = parsed;
+  let at = "(root)";
+  if (params.path) {
+    const resolved = resolvePath(parsed, params.path);
+    if (!resolved.ok) return {
+      ...meta,
+      ok: false,
+      error: resolved.error
+    };
+    value = resolved.value;
+    at = params.path;
+  }
+  if (params.slice) {
+    const [a, b] = params.slice;
+    if (Array.isArray(value)) return {
+      ...meta,
+      at,
+      sliced: [a, b],
+      of: value.length,
+      value: value.slice(a, b)
+    };
+    if (typeof value === "string") return {
+      ...meta,
+      at,
+      sliced: [a, b],
+      of: value.length,
+      value: value.slice(a, b)
+    };
+    return {
+      ...meta,
+      ok: false,
+      error: `slice applies to an array or a string; the value at ${at} is ${typeOf(value)}.`
+    };
+  }
+  if (!params.path) return {
+    ...meta,
+    shape: shapeOf(parsed),
+    hint: "Pass path (e.g. \"stats.0\") or pattern to read a part."
+  };
+  return {
+    ...meta,
+    at,
+    value
+  };
+}
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+function typeOf(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array";
+  return typeof v;
+}
+
+/** Top-level keys (or array items) with a type and a size, for choosing a path. */
+function shapeOf(v) {
+  if (Array.isArray(v)) {
+    return {
+      type: "array",
+      length: v.length,
+      first: v.length ? describe(v[0]) : undefined
+    };
+  }
+  if (v && typeof v === "object") {
+    const keys = Object.keys(v);
+    const shown = keys.slice(0, MAX_SHAPE_KEYS);
+    const out = {};
+    for (const k of shown) out[k] = describe(v[k]);
+    return keys.length > shown.length ? {
+      ...out,
+      "…": `${keys.length - shown.length} more keys`
+    } : out;
+  }
+  return describe(v);
+}
+function describe(v) {
+  if (v === null || v === undefined) return String(v);
+  if (Array.isArray(v)) return `array(${v.length})`;
+  if (typeof v === "object") {
+    const keys = Object.keys(v);
+    const size = JSON.stringify(v).length;
+    return `object{${keys.slice(0, 6).join(", ")}${keys.length > 6 ? ", …" : ""}} ~${size.toLocaleString("en-US")} chars`;
+  }
+  if (typeof v === "string") return v.length > 40 ? `string(${v.length})` : JSON.stringify(v);
+  return `${typeof v}: ${String(v)}`;
+}
+function resolvePath(root, path) {
+  const segs = path.replace(/^\/+/, "").split(/[./]/).filter(s => s.length > 0);
+  let cur = root;
+  const walked = [];
+  for (const seg of segs) {
+    if (cur === null || typeof cur !== "object") {
+      return {
+        ok: false,
+        error: `Cannot go into ${walked.join(".") || "(root)"} — it is ${typeOf(cur)}.`
+      };
+    }
+    if (Array.isArray(cur)) {
+      const i = Number(seg);
+      if (!Number.isInteger(i) || i < 0 || i >= cur.length) {
+        return {
+          ok: false,
+          error: `${walked.join(".") || "(root)"} is an array of ${cur.length}; "${seg}" is not an index in it.`
+        };
+      }
+      cur = cur[i];
+    } else {
+      const rec = cur;
+      if (!(seg in rec)) {
+        return {
+          ok: false,
+          error: `No field "${seg}" at ${walked.join(".") || "(root)"}. It has: ${Object.keys(rec).slice(0, 30).join(", ")}.`
+        };
+      }
+      cur = rec[seg];
+    }
+    walked.push(seg);
+  }
+  return {
+    ok: true,
+    value: cur
+  };
+}
+function search(text, pattern, contextLines) {
+  const lines = text.split("\n");
+  const needle = pattern.toLowerCase();
+  const hits = [];
+  for (let i = 0; i < lines.length; i++) if (lines[i].toLowerCase().includes(needle)) hits.push(i);
+  const ctx = Math.max(0, Math.min(10, contextLines));
+  const matches = hits.slice(0, MAX_MATCHES).map(i => ({
+    line: i + 1,
+    text: lines.slice(Math.max(0, i - ctx), i + ctx + 1).join("\n")
+  }));
+  return {
+    matches,
+    totalMatches: hits.length
+  };
+}
+//# sourceMappingURL=retrieve.js.map

package/lib/module/engine/retrieve.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_MATCHES","MAX_SHAPE_KEYS","DEFAULT_CONTEXT_LINES","retrieveEvidence","store","params","ok","error","entry","get","ref","wasEvicted","meta","from","toolId","action","capturedAt","Date","toISOString","totalChars","text","length","parsed","isJson","JSON","parse","pattern","undefined","search","stringify","contextLines","slice","value","at","path","resolved","resolvePath","a","b","Array","isArray","sliced","of","typeOf","shape","shapeOf","hint","v","type","first","describe","keys","Object","shown","out","k","String","size","join","toLocaleString","root","segs","replace","split","filter","s","cur","walked","seg","i","Number","isInteger","rec","push","lines","needle","toLowerCase","hits","includes","ctx","Math","max","min","matches","map","line","totalMatches"],"sourceRoot":"../../../src","sources":["engine/retrieve.ts"],"mappings":"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","ignoreList":[]}