@elizaos/plugin-shell 1.2.0 → 2.0.0-alpha.10

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { default, shellHistoryProvider } from "./shellHistoryProvider";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/providers/shellHistoryProvider.d.ts

@@ -0,0 +1,4 @@
+import { type Provider } from "@elizaos/core";
+export declare const shellHistoryProvider: Provider;
+export default shellHistoryProvider;
+//# sourceMappingURL=shellHistoryProvider.d.ts.map

package/dist/providers/shellHistoryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellHistoryProvider.d.ts","sourceRoot":"","sources":["../../providers/shellHistoryProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,KAAK,QAAQ,EAEb,MAAM,eAAe,CAAC;AAUvB,eAAO,MAAM,oBAAoB,EAAE,QAuHlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/providers/terminalUsage.d.ts

@@ -0,0 +1,3 @@
+import { type Provider } from "@elizaos/core";
+export declare const terminalUsageProvider: Provider;
+//# sourceMappingURL=terminalUsage.d.ts.map

package/dist/providers/terminalUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalUsage.d.ts","sourceRoot":"","sources":["../../providers/terminalUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,QAAQ,EAGhB,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,qBAAqB,EAAE,QAqDnC,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+export { addSession, appendOutput, clearFinished, createSessionSlug, deleteSession, drainSession, getFinishedSession, getSession, listFinishedSessions, listRunningSessions, markBackgrounded, markExited, resetProcessRegistryForTests, setJobTtlMs, tail, trimWithCap, } from "./processRegistry";
+export { ShellService } from "./shellService";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,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,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services/processRegistry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Process Registry - Manages running and finished shell sessions
+ * Ported from otto bash-process-registry.ts
+ */
+import type { FinishedSession, ProcessSession, ProcessStatus } from "../types";
+export declare function createSessionSlug(isTaken?: (id: string) => boolean): string;
+export declare function addSession(session: ProcessSession): void;
+export declare function getSession(id: string): ProcessSession | undefined;
+export declare function getFinishedSession(id: string): FinishedSession | undefined;
+export declare function deleteSession(id: string): void;
+export declare function tail(text: string, max?: number): string;
+export declare function trimWithCap(text: string, max: number): string;
+export declare function appendOutput(session: ProcessSession, stream: "stdout" | "stderr", chunk: string): void;
+export declare function drainSession(session: ProcessSession): {
+    stdout: string;
+    stderr: string;
+};
+export declare function markExited(session: ProcessSession, exitCode: number | null, exitSignal: NodeJS.Signals | number | null, status: ProcessStatus): void;
+export declare function markBackgrounded(session: ProcessSession): void;
+export declare function listRunningSessions(): ProcessSession[];
+export declare function listFinishedSessions(): FinishedSession[];
+export declare function clearFinished(): void;
+export declare function resetProcessRegistryForTests(): void;
+export declare function setJobTtlMs(value?: number): void;
+//# sourceMappingURL=processRegistry.d.ts.map

package/dist/services/processRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRegistry.d.ts","sourceRoot":"","sources":["../../services/processRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA4I/E,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CA8B3E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAGxD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE1E;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG9C;AAoCD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAKrD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAgB,YAAY,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,KAAK,EAAE,MAAM,GACX,IAAI,CAoCN;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf,CAQA;AAwBD,wBAAgB,UAAU,CACzB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,EAC1C,MAAM,EAAE,aAAa,GACnB,IAAI,CAMN;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAEtD;AAED,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAInD;AAED,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAOhD"}

