@buoy-gg/agent-core 7.0.36 → 7.0.38

package/lib/commonjs/engine/historyBudget.js

@@ -3,12 +3,14 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.MAX_REQUEST_CHARS = exports.MAX_HISTORY_CHARS = void 0;
+exports.MAX_REQUEST_TOKENS = exports.MAX_REQUEST_CHARS = exports.MAX_HISTORY_TOKENS = exports.MAX_HISTORY_CHARS = void 0;
 exports.budgetForRequest = budgetForRequest;
 exports.compressConsumed = compressConsumed;
 exports.messageSize = messageSize;
 exports.trimHistory = trimHistory;
 exports.trimHistoryReport = trimHistoryReport;
+var _evidence = require("./evidence");
+var _tokenCalibration = require("./tokenCalibration");
 /**
  * How much conversation the model is allowed to be sent, and what gets cut.
  *
@@ -52,14 +54,22 @@ exports.trimHistoryReport = trimHistoryReport;
  * before — a round starts at a user message, so the assistant/tool-result
  * pairing every provider requires stays intact.
  */
-const MAX_HISTORY_CHARS = exports.MAX_HISTORY_CHARS = 150_000;
+/**
+ * The limits are in TOKENS — the unit the provider enforces — and turned into
+ * characters at the ratio the session has measured (engine/tokenCalibration.ts).
+ * The `_CHARS` constants below are those limits at the default 4 chars/token,
+ * kept for callers that have no calibration in hand (tests, one-shot use).
+ */
+const MAX_HISTORY_TOKENS = exports.MAX_HISTORY_TOKENS = 37_500;
 /**
  * The ceiling on a WHOLE request: tools, system prompt, messages and the room
- * reserved for the reply. ~100k tokens, which fits the smallest context Ask
- * Buoy is pointed at in practice (a 128k-token gateway) with headroom, and
- * leaves Anthropic's 200k far from the limit.
+ * reserved for the reply. 100k tokens fits the smallest context Ask Buoy is
+ * pointed at in practice (a 128k-token gateway) with headroom, and leaves
+ * Anthropic's 200k far from the limit.
  */
-const MAX_REQUEST_CHARS = exports.MAX_REQUEST_CHARS = 400_000;
+const MAX_REQUEST_TOKENS = exports.MAX_REQUEST_TOKENS = 100_000;
+const MAX_HISTORY_CHARS = exports.MAX_HISTORY_CHARS = MAX_HISTORY_TOKENS * _tokenCalibration.DEFAULT_CHARS_PER_TOKEN;
+const MAX_REQUEST_CHARS = exports.MAX_REQUEST_CHARS = MAX_REQUEST_TOKENS * _tokenCalibration.DEFAULT_CHARS_PER_TOKEN;
 const MIN_KEEP_MESSAGES = 4;
 /** Below this a marker costs more than the payload it replaces. */
 const MIN_COMPRESS_CHARS = 400;
