@elizaos/plugin-shell 2.0.0-beta.1 → 2.0.3-beta.3

package/README.md

@@ -1,363 +1,111 @@
 # @elizaos/plugin-shell
 
-A comprehensive shell command execution plugin for ElizaOS with PTY support, background execution, session management, and security restrictions.
+Shell command execution plugin for elizaOS. Adds sandboxed shell access, PTY support, background session management, command approval, and shell history to an Eliza agent.
 
-**Key Features:**
+## What it does
 
-- 🔄 **PTY Support** - Run interactive terminal applications with full pseudo-terminal support
-- ⏱️ **Background Execution** - Long-running commands automatically background with session management
-- 📋 **Session Management** - Track, poll, and interact with running processes
-- 🔒 **Security First** - Directory restrictions, forbidden commands, and timeout protection
-- 📝 **Command History** - Per-conversation command tracking
+- Executes shell commands restricted to a configured directory (`SHELL_ALLOWED_DIRECTORY`).
+- Supports interactive terminal applications via PTY (`@lydell/node-pty`, optional).
+- Runs long commands in the background with named sessions; poll, send-keys, paste, and kill them later.
+- Maintains per-conversation command history with stdout/stderr/exit-code capture.
+- Provides the `SHELL_HISTORY` context provider so the agent always knows its cwd and recent commands.
+- Provides `ExecApprovalService` to gate commands through an allowlist and user-approval flow.
 
-**Available in three languages:**
-
-- 🟦 **TypeScript** - Primary implementation for Node.js (full feature support)
-- 🐍 **Python** - Native Python implementation
-- 🦀 **Rust** - High-performance Rust implementation
-
-## 🚨 TL;DR - Quick Setup
-
-**Just want your agent to execute commands? Here's the fastest path:**
-
-1. **Install the plugin**:
-
-   ```bash
-   cd your-eliza-project
-   bun add @elizaos/plugin-shell
-   ```
-
-2. **Create/update your `.env`**:
-
-   ```bash
-   SHELL_ALLOWED_DIRECTORY=/path/to/safe/directory
-   ```
-
-3. **Add to your character**:
-
-   ```typescript
-   const character = {
-     // ... other config
-     plugins: ["@elizaos/plugin-shell"],
-   };
-   ```
-
-4. **Run:** `bun start`
-
-⚠️ **Security note:** The agent can ONLY execute commands within `SHELL_ALLOWED_DIRECTORY` - choose wisely!
-
-## Features
-
-### Core Features
-- ✅ **Cross-platform support**: Works on Linux, macOS, and Windows
-- ✅ **Directory restriction**: Commands are restricted to a specified directory for safety
-- ✅ **Command filtering**: Configurable list of forbidden commands
-- ✅ **Timeout protection**: Automatic termination of long-running commands
-- ✅ **Command history**: Tracks command execution history per conversation
-- ✅ **File operation tracking**: Monitors file creation, modification, and deletion
-- ✅ **Shell context provider**: Provides command history and working directory to agent context
-- ✅ **Output capture**: Returns both stdout and stderr from executed commands
-- ✅ **Safety first**: Disabled by default, requires explicit enabling
-
-### Advanced Features (TypeScript)
-- ✅ **PTY Support**: Run interactive terminal applications (vim, htop, etc.) with `@lydell/node-pty`
-- ✅ **Background Execution**: Commands automatically background after configurable yield window
-- ✅ **Session Management**: Track running/finished sessions, poll output, send keys
-- ✅ **Process Control**: List, poll, log, write, send-keys, submit, paste, kill, clear, remove
-- ✅ **Output Truncation**: Configurable max output with intelligent truncation
-- ✅ **Platform-specific Shell**: Auto-detects shell (bash, sh, PowerShell on Windows)
-
-## Project Structure
-
-```
-plugin-shell/
-├── typescript/          # TypeScript implementation
-│   ├── actions/         # EXECUTE_COMMAND, CLEAR_SHELL_HISTORY
-│   ├── providers/       # SHELL_HISTORY provider
-│   ├── services/        # ShellService
-│   ├── utils/           # Path validation, security checks
-│   ├── types/           # Type definitions
-│   └── __tests__/       # Unit tests
-├── python/              # Python implementation
-│   ├── elizaos_plugin_shell/
-│   │   ├── service.py   # ShellService
-│   │   ├── path_utils.py
-│   │   └── types.py
-│   └── tests/           # Python tests
-├── rust/                # Rust implementation
-│   ├── src/
-│   │   ├── lib.rs
-│   │   ├── service.rs   # ShellService
-│   │   ├── path_utils.rs
-│   │   └── types.rs
-│   └── tests/           # Integration tests
-└── package.json         # NPM package config
-```
+The agent-facing `SHELL` action that exposes shell execution is in `@elizaos/plugin-coding-tools`, which consumes this plugin's services. Its `action` parameter (list/poll/kill/etc.) drives `ShellService.processAction()`.
 
 ## Installation
 
