@buoy-gg/agent-core 7.0.41 → 7.0.42

package/lib/commonjs/effects/ledger.js

@@ -1,345 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.EffectLedger = void 0;
-exports.isReversible = isReversible;
-var _digest = require("./digest");
-/**
- * The effect ledger — what the agent changed, and how to put it back.
- *
- * Ask Buoy runs mutations immediately rather than asking first, so "undo" has
- * to be real. The model is Scenarios' `AppliedEffect` / `revertEffects`
- * (packages/scenarios/src/engine.ts:238-272), with two deliberate departures,
- * both fixing gaps that engine documents in itself:
- *
- * 1. STORAGE IS ACTUALLY REVERSIBLE HERE. Scenarios classifies storage writes
- *    as unrecoverable because it never captured the prior value. An agent can:
- *    it reads the key before it writes, so undo restores the old value exactly,
- *    and removes the key when it did not exist before.
- * 2. THE COUNT TELLS THE TRUTH. Scenarios' banner counts transients as
- *    "changes" and then silently no-ops on them at revert. Here reversible and
- *    one-shot effects are counted separately and the banner says both, because
- *    a user who taps Undo and sees "4 changes" become nothing changed learns
- *    not to trust the banner.
- *
- * Undo runs in REVERSE order — a later write to the same key must be undone
- * before the earlier one, or the earlier value is the one that survives.
- */
-
-/**
- * Whether Undo can actually put this effect back. THE one place the answer
- * lives: the bar, the sync snapshot and `revertOne` all agree through it.
- * `state-write` is a wipe or a store write with no captured prior state —
- * the ledger records it so the user can see it happened, and it is
- * PERMANENT. Counting it as undoable made the bar promise "1 undoable" and
- * then fail with "can't be undone automatically" on tap.
- */
-function isReversible(effect) {
-  return effect.kind !== "transient" && effect.kind !== "state-write";
-}
-let seq = 0;
-class EffectLedger {
-  entries = [];
-  listeners = new Set();
-  gen = 0;
-
-  /**
-   * Which conversation this ledger is holding, bumped by `clear`.
-   *
-   * A turn captures it when it starts and hands it back on every `record`.
-   * Nothing about a dispatch can be pulled back once it is in flight, so a
-   * write that settles after the user has already tapped "New conversation"
-   * still lands in the app — but it must not land in the NEW conversation's
-   * undo bar, which is what happened: reset cleared the ledger, the old
-   * write finished a moment later, and an empty chat came up owning a change
-   * nobody in it had made. Recording it here would be worse than dropping it,
-   * because Undo would then offer to reverse something the user cannot see.
-   */
-  get generation() {
-    return this.gen;
-  }
-
-  /**
-   * @param generation The value of `generation` when the turn began. Omit for
-   * a human-initiated action, which is by definition happening now — and which
-   * therefore always returns an entry.
-   */
-
-  record(toolId, action, effect, generation) {
-    if (generation !== undefined && generation !== this.gen) return undefined;
-    const entry = {
-      id: `fx-${++seq}-${Date.now()}`,
-      at: Date.now(),
-      toolId,
-      action,
-      effect
-    };
-    // Copy-on-write: `list()` is a useSyncExternalStore snapshot, and React
-    // bails out of the re-render when the snapshot is reference-equal. A
-    // push would leave the bar showing a stale count until something else
-    // happened to re-render it.
-    this.entries = [...this.entries, entry];
-    this.emit();
-    return entry;
-  }
-  list() {
-    return this.entries;
-  }
-
-  /** Tool-call ids of changes still applied — the rounds history budgeting keeps longest. */
-  liveCallIds() {
-    const out = new Set();
-    for (const e of this.entries) if (!e.undoneAt && e.callId) out.add(e.callId);
-    return out;
-  }
-
-  /**
-   * Put back the entries of a conversation that outlived the app.
-   *
-   * The ledger is the ONLY undo surface, and it used to die with the JS
-   * context: after a reload the transcript came back — receipt cards, "saved"
-   * lines and all — while the changes bar quietly vanished and the changes
-   * themselves stayed applied. "New conversation" warns before losing that
-   * ("Clearing the conversation loses the only automatic undo for it"); a
-   * reload took the same thing without asking.
-   *
-   * Refuses once anything has been recorded, for the same reason `hydrate`
-   * refuses a live transcript: a late disk read must not shuffle old entries
-   * in among changes made since.
-   */
-  restore(entries) {
-    if (this.entries.length > 0 || entries.length === 0) return false;
-    this.entries = [...entries];
-    this.emit();
-    return true;
-  }
-
-  /** New array identity for the snapshot after entries were mutated in place. */
-  touch() {
-    this.entries = [...this.entries];
-    this.emit();
-  }
-
-  /** Not-yet-undone entries that Undo can actually deliver on. Agrees with
-   * `isReversible` — it used to include state-writes, which revertOne refuses,
-   * so the two disagreed about the one fact they both exist to answer. */
-  reversible() {
-    return this.entries.filter(e => !e.undoneAt && isReversible(e.effect));
-  }
-
-  /** Not-yet-undone one-shots. Counted separately so the banner is honest. */
-  transients() {
-    return this.entries.filter(e => !e.undoneAt && e.effect.kind === "transient");
-  }
-  isEmpty() {
-    return this.entries.every(e => e.undoneAt !== undefined);
-  }
-  subscribe(fn) {
-    this.listeners.add(fn);
-    return () => this.listeners.delete(fn);
-  }
-  clear() {
-    this.entries = [];
-    // Anything a turn already in flight is about to record belongs to the
-    // conversation being thrown away, not to the one replacing it.
-    this.gen += 1;
-    this.emit();
-  }
-
-  /**
-   * Reconcile the ledger after a change was reverted OUTSIDE `revertOne` —
-   * the model deleting the override it created, a block button's Delete, a
-   * stopImpersonation call. Without this the create entry stays "undoable"
-   * and Undo later fails against a rule that no longer exists, which reads
-   * as the banner lying.
-   *
-   * Returns true when the call undid something, so the caller does not also
-   * record the undo itself as a new change.
-   */
-  noteExternalRevert(toolId, action, params) {
-    let changed = false;
-    const mark = match => {
-      for (const entry of this.entries) {
-        if (!entry.undoneAt && match(entry)) {
-          entry.undoneAt = Date.now();
-          entry.undoError = undefined;
-          changed = true;
-        }
-      }
-    };
-    if (toolId === "network" && action === "deleteOverrideRule") {
-      mark(e => e.effect.kind === "network-override" && e.effect.ruleId === params.id);
-    } else if (toolId === "network" && action === "clearOverrideRules") {
-      mark(e => e.effect.kind === "network-override");
-    } else if (toolId === "impersonate" && action === "stopImpersonation") {
-      mark(e => e.effect.kind === "impersonation");
-    } else {
-      // Calling the inverse by hand — restoreLoading after triggerLoading,
-      // switching a rule back — is the undo too.
-      mark(e => {
-        const fx = e.effect;
-        if (fx.kind !== "inverse-call" || fx.toolId !== toolId || fx.action !== action) return false;
-        return Object.entries(fx.params).every(([k, v]) => JSON.stringify(params[k] ?? (k === "enabled" ? false : undefined)) === JSON.stringify(v));
-      });
-    }
-    if (changed) this.touch();
-    return changed;
-  }
-  emit() {
-    for (const fn of this.listeners) {
-      try {
-        fn();
-      } catch {
-        // A throwing listener must not take the ledger down.
-      }
-    }
-  }
-
-  /** Undo one entry. Returns an error string, or undefined on success. */
-  async revertOne(entry, dispatch) {
-    if (entry.undoneAt) return undefined;
-    const fx = entry.effect;
-    try {
-      switch (fx.kind) {
-        case "network-override":
-          await dispatch("network", "deleteOverrideRule", {
-            id: fx.ruleId
-          });
-          break;
-        case "impersonation":
-          await dispatch("impersonate", "stopImpersonation", {});
-          break;
-        case "storage-write":
-          {
-            // `instanceId` rides along for MMKV and is absent for AsyncStorage,
-            // whose actions take the key alone.
-            const scope = fx.instanceId ? {
-              instanceId: fx.instanceId
-            } : {};
-
-            // Concurrent-writer guard: if the key no longer holds the value WE
-            // wrote, someone else wrote after us and a blind restore would
-            // destroy their newer value. Best-effort — an unreadable key still
-            // restores, because a failed read must not strand the undo.
-            if (fx.wrote !== undefined) {
-              const readAction = fx.action === "mmkv.set" ? "mmkv.get" : "async.getItem";
-              try {
-                const current = await dispatch(fx.toolId, readAction, {
-                  ...scope,
-                  key: fx.key
-                });
-                const rec = current && typeof current === "object" ? current : undefined;
-                const value = rec ? rec.value : current;
-                if (rec?.found !== false && value !== undefined && value !== fx.wrote) {
-                  return "This value was changed again after Ask Buoy wrote it — left the newer value alone";
-                }
-              } catch {
-                /* unreadable now; proceed with the restore */
-              }
-            }
-            if (fx.before === undefined) {
-              if (!fx.removeAction) return "No remove action known for this key";
-              await dispatch(fx.toolId, fx.removeAction, {
-                ...scope,
-                key: fx.key
-              });
-            } else {
-              await dispatch(fx.toolId, fx.action, {
-                ...scope,
-                key: fx.key,
-                value: fx.before
-              });
-            }
-            break;
-          }
-        case "query-write":
-          {
-            // Same concurrent-writer guard as storage, but the usual "other
-            // writer" here is the app itself refetching — in which case the
-            // server's data is already back and there is nothing to undo.
-            if (fx.wroteDigest !== undefined) {
-              try {
-                const current = await dispatch("query", "getQueryData", {
-                  queryHash: fx.queryHash
-                });
-                if (current?.found === true) {
-                  const now = current.hasData === false ? undefined : (0, _digest.digestOf)(current.data);
-                  if (now !== fx.wroteDigest) {
-                    return "The app has refetched or changed this query since Ask Buoy wrote it — left the newer data alone";
-                  }
-                }
-              } catch {
-                /* unreadable now; proceed with the restore */
-              }
-            }
-            const outcome = await (fx.before === undefined ? dispatch("query", "invalidate", {
-              queryHash: fx.queryHash
-            }) : dispatch("query", "setQueryData", {
-              queryHash: fx.queryHash,
-              data: fx.before,
-              // The whole prior value, verbatim: the drop-a-field guard is
-              // for edits, and this is a restore of what the guard protects.
-              force: true
-            }));
-            if (outcome && typeof outcome === "object" && outcome.ok === false) {
-              return typeof outcome.error === "string" ? outcome.error : "The query could not be restored";
-            }
-            break;
-          }
-        case "inverse-call":
-          {
-            const outcome = await dispatch(fx.toolId, fx.action, fx.params);
-            if (outcome && typeof outcome === "object" && outcome.ok === false) {
-              return typeof outcome.error === "string" ? outcome.error : "The change could not be undone";
-            }
-            break;
-          }
-        case "state-write":
-          return "This change can't be undone automatically";
-        case "transient":
-          return undefined;
-      }
-      entry.undoneAt = Date.now();
-      entry.undoError = undefined;
-      this.touch();
-      return undefined;
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      entry.undoError = msg;
-      this.touch();
-      return msg;
-    }
-  }
-
-  /** Undo everything still outstanding, newest first. */
-  async revertAll(dispatch) {
-    const outcome = {
-      reverted: 0,
-      failed: [],
-      skippedTransients: 0,
-      permanent: 0
-    };
-    const pending = [...this.entries].filter(e => !e.undoneAt).reverse();
-    for (const entry of pending) {
-      if (entry.effect.kind === "transient") {
-        outcome.skippedTransients += 1;
-        continue;
-      }
-      if (!isReversible(entry.effect)) {
-        outcome.permanent += 1;
-        continue;
-      }
-      const error = await this.revertOne(entry, dispatch);
-      if (error) outcome.failed.push({
-        label: entry.effect.label,
-        error
-      });else outcome.reverted += 1;
-    }
-    this.emit();
-    return outcome;
-  }
-}
-exports.EffectLedger = EffectLedger;
-//# sourceMappingURL=ledger.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.EffectLedger=void 0;exports.isReversible=isReversible;var _digest=require("./digest");function isReversible(f){return f.kind!=="transient"&&f.kind!=="state-write"}let seq=0;class EffectLedger{entries=[];listeners=new Set;gen=0;get generation(){return this.gen}record(t,n,e,r){if(r!==void 0&&r!==this.gen)return void 0;const i={id:`fx-${++seq}-${Date.now()}`,at:Date.now(),toolId:t,action:n,effect:e};this.entries=[...this.entries,i];this.emit();return i}list(){return this.entries}liveCallIds(){const t=new Set;for(const n of this.entries)if(!n.undoneAt&&n.callId)t.add(n.callId);return t}restore(t){if(this.entries.length>0||t.length===0)return false;this.entries=[...t];this.emit();return true}touch(){this.entries=[...this.entries];this.emit()}reversible(){return this.entries.filter(t=>!t.undoneAt&&isReversible(t.effect))}transients(){return this.entries.filter(t=>!t.undoneAt&&t.effect.kind==="transient")}isEmpty(){return this.entries.every(t=>t.undoneAt!==void 0)}subscribe(t){this.listeners.add(t);return()=>this.listeners.delete(t)}clear(){this.entries=[];this.gen+=1;this.emit()}noteExternalRevert(t,n,e){let r=false;const i=s=>{for(const o of this.entries){if(!o.undoneAt&&s(o)){o.undoneAt=Date.now();o.undoError=void 0;r=true}}};if(t==="network"&&n==="deleteOverrideRule"){i(s=>s.effect.kind==="network-override"&&s.effect.ruleId===e.id)}else if(t==="network"&&n==="clearOverrideRules"){i(s=>s.effect.kind==="network-override")}else if(t==="impersonate"&&n==="stopImpersonation"){i(s=>s.effect.kind==="impersonation")}else{i(s=>{const o=s.effect;if(o.kind!=="inverse-call"||o.toolId!==t||o.action!==n)return false;return Object.entries(o.params).every(([a,u])=>JSON.stringify(e[a]??(a==="enabled"?false:void 0))===JSON.stringify(u))})}if(r)this.touch();return r}emit(){for(const t of this.listeners){try{t()}catch{}}}async revertOne(t,n){if(t.undoneAt)return void 0;const e=t.effect;try{switch(e.kind){case"network-override":await n("network","deleteOverrideRule",{id:e.ruleId});break;case"impersonation":await n("impersonate","stopImpersonation",{});break;case"storage-write":{const r=e.instanceId?{instanceId:e.instanceId}:{};if(e.wrote!==void 0){const i=e.action==="mmkv.set"?"mmkv.get":"async.getItem";try{const s=await n(e.toolId,i,{...r,key:e.key});const o=s&&typeof s==="object"?s:void 0;const a=o?o.value:s;if(o?.found!==false&&a!==void 0&&a!==e.wrote){return"This value was changed again after Ask Buoy wrote it \u2014 left the newer value alone"}}catch{}}if(e.before===void 0){if(!e.removeAction)return"No remove action known for this key";await n(e.toolId,e.removeAction,{...r,key:e.key})}else{await n(e.toolId,e.action,{...r,key:e.key,value:e.before})}break}case"query-write":{if(e.wroteDigest!==void 0){try{const i=await n("query","getQueryData",{queryHash:e.queryHash});if(i?.found===true){const s=i.hasData===false?void 0:(0,_digest.digestOf)(i.data);if(s!==e.wroteDigest){return"The app has refetched or changed this query since Ask Buoy wrote it \u2014 left the newer data alone"}}}catch{}}const r=await(e.before===void 0?n("query","invalidate",{queryHash:e.queryHash}):n("query","setQueryData",{queryHash:e.queryHash,data:e.before,force:true}));if(r&&typeof r==="object"&&r.ok===false){return typeof r.error==="string"?r.error:"The query could not be restored"}break}case"inverse-call":{const r=await n(e.toolId,e.action,e.params);if(r&&typeof r==="object"&&r.ok===false){return typeof r.error==="string"?r.error:"The change could not be undone"}break}case"state-write":return"This change can't be undone automatically";case"transient":return void 0}t.undoneAt=Date.now();t.undoError=void 0;this.touch();return void 0}catch(r){const i=r instanceof Error?r.message:String(r);t.undoError=i;this.touch();return i}}async revertAll(t){const n={reverted:0,failed:[],skippedTransients:0,permanent:0};const e=[...this.entries].filter(r=>!r.undoneAt).reverse();for(const r of e){if(r.effect.kind==="transient"){n.skippedTransients+=1;continue}if(!isReversible(r.effect)){n.permanent+=1;continue}const i=await this.revertOne(r,t);if(i)n.failed.push({label:r.effect.label,error:i});else n.reverted+=1}this.emit();return n}}exports.EffectLedger=EffectLedger;

