agent-sh 0.1.0

package/examples/extensions/interactive-prompts.ts

@@ -0,0 +1,161 @@
+/**
+ * Interactive permission prompts extension.
+ *
+ * Adds permission gates for tool calls and file writes.
+ * Without this extension, agent-sh runs in yolo mode (auto-approve).
+ *
+ * Usage:
+ *   # Load by short name (built-in):
+ *   agent-sh --extensions interactive-prompts
+ *
+ *   # Or copy to ~/.agent-sh/extensions/ for permanent use:
+ *   cp examples/extensions/interactive-prompts.ts ~/.agent-sh/extensions/
+ *
+ *   # Or install as an npm package and load by name:
+ *   agent-sh --extensions my-prompts-package
+ */
+import { renderDiff } from "agent-sh/utils/diff-renderer.js";
+import { renderBoxFrame } from "agent-sh/utils/box-frame.js";
+import { palette as p } from "agent-sh/utils/palette.js";
+import type { ExtensionContext } from "agent-sh/types";
+
+export default function activate({ bus }: ExtensionContext) {
+  let autoApproveWrites = false;
+
+  bus.onPipeAsync("permission:request", async (payload) => {
+    switch (payload.kind) {
+      case "tool-call":
+        return handleToolCallPermission(payload);
+      case "file-write": {
+        if (autoApproveWrites) {
+          return { ...payload, decision: { approved: true } };
+        }
+        const result = await handleFileWritePermission(payload);
+        if (result.decision.autoApprove) {
+          autoApproveWrites = true;
+        }
+        return result;
+      }
+      default:
+        return payload;
+    }
+  });
+}
+
+async function handleToolCallPermission(payload) {
+  const options = payload.metadata.options;
+  const answer = await promptPermission(payload.title);
+
+  if (answer === "approve" || answer === "approve_all") {
+    const option = answer === "approve_all"
+      ? options.find((o) => o.kind === "allow_always") ?? options.find((o) => o.kind === "allow_once")
+      : options.find((o) => o.kind === "allow_once" || o.kind === "allow_always");
+    if (option) {
+      return { ...payload, decision: { outcome: "selected", optionId: option.optionId } };
+    }
+  }
+  return { ...payload, decision: { outcome: "cancelled" } };
+}
+
+async function handleFileWritePermission(payload) {
+  const diff = payload.metadata.diff;
+  const filePath = payload.metadata.path;
+  const answer = await previewDiff({ path: filePath, diff });
+  if (answer === "approve") {
+    return { ...payload, decision: { approved: true } };
+  }
+  if (answer === "approve_all") {
+    return { ...payload, decision: { approved: true, autoApprove: true } };
+  }
+  return { ...payload, decision: { approved: false } };
+}
+
+async function promptPermission(title) {
+  const termW = process.stdout.columns || 80;
+  const boxW = Math.min(84, termW);
+
+  const framed = renderBoxFrame(
+    [`${p.bold}⚠ ${title}${p.reset}`],
+    {
+      width: boxW,
+      style: "rounded",
+      borderColor: p.warning,
+      title: "Permission required",
+      footer: [`  ${p.dim}[y]es / [n]o / [a]llow all${p.reset}`],
+    },
+  );
+
+  process.stdout.write("\n");
+  for (const line of framed) {
+    process.stdout.write(line + "\n");
+  }
+  process.stdout.write("  ");
+
+  return new Promise((resolve) => {
+    const handler = (data) => {
+      const ch = data.toString("utf-8").toLowerCase();
+      process.stdin.removeListener("data", handler);
+      process.stdout.write("\n");
+
+      if (ch === "y") resolve("approve");
+      else if (ch === "a") resolve("approve_all");
+      else resolve(null);
+    };
+    process.stdin.on("data", handler);
+  });
+}
+
+async function previewDiff(opts) {
+  const termW = process.stdout.columns || 80;
+  const boxW = Math.min(84, termW);
+  const contentW = boxW - 4;
+  const MAX_DISPLAY = 25;
+
+  const stats = opts.diff.isNewFile
+    ? `(+${opts.diff.added} lines)`
+    : `(+${opts.diff.added} / -${opts.diff.removed})`;
+  const title = opts.diff.isNewFile
+    ? `new: ${opts.path}  ${stats}`
+    : `${opts.path}  ${stats}`;
+
+  const diffLines = renderDiff(opts.diff, {
+    width: contentW,
+    filePath: opts.path,
+    maxLines: MAX_DISPLAY,
+    trueColor: true,
+    mode: "unified",
+  });
+  const content = ["", ...diffLines.slice(1), ""];
+
+  const framed = renderBoxFrame(content, {
+    width: boxW,
+    style: "rounded",
+    borderColor: p.warning,
+    title,
+    footer: [`  ${p.bold}[y] Apply  [n] Skip  [a] Don't ask again${p.reset}`],
+  });
+
+  process.stdout.write("\n");
+  for (const line of framed) {
+    process.stdout.write(line + "\n");
+  }
+
+  return new Promise((resolve) => {
+    const handler = (data) => {
+      const ch = data.toString("utf-8").toLowerCase();
+      process.stdin.removeListener("data", handler);
+
+      if (ch === "y") {
+        process.stdout.write(`  ${p.success}✓ Applied${p.reset}\n`);
+        resolve("approve");
+      } else if (ch === "a") {
+        process.stdout.write(`  ${p.success}✓ Applied (auto-approve on)${p.reset}\n`);
+        resolve("approve_all");
+      } else {
+        process.stdout.write(`  ${p.error}✗ Skipped${p.reset}\n`);
+        resolve("reject");
+      }
+    };
+    process.stdin.on("data", handler);
+  });
+}

