@corenel/term 0.3.0 → 0.5.0

package/README.md

@@ -4,7 +4,7 @@ Corenel's terminal face: a headless chat controller and the [Ink](https://github
 views that render it. Published so [`@corenel/cli`](https://www.npmjs.com/package/@corenel/cli)
 can depend on it; usable directly if you are building a terminal agent of your own.
 
-Requires Node 18+.
+Requires Node 22+.
 
 ## The split that matters
 

package/dist/approvalText.d.ts

@@ -0,0 +1,6 @@
+import type { ApprovalSuggestion, SuggestionChoice } from '@corenel/protocol';
+export declare function suggestionLine(s: ApprovalSuggestion): string;
+export declare function suggestionKeys(s: ApprovalSuggestion): string;
+export declare function parseSuggestionChoice(s: ApprovalSuggestion, input: string | null): SuggestionChoice | null;
+export declare function suggestionOutcome(tool: string, choice: SuggestionChoice): string;
+//# sourceMappingURL=approvalText.d.ts.map

package/dist/approvalText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvalText.d.ts","sourceRoot":"","sources":["../src/approvalText.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiB9E,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAI5D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAO1G;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAQhF"}

package/dist/{chunk-HUVRQX53.js → chunk-IF6DCCK2.js}

@@ -1,13 +1,13 @@
 import {
   emptyState,
   parseTodos
-} from "./chunk-2MGDL3I4.js";
+} from "./chunk-MAZLORMD.js";
 import {
   formatHelpText,
   isKnownCommandWord,
   parseCommand,
   unknownCommandMessage
-} from "./chunk-5RPHYXND.js";
+} from "./chunk-TWFWLEIP.js";
 import {
   WRITE_TOOL_NAMES,
   buildWritePreview
@@ -155,9 +155,44 @@ function stripInline(s) {
   return s.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)").replace(/\*\*(\S(?:[^*]*\S)?)\*\*/g, "$1").replace(/(?<!\*)\*(\S(?:[^*]*\S)?)\*(?!\*)/g, "$1").replace(/`([^`]+)`/g, "$1");
 }
 
+// src/approvalText.ts
+function sanitizeToolName(name) {
+  return name.replace(/[\u0000-\u001f\u007f-\u009f]/g, "");
+}
+function suggestionLine(s) {
+  return `You have allowed ${sanitizeToolName(s.tool)} ${s.count} times${s.scope === "workspace" ? " in this folder" : ""}. Always allow it?`;
+}
+function suggestionKeys(s) {
+  return s.scopeChoice ? "[w] this folder  [e] everywhere  [n] not now  [x] never" : "[e] always  [n] not now  [x] never";
+}
+function parseSuggestionChoice(s, input) {
+  const k = (input ?? "").trim().toLowerCase();
+  if (k === "w") return s.scopeChoice ? "workspace" : null;
+  if (k === "e") return "global";
+  if (k === "n") return "not-now";
+  if (k === "x") return "never";
+  return null;
+}
+function suggestionOutcome(tool, choice) {
+  const t = sanitizeToolName(tool);
+  switch (choice) {
+    case "workspace":
+      return `always allowing ${t} in this folder (undo: corenel approvals revoke ${t})`;
+    case "global":
+      return `always allowing ${t} everywhere (undo: corenel approvals revoke ${t} --global)`;
+    case "not-now":
+      return `not now: ${t} will be suggested again after more approvals`;
+    case "never":
+      return `${t} will not be suggested again`;
+  }
+}
+
 // src/session.ts
 var DELTA_FLUSH_MS = 50;
 var TOOL_DELTA_CAP = 4e3;
