@elizaos/plugin-shell 2.0.3-beta.2 → 2.0.3-beta.3

package/dist/utils/shellUtils.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Shell Utilities - Platform-specific shell configuration and helpers
+ * Ported from otto shell-utils.ts and bash-tools.shared.ts
+ */
+import type { ChildProcess, ChildProcessWithoutNullStreams, SpawnOptions } from "node:child_process";
+import { spawn } from "node:child_process";
+/**
+ * Get shell configuration for the current platform
+ */
+export declare function getShellConfig(): {
+    shell: string;
+    args: string[];
+};
+/**
+ * Sanitize binary output by removing control characters
+ */
+export declare function sanitizeBinaryOutput(text: string): string;
+/**
+ * Kill a process tree (cross-platform)
+ */
+export declare function killProcessTree(pid: number): void;
+/**
+ * Kill a session's process
+ */
+export declare function killSession(session: {
+    pid?: number;
+    child?: ChildProcessWithoutNullStreams;
+}): void;
+/**
+ * Coerce environment object to Record<string, string>
+ */
+export declare function coerceEnv(env?: NodeJS.ProcessEnv | Record<string, string>): Record<string, string>;
+/**
+ * Resolve working directory with fallback
+ */
+export declare function resolveWorkdir(workdir: string, warnings: string[]): string;
+/**
+ * Clamp a number to a range with a default value
+ */
+export declare function clampNumber(value: number | undefined, defaultValue: number, min: number, max: number): number;
+/**
+ * Read an environment variable as an integer
+ */
+export declare function readEnvInt(key: string): number | undefined;
+/**
+ * Chunk a string into smaller pieces
+ */
+export declare function chunkString(input: string, limit?: number): string[];
+/**
+ * Safely slice a string respecting UTF-16 surrogate pairs
+ */
+export declare function sliceUtf16Safe(str: string, start: number, end?: number): string;
+/**
+ * Truncate string in the middle with ellipsis
+ */
+export declare function truncateMiddle(str: string, max: number): string;
+/**
+ * Slice log lines with optional offset and limit
+ */
+export declare function sliceLogLines(text: string, offset?: number, limit?: number): {
+    slice: string;
+    totalLines: number;
+    totalChars: number;
+};
+/**
+ * Derive a session name from a command
+ */
+export declare function deriveSessionName(command: string): string | undefined;
+/**
+ * Format duration in human-readable format
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Pad a string to a minimum width
+ */
+export declare function pad(str: string, width: number): string;
+export type SpawnFallback = {
+    label: string;
+    options: SpawnOptions;
+};
+export type SpawnWithFallbackResult = {
+    child: ChildProcess;
+    usedFallback: boolean;
+    fallbackLabel?: string;
+};
+type SpawnWithFallbackParams = {
+    argv: string[];
+    options: SpawnOptions;
+    fallbacks?: SpawnFallback[];
+    spawnImpl?: typeof spawn;
+    retryCodes?: string[];
+    onFallback?: (err: unknown, fallback: SpawnFallback) => void;
+};
+/**
+ * Format a spawn error for display
+ */
+export declare function formatSpawnError(err: unknown): string;
+/**
+ * Spawn a process with fallback options on certain error codes
+ */
+export declare function spawnWithFallback(params: SpawnWithFallbackParams): Promise<SpawnWithFallbackResult>;
+export {};
+//# sourceMappingURL=shellUtils.d.ts.map

package/dist/utils/shellUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellUtils.d.ts","sourceRoot":"","sources":["../../utils/shellUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/terminalCapabilities.d.ts

@@ -0,0 +1,30 @@
+export declare const TERMINAL_TOOL_NAMES: readonly ["sh", "git", "rg", "bun", "acpx", "codex", "claude", "opencode"];
+export type TerminalToolName = (typeof TERMINAL_TOOL_NAMES)[number];
+export interface ToolCapability {
+    name: TerminalToolName;
+    path?: string;
+    available: boolean;
+}
+export interface ShellResolution {
+    shell: string;
+    args: string[];
+    available: boolean;
+    source: "env:CODING_TOOLS_SHELL" | "env:SHELL" | "candidate" | "fallback";
+    warning?: string;
+}
+export type TerminalUnsupportedReason = "store_build" | "vanilla_mobile" | "not_local_yolo" | "missing_shell";
+export interface TerminalSupport {
+    supported: boolean;
+    reason?: TerminalUnsupportedReason;
+    message?: string;
+}
+export declare function isAndroidRuntime(): boolean;
+export declare function isAospTerminalRuntime(): boolean;
+export declare function resolveExecutable(nameOrPath: string): string | undefined;
+export declare function resolveTerminalShell(): ShellResolution;
+export declare function detectTerminalCapabilities(): ToolCapability[];
+export declare function formatTerminalCapabilities(capabilities?: ToolCapability[]): string;
+export declare function missingToolMessage(tool: TerminalToolName): string;
+export declare function missingTerminalToolForCommand(command: string): TerminalToolName | undefined;
+export declare function detectTerminalSupport(): TerminalSupport;
+//# sourceMappingURL=terminalCapabilities.d.ts.map

