@llmist/cli 9.1.1 → 9.2.0

package/README.md

@@ -0,0 +1,107 @@
+# @llmist/cli
+
+<p align="center">
+  <a href="https://github.com/zbigniewsobiecki/llmist/actions/workflows/ci.yml"><img src="https://github.com/zbigniewsobiecki/llmist/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@llmist/cli"><img src="https://img.shields.io/npm/v/@llmist/cli.svg" alt="npm version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
+</p>
+
+**Command-line interface for llmist - run LLM agents from the terminal.**
+
+## Installation
+
+```bash
+npm install -g @llmist/cli
+# or
+bunx @llmist/cli
+```
+
+## Quick Start
+
+```bash
+# Set your API key
+export OPENAI_API_KEY="sk-..."
+
+# Quick completion
+llmist complete "Explain TypeScript generics in one paragraph"
+
+# Run an agent with gadgets
+llmist agent "Search for files" --gadgets ./my-gadgets/
+
+# Interactive chat
+llmist chat
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `complete <prompt>` | One-shot LLM completion |
+| `agent <prompt>` | Run agent with gadgets |
+| `chat` | Interactive chat session |
+| `tui` | Launch terminal UI |
+
+## Using Gadgets
+
+Load gadgets from various sources:
+
+```bash
+# Local directory
+llmist agent "Do something" --gadgets ./gadgets/
+
+# npm package
+llmist agent "Search the web" --gadgets dhalsim/BrowseWeb
+
+# Git URL
+llmist agent "Process files" --gadgets github:user/repo
+```
+
+## Configuration
+
+Create a `llmist.toml` file for reusable configurations:
+
+```toml
+[agent]
+model = "sonnet"
+system = "You are a helpful assistant"
+
+[gadgets]
+paths = ["./gadgets"]
+external = ["dhalsim/BrowseWeb"]
+
+[display]
+markdown = true
+colors = true
+```
+
+Use with:
+
+```bash
+llmist agent "Do something" --config ./llmist.toml
+```
+
+## Terminal UI
+
+The TUI provides an interactive interface to browse execution history, inspect raw payloads, and debug agent runs:
+
+```bash
+llmist tui
+```
+
+## Documentation
+
+Full documentation at [llmist.dev/cli](https://llmist.dev/cli/getting-started/introduction/)
+
+- [Configuration Reference](https://llmist.dev/cli/configuration/toml-reference/)
+- [Writing Gadgets](https://llmist.dev/cli/gadgets/local-gadgets/)
+- [External Gadgets](https://llmist.dev/cli/gadgets/external-gadgets/)
+- [TUI Guide](https://llmist.dev/cli/tui/overview/)
+
+## Related Packages
+
+- [`llmist`](https://www.npmjs.com/package/llmist) - Core library
+- [`@llmist/testing`](https://www.npmjs.com/package/@llmist/testing) - Testing utilities
+
+## License
+
+MIT

package/dist/cli.js

@@ -79,7 +79,7 @@ import { Command, InvalidArgumentError as InvalidArgumentError2 } from "commande
 // package.json
 var package_default = {
   name: "@llmist/cli",
-  version: "9.1.1",
+  version: "9.2.0",
   description: "CLI for llmist - run LLM agents from the command line",
   type: "module",
   main: "dist/cli.js",
@@ -91,7 +91,8 @@ var package_default = {
     build: "tsup",
     typecheck: "tsc --noEmit",
     test: "bun test src",
-    clean: "rimraf dist"
+    clean: "rimraf dist",
+    postinstall: "node scripts/postinstall.js"
   },
   repository: {
     type: "git",
@@ -102,7 +103,8 @@ var package_default = {
     access: "public"
   },
   files: [
-    "dist"
+    "dist",
+    "scripts"
   ],
   keywords: [
     "llmist",
@@ -358,6 +360,84 @@ import { AbstractGadget } from "llmist";
 import { z as z2 } from "zod";
 import { createGadget as createGadget2 } from "llmist";
 
+// src/spawn.ts
+import { spawn as nodeSpawn } from "child_process";
+var isBun = typeof Bun !== "undefined";
+function adaptBunProcess(proc) {
+  return {
+    exited: proc.exited,
+    stdout: proc.stdout ?? null,
+    stderr: proc.stderr ?? null,
+    stdin: proc.stdin ? {
+      write(data) {
+        proc.stdin?.write(data);
+      },
+      end() {
+        proc.stdin?.end();
+      }
+    } : null,
+    kill: () => proc.kill()
+  };
+}
+function nodeStreamToReadableStream(nodeStream) {
+  if (!nodeStream) return null;
+  return new ReadableStream({
+    start(controller) {
+      nodeStream.on("data", (chunk) => {
+        controller.enqueue(new Uint8Array(chunk));
+      });
+      nodeStream.on("end", () => {
+        controller.close();
+      });
+      nodeStream.on("error", (err) => {
+        controller.error(err);
+      });
+    },
+    cancel() {
+      nodeStream.destroy();
+    }
+  });
+}
+function spawn(argv, options = {}) {
+  if (isBun) {
+    return adaptBunProcess(Bun.spawn(argv, options));
+  }
+  const [command, ...args] = argv;
+  const proc = nodeSpawn(command, args, {
+    cwd: options.cwd,
+    stdio: [
+      options.stdin === "pipe" ? "pipe" : options.stdin ?? "ignore",
+      options.stdout === "pipe" ? "pipe" : options.stdout ?? "ignore",
+      options.stderr === "pipe" ? "pipe" : options.stderr ?? "ignore"
+    ]
+  });
+  const exited = new Promise((resolve2, reject) => {
+    proc.on("exit", (code) => {
+      resolve2(code ?? 1);
+    });
+    proc.on("error", (err) => {
+      reject(err);
+    });
+  });
+  const stdin = proc.stdin ? {
+    write(data) {
+      proc.stdin?.write(data);
+    },
+    end() {
+      proc.stdin?.end();
+    }
+  } : null;
+  return {
+    exited,
+    stdout: nodeStreamToReadableStream(proc.stdout),
+    stderr: nodeStreamToReadableStream(proc.stderr),
+    stdin,
+    kill() {
+      proc.kill();
+    }
+  };
+}
+
 // src/builtins/filesystem/utils.ts
 import fs from "fs";
 import path from "path";
@@ -447,11 +527,16 @@ q`
     const validatedPath = validatePathIsWithinCwd(filePath);
     const safeCommands = filterDangerousCommands(commands);
     try {
-      const proc = Bun.spawn(["ed", validatedPath], {
+      const proc = spawn(["ed", validatedPath], {
         stdin: "pipe",
         stdout: "pipe",
         stderr: "pipe"
       });
+      if (!proc.stdin) {
+        return `path=${filePath}
+
+error: Failed to open stdin for ed process`;
+      }
       proc.stdin.write(`${safeCommands}
 `);
       proc.stdin.end();
@@ -771,7 +856,7 @@ var runCommand = createGadget6({
     }
     let timeoutId;
     try {
-      const proc = Bun.spawn(argv, {
+      const proc = spawn(argv, {
         cwd: workingDir,
         stdout: "pipe",
         stderr: "pipe"