agent-sh 0.12.25 → 0.12.27

package/dist/agent/agent-loop.js

@@ -1105,7 +1105,7 @@ export class AgentLoop {
                 // Compact deeply — shallow targets buy only 1–2 turns of runway on
                 // tool-heavy workloads.
                 const target = Math.floor(threshold * 0.25);
-                const result = this.compactWithHooks(target, 6);
+                const result = this.compactWithHooks(target, 1);
                 if (!result) {
                     // Auto-compact fired but nothing was evictable. This can happen
                     // in short conversations with heavy tool output where the pin
@@ -1488,7 +1488,7 @@ export class AgentLoop {
                 if (this.isContextOverflow(e)) {
                     const contextWindow = this.currentMode.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
                     const target = Math.floor((contextWindow - RESPONSE_RESERVE) * 0.6);
-                    const stats = this.compactWithHooks(target, 6);
+                    const stats = this.compactWithHooks(target, 1);
                     // If compaction freed nothing, retrying will hit the same error.
                     // Surface the real failure instead of looping until exhaustion.
                     if (!stats || stats.after >= stats.before) {

package/dist/agent/conversation-state.js

@@ -29,6 +29,19 @@ function firstMatchExcerpt(text, regex) {
 function recencyWeight(idx, total) {
     return Math.max(0.1, 1 - idx / total);
 }
+// Head+tail because the start (command, opening lines) and end (final
+// result, exit code) are the informative parts of shell/file output.
+function slimToolContent(content, maxLen) {
+    const exitMatch = content.match(/exit code:?\s*(\d+)/i);
+    const exitSuffix = exitMatch ? ` (exit ${exitMatch[1]})` : "";
+    const lines = content.split("\n");
+    if (lines.length > 6) {
+        const head = lines.slice(0, 3).join("\n");
+        const tail = lines.slice(-2).join("\n");
+        return `${head}\n... [${lines.length - 5} lines trimmed by compact]\n${tail}${exitSuffix}`;
+    }
+    return `${content.slice(0, maxLen)}\n... [${content.length - maxLen} chars trimmed by compact]${exitSuffix}`;
+}
 /**
  * Conversation state with eager nucleation — shell-history shaped.
  *
@@ -611,6 +624,7 @@ export class ConversationState {
     // ── Internal: Two-tier pin for recent turns ────────────────────
     slimTurn(messages) {
         const MAX_RESULT_LEN = 1500;
+        const MAX_ASSISTANT_LEN = 1500;
         const result = [];
         const droppedToolIds = new Set();
         for (const msg of messages) {
@@ -642,13 +656,20 @@ export class ConversationState {
                     continue;
                 const content = typeof msg.content === "string" ? msg.content : "";
                 if (content.length > MAX_RESULT_LEN) {
-                    result.push({ ...msg, content: content.slice(0, MAX_RESULT_LEN) + "\n... [truncated by compact]" });
+                    result.push({ ...msg, content: slimToolContent(content, MAX_RESULT_LEN) });
                 }
                 else {
                     result.push(msg);
                 }
                 continue;
             }
+            if (msg.role === "assistant" && typeof msg.content === "string" && msg.content.length > MAX_ASSISTANT_LEN) {
+                const head = msg.content.slice(0, Math.floor(MAX_ASSISTANT_LEN * 0.6));
+                const tail = msg.content.slice(-Math.floor(MAX_ASSISTANT_LEN * 0.2));
+                const trimmed = msg.content.length - head.length - tail.length;
+                result.push({ ...msg, content: `${head}\n... [${trimmed} chars trimmed by compact]\n${tail}` });
+                continue;
+            }
             result.push(msg);
         }
         return result;

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
 import * as path from "node:path";
-import { activateShell } from "./shell/index.js";
+import { activateShell, registerShellHandlers } from "./shell/index.js";
 import { createCore } from "./core.js";
 import { palette as p } from "./utils/palette.js";
 import { loadBuiltinExtensions } from "./extensions/index.js";
@@ -237,6 +237,8 @@ async function main() {
         process.exit(0);
     };
     const extCtx = core.extensionContext({ quit: cleanup });
+    // Before loadExtensions: extensions look up shell handlers at activation.
+    registerShellHandlers(extCtx);
     // Load before spawning the shell so PS1 lands below the banner.
     await loadBuiltinExtensions(extCtx, getSettings().disabledBuiltins);
     const loadExtensionsTimeoutMs = 10000;

package/dist/install.js

@@ -69,11 +69,13 @@ function pickResolver(spec) {
             return r;
     return bundledResolver;
 }
-function maybeNpmInstall(target) {
+function readPackageJson(target) {
     const pkgJson = path.join(target, "package.json");
     if (!fs.existsSync(pkgJson))
-        return;
-    const pkg = JSON.parse(fs.readFileSync(pkgJson, "utf-8"));
+        return null;
+    return JSON.parse(fs.readFileSync(pkgJson, "utf-8"));
+}
+function maybeNpmInstall(target, pkg) {
     const deps = { ...(pkg.dependencies ?? {}), ...(pkg.peerDependencies ?? {}) };
     if (Object.keys(deps).length === 0)
         return;
@@ -88,6 +90,56 @@ function maybeNpmInstall(target) {
         throw new Error(`npm install failed in ${target}; run it manually.`);
     }
 }
+function normalizeBin(pkg) {
+    if (!pkg.bin)
+        return {};
+    if (typeof pkg.bin === "string") {
+        const name = pkg.name?.startsWith("@") ? pkg.name.split("/")[1] : pkg.name;
+        return name ? { [name]: pkg.bin } : {};
+    }
+    return pkg.bin;
+}
+function maybeNpmBuild(target, pkg) {
+    if (!pkg.scripts?.build)
+        return;
+    const binPaths = Object.values(normalizeBin(pkg)).map((p) => path.join(target, p));
+    if (binPaths.length === 0)
+        return;
+    if (binPaths.every((p) => fs.existsSync(p)))
+        return;
+    console.log(`Running npm run build in ${target}...`);
+    const result = spawnSync("npm", ["run", "build"], { cwd: target, stdio: "inherit" });
+    if (result.status !== 0) {
+        throw new Error(`npm run build failed in ${target}; run it manually.`);
+    }
+}
+function linkBins(target, pkg) {
+    const bins = normalizeBin(pkg);
+    if (Object.keys(bins).length === 0)
+        return [];
+    const binDir = path.join(CONFIG_DIR, "bin");
+    fs.mkdirSync(binDir, { recursive: true });
+    const linked = [];
+    for (const [name, relPath] of Object.entries(bins)) {
+        const src = path.resolve(target, relPath);
+        if (!fs.existsSync(src)) {
+            console.error(`agent-sh: skipping bin "${name}" — ${src} not found`);
+            continue;
+        }
+        try {
+            fs.chmodSync(src, 0o755);
+        }
+        catch { /* ignore */ }
+        const linkPath = path.join(binDir, name);
+        try {
+            fs.unlinkSync(linkPath);
+        }
+        catch { /* ignore */ }
+        fs.symlinkSync(src, linkPath);
+        linked.push(name);
+    }
+    return linked;
+}
 export async function runInstall(spec, opts = {}) {
     if (!spec) {
         console.error("Usage: agent-sh install <name|file:|npm:|github:> [--force]\n\n" +
@@ -114,10 +166,16 @@ export async function runInstall(spec, opts = {}) {
         }
         fs.rmSync(target, { recursive: true, force: true });
     }
+    let linkedBins = [];
     if (resolved.isDirectory) {
         fs.cpSync(resolved.sourcePath, target, { recursive: true });
         try {
-            maybeNpmInstall(target);
+            const pkg = readPackageJson(target);
+            if (pkg) {
+                maybeNpmInstall(target, pkg);
+                maybeNpmBuild(target, pkg);
+                linkedBins = linkBins(target, pkg);
+            }
         }
         catch (err) {
             console.error(`agent-sh: ${err instanceof Error ? err.message : String(err)}`);
@@ -128,6 +186,11 @@ export async function runInstall(spec, opts = {}) {
         fs.copyFileSync(resolved.sourcePath, target);
     }
     console.log(`Installed: ${resolved.name} -> ${target}`);
+    if (linkedBins.length > 0) {
+        const binDir = path.join(CONFIG_DIR, "bin");
+        console.log(`Linked bins: ${linkedBins.join(", ")} -> ${binDir}`);
+        console.log(`Add to PATH: export PATH="${binDir}:$PATH"`);
+    }
 }
 export async function runUninstall(name) {
     if (!name) {
@@ -146,6 +209,23 @@ export async function runUninstall(name) {
         console.error(`agent-sh: not installed: ${name}`);
         process.exit(1);
     }
+    const pkg = readPackageJson(target);
+    if (pkg) {
+        const binDir = path.join(CONFIG_DIR, "bin");
+        const targetPrefix = path.resolve(target) + path.sep;
+        for (const binName of Object.keys(normalizeBin(pkg))) {
+            const linkPath = path.join(binDir, binName);
+            try {
+                const stat = fs.lstatSync(linkPath, { throwIfNoEntry: false });
+                if (!stat?.isSymbolicLink())
+                    continue;
+                const dest = path.resolve(binDir, fs.readlinkSync(linkPath));
+                if (dest.startsWith(targetPrefix))
+                    fs.unlinkSync(linkPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
     fs.rmSync(target, { recursive: true, force: true });
     console.log(`Uninstalled: ${name}`);
 }

package/dist/shell/index.d.ts

@@ -27,6 +27,11 @@ export interface ShellHandle {
     /** Forward terminal size changes to the PTY. */
     resize(cols: number, rows: number): void;
 }
+/**
+ * Register shell-owned handlers extensions can `ctx.call`. Must run before
+ * `loadExtensions`; the handlers only need the bus, not the PTY.
+ */
+export declare function registerShellHandlers(ctx: ExtensionContext): void;
 /**
  * Construct the Shell, wire resize forwarding, and register cleanup with the
  * provided ExtensionContext. Returns a handle the caller (typically

package/dist/shell/index.js

@@ -1,6 +1,19 @@
 import { Shell } from "./shell.js";
 import { StdoutSurface } from "../utils/compositor.js";
 import { TerminalBuffer } from "../utils/terminal-buffer.js";
+/**
+ * Register shell-owned handlers extensions can `ctx.call`. Must run before
+ * `loadExtensions`; the handlers only need the bus, not the PTY.
+ */
+export function registerShellHandlers(ctx) {
+    let terminalBufferSingleton;
+    ctx.define("terminal-buffer", () => {
+        if (terminalBufferSingleton !== undefined)
+            return terminalBufferSingleton;
+        terminalBufferSingleton = TerminalBuffer.createWired(ctx.bus);
+        return terminalBufferSingleton;
+    });
+}
 /**
  * Construct the Shell, wire resize forwarding, and register cleanup with the
  * provided ExtensionContext. Returns a handle the caller (typically
@@ -13,14 +26,6 @@ export function activateShell(ctx, opts) {
     ctx.compositor.setDefault("agent", stdoutSurface);
     ctx.compositor.setDefault("query", stdoutSurface);
     ctx.compositor.setDefault("status", stdoutSurface);
-    // Lazy because @xterm/headless is optional; null when not installed.
-    let terminalBufferSingleton;
-    ctx.define("terminal-buffer", () => {
-        if (terminalBufferSingleton !== undefined)
-            return terminalBufferSingleton;
-        terminalBufferSingleton = TerminalBuffer.createWired(ctx.bus);
-        return terminalBufferSingleton;
-    });
     const shell = new Shell({
         bus: ctx.bus,
         handlers: { define: ctx.define, call: ctx.call },

package/dist/shell/input-handler.js

@@ -229,9 +229,15 @@ export class InputHandler {
         return false;
     }
     renderModeInput() {
-        this.view.clearAutocomplete();
-        this.drawPrompt();
-        this.updateAutocomplete();
+        this.view.beginFrame();
+        try {
+            this.view.clearAutocomplete();
+            this.drawPrompt();
+            this.updateAutocomplete();
+        }
+        finally {
+            this.view.endFrame();
+        }
     }
     updateAutocomplete() {
         const buf = this.editor.text;
@@ -278,13 +284,19 @@ export class InputHandler {
         else {
             this.editor.setText(selected.name);
         }
-        this.view.clearAutocomplete();
-        this.autocompleteActive = false;
-        this.autocompleteItems = [];
-        this.autocompleteIndex = 0;
-        this.drawPrompt();
-        if (isFileAc)
-            this.updateAutocomplete();
+        this.view.beginFrame();
+        try {
+            this.view.clearAutocomplete();
+            this.autocompleteActive = false;
+            this.autocompleteItems = [];
+            this.autocompleteIndex = 0;
+            this.drawPrompt();
+            if (isFileAc)
+                this.updateAutocomplete();
+        }
+        finally {
+            this.view.endFrame();
+        }
     }
     dismissAutocomplete() {
         this.view.clearAutocomplete();
@@ -314,11 +326,17 @@ export class InputHandler {
                 case "changed": {
                     const switchMode = this.modes.get(this.editor.text);
                     if (this.editor.text.length === 1 && switchMode && switchMode !== this.activeMode) {
-                        this.dismissAutocomplete();
-                        this.view.clearPromptArea();
-                        this.activeMode = switchMode;
-                        this.editor.clear();
-                        this.drawPrompt(false);
+                        this.view.beginFrame();
+                        try {
+                            this.dismissAutocomplete();
+                            this.view.clearPromptArea();
+                            this.activeMode = switchMode;
+                            this.editor.clear();
+                            this.drawPrompt(false);
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                         break;
                     }
                     this.historyIndex = -1;
@@ -371,8 +389,14 @@ export class InputHandler {
                 }
                 case "cancel":
                     if (this.autocompleteActive) {
-                        this.dismissAutocomplete();
-                        this.drawPrompt();
+                        this.view.beginFrame();
+                        try {
+                            this.dismissAutocomplete();
+                            this.drawPrompt();
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                     }
                     else {
                         this.exitMode();
@@ -393,9 +417,15 @@ export class InputHandler {
                             this.autocompleteIndex === 0
                                 ? this.autocompleteItems.length - 1
                                 : this.autocompleteIndex - 1;
-                        this.view.clearAutocomplete();
-                        this.drawPrompt();
-                        this.view.drawAutocomplete({ items: this.autocompleteItems, selected: this.autocompleteIndex });
+                        this.view.beginFrame();
+                        try {
+                            this.view.clearAutocomplete();
+                            this.drawPrompt();
+                            this.view.drawAutocomplete({ items: this.autocompleteItems, selected: this.autocompleteIndex });
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                     }
                     else if (this.history.length > 0) {
                         if (this.historyIndex === -1) {
@@ -406,8 +436,14 @@ export class InputHandler {
                             this.historyIndex--;
                         }
                         this.editor.setText(this.history[this.historyIndex]);
-                        this.view.clearAutocomplete();
-                        this.drawPrompt();
+                        this.view.beginFrame();
+                        try {
+                            this.view.clearAutocomplete();
+                            this.drawPrompt();
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                     }
                     break;
                 case "arrow-down":
@@ -416,9 +452,15 @@ export class InputHandler {
                             this.autocompleteIndex === this.autocompleteItems.length - 1
                                 ? 0
                                 : this.autocompleteIndex + 1;
-                        this.view.clearAutocomplete();
-                        this.drawPrompt();
-                        this.view.drawAutocomplete({ items: this.autocompleteItems, selected: this.autocompleteIndex });
+                        this.view.beginFrame();
+                        try {
+                            this.view.clearAutocomplete();
+                            this.drawPrompt();
+                            this.view.drawAutocomplete({ items: this.autocompleteItems, selected: this.autocompleteIndex });
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                     }
                     else if (this.historyIndex !== -1) {
                         if (this.historyIndex < this.history.length - 1) {
@@ -429,8 +471,14 @@ export class InputHandler {
                             this.historyIndex = -1;
                             this.editor.setText(this.savedBuffer);
                         }
-                        this.view.clearAutocomplete();
-                        this.drawPrompt();
+                        this.view.beginFrame();
+                        try {
+                            this.view.clearAutocomplete();
+                            this.drawPrompt();
+                        }
+                        finally {
+                            this.view.endFrame();
+                        }
                     }
                     break;
             }

package/dist/shell/tui-input-view.d.ts

@@ -26,7 +26,12 @@ export declare class TuiInputView {
     private cursorTermCol;
     private autocompleteLines;
     private readonly surface;
+    private frameBuf;
     constructor(surface?: RenderSurface);
+    beginFrame(): void;
+    endFrame(): void;
+    private emit;
+    private autoFrame;
     resetCursor(): void;
     enableModeKeys(): void;
     disableModeKeys(): void;