-### TypeScript (Node.js)
-
 ```bash
-# Using bun (recommended)
 bun add @elizaos/plugin-shell
-
-# Using npm
-npm install @elizaos/plugin-shell
 ```
-## Configuration
 
-Set the following environment variables:
+## Configuration
 
 ```bash
-# Set the allowed directory (commands can only run here)
-SHELL_ALLOWED_DIRECTORY=/home/user/safe-workspace
+# Required — commands cannot execute outside this directory
+SHELL_ALLOWED_DIRECTORY=/path/to/safe/workspace
+
+# Optional
+SHELL_TIMEOUT=30000                  # per-command timeout ms (simple executeCommand)
+SHELL_FORBIDDEN_COMMANDS=rm,mv       # comma-separated additions to the default blocklist
+SHELL_MAX_OUTPUT_CHARS=200000        # max captured output chars per session
+SHELL_BACKGROUND_MS=10000            # yield window before auto-backgrounding (ms)
+SHELL_ALLOW_BACKGROUND=true          # set "false" to disable background execution
+SHELL_JOB_TTL_MS=1800000            # finished session record TTL (ms)
+```
 
-# OPTIONAL: Set custom timeout in milliseconds (default: 30000)
-SHELL_TIMEOUT=60000
+`SHELL_ALLOWED_DIRECTORY` must point to an existing directory. The service throws at start if it is missing.
 
-# OPTIONAL: Add additional forbidden commands (comma-separated)
-SHELL_FORBIDDEN_COMMANDS=rm,mv,cp,chmod,chown,shutdown,reboot
+## Enabling
 
-# OPTIONAL: Maximum output characters to capture (default: 200000)
-SHELL_MAX_OUTPUT_CHARS=200000
+Auto-enabled when `config.features.shell` is truthy. Not available on iOS, `ELIZA_BUILD_VARIANT=store` builds, or Android unless `ELIZA_RUNTIME_MODE=local-yolo`.
 
-# OPTIONAL: Milliseconds before backgrounding (default: 10000)
-SHELL_BACKGROUND_MS=10000
+To enable explicitly in a character file:
 
-# OPTIONAL: Allow background execution (default: true)
-SHELL_ALLOW_BACKGROUND=true
+```typescript
+import shellPlugin from "@elizaos/plugin-shell";
 
-# OPTIONAL: Session record TTL in milliseconds (default: 1800000 = 30min)
-SHELL_JOB_TTL_MS=1800000
+const character = {
+  plugins: [shellPlugin],
+};
 ```
 
-## Usage Examples
+## Security
 
-### TypeScript
+- All commands execute within `SHELL_ALLOWED_DIRECTORY`. Path traversal and absolute paths outside the boundary are rejected.
+- A built-in blocklist prevents the most destructive commands (see `DEFAULT_FORBIDDEN_COMMANDS` in `utils/config.ts`).
+- Additional forbidden commands can be added via `SHELL_FORBIDDEN_COMMANDS`.
+- Commands time out automatically. Output is capped at `SHELL_MAX_OUTPUT_CHARS`.
+- `ExecApprovalService` can gate commands through an allowlist + user approval before execution.
+- Local execution is disabled in cloud mode (`isCloudExecutionMode`).
 
-```typescript
-import { shellPlugin, ShellService } from "@elizaos/plugin-shell";
+## Process actions
 
-// Use as a plugin
-const character = {
-  plugins: [shellPlugin],
-};
+Background sessions support these operations via `ShellService.processAction()`:
+
+| Action | Description |
+|---|---|
+| `list` | List all running and finished sessions |
+| `poll` | Drain new output from a running session |
+| `log` | Read session output with offset/limit pagination |
+| `write` | Write raw data to session stdin |
+| `send-keys` | Send terminal key sequences (arrows, ctrl+c, etc.) |
+| `submit` | Send carriage return (Enter) |
+| `paste` | Paste text with bracketed paste mode |
+| `kill` | Kill a running session |
+| `clear` | Remove a finished session record |
+| `remove` | Kill (if running) and remove a session |
+
+## Usage from code
 
-// Or use the service directly
-const service = new ShellService(runtime);
-const result = await service.executeCommand("ls -la", "conversation-123");
+```typescript
+import { ShellService } from "@elizaos/plugin-shell";
+
+// Simple synchronous execution
+const shellService = runtime.getService<ShellService>("shell");
+const result = await shellService.executeCommand("ls -la", conversationId);
 
