agent-sh 0.7.0 → 0.8.0

package/dist/settings.js

@@ -21,6 +21,10 @@ const DEFAULTS = {
     shellHeadLines: 5,
     shellTailLines: 5,
     recallExpandMaxLines: 100,
+    shellContextRatio: 0.35,
+    historyMaxBytes: 102400,
+    historyStartupEntries: 50,
+    nuclearMaxEntries: 200,
     maxCommandOutputLines: 3,
     readOutputMaxLines: 10,
     diffMaxLines: 20,
@@ -86,15 +90,29 @@ export function resolveProvider(name) {
     const provider = settings.providers?.[name];
     if (!provider)
         return null;
-    const models = provider.models ?? (provider.defaultModel ? [provider.defaultModel] : []);
-    const defaultModel = provider.defaultModel ?? models[0];
+    const rawModels = provider.models ?? (provider.defaultModel ? [provider.defaultModel] : []);
+    const modelIds = [];
+    const caps = new Map();
+    for (const m of rawModels) {
+        if (typeof m === "string") {
+            modelIds.push(m);
+        }
+        else {
+            modelIds.push(m.id);
+            if (m.reasoning !== undefined || m.contextWindow !== undefined) {
+                caps.set(m.id, { reasoning: m.reasoning, contextWindow: m.contextWindow });
+            }
+        }
+    }
+    const defaultModel = provider.defaultModel ?? modelIds[0];
     return {
         id: name,
         apiKey: provider.apiKey ? expandEnvVars(provider.apiKey) : undefined,
         baseURL: provider.baseURL,
         defaultModel,
-        models: models.length ? models : (defaultModel ? [defaultModel] : []),
+        models: modelIds.length ? modelIds : (defaultModel ? [defaultModel] : []),
         contextWindow: provider.contextWindow,
+        modelCapabilities: caps.size > 0 ? caps : undefined,
     };
 }
 /** Get all configured provider names. */

package/dist/shell.js

@@ -163,6 +163,10 @@ export class Shell {
         this.bus.on("shell:pty-write", ({ data }) => {
             this.ptyProcess.write(data);
         });
+        // Allow extensions to resize the PTY (sends SIGWINCH to child)
+        this.bus.on("shell:pty-resize", ({ cols, rows }) => {
+            this.ptyProcess.resize(cols, rows);
+        });
         // Ref-counted stdout hold — overlay extensions suppress PTY output
         this.bus.on("shell:stdout-hold", () => { this.stdoutHold.increment(); });
         this.bus.on("shell:stdout-release", () => { this.stdoutHold.decrement(); });

package/dist/token-budget.d.ts

@@ -0,0 +1,13 @@
+export declare class TokenBudget {
+    private contextWindow;
+    private toolCount;
+    constructor(contextWindow?: number, toolCount?: number);
+    /** Update when model or tool set changes. */
+    update(contextWindow?: number, toolCount?: number): void;
+    /** Total tokens available for shell context + conversation content. */
+    get contentBudget(): number;
+    /** Token budget for the shell context stream. */
+    get shellBudgetTokens(): number;
+    /** Token budget for the conversation messages stream. */
+    get conversationBudgetTokens(): number;
+}

package/dist/token-budget.js

@@ -0,0 +1,50 @@
+/**
+ * Unified token budget manager.
+ *
+ * Splits a model's context window between two streams:
+ *   - Shell context (user shell commands and outputs — situational awareness)
+ *   - Conversation (agent messages and tool results — task continuity)
+ *
+ * The budget accounts for fixed overhead (system prompt, tool definitions,
+ * response reserve) and divides the remaining space by a configurable ratio.
+ */
+import { getSettings } from "./settings.js";
+/** Overhead estimates (tokens). */
+const SYSTEM_PROMPT_OVERHEAD = 800;
+const DYNAMIC_CONTEXT_OVERHEAD = 500; // conventions, metadata, skills list
+const TOKENS_PER_TOOL_DEFINITION = 50;
+const RESPONSE_RESERVE = 8192; // matches llm-client.ts default max_tokens
+/** Fallback when contextWindow is unknown. */
+const DEFAULT_CONTEXT_WINDOW = 60_000;
+export class TokenBudget {
+    contextWindow;
+    toolCount;
+    constructor(contextWindow, toolCount = 0) {
+        this.contextWindow = contextWindow ?? DEFAULT_CONTEXT_WINDOW;
+        this.toolCount = toolCount;
+    }
+    /** Update when model or tool set changes. */
+    update(contextWindow, toolCount) {
+        if (contextWindow != null)
+            this.contextWindow = contextWindow;
+        if (toolCount != null)
+            this.toolCount = toolCount;
+    }
+    /** Total tokens available for shell context + conversation content. */
+    get contentBudget() {
+        const overhead = SYSTEM_PROMPT_OVERHEAD +
+            DYNAMIC_CONTEXT_OVERHEAD +
+            this.toolCount * TOKENS_PER_TOOL_DEFINITION +
+            RESPONSE_RESERVE;
+        return Math.max(0, this.contextWindow - overhead);
+    }
+    /** Token budget for the shell context stream. */
+    get shellBudgetTokens() {
+        const ratio = getSettings().shellContextRatio;
+        return Math.floor(this.contentBudget * ratio);
+    }
+    /** Token budget for the conversation messages stream. */
+    get conversationBudgetTokens() {
+        return this.contentBudget - this.shellBudgetTokens;
+    }
+}

package/dist/types.d.ts

@@ -101,12 +101,6 @@ export interface TerminalSession {
     done: boolean;
     resolve?: (value: void) => void;
 }
-export interface ToolCallRecord {
-    tool: string;
-    args: Record<string, unknown>;
-    output: string;
-    exitCode: number | null;
-}
 export type Exchange = {
     type: "shell_command";
     id: number;
@@ -124,20 +118,4 @@ export type Exchange = {
     id: number;
     timestamp: number;
     query: string;
-} | {
-    type: "agent_response";
-    id: number;
-    timestamp: number;
-    response: string;
-    toolCalls: ToolCallRecord[];
-} | {
-    type: "tool_execution";
-    id: number;
-    timestamp: number;
-    tool: string;
-    args: Record<string, unknown>;
-    output: string;
-    exitCode: number | null;
-    outputLines: number;
-    outputBytes: number;
 };

package/dist/utils/ansi.d.ts

@@ -11,5 +11,15 @@ export declare const RESET = "\u001B[0m";
  * Excludes SGR (color/style) sequences and accounts for CJK double-width chars.
  */
 export declare function visibleLen(str: string): number;
+/**
+ * Truncate a string to fit within `maxWidth` visible columns.
+ * Accounts for CJK double-width characters. Appends `…` if truncated.
+ */
+export declare function truncateToWidth(str: string, maxWidth: number): string;
+/**
+ * Pad a string with spaces to fill `targetWidth` visible columns.
+ * Accounts for CJK double-width characters.
+ */
+export declare function padEndToWidth(str: string, targetWidth: number): string;
 /** Strip all ANSI escape sequences (SGR, OSC, CSI, private mode) and carriage returns. */
 export declare function stripAnsi(str: string): string;

package/dist/utils/ansi.js

@@ -70,6 +70,33 @@ export function visibleLen(str) {
     }
     return width;
 }
+/**
+ * Truncate a string to fit within `maxWidth` visible columns.
+ * Accounts for CJK double-width characters. Appends `…` if truncated.
+ */
+export function truncateToWidth(str, maxWidth) {
+    const clean = str.replace(/\x1b\[[^m]*m/g, "");
+    let width = 0;
+    let i = 0;
+    for (const char of clean) {
+        const cw = charWidth(char.codePointAt(0) ?? 0);
+        if (width + cw > maxWidth - 1) {
+            // Need room for the "…" (1 column wide)
+            return clean.slice(0, i) + "…";
+        }
+        width += cw;
+        i += char.length;
+    }
+    return clean;
+}
+/**
+ * Pad a string with spaces to fill `targetWidth` visible columns.
+ * Accounts for CJK double-width characters.
+ */
+export function padEndToWidth(str, targetWidth) {
+    const gap = targetWidth - visibleLen(str);
+    return gap > 0 ? str + " ".repeat(gap) : str;
+}
 /** Strip all ANSI escape sequences (SGR, OSC, CSI, private mode) and carriage returns. */
 export function stripAnsi(str) {
     return str

package/dist/utils/floating-panel.d.ts

@@ -20,7 +20,7 @@ export interface FloatingPanelConfig {
      * Requires @xterm/headless — falls back to blank background if unavailable.
      */
     dimBackground?: boolean;
-    /** Auto-dismiss delay in ms when done (0 = disabled). Default: 0. */
+    /** Auto-dismiss delay in ms when done (0 = auto-prompt for follow-up). Default: 0. */
     autoDismissMs?: number;
     /** Icon shown before the input cursor. Default: "\u276f". */
     promptIcon?: string;
@@ -144,6 +144,7 @@ export declare class FloatingPanel {
      *   - `{prefix}:composite-row(content: string, bgLine: string|null, boxLeft: number, boxW: number, cols: number) -> string`
      *   - `{prefix}:submit(query: string) -> void`
      *   - `{prefix}:dismiss() -> void`
+     *   - `{prefix}:show() -> void`
      *   - `{prefix}:input(data: string) -> boolean`
      *   - `{prefix}:build-row(content: string, width: number) -> string`
      */
@@ -153,29 +154,47 @@ export declare class FloatingPanel {
     /** All byte sequences that should be recognized as the trigger key. */
     private readonly triggerSeqs;
     private phase;
+    private _visible;
+    private _passthrough;
     private editor;
     private contentLines;
     private currentPartialLine;
     private scrollOffset;
+    private userScrolled;
     private title;
     private footer;
     private renderTimer;
-    private autoDismissTimer;
     private resizeHandler;
     private prevFrame;
     private suppressNextRedraw;
+    private autoDismissTimer;
     private ptyBuffer;
     private usedAltScreen;
+    private wrapCache;
+    private wrapCacheWidth;
+    private passthroughTimer;
+    private prevSerialized;
     constructor(bus: EventBus, config: FloatingPanelConfig, handlers?: HandlerRegistry);
     private registerDefaultHandlers;
     private wireEvents;
     /** Check whether data matches any encoding of the trigger key. */
     private isTrigger;
     private ensureBuffer;
+    /** Whether the panel has an active conversation (may be hidden). */
     get active(): boolean;
+    /** Whether the panel is currently visible on screen. */
+    get visible(): boolean;
     get terminalBuffer(): TerminalBuffer | null;
+    /** Open a fresh panel with a new conversation. */
     open(): void;
+    /** Hide the panel without destroying conversation state. */
+    hide(): void;
+    /** Show the panel again after hide(), preserving conversation. */
+    show(): void;
+    /** Fully destroy the panel, resetting all state. */
     dismiss(): void;
+    /** Common screen enter logic shared by open() and show(). */
+    private enterScreen;
     appendText(text: string): void;
     appendLine(line: string): void;
     updateLastLine(fn: (line: string) => string): void;
@@ -184,15 +203,25 @@ export declare class FloatingPanel {
     setFooter(footer: string): void;
     setActive(): void;
     setDone(): void;
+    scrollUp(lines?: number): void;
+    scrollDown(lines?: number): void;
     getInput(): string;
     requestRender(): void;
     private handleIntercept;
+    /** Handle scroll input. Returns true if consumed. */
+    private handleScroll;
     private handleInputKey;
     /** Compute box geometry from config + current terminal size. */
     computeGeometry(): BoxGeometry;
     private buildFrame;
     private scheduleRender;
     private render;
-    private restoreScreen;
+    /** Full screen teardown: exit alt screen, release stdout, force redraw. */
+    private teardownScreen;
+    /** Start rendering TerminalBuffer directly (no overlay box). */
+    private startPassthrough;
+    private stopPassthrough;
+    /** Render the TerminalBuffer's screen content directly (no overlay). */
+    private renderPassthrough;
     private resolveSize;
 }