@falkenslab/agent-kit 0.30.0 → 0.30.1

package/dist/core/hooks/guidedGate.js

@@ -1,6 +1,8 @@
 import { askForChoice } from "./humanInput.js";
 import { readLock, setExtensionConfirm } from "../externalExtensions.js";
 import { t } from "../messages/index.js";
+/** How much of a labelled tool's parameters its panel shows, as one line (#84). */
+const MAX_PARAMETERS = 300;
 /** The kit's approval tool: asking it ends a batch, and its yes starts one. */
 const APPROVAL_TOOL = "mcp__approvals__request_human_approval";
 /**
@@ -70,9 +72,13 @@ export function createGuidedGate(options) {
         // For one that always asks, only what covers this call, or makes it stricter (#78).
         const choices = alwaysAsks ? [answers.yes, answers.no, answers.never] : [answers.yes, answers.session, answers.always, answers.no, answers.never];
         const label = options.labels?.()[full]?.label((pre.tool_input ?? {}));
+        // With a label saying what it does, its parameters in one line, cut short (#84): a rubric or a
+        // page's HTML as indented JSON filled the panel. Without one, the parameters are all it shows.
+        const compact = JSON.stringify(pre.tool_input ?? {});
+        const parameters = label ? (compact.length > MAX_PARAMETERS ? `${compact.slice(0, MAX_PARAMETERS)}…` : compact) : JSON.stringify(pre.tool_input, null, 2);
         const answer = await askForChoice(options.runDir, {
             title: t().guidedTitle(extension.name),
-            lines: [...(label ? [label] : []), t().toolLine(full), t().parametersLine(JSON.stringify(pre.tool_input, null, 2))],
+            lines: [...(label ? [label] : []), t().toolLine(full), t().parametersLine(parameters)],
         }, choices);
         const picked = answer.chosen[0];
         if (picked === answers.yes || picked === answers.session || picked === answers.always) {

package/dist/tui/ink/SessionView.d.ts

@@ -6,6 +6,21 @@ import { type SessionModel } from "./sessionModel.js";
 import type { InkInteraction } from "./inkInteraction.js";
 /** Replaces the default preview (title and lines) of an approval panel; the choices stay. */
 export type RenderApproval = (prompt: ApprovalPrompt) => ReactNode;
+/**
+ * The rows a checkpoint panel needs besides its preview, by its kind (#84): a choice has its
+ * options, "Other" and a line of keys, so the guided gate's five answers took four rows more than a
+ * decision's, and pushed them below the screen under a tool's long parameters. `reservedRows` is
+ * what the screen keeps for a decision's panel; the difference in frame is added to it.
+ */
+export declare function panelReservedRows(checkpoint: {
+    kind: string;
+    prompt: {
+        question?: string;
+    };
+    choice?: {
+        options: readonly string[];
+    };
+}, reservedRows?: number): number;
 /**
  * The preview's lines, capped so the whole live area stays shorter than the terminal: Ink
  * clears the entire screen (scrollback included) to redraw anything taller, and a step-gate

package/dist/tui/ink/SessionView.js

@@ -28,6 +28,26 @@ const DECISION_KEYS = { "1": "y", "2": "n", "3": "q", y: "y", n: "n", q: "q" };
 const PANEL_RESERVED_ROWS = 12;
 /** The panel's border and horizontal padding, on both sides. */
 const PANEL_FRAME_COLUMNS = 4;
+/** The rows `PANEL_RESERVED_ROWS` counts for the panel's own frame: a decision's (borders, title, a gap, "Proceed?", its three options). */
+const DECISION_FRAME_ROWS = 8;
+/**
+ * The rows a checkpoint panel needs besides its preview, by its kind (#84): a choice has its
+ * options, "Other" and a line of keys, so the guided gate's five answers took four rows more than a
+ * decision's, and pushed them below the screen under a tool's long parameters. `reservedRows` is
+ * what the screen keeps for a decision's panel; the difference in frame is added to it.
+ */
+export function panelReservedRows(checkpoint, reservedRows = PANEL_RESERVED_ROWS) {
+    const question = checkpoint.prompt.question ? 1 : 0;
+    // Borders and the title (3), then each kind's own rows.
+    const frame = checkpoint.kind === "decision"
+        ? DECISION_FRAME_ROWS
+        : checkpoint.kind === "choice"
+            ? 3 + question + 1 + (checkpoint.choice?.options.length ?? 0) + 1 + 1
+            : checkpoint.kind === "text"
+                ? 3 + question + 1 + 1 + 1
+                : 3 + question + 1 + 1;
+    return reservedRows - DECISION_FRAME_ROWS + frame;
+}
 /**
  * The preview's lines, capped so the whole live area stays shorter than the terminal: Ink
  * clears the entire screen (scrollback included) to redraw anything taller, and a step-gate
@@ -62,7 +82,7 @@ function CheckpointPanel({ checkpoint, renderApproval, reservedRows, width, }) {
     });
     const { prompt } = checkpoint;
     const { stdout } = useStdout();
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: inkColor("accent"), paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.markdown ? renderMarkdown(prompt.lines.join("\n"), width - PANEL_FRAME_COLUMNS) : prompt.lines, stdout.rows, reservedRows, width - PANEL_FRAME_COLUMNS).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: t().proceed }) })) : null, choice && checkpoint.choice ? (_jsx(ChoiceInput, { choice: checkpoint.choice, onAnswer: (value) => checkpoint.answer(value) }, checkpoint.id)) : text ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { children: "> " }), _jsx(TextInput, { placeholder: t().textAnswerHint, onSubmit: (value) => checkpoint.answer(value.trim()) }, checkpoint.id)] }), _jsx(Text, { dimColor: true, children: t().textAnswerKeys })] })) : (_jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? decisionOptions() : manualOptions(), onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) }))] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: inkColor("accent"), paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.markdown ? renderMarkdown(prompt.lines.join("\n"), width - PANEL_FRAME_COLUMNS) : prompt.lines, stdout.rows, panelReservedRows(checkpoint, reservedRows), width - PANEL_FRAME_COLUMNS).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: t().proceed }) })) : null, choice && checkpoint.choice ? (_jsx(ChoiceInput, { choice: checkpoint.choice, onAnswer: (value) => checkpoint.answer(value) }, checkpoint.id)) : text ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { children: "> " }), _jsx(TextInput, { placeholder: t().textAnswerHint, onSubmit: (value) => checkpoint.answer(value.trim()) }, checkpoint.id)] }), _jsx(Text, { dimColor: true, children: t().textAnswerKeys })] })) : (_jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? decisionOptions() : manualOptions(), onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) }))] }));
 }
 /**
  * A choice's options (one with Select, several with MultiSelect), plus "Other" to type an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkenslab/agent-kit",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Library for building an agent on top of the Claude Agent SDK",
   "author": "Francisco Vargas Ruiz",
   "license": "MIT",