package/lib/commonjs/engine/askGate.js

@@ -1,287 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ACQUISITION_CALLS = void 0;
-exports.synthesizeAskBlock = synthesizeAskBlock;
-exports.synthesizeShortfallBlock = synthesizeShortfallBlock;
-var _runId = require("../blocks/runId");
-/**
- * The last guarantee of a turn: when the turn ends WAITING ON THE USER, the
- * user gets something to tap.
- *
- * `buoy_ui` has had choice/confirm/input since the start and the prompt has
- * asked for them since the start, and models still end turns waiting in prose.
- * Two off a real device, a day apart:
- *
- *     Want me to add an Eevee line to the bag?
- *     If you want a Blastoise in there, tell me the level
- *     (Lv. 5, Lv. 25 or Lv. 50) and how many, and I'll add it.
- *
- * The first is a question. The SECOND IS NOT — no question mark anywhere, the
- * ask is an imperative, and the model had already written the options out. A
- * gate that keys on "?" catches one of these, which is why this one keys on
- * the ask instead: an offer to act, or a request for a value.
- *
- * Deliberately narrow, in this order:
- *
- * - It reads only the LAST sentence of the turn. A question the model asked
- *   and then answered itself is not waiting on anybody.
- * - Options the model ALREADY enumerated win. "(Lv. 5, Lv. 25 or Lv. 50)" is
- *   the model doing the work and writing it in the wrong place.
- * - Then a clean either-or, split into its two halves.
- * - Then Yes/No, but only for an offer to ACT ("I can add it if you'd like").
- *   A request for a value it could not enumerate — "tell me the level" —
- *   produces NOTHING. Yes/No against "tell me the level" is worse than the
- *   sentence it replaced, and the composer is already a text field.
- *
- * ENGLISH ONLY, AND DELIBERATELY FAIL-SAFE. Both patterns are English, tuned
- * to sentences observed in an English demo app, and there is no honest way to
- * make a regex multilingual. What saves this from being an overfit that ships
- * to everyone is the direction it fails in: no match returns null, the model's
- * own prose question stands, and the user answers it in the composer exactly
- * as they would have. A non-English app loses the extra card; it does not get
- * a wrong one. Do not "fix" that by loosening the patterns — a false positive
- * turns a finished answer into a spurious question, which is the one outcome
- * worse than no card at all.
- *
- * It emits a `choice`, never a `confirm`: choice carries the question in the
- * field `questionBehind` reads after a restore, renders in the neutral tone
- * rather than the warning one, and keeps the "or just type your answer"
- * escape. A synthesized card must never look like an approval.
- *
- * The block is authored AFTER the assistant message and carries no tool call,
- * so nothing enters the provider history: there is no `tool_use` to answer and
- * no `tool_result` to orphan. The user's tap becomes their next message
- * exactly as a model-authored block's would.
- */
-
-const nextId = (0, _runId.idFactory)("ask");
-
-/**
- * An offer to DO something, waiting on yes or no. Includes the trailing
- * conditional models close with — "I can add it **if you'd like**" — which is
- * the same offer with the question mark filed off.
- */
-const OFFER = /\b(?:want me to|would you like me to|would you like|do you want me to|do you want|should i|shall i|ok(?:ay)? if i|say the word|let me know if|if you'?d (?:like|prefer)|if you want)\b/i;
-
-/**
- * A request for a VALUE the engine cannot invent: "tell me the level", "just
- * say which one". Distinguished from "let me know IF you want…", which is an
- * offer, by what follows the verb.
- */
-const VALUE_ASK = /\b(?:tell me|let me know|just say|say|give me|pick|choose)\s+(?:the|which|what|how|your|one)\b/i;
-const ASK = new RegExp(`${OFFER.source}|${VALUE_ASK.source}`, "i");
-
-/** Markdown and quoting the model wrapped the sentence in. */
-const TRAILING_MARKUP = /[*_`"'’”\s]+$/;
-const LEADING_MARKUP = /^[*_`>\-\s]+/;
-
-/**
- * A sentence boundary that survives "Lv. 5".
- *
- * A terminator only ends a sentence when what follows starts one — a capital
- * or an opening quote. `.` before a digit or a lowercase word is an
- * abbreviation, and splitting there tore the Blastoise sentence into five.
- */
-const SENTENCE_END = /[.!?]["'’”)\]]*\s+(?=[A-Z("'“])|\n+/;
-
-/** "add it to the cart, or just show you the item" → two halves. */
-const OR_SPLIT = /,?\s+or\s+/i;
-
-/** A list the model already wrote out: "(Lv. 5, Lv. 25 or Lv. 50)". */
-const PARENTHETICAL = /\(([^()]{3,140})\)/;
-const LIST_SPLIT = /\s*,\s*|\s+or\s+/i;
-
-/**
- * A half that reads as a button. Clause punctuation means the split landed
- * inside a list ("a, b or c") rather than between two real alternatives.
- */
-const CLEAN_LABEL = /^[A-Za-z0-9][^,;:—–]*$/;
-/** Looser: an enumerated option was already a list item, so commas are gone. */
-const CLEAN_OPTION = /^[A-Za-z0-9$][^;:—–()]*$/;
-const YES_NO = [{
-  id: "yes",
-  label: "Yes, go ahead"
-}, {
-  id: "no",
-  label: "No thanks"
-}];
-
-/**
- * The block a turn should have ended with, or null to leave the prose alone.
- *
- * `text` is everything the model said this turn, rounds joined in order.
- */
-function synthesizeAskBlock(text) {
-  const sentence = lastSentence(text);
-  if (!sentence || sentence.length < 8 || sentence.length > 240) return null;
-  const ask = ASK.exec(sentence);
-  if (!ask) return null;
-
-  // 1. The model already wrote the options; they were just in the wrong place.
-  const listed = enumerated(sentence);
-  if (listed) return {
-    id: nextId(),
-    kind: "choice",
-    question: sentence,
-    options: listed
-  };
-
-  // 2. Two real alternatives, after the verb that offered them.
-  const after = sentence.slice(ask.index + ask[0].length).replace(/[?.!,]+$/, "").trim();
-  const halves = after ? after.split(OR_SPLIT) : [];
-  if (halves.length > 2) return null;
-  if (halves.length === 2) {
-    const alt = alternatives(halves);
-    return alt ? {
-      id: nextId(),
-      kind: "choice",
-      question: sentence,
-      options: alt
-    } : null;
-  }
-
-  // 3. Yes or no — but only for an offer to act. A value it could not
-  //    enumerate stays prose; the composer is already a text field.
-  if (VALUE_ASK.test(sentence) || !OFFER.test(sentence)) return null;
-  return {
-    id: nextId(),
-    kind: "choice",
-    question: sentence,
-    options: YES_NO
-  };
-}
-function lastSentence(text) {
-  const trimmed = text.replace(TRAILING_MARKUP, "").trim();
-  if (!trimmed) return null;
-  const parts = trimmed.split(SENTENCE_END);
-  const last = parts[parts.length - 1]?.replace(LEADING_MARKUP, "").trim();
-  return last || null;
-}
-function enumerated(sentence) {
-  const inside = PARENTHETICAL.exec(sentence)?.[1];
-  // `or` is what makes it a list of choices rather than an aside
-  // ("(Lv25, quantity 6, $9.99 each)").
-  if (!inside || !/\bor\b/i.test(inside)) return null;
-  const labels = inside.split(LIST_SPLIT).map(p => p.trim()).filter(Boolean);
-  if (labels.length < 2 || labels.length > 5) return null;
-  for (const label of labels) {
-    if (label.length < 1 || label.length > 48 || !CLEAN_OPTION.test(label)) return null;
-  }
-  return labels.map((label, i) => ({
-    id: `o${i + 1}`,
-    label: capitalize(label)
-  }));
-}
-function alternatives(halves) {
-  const labels = halves.map(h => h.trim().replace(/[?.!]+$/, "").trim());
-  for (const label of labels) {
-    if (label.length < 2 || label.length > 48 || !CLEAN_LABEL.test(label)) return null;
-  }
-  return labels.map((label, i) => ({
-    id: i === 0 ? "a" : "b",
-    label: capitalize(label)
-  }));
-}
-function capitalize(label) {
-  return /^[a-z]/.test(label) ? label[0].toUpperCase() + label.slice(1) : label;
-}
-
-/* ------------------------------------------------------------------------ *
- * The OTHER way a turn ends badly: it answers a smaller question than the
- * one it was asked, and hands the rest back to the user.
- *
- * Off a real device: "Show me all the pokemon from our poke mart app." The
- * app's home screen holds ten and fetches one per card as you swipe; the user
- * had swiped four. The agent read the cache, found four, showed four, and
- * closed with "that's everything currently in the app's cache, so if you visit
- * other Pokémon in the app I can show those too" — while holding
- * route-events.navigate, describeScreen and tapElement, and having called none
- * of them.
- *
- * `synthesizeAskBlock` above should have caught that last clause — "if you
- * visit … I can" is exactly its OFFER shape. It did not, because the turn had
- * already shipped a `suggestions` block, so `offeredTap` was true. The chips
- * were "Compare their HP", "Show me the bag", "Change Pikachu's stats". The
- * user had something to tap; none of it was the thing the agent had just
- * failed to do.
- *
- * So this gate asks a different question from that one. Not "does the user
- * have something to tap" but "can the user tap THE GAP" — and it fires even
- * when the turn offered chips, because that is the case it exists for.
- *
- * It stays quiet when the agent actually TRIED (see `attempted`). An agent
- * that navigated, tapped and re-read and still came up short has earned its
- * "that's all there is", and nagging it would be worse than silence.
- * ------------------------------------------------------------------------ */
-
-/**
- * A limit on what the answer covers: "that's all", "only", "so far".
- * Meaningless alone — half the sentences in English contain "only".
- */
-const LIMITED = /\b(?:that'?s (?:all|everything|it)|only|just|so far|nothing else|no others?|the rest (?:are|is)?n'?t)\b/i;
-
-/**
- * …AND a word that says the limit is about LOADING rather than about the
- * world. "Only four are cached" is a shortfall; "only four are in stock" is an
- * answer. Both halves have to be present.
- */
-const NOT_LOADED = /\b(?:cache[ds]?|cached|loaded|fetched|in memory|visited|opened|rendered|recorded|captured)\b/i;
-
-/**
- * The offer that hands the work back, which needs no second half: the user is
- * being asked to go and do the thing the agent could have done itself.
- */
-const GO_YOURSELF = /\b(?:if|once|when|after) you (?:visit|open|go to|navigate|browse|load|tap|swipe|scroll|look at)\b/i;
-
-/** How much of the turn to read. The concession is usually the closing line. */
-const TAIL_SENTENCES = 3;
-
-/**
- * `attempted` — did this turn call anything that GOES AND GETS data?
- * Keyed on the actions the prompt's ladder names, so the two move together.
- */
-const ACQUISITION_CALLS = exports.ACQUISITION_CALLS = new Set(["route-events.navigate", "route-events.stackGoBack", "route-events.stackNavigateToIndex", "highlight-updates.describeScreen", "highlight-updates.tapElement", "highlight-updates.waitFor", "query.refetch", "query.invalidate"]);
-/**
- * The block a turn should have ended with when it conceded a gap and never
- * tried to close it, or null to leave the prose alone.
- *
- * An `actions` block, not a `choice`: nothing is being ASKED here. The turn is
- * over and the answer stands; this is one button that says the gap is closable
- * and closes it. So it must not end the turn or set `awaiting-user` — a
- * synthesized card must never look like it is blocking on a reply.
- */
-function synthesizeShortfallBlock({
-  text,
-  attempted
-}) {
-  if (attempted) return null;
-  const tail = lastSentences(text, TAIL_SENTENCES);
-  if (!tail) return null;
-  const conceded = GO_YOURSELF.test(tail) || LIMITED.test(tail) && NOT_LOADED.test(tail);
-  if (!conceded) return null;
-  return {
-    id: nextShortfallId(),
-    kind: "actions",
-    actions: [{
-      label: "Go get the rest",
-      primary: true,
-      // Phrased as the user would phrase it, because that is what it becomes:
-      // the tap is sent as their next message.
-      send: "Don't stop at what's already loaded. Drive the app to get the rest — check the other layers, use the sitemap to navigate to the screen that loads it, wait for it, then answer in full. If it truly isn't reachable, tell me exactly what you tried."
-    }]
-  };
-}
-const nextShortfallId = (0, _runId.idFactory)("gap");
-
-/** The last `count` sentences, joined — see `lastSentence` for the split. */
-function lastSentences(text, count) {
-  const trimmed = text.replace(TRAILING_MARKUP, "").trim();
-  if (!trimmed) return null;
-  const parts = trimmed.split(SENTENCE_END).filter(p => p.trim());
-  const tail = parts.slice(-count).join(" ").replace(LEADING_MARKUP, "").trim();
-  return tail || null;
-}
-//# sourceMappingURL=askGate.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.ACQUISITION_CALLS=void 0;exports.synthesizeAskBlock=synthesizeAskBlock;exports.synthesizeShortfallBlock=synthesizeShortfallBlock;var _runId=require("../blocks/runId");const nextId=(0,_runId.idFactory)("ask");const OFFER=/\b(?:want me to|would you like me to|would you like|do you want me to|do you want|should i|shall i|ok(?:ay)? if i|say the word|let me know if|if you'?d (?:like|prefer)|if you want)\b/i;const VALUE_ASK=/\b(?:tell me|let me know|just say|say|give me|pick|choose)\s+(?:the|which|what|how|your|one)\b/i;const ASK=new RegExp(`${OFFER.source}|${VALUE_ASK.source}`,"i");const TRAILING_MARKUP=/[*_`"'’”\s]+$/;const LEADING_MARKUP=/^[*_`>\-\s]+/;const SENTENCE_END=/[.!?]["'’”)\]]*\s+(?=[A-Z("'“])|\n+/;const OR_SPLIT=/,?\s+or\s+/i;const PARENTHETICAL=/\(([^()]{3,140})\)/;const LIST_SPLIT=/\s*,\s*|\s+or\s+/i;const CLEAN_LABEL=/^[A-Za-z0-9][^,;:—–]*$/;const CLEAN_OPTION=/^[A-Za-z0-9$][^;:—–()]*$/;const YES_NO=[{id:"yes",label:"Yes, go ahead"},{id:"no",label:"No thanks"}];function synthesizeAskBlock(o){const e=lastSentence(o);if(!e||e.length<8||e.length>240)return null;const t=ASK.exec(e);if(!t)return null;const n=enumerated(e);if(n)return{id:nextId(),kind:"choice",question:e,options:n};const s=e.slice(t.index+t[0].length).replace(/[?.!,]+$/,"").trim();const i=s?s.split(OR_SPLIT):[];if(i.length>2)return null;if(i.length===2){const r=alternatives(i);return r?{id:nextId(),kind:"choice",question:e,options:r}:null}if(VALUE_ASK.test(e)||!OFFER.test(e))return null;return{id:nextId(),kind:"choice",question:e,options:YES_NO}}function lastSentence(o){const e=o.replace(TRAILING_MARKUP,"").trim();if(!e)return null;const t=e.split(SENTENCE_END);const n=t[t.length-1]?.replace(LEADING_MARKUP,"").trim();return n||null}function enumerated(o){const e=PARENTHETICAL.exec(o)?.[1];if(!e||!/\bor\b/i.test(e))return null;const t=e.split(LIST_SPLIT).map(n=>n.trim()).filter(Boolean);if(t.length<2||t.length>5)return null;for(const n of t){if(n.length<1||n.length>48||!CLEAN_OPTION.test(n))return null}return t.map((n,s)=>({id:`o${s+1}`,label:capitalize(n)}))}function alternatives(o){const e=o.map(t=>t.trim().replace(/[?.!]+$/,"").trim());for(const t of e){if(t.length<2||t.length>48||!CLEAN_LABEL.test(t))return null}return e.map((t,n)=>({id:n===0?"a":"b",label:capitalize(t)}))}function capitalize(o){return/^[a-z]/.test(o)?o[0].toUpperCase()+o.slice(1):o}const LIMITED=/\b(?:that'?s (?:all|everything|it)|only|just|so far|nothing else|no others?|the rest (?:are|is)?n'?t)\b/i;const NOT_LOADED=/\b(?:cache[ds]?|cached|loaded|fetched|in memory|visited|opened|rendered|recorded|captured)\b/i;const GO_YOURSELF=/\b(?:if|once|when|after) you (?:visit|open|go to|navigate|browse|load|tap|swipe|scroll|look at)\b/i;const TAIL_SENTENCES=3;const ACQUISITION_CALLS=exports.ACQUISITION_CALLS=new Set(["route-events.navigate","route-events.stackGoBack","route-events.stackNavigateToIndex","highlight-updates.describeScreen","highlight-updates.tapElement","highlight-updates.waitFor","query.refetch","query.invalidate"]);function synthesizeShortfallBlock({text:o,attempted:e}){if(e)return null;const t=lastSentences(o,TAIL_SENTENCES);if(!t)return null;const n=GO_YOURSELF.test(t)||LIMITED.test(t)&&NOT_LOADED.test(t);if(!n)return null;return{id:nextShortfallId(),kind:"actions",actions:[{label:"Go get the rest",primary:true,send:"Don't stop at what's already loaded. Drive the app to get the rest \u2014 check the other layers, use the sitemap to navigate to the screen that loads it, wait for it, then answer in full. If it truly isn't reachable, tell me exactly what you tried."}]}}const nextShortfallId=(0,_runId.idFactory)("gap");function lastSentences(o,e){const t=o.replace(TRAILING_MARKUP,"").trim();if(!t)return null;const n=t.split(SENTENCE_END).filter(i=>i.trim());const s=n.slice(-e).join(" ").replace(LEADING_MARKUP,"").trim();return s||null}