package/dist/services/shellService.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Enhanced Shell Service with PTY, background execution, and session management
+ * Migrated from otto bash-tools.exec.ts, bash-tools.process.ts
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import type { CommandHistoryEntry, CommandResult, ExecResult, ExecuteOptions, FinishedSession, ProcessActionParams, ProcessSession, ShellConfig } from "../types";
+export declare class ShellService extends Service {
+    static serviceType: string;
+    private shellConfig;
+    private currentDirectory;
+    private commandHistory;
+    private maxHistoryPerConversation;
+    private scopeKey?;
+    constructor(runtime: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<ShellService>;
+    stop(): Promise<void>;
+    get capabilityDescription(): string;
+    /**
+     * Set scope key for session isolation
+     */
+    setScopeKey(scopeKey: string): void;
+    /**
+     * Simple command execution (original API for backward compatibility)
+     */
+    executeCommand(command: string, conversationId?: string): Promise<CommandResult>;
+    /**
+     * Enhanced command execution with PTY, background support, and session management
+     * This is the main execution method that supports all advanced features
+     */
+    exec(command: string, options?: ExecuteOptions): Promise<ExecResult>;
+    /**
+     * Process management action handler
+     * Supports: list, poll, log, write, send-keys, submit, paste, kill, clear, remove
+     */
+    processAction(params: ProcessActionParams): Promise<{
+        success: boolean;
+        message: string;
+        data?: Record<string, unknown>;
+    }>;
+    /**
+     * List all running sessions
+     */
+    listRunningSessions(): ProcessSession[];
+    /**
+     * List all finished sessions
+     */
+    listFinishedSessions(): FinishedSession[];
+    /**
+     * Get a specific session by ID
+     */
+    getSession(id: string): ProcessSession | undefined;
+    /**
+     * Get a specific finished session by ID
+     */
+    getFinishedSession(id: string): FinishedSession | undefined;
+    /**
+     * Kill a session by ID
+     */
+    killSessionById(id: string): boolean;
+    /**
+     * Get command history for a conversation
+     */
+    getCommandHistory(conversationId: string, limit?: number): CommandHistoryEntry[];
+    /**
+     * Clear command history for a conversation
+     */
+    clearCommandHistory(conversationId: string): void;
+    /**
+     * Get current working directory
+     */
+    getCurrentDirectory(_conversationId?: string): string;
+    /**
+     * Set current working directory
+     */
+    setCurrentDirectory(directory: string): boolean;
+    /**
+     * Get allowed directory
+     */
+    getAllowedDirectory(): string;
+    /**
+     * Get shell configuration
+     */
+    getShellConfig(): ShellConfig;
+    private handleCdCommand;
+    private runCommandSimple;
+    private runExecProcess;
+    private addToHistory;
+    private detectFileOperations;
+    private resolvePath;
+}
+//# sourceMappingURL=shellService.d.ts.map

package/dist/services/shellService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellService.d.ts","sourceRoot":"","sources":["../../services/shellService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,cAAc,EAGd,eAAe,EACf,mBAAmB,EACnB,cAAc,EAGd,WAAW,EACX,MAAM,UAAU,CAAC;AA8DlB,qBAAa,YAAa,SAAQ,OAAO;IACxC,OAAc,WAAW,SAAW;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,yBAAyB,CAAO;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,OAAO,EAAE,aAAa;WAOrB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACG,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IAoHzB;;;OAGG;IACG,IAAI,CACT,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAoLtB;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QACzD,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;IAqbF;;OAEG;IACH,mBAAmB,IAAI,cAAc,EAAE;IAOvC;;OAEG;IACH,oBAAoB,IAAI,eAAe,EAAE;IAOzC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAOlD;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAO3D;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQpC;;OAEG;IACH,iBAAiB,CAChB,cAAc,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,GACZ,mBAAmB,EAAE;IAQxB;;OAEG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAKjD;;OAEG;IACH,mBAAmB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAa/C;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,cAAc,IAAI,WAAW;YAMf,eAAe;YAyCf,gBAAgB;YA6FhB,cAAc;IAoV5B,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,oBAAoB;IAgD5B,OAAO,CAAC,WAAW;CAMnB"}

package/dist/types/index.d.ts

@@ -0,0 +1,144 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
+export interface CommandResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    error?: string;
+    executedIn: string;
+}
+export interface CommandHistoryEntry {
+    command: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    timestamp: number;
+    workingDirectory: string;
+    fileOperations?: FileOperation[];
+}
+export type FileOperationType = "create" | "write" | "read" | "delete" | "mkdir" | "move" | "copy";
+export interface FileOperation {
+    type: FileOperationType;
+    target: string;
+    secondaryTarget?: string;
+}
+export interface ShellConfig {
+    enabled: boolean;
+    allowedDirectory: string;
+    timeout: number;
+    forbiddenCommands: string[];
+    maxOutputChars: number;
+    pendingMaxOutputChars: number;
+    defaultBackgroundMs: number;
+    allowBackground: boolean;
+}
+export type ProcessStatus = "running" | "completed" | "failed" | "killed";
+export type SessionStdin = {
+    write: (data: string, cb?: (err?: Error | null) => void) => void;
+    end: () => void;
+    destroyed?: boolean;
+};
+export interface ProcessSession {
+    id: string;
+    command: string;
+    scopeKey?: string;
+    sessionKey?: string;
+    notifyOnExit?: boolean;
+    exitNotified?: boolean;
+    child?: ChildProcessWithoutNullStreams;
+    stdin?: SessionStdin;
+    pid?: number;
+    startedAt: number;
+    cwd?: string;
+    maxOutputChars: number;
+    pendingMaxOutputChars?: number;
+    totalOutputChars: number;
+    pendingStdout: string[];
+    pendingStderr: string[];
+    pendingStdoutChars: number;
+    pendingStderrChars: number;
+    aggregated: string;
+    tail: string;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | number | null;
+    exited: boolean;
+    truncated: boolean;
+    backgrounded: boolean;
+}
+export interface FinishedSession {
+    id: string;
+    command: string;
+    scopeKey?: string;
+    startedAt: number;
+    endedAt: number;
+    cwd?: string;
+    status: ProcessStatus;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | number | null;
+    aggregated: string;
+    tail: string;
+    truncated: boolean;
+    totalOutputChars: number;
+}
+export interface ExecuteOptions {
+    workdir?: string;
+    env?: Record<string, string>;
+    yieldMs?: number;
+    background?: boolean;
+    timeout?: number;
+    pty?: boolean;
+    conversationId?: string;
+    scopeKey?: string;
+    sessionKey?: string;
+    notifyOnExit?: boolean;
+    onUpdate?: (session: ProcessSession) => void;
+}
+export 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;
+};
+export type ProcessAction = "list" | "poll" | "log" | "write" | "send-keys" | "submit" | "paste" | "kill" | "clear" | "remove";
+export interface ProcessActionParams {
+    action: ProcessAction;
+    sessionId?: string;
+    data?: string;
+    keys?: string[];
+    hex?: string[];
+    literal?: string;
+    text?: string;
+    bracketed?: boolean;
+    eof?: boolean;
+    offset?: number;
+    limit?: number;
+}
+export type PtyExitEvent = {
+    exitCode: number;
+    signal?: number;
+};
+export type PtyListener<T> = (event: T) => void;
+export type PtyHandle = {
+    pid: number;
+    write: (data: string | Buffer) => void;
+    onData: (listener: PtyListener<string>) => void;
+    onExit: (listener: PtyListener<PtyExitEvent>) => void;
+};
+export type PtySpawn = (file: string, args: string[] | string, options: {
+    name?: string;
+    cols?: number;
+    rows?: number;
+    cwd?: string;
+    env?: Record<string, string>;
+}) => PtyHandle;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,4 @@
+import type { ShellConfig } from "../types";
+export declare const DEFAULT_FORBIDDEN_COMMANDS: readonly string[];
+export declare function loadShellConfig(): ShellConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAa5C,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EA0B9C,CAAC;AAEX,wBAAgB,eAAe,IAAI,WAAW,CAqE7C"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { DEFAULT_FORBIDDEN_COMMANDS, loadShellConfig } from "./config";
+export { extractBaseCommand, isForbiddenCommand, isSafeCommand, validatePath, } from "./pathUtils";
+export { attachChildProcessBridge, type ChildProcessBridgeOptions, CommandLane, type CommandLane as CommandLaneType, type CommandOptions, clearCommandLane, enqueueCommand, enqueueCommandInLane, getQueueSize, getTotalQueueSize, runCommandWithTimeout, runExec, type SpawnResult, setCommandLaneConcurrency, } from "./processQueue";
+export { BRACKETED_PASTE_END, BRACKETED_PASTE_START, buildCursorPositionResponse, encodeKeySequence, encodePaste, type KeyEncodingRequest, type KeyEncodingResult, stripDsrRequests, } from "./ptyKeys";
+export { splitShellArgs } from "./shellArgv";
+export { chunkString, clampNumber, coerceEnv, deriveSessionName, formatDuration, getShellConfig, killProcessTree, killSession, pad, readEnvInt, resolveWorkdir, sanitizeBinaryOutput, sliceLogLines, sliceUtf16Safe, truncateMiddle, } from "./shellUtils";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,WAAW,EACX,KAAK,WAAW,IAAI,eAAe,EACnC,KAAK,cAAc,EACnB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,OAAO,EACP,KAAK,WAAW,EAChB,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,gBAAgB,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,GAAG,EACH,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,GACd,MAAM,cAAc,CAAC"}