+function sameTool(heldKey, askedName) {
+  return heldKey === askedName || heldKey.endsWith(`:${askedName}`);
+}
 var TermSession = class {
   constructor(deps) {
     this.deps = deps;
@@ -203,6 +238,12 @@ var TermSession = class {
   turnId = 0;
   activeTurn = 0;
   pending = null;
+  /** The tool name a `pending` permission ask is FOR -- set only by
+   * `askPermission`, never by `askUser` (a question is not tied to one tool).
+   * Consumed once by `resolvePending` to decide whether a denied ask should
+   * drop a held suggestion for the same tool (final review M3). */
+  pendingAskTool = null;
+  heldSuggestion = null;
   draining = false;
   /* Bumped whenever the conversation is REPLACED out from under a turn --
    * `/clear` and `resume()`. A turn captures it when it starts and only adopts
@@ -1016,9 +1057,12 @@ var TermSession = class {
   }
   /** esc, or any other reason the overlay should close -- a no-op unless the
    * manager is actually the modal open right now, so it can never steal a
-   * permission or question modal's close. */
+   * permission or question modal's close. Restores a held suggestion (final
+   * review M3) rather than just clearing the modal -- otherwise an offer held
+   * behind this overlay came back only when some LATER, unrelated permission
+   * ask happened to resolve. */
   closeMcpManager() {
-    if (this.state.modal?.kind === "mcp") this.set({ modal: null });
+    if (this.state.modal?.kind === "mcp") this.restoreHeldSuggestion(null);
   }
   /* ---- the Ink `/help` overlay -------------------------------------------
    *
@@ -1038,9 +1082,10 @@ var TermSession = class {
   }
   /** esc, or any other reason the overlay should close -- a no-op unless the
    * help overlay is actually the modal open right now, so it can never steal
-   * a permission, question, or MCP modal's close. */
+   * a permission, question, or MCP modal's close. Restores a held suggestion
+   * (final review M3) -- see closeMcpManager's doc. */
   closeHelp() {
-    if (this.state.modal?.kind === "help") this.set({ modal: null });
+    if (this.state.modal?.kind === "help") this.restoreHeldSuggestion(null);
   }
   /* ---- the Ink `/context` overlay ----------------------------------------
    *
@@ -1079,9 +1124,11 @@ var TermSession = class {
   }
   /** esc, or any other reason the context overlay should close -- a no-op
    * unless the context overlay is actually the modal open right now, so it
-   * can never steal a permission, question, help, or MCP modal's close. */
+   * can never steal a permission, question, help, or MCP modal's close.
+   * Restores a held suggestion (final review M3) -- see closeMcpManager's
+   * doc. */
   closeContext() {
-    if (this.state.modal?.kind === "context") this.set({ modal: null });
+    if (this.state.modal?.kind === "context") this.restoreHeldSuggestion(null);
   }
   /** Up/down inside the overlay -- wraps, and does nothing with zero rows. */
   moveMcpSelection(delta) {
@@ -1260,6 +1307,7 @@ ${line}` : line;
     this.activeTurn = mine;
     this.beginTurn();
     const system = await this.resolveSystem();
+    const skills = this.deps.skills ? await this.deps.skills().catch(() => []) : [];
     const run = this.deps.runner ?? runAgent;
     try {
       const result = await run({
@@ -1268,6 +1316,7 @@ ${line}` : line;
         ...system ? { system } : {},
         messages: this.history,
         tools: this.deps.tools,
+        ...skills.length ? { skills } : {},
         toolCtx: this.deps.toolCtx(ac.signal, (q) => this.askUser(q), this.permission),
         signal: ac.signal,
         ...this.permission ? { permission: this.permission } : {},
@@ -1344,15 +1393,17 @@ ${line}` : line;
    * fully synchronous, exactly as before this method could show a diff at
    * all. */
   askPermission(req) {
-    if (this.deps.approveAll) return Promise.resolve("allow");
+    if (this.deps.approveAll) return Promise.resolve({ decision: "allow", by: "unattended" });
     if (this.pending) throw new Error("a question is already open");
     const detail = req.input;
     const shown = typeof detail?.command === "string" ? detail.command : typeof detail?.path === "string" ? detail.path : "";
     const openModal = (diff) => {
-      if (this.state.status === "aborting") return "deny";
+      if (this.state.status === "aborting") return { decision: "deny", by: "timeout" };
+      if (this.state.modal?.kind === "suggestion") this.heldSuggestion = this.state.modal.suggestion;
       this.set({ modal: { kind: "permission", tool: req.tool, detail: shown, ...diff ? { diff } : {} } });
       return new Promise((resolve) => {
         this.pending = { resolve: (v) => resolve(v ?? "deny") };
+        this.pendingAskTool = req.tool;
       });
     };
     if (!this.deps.previewWrite || !WRITE_TOOL_NAMES.has(req.tool)) return Promise.resolve(openModal(null));
@@ -1360,6 +1411,7 @@ ${line}` : line;
   }
   askUser(questions) {
     if (this.pending) throw new Error("a question is already open");
+    if (this.state.modal?.kind === "suggestion") this.heldSuggestion = this.state.modal.suggestion;
     this.set({ modal: { kind: "user", questions } });
     return new Promise((resolve) => {
       this.pending = { resolve: (v) => resolve(v ?? null) };
@@ -1377,15 +1429,65 @@ ${line}` : line;
    * outcome that `askUserTool` (packages/harness/tools/builtins.ts) checks for. */
   forceClosePending() {
     if (!this.pending) return;
-    this.resolvePending(this.state.modal?.kind === "user" ? null : "deny");
+    this.resolvePending(this.state.modal?.kind === "user" ? null : { decision: "deny", by: "timeout" });
   }
   resolvePending(value) {
     const p = this.pending;
     if (!p) return;
     this.pending = null;
-    this.set({ modal: null });
+    const askTool = this.pendingAskTool;
+    this.pendingAskTool = null;
+    const decision = typeof value === "object" && value !== null && "decision" in value ? value.decision : value;
+    this.restoreHeldSuggestion(decision === "deny" && askTool !== null ? askTool : null);
     p.resolve(value);
   }
+  /** Restore whatever suggestion is held (if any) as the visible modal,
+   * dropping it instead if `dropForTool` names the tool it is for. Shared by
+   * every path that can uncover a held offer: answering a permission/question
+   * ask (`resolvePending`), and closing the help/MCP/context overlays -- all
+   * of which used to just clear the modal, silently losing a held offer until
+   * some LATER, unrelated permission answer happened to surface it (final
+   * review M3). */
+  restoreHeldSuggestion(dropForTool) {
+    let held = this.heldSuggestion;
+    this.heldSuggestion = null;
+    if (held && dropForTool !== null && sameTool(held.tool, dropForTool)) held = null;
+    this.set({ modal: held ? { kind: "suggestion", suggestion: held, openedAt: Date.now(), armedChoice: null } : null });
+  }
+  /** Offer a standing approval. Shown now if nothing is open, otherwise held
+   * until the open prompt is answered; a newer offer replaces a held one. */
+  offerApprovalSuggestion(s) {
+    if (!this.deps.saveApprovalChoice) return;
+    if (this.state.modal === null) {
+      this.set({ modal: { kind: "suggestion", suggestion: s, openedAt: Date.now(), armedChoice: null } });
+      return;
+    }
+    this.heldSuggestion = s;
+  }
+  /** Arm a widening choice (`workspace` / `global`) without granting it yet --
+   * only a following Enter (`respondApprovalSuggestion`) does that. See
+   * ApprovalSuggestionView's doc (final review I1). A no-op if the suggestion
+   * modal is not open. */
+  armApprovalSuggestion(choice) {
+    if (this.state.modal?.kind !== "suggestion") return;
+    this.set({ modal: { ...this.state.modal, armedChoice: choice } });
+  }
+  async respondApprovalSuggestion(choice) {
+    const modal = this.state.modal;
+    const save = this.deps.saveApprovalChoice;
+    if (modal?.kind !== "suggestion" || !save) return;
+    this.set({ modal: null });
+    try {
+      await save(modal.suggestion, choice);
+      this.note("info", suggestionOutcome(modal.suggestion.tool, choice));
+    } catch (e) {
+      this.note("warn", `could not save that choice: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  /** Escape: ignore the offer. Writes nothing (plan Task 5: ignoring is not a choice). */
+  dismissApprovalSuggestion() {
+    if (this.state.modal?.kind === "suggestion") this.set({ modal: null });
+  }
 };
 
 export {
@@ -1393,6 +1495,10 @@ export {
   ageWord,
   formatContext,
   parseMarkdown,
+  suggestionLine,
+  suggestionKeys,
+  parseSuggestionChoice,
+  suggestionOutcome,
   DELTA_FLUSH_MS,
   TOOL_DELTA_CAP,
   TermSession

package/dist/{chunk-2MGDL3I4.js → chunk-MAZLORMD.js}

@@ -1,4 +1,5 @@
 // src/state.ts
+var SUGGESTION_ARM_DELAY_MS = 400;
 function emptyState(model = "") {
   return {
     seq: 0,
@@ -45,6 +46,7 @@ function parseTodos(args) {
 }
 
 export {
+  SUGGESTION_ARM_DELAY_MS,
   emptyState,
   parseTodos
 };

package/dist/{chunk-5RPHYXND.js → chunk-TWFWLEIP.js}

@@ -1,4 +1,5 @@
 // src/commands.ts
+import { strategiesRoot } from "@corenel/protocol";
 var TERM_COMMANDS = [
   { name: "help", summary: "what you can type here" },
   { name: "tools", summary: "what the agent can do, and what it can change" },
@@ -15,7 +16,9 @@ var TERM_COMMANDS = [
   { name: "mode", args: "<id>", summary: "switch the agent mode (takes effect next turn); no id lists what is configured" },
   { name: "persona", args: "<id>", summary: "switch persona (takes effect next turn); no id lists what is configured" },
   { name: "skill", args: "<name>", summary: "apply a skill to your NEXT message only, then it clears; no name lists what is installed" },
-  { name: "strategy", args: "<name>", summary: "run a saved strategy from .prompd/strategies; no name lists what is saved" },
+  { name: "strategy", args: "<name>", get summary() {
+    return `run a saved strategy from the current project's strategies folder (${strategiesRoot()} in a folder with no project); no name lists what is saved`;
+  } },
   { name: "mcp", args: "[list|add|remove|login|refresh|forget]", summary: "MCP servers -- what is connected, and sign in or add one; no argument opens the manager" }
 ];
 function formatHelpText() {

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAkBtC,CAAC;AAEF;;;;;;;+DAO+D;AAC/D,wBAAgB,cAAc,IAAI,MAAM,CAiBvC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAChB;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE,GACjB;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAClB;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAChB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAQxH;;;;;yDAKyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAkBD;;;;;;;WAOW;AACX,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU1D;AAED;;yBAEyB;AACzB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwC/D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAK3D"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAkBtC,CAAC;AAEF;;;;;;;+DAO+D;AAC/D,wBAAgB,cAAc,IAAI,MAAM,CAiBvC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAChB;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE,GACjB;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAClB;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAChB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAQxH;;;;;yDAKyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAkBD;;;;;;;WAOW;AACX,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU1D;AAED;;yBAEyB;AACzB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwC/D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAK3D"}

package/dist/commands.js

@@ -6,7 +6,7 @@ import {
   parseCommand,
   suggestCommand,
   unknownCommandMessage
-} from "./chunk-5RPHYXND.js";
+} from "./chunk-TWFWLEIP.js";
 export {
   TERM_COMMANDS,
   filterCommands,

package/dist/ink/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ink/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAuCzC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB;;;;iDAI6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;;iBAEa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;oDAOgD;IAChD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B;;;;;oDAKgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf;uDACmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;2EAUuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAsHvD"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ink/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAoEzC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB;;;;iDAI6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;;iBAEa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;oDAOgD;IAChD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B;;;;;oDAKgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf;uDACmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;2EAUuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAuIvD"}

package/dist/ink/ContextOverlay.d.ts

@@ -8,8 +8,9 @@ import { type ContextSnapshot } from '../contextText';
  * so a turn that lands while this is open updates the numbers on the very
  * next frame with no re-fetch and no re-open -- unlike the `/mcp` manager,
  * there is nothing here that needs fetching in the first place. */
-export declare function ContextOverlay({ snapshot }: {
+export declare function ContextOverlay({ snapshot, rows }: {
     snapshot: ContextSnapshot;
+    rows?: number;
 }): React.ReactElement;
 /** Build the overlay's data straight off live `TuiState` and the two
  * host-supplied static facts -- exported so App.tsx can assemble it without

package/dist/ink/ContextOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/ContextOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGrE;;;;;;mEAMmE;AACnE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,eAAe,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAa9F;AAED;;yEAEyE;AACzE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAS1H"}
+{"version":3,"file":"ContextOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/ContextOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AASrE;;;;;;mEAMmE;AACnE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAsBnH;AAED;;yEAEyE;AACzE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAS1H"}

package/dist/ink/HelpOverlay.d.ts

@@ -7,6 +7,13 @@ import React from 'react';
  * Rendered FROM `TERM_COMMANDS` -- the same table `parseCommand` dispatches
  * against, the palette filters, and `formatHelpText` renders as text --
  * rather than from a hand-written constant, so this list cannot fall behind
- * the commands it documents. */
-export declare function HelpOverlay(): React.ReactElement;
+ * the commands it documents.
+ *
+ * `rows` bounds the command list to what the terminal can actually show (see
+ * overlayBudget.ts's module doc) -- a full command table is ~18 rows on its
+ * own, comfortably taller than a lot of real terminals once the input box and
+ * status row are accounted for. */
+export declare function HelpOverlay({ rows }: {
+    rows?: number;
+}): React.ReactElement;
 //# sourceMappingURL=HelpOverlay.d.ts.map

package/dist/ink/HelpOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HelpOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/HelpOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;;;;;gCAQgC;AAChC,wBAAgB,WAAW,IAAI,KAAK,CAAC,YAAY,CAqBhD"}
+{"version":3,"file":"HelpOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/HelpOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAc1B;;;;;;;;;;;;;mCAamC;AACnC,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAsB3E"}

package/dist/ink/McpOverlay.d.ts

@@ -1,12 +1,7 @@
 import React from 'react';
 import type { McpManager } from '../state';
-/** The `/mcp` manager, as an Ink overlay -- pure presentation over
- * `TermSession`'s own `/mcp` dispatch (see mcpText.ts's module comment). It
- * holds no server list, connection state, or login state of its own; every
- * field it renders comes straight off `modal`, which the session owns and
- * refreshes after a mutation, the same way the text `/mcp` commands already
- * do. See ink/index.tsx's `useInput` for what a/x/l/esc/arrows actually run. */
-export declare function McpOverlay({ modal }: {
+export declare function McpOverlay({ modal, rows }: {
     modal: McpManager;
+    rows?: number;
 }): React.ReactElement;
 //# sourceMappingURL=McpOverlay.d.ts.map

package/dist/ink/McpOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/McpOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAa3C;;;;;gFAKgF;AAChF,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CA+C/E"}
+{"version":3,"file":"McpOverlay.d.ts","sourceRoot":"","sources":["../../src/ink/McpOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAwB3C,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAqFpG"}

package/dist/ink/Modal.d.ts

@@ -1,11 +1,20 @@
 import React from 'react';
+import type { ApprovalSuggestion } from '@corenel/protocol';
 import type { PermissionAsk, UserAsk } from '../state';
+/** The standing-approval offer (plan 2): one line of question, one of keys.
+ * Not part of ModalView -- it pauses nothing -- so App.tsx routes it here. */
+export declare function SuggestionView({ suggestion }: {
+    suggestion: ApprovalSuggestion;
+}): React.ReactElement;
 /** The permission ask and the free-text/choice ask -- the two modals that
  * pause a turn waiting on the user. `McpManager` and `HelpView` are NOT this
  * component's job: App.tsx routes those to their own views (McpOverlay.tsx;
  * a help view, Task 10) before this is ever called, so this stays narrowed
- * to the two `Modal` variants it actually knows how to draw. */
-export declare function ModalView({ modal }: {
+ * to the two `Modal` variants it actually knows how to draw. `rows` bounds
+ * both the diff preview and the options list to the terminal's actual
+ * height (see overlayBudget.ts's module doc). */
+export declare function ModalView({ modal, rows }: {
     modal: PermissionAsk | UserAsk;
+    rows?: number;
 }): React.ReactElement;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/ink/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/ink/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAuDvD;;;;gEAIgE;AAChE,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAiC3F"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/ink/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAKvD;8EAC8E;AAC9E,wBAAgB,cAAc,CAAC,EAAE,UAAU,EAAE,EAAE;IAAE,UAAU,EAAE,kBAAkB,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAOrG;AAyGD;;;;;;iDAMiD;AACjD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CA2DhH"}

package/dist/ink/index.d.ts

@@ -1,4 +1,6 @@
 import React from 'react';
+import { PermissionService } from '@corenel/harness/guardrail/permission-service';
+import { type ApprovalsService } from '@corenel/harness/approvals';
 import { TermSession, type TermSessionDeps } from '../session';
 export interface TuiDeps extends TermSessionDeps {
     version: string;
@@ -6,6 +8,14 @@ export interface TuiDeps extends TermSessionDeps {
     resume?: {
         id?: string;
     };
+    /** The host's approvals service (plan 2). Absent: no standing approvals, no
+     * decision log, no suggestions -- the kernel runs exactly as before. */
+    approvals?: ApprovalsService;
+    /** Stamped on each decision record. The session id is added at decision time. */
+    approvalsContext?: {
+        runId?: string;
+        workspace?: string;
+    };
 }
 /** Exported for `interaction.test.tsx` only: driving real keystrokes through
  * ink-testing-library's `stdin` requires rendering this directly, since
@@ -14,5 +24,13 @@ export declare function Root({ session, deps }: {
     session: TermSession;
     deps: TuiDeps;
 }): React.ReactElement;
+/** The session's PermissionService: prompts through the session's modal,
+ * and -- with an approvals service -- honors standing approvals, records
+ * every decision, and offers a suggestion after the answer. Exported for
+ * approvalSuggestion.test.tsx. */
+export declare function tuiPermission(session: TermSession, deps: TuiDeps): {
+    permission: PermissionService;
+    settled: () => Promise<void>;
+};
 export declare function runTui(deps: TuiDeps): Promise<number>;
 //# sourceMappingURL=index.d.ts.map

package/dist/ink/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ink/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAK3E,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAM/D,MAAM,WAAW,OAAQ,SAAQ,eAAe;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAS1B;AAED;;wEAEwE;AACxE,wBAAgB,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAwPnG;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ink/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAElF,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ/D,MAAM,WAAW,OAAQ,SAAQ,eAAe;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IASzB;4EACwE;IACxE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,iFAAiF;IACjF,gBAAgB,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED;;wEAEwE;AACxE,wBAAgB,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAoSnG;AAED;;;kCAGkC;AAClC,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,UAAU,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAsBlI;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD3D"}