package/examples/extensions/solarized-theme.ts

@@ -0,0 +1,27 @@
+/**
+ * Solarized Dark theme extension.
+ *
+ * Overrides the default color palette with Solarized Dark colors.
+ *
+ * Usage:
+ *   agent-sh -e ./examples/extensions/solarized-theme.ts
+ *
+ *   # Or copy to ~/.agent-sh/extensions/ for permanent use:
+ *   cp examples/extensions/solarized-theme.ts ~/.agent-sh/extensions/
+ */
+import type { ExtensionContext } from "agent-sh/types";
+
+export default function activate({ setPalette }: ExtensionContext) {
+  setPalette({
+    accent:  "\x1b[38;2;38;139;210m",   // blue (#268bd2)
+    success: "\x1b[38;2;133;153;0m",    // green (#859900)
+    warning: "\x1b[38;2;181;137;0m",    // yellow (#b58900)
+    error:   "\x1b[38;2;220;50;47m",    // red (#dc322f)
+    muted:   "\x1b[38;2;88;110;117m",   // base01 (#586e75)
+
+    successBg:     "\x1b[48;2;7;54;66m",    // base03 with green tint
+    errorBg:       "\x1b[48;2;42;30;30m",   // base03 with red tint
+    successBgEmph: "\x1b[48;2;20;70;50m",   // stronger green tint
+    errorBgEmph:   "\x1b[48;2;70;30;30m",   // stronger red tint
+  });
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "agent-sh",
+  "version": "0.1.0",
+  "description": "A shell-first terminal where any ACP-compatible AI agent is one keystroke away",
+  "type": "module",
+  "main": "dist/core.js",
+  "types": "dist/core.d.ts",
+  "bin": {
+    "agent-sh": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./utils/*": "./dist/utils/*",
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "pi": "node dist/index.js --agent pi-acp",
+    "claude": "node dist/index.js --agent claude-agent-acp",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "terminal",
+    "shell",
+    "agent",
+    "ai",
+    "acp",
+    "cli",
+    "pty",
+    "llm"
+  ],
+  "author": "Yilun Guan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guanyilun/agent-sh.git"
+  },
+  "homepage": "https://github.com/guanyilun/agent-sh",
+  "bugs": {
+    "url": "https://github.com/guanyilun/agent-sh/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.18.1",
+    "cli-highlight": "^2.1.11",
+    "marked": "^17.0.6",
+    "node-pty": "^1.2.0-beta.12",
+    "tsx": "^4.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}