package/dist/utils/terminalCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalCapabilities.d.ts","sourceRoot":"","sources":["../../utils/terminalCapabilities.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,4EAStB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,wBAAwB,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AA2BD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAwBD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxE;AAUD,wBAAgB,oBAAoB,IAAI,eAAe,CAyCtD;AAED,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CAiB7D;AAED,wBAAgB,0BAA0B,CAAC,YAAY,mBAA+B,GAAG,MAAM,CAQ9F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAQjE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAa3F;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAyCvD"}

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAGA,wBAaG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-shell",
-  "version": "2.0.3-beta.2",
+  "version": "2.0.3-beta.3",
   "description": "Shell history and observability plugin for ElizaOS",
   "type": "module",
   "main": "dist/index.js",
@@ -28,6 +28,7 @@
     }
   },
   "files": [
+    "registry-entry.json",
     "dist",
     "auto-enable.ts"
   ],
@@ -50,8 +51,8 @@
   "author": "elizaOS",
   "license": "MIT",
   "dependencies": {
-    "@elizaos/core": "2.0.3-beta.2",
-    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.3",
+    "@elizaos/shared": "2.0.3-beta.3",
     "cross-spawn": "^7.0.6",
     "zod": "^4.4.3"
   },
@@ -148,5 +149,5 @@
       "node": "Default export (Node.js)"
     }
   },
-  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+  "gitHead": "f54b0f4eaed317d59fa7dbcdce20f4cdb0734420"
 }

package/registry-entry.json

@@ -0,0 +1,94 @@
+{
+  "id": "shell",
+  "name": "Shell",
+  "description": "A shell plugin for ElizaOS. USE AT YOUR OWN RISK. THIS GIVES AI FULL ACCESS TO THE HOST MACHINE",
+  "npmName": "@elizaos/plugin-shell",
+  "version": "2.0.0-beta.0",
+  "source": "bundled",
+  "tags": ["shell", "terminal", "command", "history"],
+  "config": {
+    "SHELL_ALLOWED_DIRECTORY": {
+      "type": "file-path",
+      "required": true,
+      "sensitive": false,
+      "label": "Allowed Directory",
+      "help": "The directory that shell commands are restricted to. Commands cannot execute outside this directory.",
+      "advanced": false
+    },
+    "SHELL_TIMEOUT": {
+      "type": "number",
+      "required": false,
+      "sensitive": false,
+      "default": "30000",
+      "label": "Timeout",
+      "help": "Maximum command execution timeout in milliseconds",
+      "advanced": false,
+      "min": 0,
+      "unit": "ms"
+    },
+    "SHELL_FORBIDDEN_COMMANDS": {
+      "type": "string",
+      "required": false,
+      "sensitive": false,
+      "label": "Forbidden Commands",
+      "help": "Comma-separated list of additional forbidden commands",
+      "advanced": false
+    },
+    "SHELL_MAX_OUTPUT_CHARS": {
+      "type": "number",
+      "required": false,
+      "sensitive": false,
+      "default": "200000",
+      "label": "Max Output Chars",
+      "help": "Maximum output characters to capture from commands",
+      "advanced": false
+    },
+    "SHELL_BACKGROUND_MS": {
+      "type": "number",
+      "required": false,
+      "sensitive": false,
+      "default": "10000",
+      "label": "Background Ms",
+      "help": "Default milliseconds to wait before backgrounding commands",
+      "advanced": false,
+      "min": 0,
+      "unit": "ms"
+    },
+    "SHELL_ALLOW_BACKGROUND": {
+      "type": "boolean",
+      "required": false,
+      "sensitive": false,
+      "default": "True",
+      "label": "Allow Background",
+      "help": "Whether to allow background command execution",
+      "advanced": false
+    },
+    "SHELL_JOB_TTL_MS": {
+      "type": "number",
+      "required": false,
+      "sensitive": false,
+      "default": "1800000",
+      "label": "Job Ttl Ms",
+      "help": "Time-to-live for finished session records in milliseconds",
+      "advanced": false,
+      "min": 0,
+      "unit": "ms"
+    }
+  },
+  "render": {
+    "visible": true,
+    "pinTo": [],
+    "style": "card",
+    "icon": "Shell",
+    "group": "devtools",
+    "groupOrder": 5,
+    "actions": ["enable", "configure"]
+  },
+  "resources": {
+    "homepage": "https://github.com/elizaos/eliza#readme",
+    "repository": "https://github.com/elizaos/eliza"
+  },
+  "dependsOn": [],
+  "kind": "plugin",
+  "subtype": "devtools"
+}