package/dist/utils/pathUtils.d.ts

@@ -0,0 +1,5 @@
+export declare function validatePath(commandPath: string, allowedDir: string, currentDir: string): string | null;
+export declare function isSafeCommand(command: string): boolean;
+export declare function extractBaseCommand(fullCommand: string): string;
+export declare function isForbiddenCommand(command: string, forbiddenCommands: string[]): boolean;
+//# sourceMappingURL=pathUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../utils/pathUtils.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAC3B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAaf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAiCtD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EAAE,GACzB,OAAO,CAmBT"}

package/dist/utils/processQueue.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Process execution utilities with command queuing.
+ *
+ * Provides cross-platform child process execution with:
+ * - Windows command resolution (.cmd extension handling)
+ * - Timeout support
+ * - Lane-based command queuing for serialization
+ * - Signal forwarding between parent and child processes
+ *
+ * @module utils/processQueue
+ */
+import { type ChildProcess } from "node:child_process";
+/**
+ * Command execution lanes for organizing concurrent command execution.
+ * Lanes allow serialization within a lane while permitting parallelism across lanes.
+ */
+export declare const CommandLane: {
+    readonly Main: "main";
+    readonly Cron: "cron";
+    readonly Subagent: "subagent";
+    readonly Nested: "nested";
+};
+export type CommandLane = (typeof CommandLane)[keyof typeof CommandLane];
+/**
+ * Simple promise-wrapped execFile with timeout support.
+ *
+ * @param command - The command to execute
+ * @param args - Command arguments
+ * @param opts - Timeout in ms or options object
+ * @returns Promise resolving to stdout and stderr
+ */
+export declare function runExec(command: string, args: string[], opts?: number | {
+    timeoutMs?: number;
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Result from a spawned command execution.
+ */
+export type SpawnResult = {
+    stdout: string;
+    stderr: string;
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    killed: boolean;
+};
+/**
+ * Options for running a command with timeout.
+ */
+export type CommandOptions = {
+    timeoutMs: number;
+    cwd?: string;
+    input?: string;
+    env?: NodeJS.ProcessEnv;
+    windowsVerbatimArguments?: boolean;
+};
+/**
+ * Run a command with timeout, input, and environment control.
+ *
+ * @param argv - Command and arguments as array
+ * @param optionsOrTimeout - Options object or timeout in ms
+ * @returns Promise resolving to spawn result
+ */
+export declare function runCommandWithTimeout(argv: string[], optionsOrTimeout: number | CommandOptions): Promise<SpawnResult>;
+/**
+ * Set the maximum concurrency for a command lane.
+ *
+ * @param lane - The lane name
+ * @param maxConcurrent - Maximum concurrent tasks
+ */
+export declare function setCommandLaneConcurrency(lane: string, maxConcurrent: number): void;
+/**
+ * Enqueue a task to execute in a specific lane.
+ *
+ * @param lane - The lane name
+ * @param task - Async task function
+ * @param opts - Options including warning threshold and callbacks
+ * @returns Promise resolving when task completes
+ */
+export declare function enqueueCommandInLane<T>(lane: string, task: () => Promise<T>, opts?: {
+    warnAfterMs?: number;
+    onWait?: (waitMs: number, queuedAhead: number) => void;
+}): Promise<T>;
+/**
+ * Enqueue a task to execute in the main lane.
+ *
+ * @param task - Async task function
+ * @param opts - Options including warning threshold and callbacks
+ * @returns Promise resolving when task completes
+ */
+export declare function enqueueCommand<T>(task: () => Promise<T>, opts?: {
+    warnAfterMs?: number;
+    onWait?: (waitMs: number, queuedAhead: number) => void;
+}): Promise<T>;
+/**
+ * Get the current queue size for a lane (queued + active).
+ *
+ * @param lane - The lane name (defaults to main)
+ * @returns Queue size
+ */
+export declare function getQueueSize(lane?: string): number;
+/**
+ * Get total queue size across all lanes.
+ *
+ * @returns Total queue size
+ */
+export declare function getTotalQueueSize(): number;
+/**
+ * Clear all pending tasks in a lane.
+ *
+ * @param lane - The lane name (defaults to main)
+ * @returns Number of tasks cleared
+ */
+export declare function clearCommandLane(lane?: string): number;
+/**
+ * Options for attaching a child process signal bridge.
+ */
+export type ChildProcessBridgeOptions = {
+    signals?: NodeJS.Signals[];
+    onSignal?: (signal: NodeJS.Signals) => void;
+};
+/**
+ * Attach signal forwarding from parent to child process.
+ * Signals sent to the parent will be forwarded to the child.
+ * Automatically detaches when child exits.
+ *
+ * @param child - The child process
+ * @param options - Bridge options
+ * @returns Object with detach function
+ */
+export declare function attachChildProcessBridge(child: ChildProcess, { signals, onSignal }?: ChildProcessBridgeOptions): {
+    detach: () => void;
+};
+//# sourceMappingURL=processQueue.d.ts.map

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

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

package/dist/utils/ptyKeys.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PTY Key Encoding - Terminal key sequence encoding utilities
+ * Ported from otto pty-keys.ts and pty-dsr.ts
+ */
+export declare const BRACKETED_PASTE_START = "\u001B[200~";
+export declare const BRACKETED_PASTE_END = "\u001B[201~";
+export type KeyEncodingRequest = {
+    keys?: string[];
+    hex?: string[];
+    literal?: string;
+};
+export type KeyEncodingResult = {
+    data: string;
+    warnings: string[];
+};
+export declare function encodeKeySequence(request: KeyEncodingRequest): KeyEncodingResult;
+export declare function encodePaste(text: string, bracketed?: boolean): string;
+export declare function stripDsrRequests(input: string): {
+    cleaned: string;
+    requests: number;
+};
+export declare function buildCursorPositionResponse(row?: number, col?: number): string;
+//# sourceMappingURL=ptyKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ptyKeys.d.ts","sourceRoot":"","sources":["../../utils/ptyKeys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAyFjD,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,kBAAkB,GACzB,iBAAiB,CA0BnB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAKlE;AAkKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAOA;AAED,wBAAgB,2BAA2B,CAAC,GAAG,SAAI,EAAE,GAAG,SAAI,GAAG,MAAM,CAEpE"}

package/dist/utils/shellArgv.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shell argument parsing utilities.
+ *
+ * Provides functions to split shell command strings into argument arrays,
+ * handling quotes and escape sequences.
+ *
+ * @module utils/shellArgv
+ */
+/**
+ * Split a shell command string into an array of arguments.
+ *
+ * Handles:
+ * - Single quotes (literal strings)
+ * - Double quotes (literal strings)
+ * - Backslash escapes (outside quotes)
+ * - Whitespace as argument separator
+ *
+ * @param raw - The raw command string
+ * @returns Array of arguments, or null if string has unclosed quotes/escapes
+ *
+ * @example
+ * ```ts
+ * splitShellArgs('git commit -m "fix bug"')
+ * // => ['git', 'commit', '-m', 'fix bug']
+ *
+ * splitShellArgs("echo 'hello world'")
+ * // => ['echo', 'hello world']
+ *
+ * splitShellArgs('path\\ with\\ spaces')
+ * // => ['path with spaces']
+ *
+ * splitShellArgs('"unclosed')
+ * // => null (unclosed quote)
+ * ```
+ */
+export declare function splitShellArgs(raw: string): string[] | null;
+//# sourceMappingURL=shellArgv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shellArgv.d.ts","sourceRoot":"","sources":["../../utils/shellArgv.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA6D3D"}