pulseed 0.4.4 → 0.4.7

package/dist/tools/system/ProcessSessionTool/ProcessSessionTool.d.ts

@@ -0,0 +1,220 @@
+import { z } from "zod";
+import type { ITool, PermissionCheckResult, ToolCallContext, ToolMetadata, ToolResult } from "../../types.js";
+export declare const ProcessSessionStartInputSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    args: string[];
+    label?: string | undefined;
+    cwd?: string | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    command: string;
+    label?: string | undefined;
+    cwd?: string | undefined;
+    env?: Record<string, string> | undefined;
+    args?: string[] | undefined;
+}>;
+export type ProcessSessionStartInput = z.infer<typeof ProcessSessionStartInputSchema>;
+export declare const ProcessSessionReadInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+    waitMs: z.ZodDefault<z.ZodNumber>;
+    consume: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    maxChars: number;
+    session_id: string;
+    waitMs: number;
+    consume: boolean;
+}, {
+    session_id: string;
+    maxChars?: number | undefined;
+    waitMs?: number | undefined;
+    consume?: boolean | undefined;
+}>;
+export type ProcessSessionReadInput = z.infer<typeof ProcessSessionReadInputSchema>;
+export declare const ProcessSessionWriteInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    input: z.ZodString;
+    appendNewline: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    input: string;
+    session_id: string;
+    appendNewline: boolean;
+}, {
+    input: string;
+    session_id: string;
+    appendNewline?: boolean | undefined;
+}>;
+export type ProcessSessionWriteInput = z.infer<typeof ProcessSessionWriteInputSchema>;
+export declare const ProcessSessionStopInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    signal: z.ZodDefault<z.ZodEnum<["SIGTERM", "SIGINT", "SIGHUP", "SIGKILL"]>>;
+    waitMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    signal: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGTERM";
+    session_id: string;
+    waitMs: number;
+}, {
+    session_id: string;
+    signal?: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGTERM" | undefined;
+    waitMs?: number | undefined;
+}>;
+export type ProcessSessionStopInput = z.infer<typeof ProcessSessionStopInputSchema>;
+export declare const ProcessSessionListInputSchema: z.ZodObject<{
+    includeExited: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeExited: boolean;
+}, {
+    includeExited?: boolean | undefined;
+}>;
+export type ProcessSessionListInput = z.infer<typeof ProcessSessionListInputSchema>;
+export interface ProcessSessionSnapshot {
+    session_id: string;
+    label?: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    pid?: number;
+    running: boolean;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    startedAt: string;
+    exitedAt?: string;
+    bufferedChars: number;
+}
+export interface ProcessSessionReadOutput extends ProcessSessionSnapshot {
+    output: string;
+    truncated: boolean;
+}
+export declare class ProcessSessionManager {
+    private readonly sessions;
+    start(input: ProcessSessionStartInput, cwd: string): ProcessSessionSnapshot;
+    read(input: ProcessSessionReadInput): Promise<ProcessSessionReadOutput | null>;
+    write(input: ProcessSessionWriteInput): ProcessSessionSnapshot | null;
+    stop(input: ProcessSessionStopInput): Promise<ProcessSessionSnapshot | null>;
+    list(includeExited: boolean): ProcessSessionSnapshot[];
+    stopAll(): Promise<void>;
+    private append;
+    private snapshot;
+}
+export declare const defaultProcessSessionManager: ProcessSessionManager;
+declare abstract class ProcessSessionBaseTool<TInput, TOutput> implements ITool<TInput, TOutput> {
+    protected readonly manager: ProcessSessionManager;
+    abstract readonly metadata: ToolMetadata;
+    abstract readonly inputSchema: z.ZodType<TInput, z.ZodTypeDef, unknown>;
+    constructor(manager?: ProcessSessionManager);
+    abstract description(): string;
+    abstract call(input: TInput, context: ToolCallContext): Promise<ToolResult>;
+    abstract checkPermissions(input: TInput, context: ToolCallContext): Promise<PermissionCheckResult>;
+    abstract isConcurrencySafe(input: TInput): boolean;
+}
+export declare class ProcessSessionStartTool extends ProcessSessionBaseTool<ProcessSessionStartInput, ProcessSessionSnapshot> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        cwd: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args: string[];
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        label?: string | undefined;
+        cwd?: string | undefined;
+        env?: Record<string, string> | undefined;
+        args?: string[] | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessSessionStartInput, context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProcessSessionStartInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessSessionStartInput): boolean;
+}
+export declare class ProcessSessionReadTool extends ProcessSessionBaseTool<ProcessSessionReadInput, ProcessSessionReadOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        session_id: z.ZodString;
+        maxChars: z.ZodDefault<z.ZodNumber>;
+        waitMs: z.ZodDefault<z.ZodNumber>;
+        consume: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        maxChars: number;
+        session_id: string;
+        waitMs: number;
+        consume: boolean;
+    }, {
+        session_id: string;
+        maxChars?: number | undefined;
+        waitMs?: number | undefined;
+        consume?: boolean | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessSessionReadInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProcessSessionReadInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessSessionReadInput): boolean;
+}
+export declare class ProcessSessionWriteTool extends ProcessSessionBaseTool<ProcessSessionWriteInput, ProcessSessionSnapshot> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        session_id: z.ZodString;
+        input: z.ZodString;
+        appendNewline: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        input: string;
+        session_id: string;
+        appendNewline: boolean;
+    }, {
+        input: string;
+        session_id: string;
+        appendNewline?: boolean | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessSessionWriteInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProcessSessionWriteInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessSessionWriteInput): boolean;
+}
+export declare class ProcessSessionStopTool extends ProcessSessionBaseTool<ProcessSessionStopInput, ProcessSessionSnapshot> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        session_id: z.ZodString;
+        signal: z.ZodDefault<z.ZodEnum<["SIGTERM", "SIGINT", "SIGHUP", "SIGKILL"]>>;
+        waitMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        signal: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGTERM";
+        session_id: string;
+        waitMs: number;
+    }, {
+        session_id: string;
+        signal?: "SIGHUP" | "SIGINT" | "SIGKILL" | "SIGTERM" | undefined;
+        waitMs?: number | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessSessionStopInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProcessSessionStopInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessSessionStopInput): boolean;
+}
+export declare class ProcessSessionListTool extends ProcessSessionBaseTool<ProcessSessionListInput, ProcessSessionSnapshot[]> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        includeExited: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        includeExited: boolean;
+    }, {
+        includeExited?: boolean | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessSessionListInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProcessSessionListInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessSessionListInput): boolean;
+}
+export {};
+//# sourceMappingURL=ProcessSessionTool.d.ts.map

