@elizaos/plugin-shell 2.0.0-alpha.2 → 2.0.0-alpha.4

package/dist/services/index.d.ts

@@ -1,2 +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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../services/index.ts"],"names":[],"mappings":"AAAA,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,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;AAuI/E,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CA4B3E;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;AAgCD,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,CAC1B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,KAAK,EAAE,MAAM,GACZ,IAAI,CA4BN;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQxF;AAwBD,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,EAC1C,MAAM,EAAE,aAAa,GACpB,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

@@ -1,24 +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 } from "../types";
+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>;
-    private handleCdCommand;
-    private runCommand;
-    private addToHistory;
-    private detectFileOperations;
-    private resolvePath;
+    /**
+     * 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

@@ -1 +1 @@
-{"version":3,"file":"shellService.d.ts","sourceRoot":"","sources":["../../services/shellService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAId,MAAM,UAAU,CAAC;AAGlB,qBAAa,YAAa,SAAQ,OAAO;IACvC,OAAc,WAAW,SAAW;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,yBAAyB,CAAO;gBAE5B,OAAO,EAAE,aAAa;WAOrB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAM3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAEK,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAqExE,eAAe;YAyCf,UAAU;IAwFxB,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,WAAW;IAOnB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAQhF,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAKjD,mBAAmB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD,mBAAmB,IAAI,MAAM;CAG9B"}
+{"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,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,cAAc,EAGd,eAAe,EACf,mBAAmB,EACnB,cAAc,EAGd,WAAW,EACZ,MAAM,UAAU,CAAC;AAoDlB,qBAAa,YAAa,SAAQ,OAAO;IACvC,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;IAM3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA0DtF;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqK9E;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QACxD,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IAwaF;;OAEG;IACH,mBAAmB,IAAI,cAAc,EAAE;IAKvC;;OAEG;IACH,oBAAoB,IAAI,eAAe,EAAE;IAKzC;;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,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAQhF;;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;YAwFhB,cAAc;IAyU5B,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,WAAW;CAMpB"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
 export interface CommandResult {
     success: boolean;
     stdout: string;
@@ -26,5 +27,118 @@ export interface ShellConfig {
     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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAS5C,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EA0B9C,CAAC;AAEX,wBAAgB,eAAe,IAAI,WAAW,CAmD7C"}
+{"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,CAwD7C"}

package/dist/utils/index.d.ts

@@ -1,3 +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

@@ -1 +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,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC"}
+{"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,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,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,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,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,GACf,MAAM,cAAc,CAAC"}

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;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA0BhF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAKlE;AAkKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOrF;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"}

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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"}