@fleetagent/pi-coding-agent 0.0.9 → 0.0.10

package/dist/core/tools/operations.d.ts

@@ -0,0 +1,145 @@
+import type { Stats } from "node:fs";
+export type ToolAccessMode = "exists" | "read" | "write" | "readwrite";
+export interface ToolFileStat {
+    isDirectory: () => boolean;
+    isFile: () => boolean;
+}
+export interface ToolExecOptions {
+    cwd?: string;
+    onData: (data: Buffer) => void;
+    signal?: AbortSignal;
+    timeout?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export interface ToolGlobOptions {
+    ignore: string[];
+    limit: number;
+}
+export interface ToolGrepOptions {
+    pattern: string;
+    path: string;
+    glob?: string;
+    ignoreCase?: boolean;
+    literal?: boolean;
+    limit: number;
+}
+export interface ToolGrepMatch {
+    filePath: string;
+    lineNumber: number;
+    lineText?: string;
+}
+export interface ToolGrepResult {
+    isDirectory: boolean;
+    matches: ToolGrepMatch[];
+}
+export type ToolBackendInfo = {
+    type: "local";
+    cwd: string;
+} | {
+    type: "ssh";
+    cwd: string;
+    remote: string;
+    configured: true;
+} | {
+    type: "ssh";
+    cwd: string;
+    configured: false;
+};
+export interface ToolOperations {
+    cwd: string;
+    exec(command: string, options: ToolExecOptions): Promise<{
+        exitCode: number | null;
+    }>;
+    access(path: string, mode?: ToolAccessMode): Promise<void>;
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string | Buffer): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    stat(path: string): Promise<ToolFileStat>;
+    readdir(path: string): Promise<string[]>;
+    glob?(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]>;
+    grep?(options: ToolGrepOptions): Promise<ToolGrepResult>;
+    detectImageMimeType?(path: string): Promise<string | null | undefined>;
+    getBackendInfo?(): ToolBackendInfo;
+    dispose?(): Promise<void>;
+}
+export interface LocalToolOperationsOptions {
+    shellPath?: string;
+}
+export interface SshToolOperationsOptions {
+    remote: string;
+    cwd: string;
+}
+export interface DeferredSshToolOperationsConfigureOptions {
+    remote: string;
+    cwd?: string;
+}
+export interface ParsedSshTarget {
+    remote: string;
+    cwd?: string;
+}
+export declare class LocalToolOperations implements ToolOperations {
+    cwd: string;
+    private shellPath;
+    constructor(cwd: string, options?: LocalToolOperationsOptions);
+    exec(command: string, options: ToolExecOptions): Promise<{
+        exitCode: number | null;
+    }>;
+    access(path: string, mode?: ToolAccessMode): Promise<void>;
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string | Buffer): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    stat(path: string): Promise<Stats>;
+    readdir(path: string): Promise<string[]>;
+    detectImageMimeType(path: string): Promise<string | null | undefined>;
+    getBackendInfo(): ToolBackendInfo;
+}
+export declare class SshToolOperations implements ToolOperations {
+    readonly remote: string;
+    cwd: string;
+    constructor(options: SshToolOperationsOptions);
+    static fromTarget(target: string): Promise<SshToolOperations>;
+    exec(command: string, options: ToolExecOptions): Promise<{
+        exitCode: number | null;
+    }>;
+    access(path: string, mode?: ToolAccessMode): Promise<void>;
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string | Buffer): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    stat(path: string): Promise<ToolFileStat>;
+    readdir(path: string): Promise<string[]>;
+    glob(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]>;
+    grep(options: ToolGrepOptions): Promise<ToolGrepResult>;
+    detectImageMimeType(path: string): Promise<string | null | undefined>;
+    getBackendInfo(): ToolBackendInfo;
+}
+export declare class DeferredSshToolOperations implements ToolOperations {
+    cwd: string;
+    private operations;
+    constructor(cwd: string);
+    configure(options: DeferredSshToolOperationsConfigureOptions): Promise<ToolBackendInfo>;
+    clear(): void;
+    private requireOperations;
+    exec(command: string, options: ToolExecOptions): Promise<{
+        exitCode: number | null;
+    }>;
+    access(path: string, mode?: ToolAccessMode): Promise<void>;
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string | Buffer): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    stat(path: string): Promise<ToolFileStat>;
+    readdir(path: string): Promise<string[]>;
+    glob(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]>;
+    grep(options: ToolGrepOptions): Promise<ToolGrepResult>;
+    detectImageMimeType(path: string): Promise<string | null | undefined>;
+    getBackendInfo(): ToolBackendInfo;
+}
+export declare function createSshToolOperations(target: string): Promise<SshToolOperations>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/core/tools/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/core/tools/operations.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport type { Stats } from \"node:fs\";\nimport { constants } from \"node:fs\";\nimport {\n\taccess as fsAccess,\n\tmkdir as fsMkdir,\n\treaddir as fsReaddir,\n\treadFile as fsReadFile,\n\tstat as fsStat,\n\twriteFile as fsWriteFile,\n} from \"node:fs/promises\";\nimport { waitForChildProcess } from \"../../utils/child-process.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.ts\";\nimport {\n\tgetShellConfig,\n\tgetShellEnv,\n\tkillProcessTree,\n\ttrackDetachedChildPid,\n\tuntrackDetachedChildPid,\n} from \"../../utils/shell.ts\";\n\nexport type ToolAccessMode = \"exists\" | \"read\" | \"write\" | \"readwrite\";\n\nexport interface ToolFileStat {\n\tisDirectory: () => boolean;\n\tisFile: () => boolean;\n}\n\nexport interface ToolExecOptions {\n\tcwd?: string;\n\tonData: (data: Buffer) => void;\n\tsignal?: AbortSignal;\n\ttimeout?: number;\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport interface ToolGlobOptions {\n\tignore: string[];\n\tlimit: number;\n}\n\nexport interface ToolGrepOptions {\n\tpattern: string;\n\tpath: string;\n\tglob?: string;\n\tignoreCase?: boolean;\n\tliteral?: boolean;\n\tlimit: number;\n}\n\nexport interface ToolGrepMatch {\n\tfilePath: string;\n\tlineNumber: number;\n\tlineText?: string;\n}\n\nexport interface ToolGrepResult {\n\tisDirectory: boolean;\n\tmatches: ToolGrepMatch[];\n}\n\nexport type ToolBackendInfo =\n\t| { type: \"local\"; cwd: string }\n\t| { type: \"ssh\"; cwd: string; remote: string; configured: true }\n\t| { type: \"ssh\"; cwd: string; configured: false };\n\nexport interface ToolOperations {\n\tcwd: string;\n\texec(command: string, options: ToolExecOptions): Promise<{ exitCode: number | null }>;\n\taccess(path: string, mode?: ToolAccessMode): Promise<void>;\n\treadFile(path: string): Promise<Buffer>;\n\twriteFile(path: string, content: string | Buffer): Promise<void>;\n\tmkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n\tstat(path: string): Promise<ToolFileStat>;\n\treaddir(path: string): Promise<string[]>;\n\tglob?(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]>;\n\tgrep?(options: ToolGrepOptions): Promise<ToolGrepResult>;\n\tdetectImageMimeType?(path: string): Promise<string | null | undefined>;\n\tgetBackendInfo?(): ToolBackendInfo;\n\tdispose?(): Promise<void>;\n}\n\nexport interface LocalToolOperationsOptions {\n\tshellPath?: string;\n}\n\nexport interface SshToolOperationsOptions {\n\tremote: string;\n\tcwd: string;\n}\n\nexport interface DeferredSshToolOperationsConfigureOptions {\n\tremote: string;\n\tcwd?: string;\n}\n\nexport interface ParsedSshTarget {\n\tremote: string;\n\tcwd?: string;\n}\n\nfunction accessModeToFsMode(mode: ToolAccessMode | undefined): number {\n\tswitch (mode) {\n\t\tcase \"read\":\n\t\t\treturn constants.R_OK;\n\t\tcase \"write\":\n\t\t\treturn constants.W_OK;\n\t\tcase \"readwrite\":\n\t\t\treturn constants.R_OK | constants.W_OK;\n\t\tcase \"exists\":\n\t\tcase undefined:\n\t\t\treturn constants.F_OK;\n\t}\n}\n\nfunction shellQuote(value: string): string {\n\treturn `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\nfunction parseSshTarget(value: string): ParsedSshTarget {\n\tconst separatorIndex = value.indexOf(\":\");\n\tif (separatorIndex === -1) {\n\t\treturn { remote: value };\n\t}\n\tconst remote = value.slice(0, separatorIndex);\n\tconst cwd = value.slice(separatorIndex + 1);\n\treturn cwd ? { remote, cwd } : { remote };\n}\n\nfunction validateSshRemote(remote: string): void {\n\tif (!remote) {\n\t\tthrow new Error(\"--ssh requires a remote target like user@host or user@host:/path\");\n\t}\n\tif (remote.startsWith(\"-\")) {\n\t\tthrow new Error(\"--ssh remote target must not start with '-'\");\n\t}\n}\n\nfunction sshArgs(remote: string, command: string): string[] {\n\tvalidateSshRemote(remote);\n\treturn [\"--\", remote, command];\n}\n\nfunction buildFdArgs(pattern: string, searchPath: string, limit: number): string[] {\n\tconst args: string[] = [\"--glob\", \"--color=never\", \"--hidden\", \"--no-require-git\", \"--max-results\", String(limit)];\n\tlet effectivePattern = pattern;\n\tif (pattern.includes(\"/\")) {\n\t\targs.push(\"--full-path\");\n\t\tif (!pattern.startsWith(\"/\") && !pattern.startsWith(\"**/\") && pattern !== \"**\") {\n\t\t\teffectivePattern = `**/${pattern}`;\n\t\t}\n\t}\n\targs.push(\"--\", effectivePattern, searchPath);\n\treturn args;\n}\n\nfunction buildRgArgs(options: ToolGrepOptions): string[] {\n\tconst args: string[] = [\"--json\", \"--line-number\", \"--color=never\", \"--hidden\"];\n\tif (options.ignoreCase) args.push(\"--ignore-case\");\n\tif (options.literal) args.push(\"--fixed-strings\");\n\tif (options.glob) args.push(\"--glob\", options.glob);\n\targs.push(\"--\", options.pattern, options.path);\n\treturn args;\n}\n\nfunction commandWithArgs(command: string, args: string[]): string {\n\treturn [command, ...args.map(shellQuote)].join(\" \");\n}\n\nasync function runSshBuffer(\n\tremote: string,\n\tcommand: string,\n\toptions: { input?: Buffer | string; signal?: AbortSignal; timeout?: number } = {},\n): Promise<Buffer> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst child = spawn(\"ssh\", sshArgs(remote, command), { stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n\t\tconst stdout: Buffer[] = [];\n\t\tconst stderr: Buffer[] = [];\n\t\tlet timedOut = false;\n\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\tif (options.timeout !== undefined && options.timeout > 0) {\n\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\ttimedOut = true;\n\t\t\t\tchild.kill();\n\t\t\t}, options.timeout * 1000);\n\t\t}\n\t\tchild.stdout.on(\"data\", (data: Buffer) => stdout.push(data));\n\t\tchild.stderr.on(\"data\", (data: Buffer) => stderr.push(data));\n\t\tchild.on(\"error\", reject);\n\t\tconst onAbort = () => child.kill();\n\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tif (options.input !== undefined) {\n\t\t\tchild.stdin.end(options.input);\n\t\t} else {\n\t\t\tchild.stdin.end();\n\t\t}\n\t\tchild.on(\"close\", (code) => {\n\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\tif (options.signal?.aborted) {\n\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (timedOut) {\n\t\t\t\treject(new Error(`timeout:${options.timeout}`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (code !== 0) {\n\t\t\t\treject(new Error(Buffer.concat(stderr).toString(\"utf-8\").trim() || `ssh exited with code ${code}`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tresolve(Buffer.concat(stdout));\n\t\t});\n\t});\n}\n\nexport class LocalToolOperations implements ToolOperations {\n\tcwd: string;\n\tprivate shellPath: string | undefined;\n\n\tconstructor(cwd: string, options: LocalToolOperationsOptions = {}) {\n\t\tthis.cwd = cwd;\n\t\tthis.shellPath = options.shellPath;\n\t}\n\n\tasync exec(command: string, options: ToolExecOptions): Promise<{ exitCode: number | null }> {\n\t\tconst cwd = options.cwd ?? this.cwd;\n\t\tconst { shell, args } = getShellConfig(this.shellPath);\n\t\ttry {\n\t\t\tawait fsAccess(cwd, constants.F_OK);\n\t\t} catch {\n\t\t\tthrow new Error(`Working directory does not exist: ${cwd}\\nCannot execute bash commands.`);\n\t\t}\n\t\tif (options.signal?.aborted) {\n\t\t\tthrow new Error(\"aborted\");\n\t\t}\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst child = spawn(shell, [...args, command], {\n\t\t\t\tcwd,\n\t\t\t\tdetached: process.platform !== \"win32\",\n\t\t\t\tenv: options.env ?? getShellEnv(),\n\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\t\twindowsHide: true,\n\t\t\t});\n\t\t\tif (child.pid) trackDetachedChildPid(child.pid);\n\t\t\tlet timedOut = false;\n\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\t\tif (options.timeout !== undefined && options.timeout > 0) {\n\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\ttimedOut = true;\n\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t}, options.timeout * 1000);\n\t\t\t}\n\t\t\tchild.stdout?.on(\"data\", options.onData);\n\t\t\tchild.stderr?.on(\"data\", options.onData);\n\t\t\tconst onAbort = () => {\n\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t};\n\t\t\tif (options.signal) {\n\t\t\t\tif (options.signal.aborted) onAbort();\n\t\t\t\telse options.signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t}\n\t\t\twaitForChildProcess(child)\n\t\t\t\t.then((code) => {\n\t\t\t\t\tif (child.pid) untrackDetachedChildPid(child.pid);\n\t\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\t\tif (options.signal) options.signal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\tif (options.signal?.aborted) {\n\t\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (timedOut) {\n\t\t\t\t\t\treject(new Error(`timeout:${options.timeout}`));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tresolve({ exitCode: code });\n\t\t\t\t})\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tif (child.pid) untrackDetachedChildPid(child.pid);\n\t\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\t\tif (options.signal) options.signal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\treject(error);\n\t\t\t\t});\n\t\t});\n\t}\n\n\tasync access(path: string, mode?: ToolAccessMode): Promise<void> {\n\t\tawait fsAccess(path, accessModeToFsMode(mode));\n\t}\n\n\tasync readFile(path: string): Promise<Buffer> {\n\t\treturn fsReadFile(path);\n\t}\n\n\tasync writeFile(path: string, content: string | Buffer): Promise<void> {\n\t\tawait fsWriteFile(path, content, typeof content === \"string\" ? \"utf-8\" : undefined);\n\t}\n\n\tasync mkdir(path: string, options: { recursive?: boolean } = {}): Promise<void> {\n\t\tawait fsMkdir(path, { recursive: options.recursive ?? false });\n\t}\n\n\tasync stat(path: string): Promise<Stats> {\n\t\treturn fsStat(path);\n\t}\n\n\tasync readdir(path: string): Promise<string[]> {\n\t\treturn fsReaddir(path);\n\t}\n\n\tasync detectImageMimeType(path: string): Promise<string | null | undefined> {\n\t\treturn detectSupportedImageMimeTypeFromFile(path);\n\t}\n\n\tgetBackendInfo(): ToolBackendInfo {\n\t\treturn { type: \"local\", cwd: this.cwd };\n\t}\n}\n\nexport class SshToolOperations implements ToolOperations {\n\treadonly remote: string;\n\tcwd: string;\n\n\tconstructor(options: SshToolOperationsOptions) {\n\t\tthis.remote = options.remote;\n\t\tthis.cwd = options.cwd;\n\t}\n\n\tstatic async fromTarget(target: string): Promise<SshToolOperations> {\n\t\tconst parsed = parseSshTarget(target);\n\t\tvalidateSshRemote(parsed.remote);\n\t\tconst cwd = parsed.cwd ?? (await runSshBuffer(parsed.remote, \"pwd\")).toString(\"utf-8\").trim();\n\t\treturn new SshToolOperations({ remote: parsed.remote, cwd });\n\t}\n\n\tasync exec(command: string, options: ToolExecOptions): Promise<{ exitCode: number | null }> {\n\t\tconst cwd = options.cwd ?? this.cwd;\n\t\tconst remoteCommand = `cd ${shellQuote(cwd)} && bash -s`;\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst child = spawn(\"ssh\", sshArgs(this.remote, remoteCommand), {\n\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t});\n\t\t\tlet timedOut = false;\n\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\t\tif (options.timeout !== undefined && options.timeout > 0) {\n\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\ttimedOut = true;\n\t\t\t\t\tchild.kill();\n\t\t\t\t}, options.timeout * 1000);\n\t\t\t}\n\t\t\tchild.stdout?.on(\"data\", options.onData);\n\t\t\tchild.stderr?.on(\"data\", options.onData);\n\t\t\tchild.on(\"error\", reject);\n\t\t\tchild.stdin.end(command);\n\t\t\tconst onAbort = () => child.kill();\n\t\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tchild.on(\"close\", (code) => {\n\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tif (options.signal?.aborted) {\n\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (timedOut) {\n\t\t\t\t\treject(new Error(`timeout:${options.timeout}`));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tresolve({ exitCode: code });\n\t\t\t});\n\t\t});\n\t}\n\n\tasync access(path: string, mode?: ToolAccessMode): Promise<void> {\n\t\tconst remotePath = shellQuote(path);\n\t\tif (mode === \"readwrite\") {\n\t\t\tawait runSshBuffer(this.remote, `test -r ${remotePath} && test -w ${remotePath}`);\n\t\t\treturn;\n\t\t}\n\t\tconst flag = mode === \"read\" ? \"-r\" : mode === \"write\" ? \"-w\" : \"-e\";\n\t\tawait runSshBuffer(this.remote, `test ${flag} ${remotePath}`);\n\t}\n\n\tasync readFile(path: string): Promise<Buffer> {\n\t\treturn runSshBuffer(this.remote, `cat ${shellQuote(path)}`);\n\t}\n\n\tasync writeFile(path: string, content: string | Buffer): Promise<void> {\n\t\tawait runSshBuffer(this.remote, `base64 -d > ${shellQuote(path)}`, {\n\t\t\tinput: Buffer.from(content).toString(\"base64\"),\n\t\t});\n\t}\n\n\tasync mkdir(path: string, options: { recursive?: boolean } = {}): Promise<void> {\n\t\tconst flag = options.recursive ? \"-p \" : \"\";\n\t\tawait runSshBuffer(this.remote, `mkdir ${flag}${shellQuote(path)}`);\n\t}\n\n\tasync stat(path: string): Promise<ToolFileStat> {\n\t\tconst output = await runSshBuffer(\n\t\t\tthis.remote,\n\t\t\t`if test -d ${shellQuote(path)}; then echo d; elif test -f ${shellQuote(path)}; then echo f; else test -e ${shellQuote(path)} && echo o || exit 1; fi`,\n\t\t);\n\t\tconst kind = output.toString(\"utf-8\").trim();\n\t\treturn {\n\t\t\tisDirectory: () => kind === \"d\",\n\t\t\tisFile: () => kind === \"f\",\n\t\t};\n\t}\n\n\tasync readdir(path: string): Promise<string[]> {\n\t\tconst output = await runSshBuffer(\n\t\t\tthis.remote,\n\t\t\t`find ${shellQuote(path)} -maxdepth 1 -mindepth 1 -printf '%f\\\\n'`,\n\t\t);\n\t\treturn output.toString(\"utf-8\").split(\"\\n\").filter(Boolean);\n\t}\n\n\tasync glob(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]> {\n\t\tconst command = commandWithArgs(\"fd\", buildFdArgs(pattern, cwd, options.limit));\n\t\tconst output = await runSshBuffer(this.remote, command);\n\t\treturn output.toString(\"utf-8\").split(\"\\n\").filter(Boolean);\n\t}\n\n\tasync grep(options: ToolGrepOptions): Promise<ToolGrepResult> {\n\t\tconst isDirectory = (await this.stat(options.path)).isDirectory();\n\t\tconst command = commandWithArgs(\"rg\", buildRgArgs(options));\n\t\tconst output = await runSshBuffer(this.remote, command).catch((error: unknown) => {\n\t\t\tif (error instanceof Error && error.message.includes(\"ssh exited with code 1\")) {\n\t\t\t\treturn Buffer.alloc(0);\n\t\t\t}\n\t\t\tthrow error;\n\t\t});\n\t\tconst matches: ToolGrepMatch[] = [];\n\t\tfor (const line of output.toString(\"utf-8\").split(\"\\n\")) {\n\t\t\tif (!line.trim() || matches.length >= options.limit) continue;\n\t\t\tlet event: unknown;\n\t\t\ttry {\n\t\t\t\tevent = JSON.parse(line);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!event || typeof event !== \"object\" || !(\"type\" in event) || event.type !== \"match\") continue;\n\t\t\tconst data = \"data\" in event && event.data && typeof event.data === \"object\" ? event.data : undefined;\n\t\t\tconst filePath =\n\t\t\t\tdata && \"path\" in data && data.path && typeof data.path === \"object\" && \"text\" in data.path\n\t\t\t\t\t? data.path.text\n\t\t\t\t\t: undefined;\n\t\t\tconst lineNumber = data && \"line_number\" in data ? data.line_number : undefined;\n\t\t\tconst lineText =\n\t\t\t\tdata && \"lines\" in data && data.lines && typeof data.lines === \"object\" && \"text\" in data.lines\n\t\t\t\t\t? data.lines.text\n\t\t\t\t\t: undefined;\n\t\t\tif (typeof filePath === \"string\" && typeof lineNumber === \"number\") {\n\t\t\t\tmatches.push({ filePath, lineNumber, lineText: typeof lineText === \"string\" ? lineText : undefined });\n\t\t\t}\n\t\t}\n\t\treturn { isDirectory, matches };\n\t}\n\n\tasync detectImageMimeType(path: string): Promise<string | null | undefined> {\n\t\ttry {\n\t\t\tconst output = await runSshBuffer(this.remote, `file --mime-type -b ${shellQuote(path)}`);\n\t\t\tconst mimeType = output.toString(\"utf-8\").trim();\n\t\t\treturn [\"image/jpeg\", \"image/png\", \"image/gif\", \"image/webp\"].includes(mimeType) ? mimeType : null;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tgetBackendInfo(): ToolBackendInfo {\n\t\treturn { type: \"ssh\", remote: this.remote, cwd: this.cwd, configured: true };\n\t}\n}\n\nexport class DeferredSshToolOperations implements ToolOperations {\n\tcwd: string;\n\tprivate operations: SshToolOperations | undefined;\n\n\tconstructor(cwd: string) {\n\t\tthis.cwd = cwd;\n\t}\n\n\tasync configure(options: DeferredSshToolOperationsConfigureOptions): Promise<ToolBackendInfo> {\n\t\tconst next = new SshToolOperations({ remote: options.remote, cwd: options.cwd ?? this.cwd });\n\t\tconst stat = await next.stat(next.cwd);\n\t\tif (!stat.isDirectory()) {\n\t\t\tthrow new Error(`SSH sandbox cwd is not a directory: ${next.cwd}`);\n\t\t}\n\t\tthis.cwd = next.cwd;\n\t\tthis.operations = next;\n\t\treturn this.getBackendInfo();\n\t}\n\n\tclear(): void {\n\t\tthis.operations = undefined;\n\t}\n\n\tprivate requireOperations(): SshToolOperations {\n\t\tif (!this.operations) {\n\t\t\tthrow new Error(\n\t\t\t\t\"SSH sandbox is not configured. Configure it over RPC or with /ssh-sandbox before using tools.\",\n\t\t\t);\n\t\t}\n\t\treturn this.operations;\n\t}\n\n\tasync exec(command: string, options: ToolExecOptions): Promise<{ exitCode: number | null }> {\n\t\treturn this.requireOperations().exec(command, options);\n\t}\n\n\tasync access(path: string, mode?: ToolAccessMode): Promise<void> {\n\t\tawait this.requireOperations().access(path, mode);\n\t}\n\n\tasync readFile(path: string): Promise<Buffer> {\n\t\treturn this.requireOperations().readFile(path);\n\t}\n\n\tasync writeFile(path: string, content: string | Buffer): Promise<void> {\n\t\tawait this.requireOperations().writeFile(path, content);\n\t}\n\n\tasync mkdir(path: string, options?: { recursive?: boolean }): Promise<void> {\n\t\tawait this.requireOperations().mkdir(path, options);\n\t}\n\n\tasync stat(path: string): Promise<ToolFileStat> {\n\t\treturn this.requireOperations().stat(path);\n\t}\n\n\tasync readdir(path: string): Promise<string[]> {\n\t\treturn this.requireOperations().readdir(path);\n\t}\n\n\tasync glob(pattern: string, cwd: string, options: ToolGlobOptions): Promise<string[]> {\n\t\treturn this.requireOperations().glob(pattern, cwd, options);\n\t}\n\n\tasync grep(options: ToolGrepOptions): Promise<ToolGrepResult> {\n\t\treturn this.requireOperations().grep(options);\n\t}\n\n\tasync detectImageMimeType(path: string): Promise<string | null | undefined> {\n\t\treturn this.requireOperations().detectImageMimeType(path);\n\t}\n\n\tgetBackendInfo(): ToolBackendInfo {\n\t\treturn this.operations?.getBackendInfo() ?? { type: \"ssh\", cwd: this.cwd, configured: false };\n\t}\n}\n\nexport function createSshToolOperations(target: string): Promise<SshToolOperations> {\n\treturn SshToolOperations.fromTarget(target);\n}\n"]}

