@buoy-gg/agent-core 7.0.40 → 7.0.42

package/lib/module/engine/retrieve.js

@@ -1,210 +1 @@
-"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
+"use strict";const h=20;const g=60;const y=2;export function retrieveEvidence(e,t){if(!e){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 o=e.get(t.ref);if(!o){return e.wasEvicted(t.ref)?{ok:false,error:`${t.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 ${t.ref}. Refs look like ev_12 and appear in [truncated \u2014 \u2026] and [earlier result \u2014 \u2026] markers.`}}const r={ref:o.ref,from:`${o.toolId}.${o.action}`,capturedAt:new Date(o.capturedAt).toISOString(),totalChars:o.text.length};let l;let s=true;try{l=JSON.parse(o.text)}catch{s=false}if(t.pattern!==void 0&&t.pattern!==""){return{...r,...$(s?JSON.stringify(l,null,1):o.text,t.pattern,t.contextLines??y)}}if(!s){const i=t.slice?o.text.slice(t.slice[0],t.slice[1]):o.text;return{...r,text:i}}let n=l;let c="(root)";if(t.path){const i=k(l,t.path);if(!i.ok)return{...r,ok:false,error:i.error};n=i.value;c=t.path}if(t.slice){const[i,a]=t.slice;if(Array.isArray(n))return{...r,at:c,sliced:[i,a],of:n.length,value:n.slice(i,a)};if(typeof n==="string")return{...r,at:c,sliced:[i,a],of:n.length,value:n.slice(i,a)};return{...r,ok:false,error:`slice applies to an array or a string; the value at ${c} is ${u(n)}.`}}if(!t.path)return{...r,shape:d(l),hint:'Pass path (e.g. "stats.0") or pattern to read a part.'};return{...r,at:c,value:n}}function u(e){if(e===null)return"null";if(Array.isArray(e))return"array";return typeof e}function d(e){if(Array.isArray(e)){return{type:"array",length:e.length,first:e.length?f(e[0]):void 0}}if(e&&typeof e==="object"){const t=Object.keys(e);const o=t.slice(0,g);const r={};for(const l of o)r[l]=f(e[l]);return t.length>o.length?{...r,"\u2026":`${t.length-o.length} more keys`}:r}return f(e)}function f(e){if(e===null||e===void 0)return String(e);if(Array.isArray(e))return`array(${e.length})`;if(typeof e==="object"){const t=Object.keys(e);const o=JSON.stringify(e).length;return`object{${t.slice(0,6).join(", ")}${t.length>6?", \u2026":""}} ~${o.toLocaleString("en-US")} chars`}if(typeof e==="string")return e.length>40?`string(${e.length})`:JSON.stringify(e);return`${typeof e}: ${String(e)}`}function k(e,t){const o=t.replace(/^\/+/,"").split(/[./]/).filter(s=>s.length>0);let r=e;const l=[];for(const s of o){if(r===null||typeof r!=="object"){return{ok:false,error:`Cannot go into ${l.join(".")||"(root)"} \u2014 it is ${u(r)}.`}}if(Array.isArray(r)){const n=Number(s);if(!Number.isInteger(n)||n<0||n>=r.length){return{ok:false,error:`${l.join(".")||"(root)"} is an array of ${r.length}; "${s}" is not an index in it.`}}r=r[n]}else{const n=r;if(!(s in n)){return{ok:false,error:`No field "${s}" at ${l.join(".")||"(root)"}. It has: ${Object.keys(n).slice(0,30).join(", ")}.`}}r=n[s]}l.push(s)}return{ok:true,value:r}}function $(e,t,o){const r=e.split("\n");const l=t.toLowerCase();const s=[];for(let i=0;i<r.length;i++)if(r[i].toLowerCase().includes(l))s.push(i);const n=Math.max(0,Math.min(10,o));const c=s.slice(0,h).map(i=>({line:i+1,text:r.slice(Math.max(0,i-n),i+n+1).join("\n")}));return{matches:c,totalMatches:s.length}}