package/dist/tools/system/ProcessSessionTool/ProcessSessionTool.d.ts.map

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

package/dist/tools/system/ProcessSessionTool/ProcessSessionTool.js

@@ -0,0 +1,354 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+const MAX_BUFFER_CHARS = 1_000_000;
+const DEFAULT_MAX_READ_CHARS = 12_000;
+export const ProcessSessionStartInputSchema = z.object({
+    command: z.string().min(1),
+    args: z.array(z.string()).default([]),
+    cwd: z.string().optional(),
+    env: z.record(z.string()).optional(),
+    label: z.string().min(1).max(120).optional(),
+});
+export const ProcessSessionReadInputSchema = z.object({
+    session_id: z.string().min(1),
+    maxChars: z.number().int().min(1).max(100_000).default(DEFAULT_MAX_READ_CHARS),
+    waitMs: z.number().int().min(0).max(30_000).default(0),
+    consume: z.boolean().default(true),
+});
+export const ProcessSessionWriteInputSchema = z.object({
+    session_id: z.string().min(1),
+    input: z.string(),
+    appendNewline: z.boolean().default(true),
+});
+export const ProcessSessionStopInputSchema = z.object({
+    session_id: z.string().min(1),
+    signal: z.enum(["SIGTERM", "SIGINT", "SIGHUP", "SIGKILL"]).default("SIGTERM"),
+    waitMs: z.number().int().min(0).max(30_000).default(1_000),
+});
+export const ProcessSessionListInputSchema = z.object({
+    includeExited: z.boolean().default(true),
+});
+export class ProcessSessionManager {
+    sessions = new Map();
+    start(input, cwd) {
+        const id = randomUUID();
+        const resolvedCwd = input.cwd ?? cwd;
+        const child = spawn(input.command, input.args, {
+            cwd: resolvedCwd,
+            env: input.env ? { ...process.env, ...input.env } : process.env,
+            stdio: "pipe",
+        });
+        const record = {
+            id,
+            label: input.label,
+            command: input.command,
+            args: input.args,
+            cwd: resolvedCwd,
+            child,
+            startedAt: new Date(),
+            exitCode: null,
+            signal: null,
+            combined: "",
+            readOffset: 0,
+        };
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.append(record, String(chunk)));
+        child.stderr.on("data", (chunk) => this.append(record, String(chunk)));
+        child.on("error", (err) => {
+            this.append(record, `[process error] ${err.message}\n`);
+        });
+        child.on("exit", (code, signal) => {
+            record.exitCode = code;
+            record.signal = signal;
+            record.exitedAt = new Date();
+            this.append(record, `[process exited code=${code ?? "null"} signal=${signal ?? "null"}]\n`);
+        });
+        this.sessions.set(id, record);
+        return this.snapshot(record);
+    }
+    async read(input) {
+        const record = this.sessions.get(input.session_id);
+        if (!record)
+            return null;
+        if (input.waitMs > 0) {
+            await delay(input.waitMs);
+        }
+        const unread = record.combined.slice(record.readOffset);
+        const truncated = unread.length > input.maxChars;
+        const output = truncated ? unread.slice(0, input.maxChars) : unread;
+        if (input.consume) {
+            record.readOffset += output.length;
+        }
+        return { ...this.snapshot(record), output, truncated };
+    }
+    write(input) {
+        const record = this.sessions.get(input.session_id);
+        if (!record || record.child.killed || record.exitCode !== null)
+            return null;
+        record.child.stdin.write(input.appendNewline ? `${input.input}\n` : input.input);
+        return this.snapshot(record);
+    }
+    async stop(input) {
+        const record = this.sessions.get(input.session_id);
+        if (!record)
+            return null;
+        if (record.exitCode === null && !record.child.killed) {
+            record.child.kill(input.signal);
+            if (input.waitMs > 0) {
+                await Promise.race([
+                    onceExit(record),
+                    delay(input.waitMs),
+                ]);
+            }
+        }
+        return this.snapshot(record);
+    }
+    list(includeExited) {
+        return [...this.sessions.values()]
+            .filter((record) => includeExited || record.exitCode === null)
+            .map((record) => this.snapshot(record));
+    }
+    async stopAll() {
+        await Promise.all([...this.sessions.values()].map(async (record) => {
+            if (record.exitCode === null && !record.child.killed) {
+                record.child.kill("SIGTERM");
+                await Promise.race([onceExit(record), delay(500)]);
+            }
+        }));
+    }
+    append(record, chunk) {
+        record.combined += chunk;
+        if (record.combined.length <= MAX_BUFFER_CHARS)
+            return;
+        const overflow = record.combined.length - MAX_BUFFER_CHARS;
+        record.combined = record.combined.slice(overflow);
+        record.readOffset = Math.max(0, record.readOffset - overflow);
+    }
+    snapshot(record) {
+        return {
+            session_id: record.id,
+            label: record.label,
+            command: record.command,
+            args: record.args,
+            cwd: record.cwd,
+            pid: record.child.pid,
+            running: record.exitCode === null && !record.child.killed,
+            exitCode: record.exitCode,
+            signal: record.signal,
+            startedAt: record.startedAt.toISOString(),
+            exitedAt: record.exitedAt?.toISOString(),
+            bufferedChars: record.combined.length,
+        };
+    }
+}
+export const defaultProcessSessionManager = new ProcessSessionManager();
+class ProcessSessionBaseTool {
+    manager;
+    constructor(manager = defaultProcessSessionManager) {
+        this.manager = manager;
+    }
+}
+export class ProcessSessionStartTool extends ProcessSessionBaseTool {
+    metadata = {
+        name: "process_session_start",
+        aliases: ["start_process_session", "start_session_process"],
+        permissionLevel: "execute",
+        isReadOnly: false,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 2,
+        maxOutputChars: DEFAULT_MAX_READ_CHARS,
+        tags: ["process", "session", "agentloop", "dev-server"],
+    };
+    inputSchema = ProcessSessionStartInputSchema;
+    description() {
+        return "Start a persistent process session without a shell. Use for dev servers, watchers, and REPL-like commands.";
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        try {
+            const data = this.manager.start(input, context.cwd);
+            return {
+                success: true,
+                data,
+                summary: `Started process session ${data.session_id}${data.pid ? ` (pid ${data.pid})` : ""}: ${data.command} ${data.args.join(" ")}`.trim(),
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return failureResult(`Failed to start process session: ${err.message}`, startTime);
+        }
+    }
+    async checkPermissions(_input) {
+        return { status: "needs_approval", reason: "Starting a persistent process can execute arbitrary local code." };
+    }
+    isConcurrencySafe(_input) {
+        return false;
+    }
+}
+export class ProcessSessionReadTool extends ProcessSessionBaseTool {
+    metadata = {
+        name: "process_session_read",
+        aliases: ["read_process_session"],
+        permissionLevel: "read_metrics",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 5,
+        maxOutputChars: DEFAULT_MAX_READ_CHARS,
+        tags: ["process", "session", "agentloop", "dev-server"],
+    };
+    inputSchema = ProcessSessionReadInputSchema;
+    description() {
+        return "Read buffered output from a persistent process session.";
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        const data = await this.manager.read(input);
+        if (!data) {
+            return failureResult(`Process session not found: ${input.session_id}`, startTime);
+        }
+        return {
+            success: true,
+            data,
+            summary: `Read ${data.output.length} chars from process session ${input.session_id}${data.truncated ? " (truncated)" : ""}`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+export class ProcessSessionWriteTool extends ProcessSessionBaseTool {
+    metadata = {
+        name: "process_session_write",
+        aliases: ["write_process_session"],
+        permissionLevel: "execute",
+        isReadOnly: false,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 1,
+        maxOutputChars: DEFAULT_MAX_READ_CHARS,
+        tags: ["process", "session", "agentloop", "dev-server"],
+    };
+    inputSchema = ProcessSessionWriteInputSchema;
+    description() {
+        return "Write stdin to a running persistent process session.";
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        const data = this.manager.write(input);
+        if (!data) {
+            return failureResult(`Process session not found or not running: ${input.session_id}`, startTime);
+        }
+        return {
+            success: true,
+            data,
+            summary: `Wrote stdin to process session ${input.session_id}`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "needs_approval", reason: "Writing stdin to a process can trigger local side effects." };
+    }
+    isConcurrencySafe(_input) {
+        return false;
+    }
+}
+export class ProcessSessionStopTool extends ProcessSessionBaseTool {
+    metadata = {
+        name: "process_session_stop",
+        aliases: ["stop_process_session"],
+        permissionLevel: "execute",
+        isReadOnly: false,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 1,
+        maxOutputChars: DEFAULT_MAX_READ_CHARS,
+        tags: ["process", "session", "agentloop", "dev-server"],
+    };
+    inputSchema = ProcessSessionStopInputSchema;
+    description() {
+        return "Stop a persistent process session.";
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        const data = await this.manager.stop(input);
+        if (!data) {
+            return failureResult(`Process session not found: ${input.session_id}`, startTime);
+        }
+        return {
+            success: true,
+            data,
+            summary: `Stopped process session ${input.session_id}`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "needs_approval", reason: "Stopping a process changes local runtime state." };
+    }
+    isConcurrencySafe(_input) {
+        return false;
+    }
+}
+export class ProcessSessionListTool extends ProcessSessionBaseTool {
+    metadata = {
+        name: "process_session_list",
+        aliases: ["list_process_sessions"],
+        permissionLevel: "read_metrics",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 5,
+        maxOutputChars: DEFAULT_MAX_READ_CHARS,
+        tags: ["process", "session", "agentloop", "dev-server"],
+    };
+    inputSchema = ProcessSessionListInputSchema;
+    description() {
+        return "List persistent process sessions started by this PulSeed process.";
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        const data = this.manager.list(input.includeExited);
+        return {
+            success: true,
+            data,
+            summary: `Found ${data.length} process session(s)`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+function onceExit(record) {
+    if (record.exitCode !== null)
+        return Promise.resolve();
+    return new Promise((resolve) => record.child.once("exit", () => resolve()));
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function failureResult(message, startTime) {
+    return {
+        success: false,
+        data: null,
+        summary: message,
+        error: message,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=ProcessSessionTool.js.map

package/dist/tools/system/ProcessSessionTool/ProcessSessionTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessSessionTool.js","sourceRoot":"","sources":["../../../../src/tools/system/ProcessSessionTool/ProcessSessionTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/system/ShellCommandTool/ShellCommandTool.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { ITool, PermissionCheckResult, ToolCallContext, ToolMetadata, ToolResult } from "../../types.js";
+export declare const ShellCommandInputSchema: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeoutMs: number;
+    description?: string | undefined;
+    cwd?: string | undefined;
+}, {
+    command: string;
+    description?: string | undefined;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export type ShellCommandInput = z.infer<typeof ShellCommandInputSchema>;
+export declare class ShellCommandTool implements ITool<ShellCommandInput> {
+    private readonly shellTool;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeoutMs: number;
+        description?: string | undefined;
+        cwd?: string | undefined;
+    }, {
+        command: string;
+        description?: string | undefined;
+        cwd?: string | undefined;
+        timeoutMs?: number | undefined;
+    }>;
+    description(): string;
+    call(input: ShellCommandInput, context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(input: ShellCommandInput, context: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(input: ShellCommandInput): boolean;
+}
+//# sourceMappingURL=ShellCommandTool.d.ts.map

package/dist/tools/system/ShellCommandTool/ShellCommandTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellCommandTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/system/ShellCommandTool/ShellCommandTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG9G,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,qBAAa,gBAAiB,YAAW,KAAK,CAAC,iBAAiB,CAAC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAE7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAK7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;OAA2B;IAE/C,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAa7E,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI1G,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;CAGrD"}