package/dist/core/tools/operations.js

@@ -0,0 +1,418 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { access as fsAccess, mkdir as fsMkdir, readdir as fsReaddir, readFile as fsReadFile, stat as fsStat, writeFile as fsWriteFile, } from "node:fs/promises";
+import { waitForChildProcess } from "../../utils/child-process.js";
+import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.js";
+import { getShellConfig, getShellEnv, killProcessTree, trackDetachedChildPid, untrackDetachedChildPid, } from "../../utils/shell.js";
+function accessModeToFsMode(mode) {
+    switch (mode) {
+        case "read":
+            return constants.R_OK;
+        case "write":
+            return constants.W_OK;
+        case "readwrite":
+            return constants.R_OK | constants.W_OK;
+        case "exists":
+        case undefined:
+            return constants.F_OK;
+    }
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function parseSshTarget(value) {
+    const separatorIndex = value.indexOf(":");
+    if (separatorIndex === -1) {
+        return { remote: value };
+    }
+    const remote = value.slice(0, separatorIndex);
+    const cwd = value.slice(separatorIndex + 1);
+    return cwd ? { remote, cwd } : { remote };
+}
+function validateSshRemote(remote) {
+    if (!remote) {
+        throw new Error("--ssh requires a remote target like user@host or user@host:/path");
+    }
+    if (remote.startsWith("-")) {
+        throw new Error("--ssh remote target must not start with '-'");
+    }
+}
+function sshArgs(remote, command) {
+    validateSshRemote(remote);
+    return ["--", remote, command];
+}
+function buildFdArgs(pattern, searchPath, limit) {
+    const args = ["--glob", "--color=never", "--hidden", "--no-require-git", "--max-results", String(limit)];
+    let effectivePattern = pattern;
+    if (pattern.includes("/")) {
+        args.push("--full-path");
+        if (!pattern.startsWith("/") && !pattern.startsWith("**/") && pattern !== "**") {
+            effectivePattern = `**/${pattern}`;
+        }
+    }
+    args.push("--", effectivePattern, searchPath);
+    return args;
+}
+function buildRgArgs(options) {
+    const args = ["--json", "--line-number", "--color=never", "--hidden"];
+    if (options.ignoreCase)
+        args.push("--ignore-case");
+    if (options.literal)
+        args.push("--fixed-strings");
+    if (options.glob)
+        args.push("--glob", options.glob);
+    args.push("--", options.pattern, options.path);
+    return args;
+}
+function commandWithArgs(command, args) {
+    return [command, ...args.map(shellQuote)].join(" ");
+}
+async function runSshBuffer(remote, command, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("ssh", sshArgs(remote, command), { stdio: ["pipe", "pipe", "pipe"] });
+        const stdout = [];
+        const stderr = [];
+        let timedOut = false;
+        let timeoutHandle;
+        if (options.timeout !== undefined && options.timeout > 0) {
+            timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill();
+            }, options.timeout * 1000);
+        }
+        child.stdout.on("data", (data) => stdout.push(data));
+        child.stderr.on("data", (data) => stderr.push(data));
+        child.on("error", reject);
+        const onAbort = () => child.kill();
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        if (options.input !== undefined) {
+            child.stdin.end(options.input);
+        }
+        else {
+            child.stdin.end();
+        }
+        child.on("close", (code) => {
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            options.signal?.removeEventListener("abort", onAbort);
+            if (options.signal?.aborted) {
+                reject(new Error("aborted"));
+                return;
+            }
+            if (timedOut) {
+                reject(new Error(`timeout:${options.timeout}`));
+                return;
+            }
+            if (code !== 0) {
+                reject(new Error(Buffer.concat(stderr).toString("utf-8").trim() || `ssh exited with code ${code}`));
+                return;
+            }
+            resolve(Buffer.concat(stdout));
+        });
+    });
+}
+export class LocalToolOperations {
+    cwd;
+    shellPath;
+    constructor(cwd, options = {}) {
+        this.cwd = cwd;
+        this.shellPath = options.shellPath;
+    }
+    async exec(command, options) {
+        const cwd = options.cwd ?? this.cwd;
+        const { shell, args } = getShellConfig(this.shellPath);
+        try {
+            await fsAccess(cwd, constants.F_OK);
+        }
+        catch {
+            throw new Error(`Working directory does not exist: ${cwd}\nCannot execute bash commands.`);
+        }
+        if (options.signal?.aborted) {
+            throw new Error("aborted");
+        }
+        return new Promise((resolve, reject) => {
+            const child = spawn(shell, [...args, command], {
+                cwd,
+                detached: process.platform !== "win32",
+                env: options.env ?? getShellEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+                windowsHide: true,
+            });
+            if (child.pid)
+                trackDetachedChildPid(child.pid);
+            let timedOut = false;
+            let timeoutHandle;
+            if (options.timeout !== undefined && options.timeout > 0) {
+                timeoutHandle = setTimeout(() => {
+                    timedOut = true;
+                    if (child.pid)
+                        killProcessTree(child.pid);
+                }, options.timeout * 1000);
+            }
+            child.stdout?.on("data", options.onData);
+            child.stderr?.on("data", options.onData);
+            const onAbort = () => {
+                if (child.pid)
+                    killProcessTree(child.pid);
+            };
+            if (options.signal) {
+                if (options.signal.aborted)
+                    onAbort();
+                else
+                    options.signal.addEventListener("abort", onAbort, { once: true });
+            }
+            waitForChildProcess(child)
+                .then((code) => {
+                if (child.pid)
+                    untrackDetachedChildPid(child.pid);
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                if (options.signal?.aborted) {
+                    reject(new Error("aborted"));
+                    return;
+                }
+                if (timedOut) {
+                    reject(new Error(`timeout:${options.timeout}`));
+                    return;
+                }
+                resolve({ exitCode: code });
+            })
+                .catch((error) => {
+                if (child.pid)
+                    untrackDetachedChildPid(child.pid);
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                reject(error);
+            });
+        });
+    }
+    async access(path, mode) {
+        await fsAccess(path, accessModeToFsMode(mode));
+    }
+    async readFile(path) {
+        return fsReadFile(path);
+    }
+    async writeFile(path, content) {
+        await fsWriteFile(path, content, typeof content === "string" ? "utf-8" : undefined);
+    }
+    async mkdir(path, options = {}) {
+        await fsMkdir(path, { recursive: options.recursive ?? false });
+    }
+    async stat(path) {
+        return fsStat(path);
+    }
+    async readdir(path) {
+        return fsReaddir(path);
+    }
+    async detectImageMimeType(path) {
+        return detectSupportedImageMimeTypeFromFile(path);
+    }
+    getBackendInfo() {
+        return { type: "local", cwd: this.cwd };
+    }
+}
+export class SshToolOperations {
+    remote;
+    cwd;
+    constructor(options) {
+        this.remote = options.remote;
+        this.cwd = options.cwd;
+    }
+    static async fromTarget(target) {
+        const parsed = parseSshTarget(target);
+        validateSshRemote(parsed.remote);
+        const cwd = parsed.cwd ?? (await runSshBuffer(parsed.remote, "pwd")).toString("utf-8").trim();
+        return new SshToolOperations({ remote: parsed.remote, cwd });
+    }
+    async exec(command, options) {
+        const cwd = options.cwd ?? this.cwd;
+        const remoteCommand = `cd ${shellQuote(cwd)} && bash -s`;
+        return new Promise((resolve, reject) => {
+            const child = spawn("ssh", sshArgs(this.remote, remoteCommand), {
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            let timedOut = false;
+            let timeoutHandle;
+            if (options.timeout !== undefined && options.timeout > 0) {
+                timeoutHandle = setTimeout(() => {
+                    timedOut = true;
+                    child.kill();
+                }, options.timeout * 1000);
+            }
+            child.stdout?.on("data", options.onData);
+            child.stderr?.on("data", options.onData);
+            child.on("error", reject);
+            child.stdin.end(command);
+            const onAbort = () => child.kill();
+            options.signal?.addEventListener("abort", onAbort, { once: true });
+            child.on("close", (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                options.signal?.removeEventListener("abort", onAbort);
+                if (options.signal?.aborted) {
+                    reject(new Error("aborted"));
+                    return;
+                }
+                if (timedOut) {
+                    reject(new Error(`timeout:${options.timeout}`));
+                    return;
+                }
+                resolve({ exitCode: code });
+            });
+        });
+    }
+    async access(path, mode) {
+        const remotePath = shellQuote(path);
+        if (mode === "readwrite") {
+            await runSshBuffer(this.remote, `test -r ${remotePath} && test -w ${remotePath}`);
+            return;
+        }
+        const flag = mode === "read" ? "-r" : mode === "write" ? "-w" : "-e";
+        await runSshBuffer(this.remote, `test ${flag} ${remotePath}`);
+    }
+    async readFile(path) {
+        return runSshBuffer(this.remote, `cat ${shellQuote(path)}`);
+    }
+    async writeFile(path, content) {
+        await runSshBuffer(this.remote, `base64 -d > ${shellQuote(path)}`, {
+            input: Buffer.from(content).toString("base64"),
+        });
+    }
+    async mkdir(path, options = {}) {
+        const flag = options.recursive ? "-p " : "";
+        await runSshBuffer(this.remote, `mkdir ${flag}${shellQuote(path)}`);
+    }
+    async stat(path) {
+        const output = await runSshBuffer(this.remote, `if test -d ${shellQuote(path)}; then echo d; elif test -f ${shellQuote(path)}; then echo f; else test -e ${shellQuote(path)} && echo o || exit 1; fi`);
+        const kind = output.toString("utf-8").trim();
+        return {
+            isDirectory: () => kind === "d",
+            isFile: () => kind === "f",
+        };
+    }
+    async readdir(path) {
+        const output = await runSshBuffer(this.remote, `find ${shellQuote(path)} -maxdepth 1 -mindepth 1 -printf '%f\\n'`);
+        return output.toString("utf-8").split("\n").filter(Boolean);
+    }
+    async glob(pattern, cwd, options) {
+        const command = commandWithArgs("fd", buildFdArgs(pattern, cwd, options.limit));
+        const output = await runSshBuffer(this.remote, command);
+        return output.toString("utf-8").split("\n").filter(Boolean);
+    }
+    async grep(options) {
+        const isDirectory = (await this.stat(options.path)).isDirectory();
+        const command = commandWithArgs("rg", buildRgArgs(options));
+        const output = await runSshBuffer(this.remote, command).catch((error) => {
+            if (error instanceof Error && error.message.includes("ssh exited with code 1")) {
+                return Buffer.alloc(0);
+            }
+            throw error;
+        });
+        const matches = [];
+        for (const line of output.toString("utf-8").split("\n")) {
+            if (!line.trim() || matches.length >= options.limit)
+                continue;
+            let event;
+            try {
+                event = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (!event || typeof event !== "object" || !("type" in event) || event.type !== "match")
+                continue;
+            const data = "data" in event && event.data && typeof event.data === "object" ? event.data : undefined;
+            const filePath = data && "path" in data && data.path && typeof data.path === "object" && "text" in data.path
+                ? data.path.text
+                : undefined;
+            const lineNumber = data && "line_number" in data ? data.line_number : undefined;
+            const lineText = data && "lines" in data && data.lines && typeof data.lines === "object" && "text" in data.lines
+                ? data.lines.text
+                : undefined;
+            if (typeof filePath === "string" && typeof lineNumber === "number") {
+                matches.push({ filePath, lineNumber, lineText: typeof lineText === "string" ? lineText : undefined });
+            }
+        }
+        return { isDirectory, matches };
+    }
+    async detectImageMimeType(path) {
+        try {
+            const output = await runSshBuffer(this.remote, `file --mime-type -b ${shellQuote(path)}`);
+            const mimeType = output.toString("utf-8").trim();
+            return ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(mimeType) ? mimeType : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getBackendInfo() {
+        return { type: "ssh", remote: this.remote, cwd: this.cwd, configured: true };
+    }
+}
+export class DeferredSshToolOperations {
+    cwd;
+    operations;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async configure(options) {
+        const next = new SshToolOperations({ remote: options.remote, cwd: options.cwd ?? this.cwd });
+        const stat = await next.stat(next.cwd);
+        if (!stat.isDirectory()) {
+            throw new Error(`SSH sandbox cwd is not a directory: ${next.cwd}`);
+        }
+        this.cwd = next.cwd;
+        this.operations = next;
+        return this.getBackendInfo();
+    }
+    clear() {
+        this.operations = undefined;
+    }
+    requireOperations() {
+        if (!this.operations) {
+            throw new Error("SSH sandbox is not configured. Configure it over RPC or with /ssh-sandbox before using tools.");
+        }
+        return this.operations;
+    }
+    async exec(command, options) {
+        return this.requireOperations().exec(command, options);
+    }
+    async access(path, mode) {
+        await this.requireOperations().access(path, mode);
+    }
+    async readFile(path) {
+        return this.requireOperations().readFile(path);
+    }
+    async writeFile(path, content) {
+        await this.requireOperations().writeFile(path, content);
+    }
+    async mkdir(path, options) {
+        await this.requireOperations().mkdir(path, options);
+    }
+    async stat(path) {
+        return this.requireOperations().stat(path);
+    }
+    async readdir(path) {
+        return this.requireOperations().readdir(path);
+    }
+    async glob(pattern, cwd, options) {
+        return this.requireOperations().glob(pattern, cwd, options);
+    }
+    async grep(options) {
+        return this.requireOperations().grep(options);
+    }
+    async detectImageMimeType(path) {
+        return this.requireOperations().detectImageMimeType(path);
+    }
+    getBackendInfo() {
+        return this.operations?.getBackendInfo() ?? { type: "ssh", cwd: this.cwd, configured: false };
+    }
+}
+export function createSshToolOperations(target) {
+    return SshToolOperations.fromTarget(target);
+}
+//# sourceMappingURL=operations.js.map