-// Advanced: Use exec with PTY and background support
-const execResult = await service.exec("npm install", {
-  pty: true,         // Run with pseudo-terminal
-  background: false, // Or yieldMs: 5000 to auto-background after 5s
-  timeout: 300,      // 5 minute timeout
+// Advanced: PTY + background
+const execResult = await shellService.exec("bun install", {
+  pty: true,
+  yieldMs: 5000,   // background after 5 s if still running
+  timeout: 300,    // 5-minute hard timeout (seconds)
   workdir: "/project",
 });
 
 if (execResult.status === "running") {
-  console.log(`Background session: ${execResult.sessionId}`);
-  
-  // Poll for updates
-  const pollResult = await service.processAction({
+  // Poll later
+  const poll = await shellService.processAction({
     action: "poll",
     sessionId: execResult.sessionId,
   });
-  console.log(pollResult.message);
 }
-
-// Get the service from an Eliza agent runtime
-const shellService = runtime.getService<ShellService>("shell");
 ```
-## 📋 Available Actions
-
-### EXECUTE_COMMAND
-
-Executes ANY shell command within the allowed directory, including file operations.
-
-**Examples:**
-
-- `run ls -la` - List files with details
-- `execute npm test` - Run tests
-- `create a file called hello.txt` - Creates a new file
-- `check git status` - Show git repository status
-
-### MANAGE_PROCESS
-
-Manage running and finished shell sessions. Supports the following operations:
 
-| Action      | Description                                    |
-|-------------|------------------------------------------------|
-| `list`      | List all running and finished sessions         |
-| `poll`      | Get new output from a running session          |
-| `log`       | Get session output with offset/limit           |
-| `write`     | Write data to session stdin                    |
-| `send-keys` | Send terminal key sequences (arrows, ctrl, etc)|
-| `submit`    | Send carriage return (Enter)                   |
-| `paste`     | Paste text with bracketed paste mode           |
-| `kill`      | Kill a running session                         |
-| `clear`     | Clear a finished session record                |
-| `remove`    | Kill (if running) and remove session           |
-
-**Examples:**
-
-- `list all running processes`
-- `check session calm-harbor`
-- `kill the process swift-reef`
-- `send enter to session brisk-cove`
-
-### CLEAR_SHELL_HISTORY
-
-Clears the command history for the current conversation.
-
-**Examples:**
-
-- `clear my shell history`
-- `reset the terminal history`
-
-## 🧠 Shell History Provider
-
-The plugin includes a `SHELL_HISTORY` provider that makes the following information available to the agent:
-
-- **Recent Commands**: Last 10 executed commands with their outputs
-- **Current Working Directory**: The current directory within the allowed path
-- **Allowed Directory**: The configured safe directory boundary
-- **File Operations**: Recent file creation, modification, and deletion operations
-
-## 🔒 Security Considerations
-
-### Directory Restriction
-
-All commands execute within `SHELL_ALLOWED_DIRECTORY`:
-
-- Attempts to navigate outside are blocked
-- Absolute paths outside the boundary are rejected
-- `cd ..` stops at the allowed directory root
-
-### Forbidden Commands
-
-By default, these potentially dangerous commands are blocked:
-
-- **Destructive**: `rm -rf /`, `rmdir`
-- **Permission changes**: `chmod 777`, `chown`, `chgrp`
-- **System operations**: `shutdown`, `reboot`, `halt`, `poweroff`
-- **Process control**: `kill -9`, `killall`, `pkill`
-- **User management**: `sudo rm -rf`, `su`, `passwd`, `useradd`, `userdel`
-- **Disk operations**: `format`, `fdisk`, `mkfs`, `dd if=/dev/zero`, `shred`
-
-### Additional Safety Features
-
-- **No Shell Expansion**: Commands execute without dangerous shell interpretation
-- **Timeout Protection**: Commands auto-terminate after timeout
-- **Command History**: All executed commands are logged for audit
-- **Path Traversal Protection**: Blocks `../` and similar patterns
-
-## 🧪 Development & Testing
-
-### TypeScript
+## Development
 
 ```bash
-cd typescript
-bun run build.ts     # Build
-npx vitest           # Run tests
+bun run --cwd plugins/plugin-shell build    # build dist/
+bun run --cwd plugins/plugin-shell test     # vitest
+bun run --cwd plugins/plugin-shell dev      # hot-reload build
 ```
-### All Languages
-
-```bash
-# From plugin root
-bun run build          # Build TypeScript
-bun run build:python   # Build Python
-bun run build:rust     # Build Rust
-bun run test           # Test TypeScript
-bun run test:python    # Test Python
-bun run test:rust      # Test Rust
-```
-
-## 📖 API Reference
-
-### CommandResult
-
-| Field        | Type                | Description                               |
-| ------------ | ------------------- | ----------------------------------------- |
-| `success`    | boolean             | Whether the command executed successfully |
-| `stdout`     | string              | Standard output from the command          |
-| `stderr`     | string              | Standard error output                     |
-| `exitCode`   | number \| null      | Exit code of the command                  |
-| `error`      | string \| undefined | Error message if command failed           |
-| `executedIn` | string              | Directory where command was executed      |
-
-### FileOperation
-
-| Field             | Type                | Description                                                        |
-| ----------------- | ------------------- | ------------------------------------------------------------------ |
-| `type`            | FileOperationType   | Type of operation (create, write, read, delete, mkdir, move, copy) |
-| `target`          | string              | Target file/directory path                                         |
-| `secondaryTarget` | string \| undefined | Secondary target for move/copy                                     |
-
-### ShellConfig
-
-| Field                   | Type     | Default  | Description                          |
-| ----------------------- | -------- | -------- | ------------------------------------ |
-| `enabled`               | boolean  | false    | Whether shell is enabled             |
-| `allowedDirectory`      | string   | cwd      | Directory to restrict commands to    |
-| `timeout`               | number   | 30000    | Timeout in milliseconds              |
-| `forbiddenCommands`     | string[] | [...]    | List of forbidden commands           |
-| `maxOutputChars`        | number   | 200000   | Max output characters to capture     |
-| `pendingMaxOutputChars` | number   | 200000   | Max pending output per stream        |
-| `defaultBackgroundMs`   | number   | 10000    | Default background yield window      |
-| `allowBackground`       | boolean  | true     | Allow background execution           |
-
-### ProcessSession
-
-| Field                 | Type                    | Description                           |
-| --------------------- | ----------------------- | ------------------------------------- |
-| `id`                  | string                  | Unique session identifier (slug)      |
-| `command`             | string                  | The executed command                  |
-| `pid`                 | number \| undefined     | Process ID                            |
-| `startedAt`           | number                  | Start timestamp                       |
-| `cwd`                 | string \| undefined     | Working directory                     |
-| `aggregated`          | string                  | Accumulated output                    |
-| `tail`                | string                  | Last 2000 chars of output             |
-| `exited`              | boolean                 | Whether process has exited            |
-| `exitCode`            | number \| null          | Exit code (if exited)                 |
-| `exitSignal`          | string \| number \| null| Exit signal (if killed)               |
-| `truncated`           | boolean                 | Whether output was truncated          |
-| `backgrounded`        | boolean                 | Whether running in background         |
-
-### ExecResult
-
-```typescript
-type ExecResult =
-  | { status: "running"; sessionId: string; pid?: number; startedAt: number; cwd?: string; tail?: string }
-  | { status: "completed" | "failed"; exitCode: number | null; durationMs: number; aggregated: string; cwd?: string; timedOut?: boolean; reason?: string }
-```
-
-### ExecuteOptions
-
-| Field           | Type                        | Description                           |
-| --------------- | --------------------------- | ------------------------------------- |
-| `workdir`       | string                      | Working directory                     |
-| `env`           | Record<string, string>      | Additional environment variables      |
-| `yieldMs`       | number                      | Yield to background after this time   |
-| `background`    | boolean                     | Run immediately in background         |
-| `timeout`       | number                      | Timeout in seconds                    |
-| `pty`           | boolean                     | Use pseudo-terminal                   |
-| `conversationId`| string                      | Conversation ID for history tracking  |
-| `scopeKey`      | string                      | Scope key for session isolation       |
-| `sessionKey`    | string                      | Session key for notifications         |
-| `notifyOnExit`  | boolean                     | Notify on background exit             |
-| `onUpdate`      | (session) => void           | Callback for output updates           |
-
-## 🤝 Contributing
-
-Contributions are welcome! Please ensure:
-
-1. All three language implementations stay in feature parity
-2. Tests pass for all languages
-3. Follow the code style of each language
-4. Update documentation as needed
-
-## 📝 License
-
-MIT - See [LICENSE](./LICENSE) for details.

package/auto-enable.ts

@@ -7,7 +7,7 @@
 import type { PluginAutoEnableContext } from "@elizaos/core";
 
 function isFeatureEnabled(config: PluginAutoEnableContext["config"], key: string): boolean {
-  const f = (config?.features as Record<string, unknown> | undefined)?.[key];
+  const f = (config.features as Record<string, unknown> | undefined)?.[key];
   if (f === true) return true;
   if (f && typeof f === "object" && f !== null) {
     return (f as Record<string, unknown>).enabled !== false;
@@ -15,7 +15,23 @@ function isFeatureEnabled(config: PluginAutoEnableContext["config"], key: string
   return false;
 }
 
+function terminalSupportedByEnv(ctx: PluginAutoEnableContext): boolean {
+  const env = ctx.env;
+  const variant = (env.ELIZA_BUILD_VARIANT ?? "").trim().toLowerCase();
+  if (variant === "store") return false;
+
+  const platform = env.ELIZA_PLATFORM?.trim().toLowerCase();
+  const mobile =
+    platform === "android" || platform === "ios" || Boolean(env.ANDROID_ROOT || env.ANDROID_DATA);
+  if (!mobile) return true;
+
+  const mode = (env.ELIZA_RUNTIME_MODE ?? env.RUNTIME_MODE ?? env.LOCAL_RUNTIME_MODE ?? "")
+    .trim()
+    .toLowerCase();
+  return platform === "android" && mode === "local-yolo";
+}
+
 /** Enable when `config.features.shell` is truthy / not explicitly disabled. */
 export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
-  return isFeatureEnabled(ctx.config, "shell");
+  return isFeatureEnabled(ctx.config, "shell") && terminalSupportedByEnv(ctx);
 }

package/dist/approvals/allowlist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../approvals/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAElB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,OAAO,EACP,YAAY,EACb,MAAM,SAAS,CAAC;AAgCjB;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAmED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAmC7E;AASD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CA8C7D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAyCjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAoB3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CA8BnD;AAsBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACzC,qBAAqB,CAuBvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAoDxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACnC,kBAAkB,GAAG,IAAI,CAoB3B;AAqFD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CA+BT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAwCT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAO1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAGtD"}
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../approvals/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAElB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,OAAO,EACP,YAAY,EACb,MAAM,SAAS,CAAC;AA0BjB;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAmED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAmC7E;AASD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,CA8C7D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAyCjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAoB3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CA8BnD;AAsBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACzC,qBAAqB,CAuBvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAoDxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACnC,kBAAkB,GAAG,IAAI,CAoB3B;AAqFD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CA+BT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAwCT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAO1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAGtD"}

package/dist/auto-enable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-enable.d.ts","sourceRoot":"","sources":["../auto-enable.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAW7D,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAElE"}
+{"version":3,"file":"auto-enable.d.ts","sourceRoot":"","sources":["../auto-enable.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AA2B7D,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAElE"}

package/dist/generated/specs/specs.d.ts

@@ -19,21 +19,11 @@ export type ProviderDoc = {
 };
 export declare const coreActionsSpec: {
     readonly version: "1.0.0";
-    readonly actions: readonly [{
-        readonly name: "CLEAR_SHELL_HISTORY";
-        readonly description: "Clears the recorded history of shell commands for the current conversation";
-        readonly similes: readonly ["RESET_SHELL", "CLEAR_TERMINAL", "CLEAR_HISTORY", "RESET_HISTORY"];
-        readonly parameters: readonly [];
-    }];
+    readonly actions: readonly [];
 };
 export declare const allActionsSpec: {
     readonly version: "1.0.0";
-    readonly actions: readonly [{
-        readonly name: "CLEAR_SHELL_HISTORY";
-        readonly description: "Clears the recorded history of shell commands for the current conversation";
-        readonly similes: readonly ["RESET_SHELL", "CLEAR_TERMINAL", "CLEAR_HISTORY", "RESET_HISTORY"];
-        readonly parameters: readonly [];
-    }];
+    readonly actions: readonly [];
 };
 export declare const coreProvidersSpec: {
     readonly version: "1.0.0";

package/dist/generated/specs/specs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../generated/specs/specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;CAUlB,CAAC;AACX,eAAO,MAAM,cAAc;;;;;;;;CAUjB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;;;;;CAUpB,CAAC;AACX,eAAO,MAAM,gBAAgB;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAA4B,CAAC;AAC5E,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAA2B,CAAC;AAC1E,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAgC,CAAC;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAA+B,CAAC"}
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../generated/specs/specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;;;;;CAUpB,CAAC;AACX,eAAO,MAAM,gBAAgB;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAA4B,CAAC;AAC5E,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAA2B,CAAC;AAC1E,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAgC,CAAC;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAA+B,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import type { Plugin } from "@elizaos/core";
 export declare const shellPlugin: Plugin;
 export default shellPlugin;
-export { clearHistory } from "./actions/clearHistory";
 export { addAllowlistEntry, analyzeShellCommand, type CommandCheckResult, type CommandResolution, DEFAULT_SAFE_BINS, EXEC_APPROVAL_DEFAULTS, type ExecAllowlistAnalysis, type ExecAllowlistEntry, type ExecAllowlistEvaluation, type ExecApprovalDecision, type ExecApprovalRequest, type ExecApprovalResult, ExecApprovalService, type ExecApprovalsAgent, type ExecApprovalsDefaults, type ExecApprovalsFile, type ExecApprovalsResolved, type ExecApprovalsSnapshot, type ExecAsk, type ExecCommandAnalysis, type ExecCommandSegment, type ExecHost, type ExecSecurity, ensureApprovals, evaluateExecAllowlist, evaluateShellAllowlist, getApprovalFilePath, getApprovalSocketPath, isSafeBinUsage, loadApprovals, matchAllowlist, maxAsk, minSecurity, normalizeApprovals, normalizeSafeBins, readApprovalsSnapshot, recordAllowlistUse, requiresExecApproval, resolveApprovals, resolveApprovalsFromFile, resolveCommandFromArgv, resolveCommandResolution, resolveSafeBins, saveApprovals, } from "./approvals";
 export { shellHistoryProvider } from "./providers/shellHistoryProvider";
 export { addSession, appendOutput, clearFinished, createSessionSlug, deleteSession, drainSession, getFinishedSession, getSession, listFinishedSessions, listRunningSessions, markBackgrounded, markExited, resetProcessRegistryForTests, setJobTtlMs, tail, trimWithCap, } from "./services/processRegistry";
@@ -10,4 +9,5 @@ export type { CommandHistoryEntry, CommandResult, ExecResult, ExecuteOptions, Fi
 export { DEFAULT_FORBIDDEN_COMMANDS, extractBaseCommand, isForbiddenCommand, isSafeCommand, loadShellConfig, validatePath, } from "./utils";
 export { BRACKETED_PASTE_END, BRACKETED_PASTE_START, buildCursorPositionResponse, encodeKeySequence, encodePaste, type KeyEncodingRequest, type KeyEncodingResult, stripDsrRequests, } from "./utils/ptyKeys";
 export { chunkString, clampNumber, coerceEnv, deriveSessionName, formatDuration, formatSpawnError, getShellConfig, killProcessTree, killSession, pad, readEnvInt, resolveWorkdir, type SpawnFallback, type SpawnWithFallbackResult, sanitizeBinaryOutput, sliceLogLines, sliceUtf16Safe, spawnWithFallback, truncateMiddle, } from "./utils/shellUtils";
+export { detectTerminalCapabilities, formatTerminalCapabilities, isAndroidRuntime, missingTerminalToolForCommand, missingToolMessage, resolveExecutable, resolveTerminalShell, type ShellResolution, TERMINAL_TOOL_NAMES, type TerminalToolName, type ToolCapability, } from "./utils/terminalCapabilities";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAM5C,eAAO,MAAM,WAAW,EAAE,MAgBzB,CAAC;AAEF,eAAe,WAAW,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,cAAc,EACd,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,4BAA4B,EAC5B,WAAW,EACX,IAAI,EACJ,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACX,GAAG,EACH,UAAU,EACV,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAkB5C,eAAO,MAAM,WAAW,EAAE,MAuBzB,CAAC;AAEF,eAAe,WAAW,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,cAAc,EACd,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,4BAA4B,EAC5B,WAAW,EACX,IAAI,EACJ,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACX,GAAG,EACH,UAAU,EACV,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,8BAA8B,CAAC"}