@@ -75,16 +85,21 @@ function messageSize(m) {
  * Replace consumed tool results with a marker. See the note above
  * MAX_HISTORY_CHARS for what "consumed" means and why the exemptions exist.
  */
-function compressConsumed(messages) {
+function compressConsumed(messages, exemptNewest = true) {
   // The newest tool-results message: the model is about to answer from it.
-  let newest = -1;
-  for (let i = messages.length - 1; i >= 0; i--) {
-    if (messages[i].role === "tool-results") {
-      newest = i;
-      break;
+  // Unless the caller says otherwise — `budgetForRequest` hands in the rounds
+  // BEFORE the current one, whose last result was answered long ago.
+  let newest = messages.length;
+  if (exemptNewest) {
+    newest = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+      if (messages[i].role === "tool-results") {
+        newest = i;
+        break;
+      }
     }
+    if (newest <= 0) return messages;
   }
-  if (newest <= 0) return messages;
 
   // The reads a later write depended on. An assistant turn that called a
   // write was matching a shape it read in the round before, and that is the
@@ -109,9 +124,11 @@ function compressConsumed(messages) {
       if (r.isError || r.content.length < MIN_COMPRESS_CHARS) return r;
       if (r.content.startsWith("[earlier result")) return r;
       touched = true;
+      // The ref survives the compression: the marker names it, and a later
+      // `retrieve` reads the full text back. See engine/evidence.ts.
       return {
         ...r,
-        content: `[earlier result — ${r.content.length} characters, already read. Ask again if you need it.]`
+        content: (0, _evidence.compressedMarker)(r.content.length, r.ref)
       };
     });
     if (!touched) return m;
@@ -131,6 +148,70 @@ function compressConsumed(messages) {
  */
 const WRITE_ISH = /set|write|dispatch|navigate|tap|override|restore|delete|remove|clear|save|run|impersonat|reload/i;
 
+/**
+ * A round: a user message and everything up to the next one. `pinned` when
+ * one of its tool calls made a change that is still applied — see
+ * `dropRounds`.
+ */
+
+function splitRounds(messages, pinnedCallIds) {
+  const rounds = [];
+  for (const m of messages) {
+    if (m.role === "user" || rounds.length === 0) rounds.push({
+      messages: [],
+      size: 0,
+      pinned: false
+    });
+    const round = rounds[rounds.length - 1];
+    round.messages.push(m);
+    round.size += messageSize(m);
+    if (pinnedCallIds?.size && m.role === "assistant" && m.toolCalls?.some(c => pinnedCallIds.has(c.id))) round.pinned = true;
+  }
+  return rounds;
+}
+
+/**
+ * Drop whole rounds, oldest first, until `keepSize + dropped` fits — but the
+ * PINNED rounds last.
+ *
+ * Dropping oldest-first was the whole rule, and in a QA session the oldest
+ * round is usually the SETUP: the override that was armed, the store that
+ * was written, the user someone is impersonating. Lose it and the model can
+ * no longer explain the screen it is looking at, or that a "wrong" response
+ * is its own mock — and the changes list in the prompt names the change but
+ * not the reasoning around it. The ledger knows which changes are still
+ * applied, so a round that made one is kept (compressed, like any other) for
+ * as long as an unpinned round remains to drop instead. Only when nothing
+ * else is left do pinned rounds go, oldest first, and the caller says so.
+ * Strands' `pin-message.ts` is the same idea, keyed on message metadata.
+ *
+ * `minMessages` is the floor the session-level trim keeps (a history that
+ * opens mid-exchange is rejected by every provider; the floor is applied on
+ * STARTING a drop, so a drop always runs to the next user boundary).
+ */
+function dropRounds(rounds, budget, keepSize, minMessages) {
+  const remaining = [...rounds];
+  let size = remaining.reduce((n, r) => n + r.size, 0);
+  let droppedRounds = 0;
+  let droppedPinned = 0;
+  const messageCount = () => remaining.reduce((n, r) => n + r.messages.length, 0);
+  while (remaining.length > 0 && size + keepSize > budget && messageCount() > minMessages) {
+    let i = remaining.findIndex(r => !r.pinned);
+    if (i < 0) {
+      i = 0;
+      droppedPinned += 1;
+    }
+    size -= remaining[i].size;
+    remaining.splice(i, 1);
+    droppedRounds += 1;
+  }
+  return {
+    kept: remaining.flatMap(r => r.messages),
+    droppedRounds,
+    droppedPinned
+  };
+}
+
 /**
  * Trim, and say how many whole rounds were dropped — the number the UI turns
  * into "older messages were trimmed from the agent's memory".
@@ -141,37 +222,35 @@ const WRITE_ISH = /set|write|dispatch|navigate|tap|override|restore|delete|remov
  * assistant or tool-results message — which every provider rejects. The
  * minimum-keep guard belongs on STARTING a drop, not on finishing one.
  */
-function trimHistoryReport(messages) {
+function trimHistoryReport(messages, charsPerToken = _tokenCalibration.DEFAULT_CHARS_PER_TOKEN, /** Tool-call ids whose change is still applied — their rounds are dropped last. See dropRounds. */
+pinnedCallIds) {
+  const limit = Math.floor(MAX_HISTORY_TOKENS * charsPerToken);
   let total = 0;
   for (const m of messages) total += messageSize(m);
-  if (total <= MAX_HISTORY_CHARS) return {
+  if (total <= limit) return {
     messages,
-    droppedRounds: 0
+    droppedRounds: 0,
+    droppedPinned: 0
   };
 
   // Compress before dropping — a compressed round still explains the screen.
   const compressed = compressConsumed(messages);
   let after = 0;
   for (const m of compressed) after += messageSize(m);
-  if (after <= MAX_HISTORY_CHARS) return {
+  if (after <= limit) return {
     messages: compressed,
-    droppedRounds: 0
+    droppedRounds: 0,
+    droppedPinned: 0
   };
-  total = after;
-  const out = [...compressed];
-  let droppedRounds = 0;
-  while (out.length > MIN_KEEP_MESSAGES && total > MAX_HISTORY_CHARS) {
-    total -= messageSize(out[0]);
-    out.shift();
-    while (out.length > 0 && out[0].role !== "user") {
-      total -= messageSize(out[0]);
-      out.shift();
-    }
-    droppedRounds += 1;
-  }
+  const {
+    kept,
+    droppedRounds,
+    droppedPinned
+  } = dropRounds(splitRounds(compressed, pinnedCallIds), limit, 0, MIN_KEEP_MESSAGES);
   return {
-    messages: out,
-    droppedRounds
+    messages: kept,
+    droppedRounds,
+    droppedPinned
   };
 }
 
@@ -194,7 +273,15 @@ function trimHistory(messages) {
  * installed), the system prompt, and the reply the model is allowed to write.
  * Budgeting messages alone would leave the biggest fixed cost out of the sum.
  */
-function budgetForRequest(messages, reserve) {
+function budgetForRequest(messages, reserve,
+/**
+ * A tighter ceiling on the messages than MAX_HISTORY_CHARS — set by the
+ * engine after the provider refused a request as too big. The proactive
+ * budget is an estimate; the provider's refusal is the truth.
+ */
+cap = MAX_HISTORY_CHARS, /** The session's measured ratio; scales the whole-request ceiling. */
+charsPerToken = _tokenCalibration.DEFAULT_CHARS_PER_TOKEN, /** Tool-call ids whose change is still applied — their rounds are dropped last. See dropRounds. */
+pinnedCallIds) {
   /**
    * `MAX_HISTORY_CHARS` is a MESSAGES budget and always was — subtracting the
    * reserve from it is wrong by a wide margin. The tool block alone is ~94,000
@@ -208,12 +295,13 @@ function budgetForRequest(messages, reserve) {
    * the fixed cost is counted. In an ordinary install the first wins and
    * nothing changes; the second only bites when the tools are huge.
    */
-  const budget = Math.min(MAX_HISTORY_CHARS, MAX_REQUEST_CHARS - reserve);
+  const budget = Math.min(cap, Math.floor(MAX_REQUEST_TOKENS * charsPerToken) - reserve);
   let total = 0;
   for (const m of messages) total += messageSize(m);
   if (total <= budget) return {
     messages,
-    droppedRounds: 0
+    droppedRounds: 0,
+    droppedPinned: 0
   };
 
   // Where the current round begins. Nothing from here on is eligible.
@@ -224,37 +312,52 @@ function budgetForRequest(messages, reserve) {
       break;
     }
   }
-  if (currentRound <= 0) return {
-    messages,
-    droppedRounds: 0
-  };
+  if (currentRound <= 0) {
+    // The whole history is this one round and it is over the limit by
+    // itself. Its consumed results are compressed, the newest kept — see the
+    // last-resort note below; this is the same move with nothing to drop.
+    return {
+      messages: compressConsumed(messages),
+      droppedRounds: 0,
+      droppedPinned: 0
+    };
+  }
   const earlier = messages.slice(0, currentRound);
   const current = messages.slice(currentRound);
   let currentSize = 0;
   for (const m of current) currentSize += messageSize(m);
-  const compressed = compressConsumed(earlier);
+
+  // `false`: the earlier rounds' last result was answered long ago — the
+  // newest-result exemption is about the round being answered NOW.
+  const compressed = compressConsumed(earlier, false);
   let earlierSize = 0;
   for (const m of compressed) earlierSize += messageSize(m);
   if (earlierSize + currentSize <= budget) {
     return {
       messages: [...compressed, ...current],
-      droppedRounds: 0
+      droppedRounds: 0,
+      droppedPinned: 0
     };
   }
-  const out = [...compressed];
-  let droppedRounds = 0;
-  while (out.length > 0 && earlierSize + currentSize > budget) {
-    earlierSize -= messageSize(out[0]);
-    out.shift();
-    while (out.length > 0 && out[0].role !== "user") {
-      earlierSize -= messageSize(out[0]);
-      out.shift();
-    }
-    droppedRounds += 1;
-  }
+  const {
+    kept: out,
+    droppedRounds,
+    droppedPinned
+  } = dropRounds(splitRounds(compressed, pinnedCallIds), budget, currentSize, 0);
+  earlierSize = out.reduce((n, m) => n + messageSize(m), 0);
+  /**
+   * LAST RESORT, inside the current round. Everything earlier is gone and the
+   * turn's own reads are still over the limit — a twelve-step investigation
+   * of 24k-character results does that by itself. The consumed ones (an
+   * assistant message came after them) are compressed the same way earlier
+   * rounds were, newest result and the reads before a write still exempt.
+   * Their refs make this lossless for the model: `retrieve` reads them back.
+   */
+  const currentOut = out.length === 0 && earlierSize + currentSize > budget ? compressConsumed(current) : current;
   return {
-    messages: [...out, ...current],
-    droppedRounds
+    messages: [...out, ...currentOut],
+    droppedRounds,
+    droppedPinned
   };
 }
 //# sourceMappingURL=historyBudget.js.map

package/lib/commonjs/engine/historyBudget.js.map

@@ -1 +1 @@
-{"version":3,"names":["MAX_HISTORY_CHARS","exports","MAX_REQUEST_CHARS","MIN_KEEP_MESSAGES","MIN_COMPRESS_CHARS","messageSize","m","JSON","stringify","length","compressConsumed","messages","newest","i","role","beforeWrite","Set","toolCalls","some","c","WRITE_ISH","test","input","name","j","add","changed","out","map","has","touched","results","r","isError","content","startsWith","trimHistoryReport","total","droppedRounds","compressed","after","shift","trimHistory","budgetForRequest","reserve","budget","Math","min","currentRound","earlier","slice","current","currentSize","earlierSize"],"sourceRoot":"../../../src","sources":["engine/historyBudget.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_evidence","require","_tokenCalibration","MAX_HISTORY_TOKENS","exports","MAX_REQUEST_TOKENS","MAX_HISTORY_CHARS","DEFAULT_CHARS_PER_TOKEN","MAX_REQUEST_CHARS","MIN_KEEP_MESSAGES","MIN_COMPRESS_CHARS","messageSize","m","JSON","stringify","length","compressConsumed","messages","exemptNewest","newest","i","role","beforeWrite","Set","toolCalls","some","c","WRITE_ISH","test","input","name","j","add","changed","out","map","has","touched","results","r","isError","content","startsWith","compressedMarker","ref","splitRounds","pinnedCallIds","rounds","push","size","pinned","round","id","dropRounds","budget","keepSize","minMessages","remaining","reduce","n","droppedRounds","droppedPinned","messageCount","findIndex","splice","kept","flatMap","trimHistoryReport","charsPerToken","limit","Math","floor","total","compressed","after","trimHistory","budgetForRequest","reserve","cap","min","currentRound","earlier","slice","current","currentSize","earlierSize","currentOut"],"sourceRoot":"../../../src","sources":["engine/historyBudget.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/engine/retrieve.js

@@ -0,0 +1,214 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.retrieveEvidence = retrieveEvidence;
+/**
+ * `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;
+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/commonjs/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":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,MAAMA,WAAW,GAAG,EAAE;AACtB,MAAMC,cAAc,GAAG,EAAE;AACzB,MAAMC,qBAAqB,GAAG,CAAC;AAExB,SAASC,gBAAgBA,CAACC,KAAgC,EAAEC,MAAsB,EAAW;EAClG,IAAI,CAACD,KAAK,EAAE;IACV,OAAO;MAAEE,EAAE,EAAE,KAAK;MAAEC,KAAK,EAAE;IAA+H,CAAC;EAC7J;EACA,MAAMC,KAAK,GAAGJ,KAAK,CAACK,GAAG,CAACJ,MAAM,CAACK,GAAG,CAAC;EACnC,IAAI,CAACF,KAAK,EAAE;IACV,OAAOJ,KAAK,CAACO,UAAU,CAACN,MAAM,CAACK,GAAG,CAAC,GAC/B;MAAEJ,EAAE,EAAE,KAAK;MAAEC,KAAK,EAAE,GAAGF,MAAM,CAACK,GAAG;IAAmJ,CAAC,GACrL;MAAEJ,EAAE,EAAE,KAAK;MAAEC,KAAK,EAAE,sBAAsBF,MAAM,CAACK,GAAG;IAAyF,CAAC;EACpJ;EAEA,MAAME,IAAI,GAAG;IACXF,GAAG,EAAEF,KAAK,CAACE,GAAG;IACdG,IAAI,EAAE,GAAGL,KAAK,CAACM,MAAM,IAAIN,KAAK,CAACO,MAAM,EAAE;IACvCC,UAAU,EAAE,IAAIC,IAAI,CAACT,KAAK,CAACQ,UAAU,CAAC,CAACE,WAAW,CAAC,CAAC;IACpDC,UAAU,EAAEX,KAAK,CAACY,IAAI,CAACC;EACzB,CAAC;EAED,IAAIC,MAAe;EACnB,IAAIC,MAAM,GAAG,IAAI;EACjB,IAAI;IACFD,MAAM,GAAGE,IAAI,CAACC,KAAK,CAACjB,KAAK,CAACY,IAAI,CAAC;EACjC,CAAC,CAAC,MAAM;IACNG,MAAM,GAAG,KAAK;EAChB;EAEA,IAAIlB,MAAM,CAACqB,OAAO,KAAKC,SAAS,IAAItB,MAAM,CAACqB,OAAO,KAAK,EAAE,EAAE;IACzD,OAAO;MAAE,GAAGd,IAAI;MAAE,GAAGgB,MAAM,CAACL,MAAM,GAAGC,IAAI,CAACK,SAAS,CAACP,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAGd,KAAK,CAACY,IAAI,EAAEf,MAAM,CAACqB,OAAO,EAAErB,MAAM,CAACyB,YAAY,IAAI5B,qBAAqB;IAAE,CAAC;EACpJ;EAEA,IAAI,CAACqB,MAAM,EAAE;IACX,MAAMH,IAAI,GAAGf,MAAM,CAAC0B,KAAK,GAAGvB,KAAK,CAACY,IAAI,CAACW,KAAK,CAAC1B,MAAM,CAAC0B,KAAK,CAAC,CAAC,CAAC,EAAE1B,MAAM,CAAC0B,KAAK,CAAC,CAAC,CAAC,CAAC,GAAGvB,KAAK,CAACY,IAAI;IAC3F,OAAO;MAAE,GAAGR,IAAI;MAAEQ;IAAK,CAAC;EAC1B;EAEA,IAAIY,KAAK,GAAGV,MAAM;EAClB,IAAIW,EAAE,GAAG,QAAQ;EACjB,IAAI5B,MAAM,CAAC6B,IAAI,EAAE;IACf,MAAMC,QAAQ,GAAGC,WAAW,CAACd,MAAM,EAAEjB,MAAM,CAAC6B,IAAI,CAAC;IACjD,IAAI,CAACC,QAAQ,CAAC7B,EAAE,EAAE,OAAO;MAAE,GAAGM,IAAI;MAAEN,EAAE,EAAE,KAAK;MAAEC,KAAK,EAAE4B,QAAQ,CAAC5B;IAAM,CAAC;IACtEyB,KAAK,GAAGG,QAAQ,CAACH,KAAK;IACtBC,EAAE,GAAG5B,MAAM,CAAC6B,IAAI;EAClB;EAEA,IAAI7B,MAAM,CAAC0B,KAAK,EAAE;IAChB,MAAM,CAACM,CAAC,EAAEC,CAAC,CAAC,GAAGjC,MAAM,CAAC0B,KAAK;IAC3B,IAAIQ,KAAK,CAACC,OAAO,CAACR,KAAK,CAAC,EAAE,OAAO;MAAE,GAAGpB,IAAI;MAAEqB,EAAE;MAAEQ,MAAM,EAAE,CAACJ,CAAC,EAAEC,CAAC,CAAC;MAAEI,EAAE,EAAEV,KAAK,CAACX,MAAM;MAAEW,KAAK,EAAEA,KAAK,CAACD,KAAK,CAACM,CAAC,EAAEC,CAAC;IAAE,CAAC;IAC5G,IAAI,OAAON,KAAK,KAAK,QAAQ,EAAE,OAAO;MAAE,GAAGpB,IAAI;MAAEqB,EAAE;MAAEQ,MAAM,EAAE,CAACJ,CAAC,EAAEC,CAAC,CAAC;MAAEI,EAAE,EAAEV,KAAK,CAACX,MAAM;MAAEW,KAAK,EAAEA,KAAK,CAACD,KAAK,CAACM,CAAC,EAAEC,CAAC;IAAE,CAAC;IACjH,OAAO;MAAE,GAAG1B,IAAI;MAAEN,EAAE,EAAE,KAAK;MAAEC,KAAK,EAAE,uDAAuD0B,EAAE,OAAOU,MAAM,CAACX,KAAK,CAAC;IAAI,CAAC;EACxH;EAEA,IAAI,CAAC3B,MAAM,CAAC6B,IAAI,EAAE,OAAO;IAAE,GAAGtB,IAAI;IAAEgC,KAAK,EAAEC,OAAO,CAACvB,MAAM,CAAC;IAAEwB,IAAI,EAAE;EAA0D,CAAC;EAC7H,OAAO;IAAE,GAAGlC,IAAI;IAAEqB,EAAE;IAAED;EAAM,CAAC;AAC/B;;AAEA;;AAEA,SAASW,MAAMA,CAACI,CAAU,EAAU;EAClC,IAAIA,CAAC,KAAK,IAAI,EAAE,OAAO,MAAM;EAC7B,IAAIR,KAAK,CAACC,OAAO,CAACO,CAAC,CAAC,EAAE,OAAO,OAAO;EACpC,OAAO,OAAOA,CAAC;AACjB;;AAEA;AACA,SAASF,OAAOA,CAACE,CAAU,EAAW;EACpC,IAAIR,KAAK,CAACC,OAAO,CAACO,CAAC,CAAC,EAAE;IACpB,OAAO;MAAEC,IAAI,EAAE,OAAO;MAAE3B,MAAM,EAAE0B,CAAC,CAAC1B,MAAM;MAAE4B,KAAK,EAAEF,CAAC,CAAC1B,MAAM,GAAG6B,QAAQ,CAACH,CAAC,CAAC,CAAC,CAAC,CAAC,GAAGpB;IAAU,CAAC;EAC1F;EACA,IAAIoB,CAAC,IAAI,OAAOA,CAAC,KAAK,QAAQ,EAAE;IAC9B,MAAMI,IAAI,GAAGC,MAAM,CAACD,IAAI,CAACJ,CAA4B,CAAC;IACtD,MAAMM,KAAK,GAAGF,IAAI,CAACpB,KAAK,CAAC,CAAC,EAAE9B,cAAc,CAAC;IAC3C,MAAMqD,GAA2B,GAAG,CAAC,CAAC;IACtC,KAAK,MAAMC,CAAC,IAAIF,KAAK,EAAEC,GAAG,CAACC,CAAC,CAAC,GAAGL,QAAQ,CAAEH,CAAC,CAA6BQ,CAAC,CAAC,CAAC;IAC3E,OAAOJ,IAAI,CAAC9B,MAAM,GAAGgC,KAAK,CAAChC,MAAM,GAAG;MAAE,GAAGiC,GAAG;MAAE,GAAG,EAAE,GAAGH,IAAI,CAAC9B,MAAM,GAAGgC,KAAK,CAAChC,MAAM;IAAa,CAAC,GAAGiC,GAAG;EACtG;EACA,OAAOJ,QAAQ,CAACH,CAAC,CAAC;AACpB;AAEA,SAASG,QAAQA,CAACH,CAAU,EAAU;EACpC,IAAIA,CAAC,KAAK,IAAI,IAAIA,CAAC,KAAKpB,SAAS,EAAE,OAAO6B,MAAM,CAACT,CAAC,CAAC;EACnD,IAAIR,KAAK,CAACC,OAAO,CAACO,CAAC,CAAC,EAAE,OAAO,SAASA,CAAC,CAAC1B,MAAM,GAAG;EACjD,IAAI,OAAO0B,CAAC,KAAK,QAAQ,EAAE;IACzB,MAAMI,IAAI,GAAGC,MAAM,CAACD,IAAI,CAACJ,CAAW,CAAC;IACrC,MAAMU,IAAI,GAAGjC,IAAI,CAACK,SAAS,CAACkB,CAAC,CAAC,CAAC1B,MAAM;IACrC,OAAO,UAAU8B,IAAI,CAACpB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC2B,IAAI,CAAC,IAAI,CAAC,GAAGP,IAAI,CAAC9B,MAAM,GAAG,CAAC,GAAG,KAAK,GAAG,EAAE,MAAMoC,IAAI,CAACE,cAAc,CAAC,OAAO,CAAC,QAAQ;EACvH;EACA,IAAI,OAAOZ,CAAC,KAAK,QAAQ,EAAE,OAAOA,CAAC,CAAC1B,MAAM,GAAG,EAAE,GAAG,UAAU0B,CAAC,CAAC1B,MAAM,GAAG,GAAGG,IAAI,CAACK,SAAS,CAACkB,CAAC,CAAC;EAC3F,OAAO,GAAG,OAAOA,CAAC,KAAKS,MAAM,CAACT,CAAC,CAAC,EAAE;AACpC;AAEA,SAASX,WAAWA,CAACwB,IAAa,EAAE1B,IAAY,EAA+D;EAC7G,MAAM2B,IAAI,GAAG3B,IAAI,CAAC4B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAACC,KAAK,CAAC,MAAM,CAAC,CAACC,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAAC5C,MAAM,GAAG,CAAC,CAAC;EAC/E,IAAI6C,GAAG,GAAGN,IAAI;EACd,MAAMO,MAAgB,GAAG,EAAE;EAC3B,KAAK,MAAMC,GAAG,IAAIP,IAAI,EAAE;IACtB,IAAIK,GAAG,KAAK,IAAI,IAAI,OAAOA,GAAG,KAAK,QAAQ,EAAE;MAC3C,OAAO;QAAE5D,EAAE,EAAE,KAAK;QAAEC,KAAK,EAAE,kBAAkB4D,MAAM,CAACT,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,YAAYf,MAAM,CAACuB,GAAG,CAAC;MAAI,CAAC;IACvG;IACA,IAAI3B,KAAK,CAACC,OAAO,CAAC0B,GAAG,CAAC,EAAE;MACtB,MAAMG,CAAC,GAAGC,MAAM,CAACF,GAAG,CAAC;MACrB,IAAI,CAACE,MAAM,CAACC,SAAS,CAACF,CAAC,CAAC,IAAIA,CAAC,GAAG,CAAC,IAAIA,CAAC,IAAIH,GAAG,CAAC7C,MAAM,EAAE;QACpD,OAAO;UAAEf,EAAE,EAAE,KAAK;UAAEC,KAAK,EAAE,GAAG4D,MAAM,CAACT,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,mBAAmBQ,GAAG,CAAC7C,MAAM,MAAM+C,GAAG;QAA2B,CAAC;MAC9H;MACAF,GAAG,GAAGA,GAAG,CAACG,CAAC,CAAC;IACd,CAAC,MAAM;MACL,MAAMG,GAAG,GAAGN,GAA8B;MAC1C,IAAI,EAAEE,GAAG,IAAII,GAAG,CAAC,EAAE;QACjB,OAAO;UAAElE,EAAE,EAAE,KAAK;UAAEC,KAAK,EAAE,aAAa6D,GAAG,QAAQD,MAAM,CAACT,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,aAAaN,MAAM,CAACD,IAAI,CAACqB,GAAG,CAAC,CAACzC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC2B,IAAI,CAAC,IAAI,CAAC;QAAI,CAAC;MAC3I;MACAQ,GAAG,GAAGM,GAAG,CAACJ,GAAG,CAAC;IAChB;IACAD,MAAM,CAACM,IAAI,CAACL,GAAG,CAAC;EAClB;EACA,OAAO;IAAE9D,EAAE,EAAE,IAAI;IAAE0B,KAAK,EAAEkC;EAAI,CAAC;AACjC;AAEA,SAAStC,MAAMA,CAACR,IAAY,EAAEM,OAAe,EAAEI,YAAoB,EAAuE;EACxI,MAAM4C,KAAK,GAAGtD,IAAI,CAAC2C,KAAK,CAAC,IAAI,CAAC;EAC9B,MAAMY,MAAM,GAAGjD,OAAO,CAACkD,WAAW,CAAC,CAAC;EACpC,MAAMC,IAAc,GAAG,EAAE;EACzB,KAAK,IAAIR,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGK,KAAK,CAACrD,MAAM,EAAEgD,CAAC,EAAE,EAAE,IAAIK,KAAK,CAACL,CAAC,CAAC,CAAEO,WAAW,CAAC,CAAC,CAACE,QAAQ,CAACH,MAAM,CAAC,EAAEE,IAAI,CAACJ,IAAI,CAACJ,CAAC,CAAC;EACjG,MAAMU,GAAG,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,GAAG,CAAC,EAAE,EAAEpD,YAAY,CAAC,CAAC;EACnD,MAAMqD,OAAO,GAAGN,IAAI,CAAC9C,KAAK,CAAC,CAAC,EAAE/B,WAAW,CAAC,CAACoF,GAAG,CAAEf,CAAC,KAAM;IACrDgB,IAAI,EAAEhB,CAAC,GAAG,CAAC;IACXjD,IAAI,EAAEsD,KAAK,CAAC3C,KAAK,CAACiD,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEZ,CAAC,GAAGU,GAAG,CAAC,EAAEV,CAAC,GAAGU,GAAG,GAAG,CAAC,CAAC,CAACrB,IAAI,CAAC,IAAI;EAChE,CAAC,CAAC,CAAC;EACH,OAAO;IAAEyB,OAAO;IAAEG,YAAY,EAAET,IAAI,CAACxD;EAAO,CAAC;AAC/C","ignoreList":[]}