@xopcai/xopc 0.0.122 → 0.0.124

package/dist/src/agent/tools/shell.js

@@ -1,158 +0,0 @@
-import { evaluateExecPolicy } from "../sandbox/exec-policy.js";
-import { spawn } from "child_process";
-import { Type } from "@sinclair/typebox";
-//#region src/agent/tools/shell.ts
-const MAX_SHELL_TIMEOUT = 300;
-const DEFAULT_MAX_BYTES = 50 * 1024;
-const DEFAULT_MAX_LINES = 2e3;
-const ShellSchema = Type.Object({ command: Type.String({ description: "Shell command to execute" }) });
-function formatSize(bytes) {
-	if (bytes < 1024) return `${bytes}B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
-	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-}
-function isLikelyTestCommand(command) {
-	return /\b(test|vitest|jest|pytest|go test|cargo test|npm test|pnpm test|yarn test)\b/i.test(command);
-}
-function truncateTail(content, maxLines = DEFAULT_MAX_LINES, maxBytes = DEFAULT_MAX_BYTES) {
-	const totalBytes = Buffer.byteLength(content, "utf-8");
-	const lines = content.split("\n");
-	const totalLines = lines.length;
-	if (totalLines <= maxLines && totalBytes <= maxBytes) return {
-		content,
-		truncated: false,
-		truncatedBy: null,
-		totalLines,
-		totalBytes,
-		outputLines: totalLines,
-		outputBytes: totalBytes
-	};
-	const outputLinesArr = [];
-	let outputBytesCount = 0;
-	let truncatedBy = "lines";
-	for (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {
-		const line = lines[i];
-		const lineBytes = Buffer.byteLength(line, "utf-8") + (outputLinesArr.length > 0 ? 1 : 0);
-		if (outputBytesCount + lineBytes > maxBytes) {
-			truncatedBy = "bytes";
-			break;
-		}
-		outputLinesArr.unshift(line);
-		outputBytesCount += lineBytes;
-	}
-	return {
-		content: outputLinesArr.join("\n"),
-		truncated: true,
-		truncatedBy,
-		totalLines,
-		totalBytes,
-		outputLines: outputLinesArr.length,
-		outputBytes: outputBytesCount
-	};
-}
-function createShellTool(cwd, options) {
-	return {
-		name: "shell",
-		description: "Execute shell command.",
-		parameters: ShellSchema,
-		label: "💻 Shell",
-		async execute(toolCallId, params, _signal) {
-			const p = params;
-			const passthroughNames = options?.getSkillPassthroughEnvVarNames?.() ?? [];
-			const policy = evaluateExecPolicy({
-				command: p.command,
-				cwd,
-				allowedEnvVars: passthroughNames
-			});
-			if (!policy.allowed) return {
-				content: [{
-					type: "text",
-					text: `🚫 Sandbox: ${policy.reason}`
-				}],
-				details: {
-					exitCode: null,
-					timedOut: false,
-					truncated: false
-				}
-			};
-			return new Promise((resolve) => {
-				let output = "";
-				let errorOutput = "";
-				let timedOut = false;
-				let tempStream = null;
-				const effectiveTimeoutSec = Math.min(MAX_SHELL_TIMEOUT, Math.ceil(policy.timeoutMs / 1e3));
-				const timeout = setTimeout(() => {
-					timedOut = true;
-					proc.kill("SIGKILL");
-				}, effectiveTimeoutSec * 1e3);
-				const proc = spawn(p.command, [], {
-					shell: true,
-					cwd: policy.effectiveCwd,
-					env: {
-						...policy.sanitizedEnv,
-						COLUMNS: "200"
-					}
-				});
-				proc.stdout?.on("data", (data) => {
-					const text = data.toString();
-					output += text;
-				});
-				proc.stderr?.on("data", (data) => {
-					const text = data.toString();
-					errorOutput += text;
-				});
-				proc.on("close", (code) => {
-					clearTimeout(timeout);
-					tempStream?.end();
-					const truncation = truncateTail(errorOutput + output);
-					let resultText = truncation.content;
-					if (timedOut) resultText = `⏱️ Command timed out after ${MAX_SHELL_TIMEOUT}s\n` + resultText;
-					if (truncation.truncated) resultText += `\n\n[Output truncated: ${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}]`;
-					const result = {
-						content: [{
-							type: "text",
-							text: resultText
-						}],
-						details: {
-							exitCode: code,
-							timedOut,
-							truncated: truncation.truncated,
-							truncatedBy: truncation.truncatedBy,
-							outputBytes: truncation.outputBytes
-						}
-					};
-					Promise.resolve(options?.recordGoalEvidence?.({
-						kind: timedOut || code !== 0 ? "command" : isLikelyTestCommand(p.command) ? "test" : "command",
-						title: `Command: ${p.command.slice(0, 120)}`,
-						summary: resultText.slice(0, 2e3),
-						data: {
-							command: p.command,
-							exitCode: code,
-							timedOut,
-							truncated: truncation.truncated,
-							outputBytes: truncation.outputBytes
-						}
-					})).finally(() => resolve(result));
-				});
-				proc.on("error", (err) => {
-					clearTimeout(timeout);
-					resolve({
-						content: [{
-							type: "text",
-							text: `Error: ${err.message}`
-						}],
-						details: {
-							exitCode: null,
-							timedOut: false,
-							truncated: false
-						}
-					});
-				});
-			});
-		}
-	};
-}
-//#endregion
-export { createShellTool };
-
-//# sourceMappingURL=shell.js.map

package/dist/src/agent/tools/shell.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell.js","names":[],"sources":["../../../../src/agent/tools/shell.ts"],"sourcesContent":["// Shell tool - executes commands with output truncation\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { spawn } from 'child_process';\nimport { evaluateExecPolicy } from '../sandbox/exec-policy.js';\nimport { createWriteStream } from 'fs';\nimport type { GoalEvidenceRecordInput } from './goal-evidence-recorder.js';\n\nconst MAX_SHELL_TIMEOUT = 300;\nconst DEFAULT_MAX_BYTES = 50 * 1024;\nconst DEFAULT_MAX_LINES = 2000;\n\nconst ShellSchema = Type.Object({\n  command: Type.String({ description: 'Shell command to execute' }),\n});\n\nexport interface ShellDetails {\n  exitCode: number | null;\n  timedOut: boolean;\n  truncated: boolean;\n  truncatedBy?: 'lines' | 'bytes';\n  outputBytes?: number;\n}\n\nfunction formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes}B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n}\n\nfunction isLikelyTestCommand(command: string): boolean {\n  return /\\b(test|vitest|jest|pytest|go test|cargo test|npm test|pnpm test|yarn test)\\b/i.test(command);\n}\n\nfunction truncateTail(content: string, maxLines = DEFAULT_MAX_LINES, maxBytes = DEFAULT_MAX_BYTES) {\n  const totalBytes = Buffer.byteLength(content, 'utf-8');\n  const lines = content.split('\\n');\n  const totalLines = lines.length;\n\n  if (totalLines <= maxLines && totalBytes <= maxBytes) {\n    return { content, truncated: false, truncatedBy: null, totalLines, totalBytes, outputLines: totalLines, outputBytes: totalBytes };\n  }\n\n  const outputLinesArr: string[] = [];\n  let outputBytesCount = 0;\n  let truncatedBy: 'lines' | 'bytes' = 'lines';\n\n  for (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {\n    const line = lines[i];\n    const lineBytes = Buffer.byteLength(line, 'utf-8') + (outputLinesArr.length > 0 ? 1 : 0);\n\n    if (outputBytesCount + lineBytes > maxBytes) {\n      truncatedBy = 'bytes';\n      break;\n    }\n\n    outputLinesArr.unshift(line);\n    outputBytesCount += lineBytes;\n  }\n\n  return { content: outputLinesArr.join('\\n'), truncated: true, truncatedBy, totalLines, totalBytes, outputLines: outputLinesArr.length, outputBytes: outputBytesCount };\n}\n\nexport interface CreateShellToolOptions {\n  /** Env var names allowed through {@link prepareSafeToolEnv} even if they match secret heuristics (skill passthrough). */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  recordGoalEvidence?: (input: GoalEvidenceRecordInput) => Promise<void> | void;\n}\n\nexport function createShellTool(\n  cwd: string,\n  options?: CreateShellToolOptions,\n): AgentTool {\n  return {\n    name: 'shell',\n    description: 'Execute shell command.',\n    parameters: ShellSchema,\n    label: '💻 Shell',\n\n    async execute(\n      toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<ShellDetails>> {\n      const p = params as { command: string };\n\n      // Sandbox exec-policy check (path + command injection + env sanitization)\n      const passthroughNames = options?.getSkillPassthroughEnvVarNames?.() ?? [];\n      const policy = evaluateExecPolicy({\n        command: p.command,\n        cwd,\n        allowedEnvVars: passthroughNames,\n      });\n      if (!policy.allowed) {\n        return {\n          content: [{ type: 'text', text: `🚫 Sandbox: ${policy.reason}` }],\n          details: { exitCode: null, timedOut: false, truncated: false },\n        };\n      }\n\n      return new Promise((resolve) => {\n        const _startTime = Date.now();\n        let output = '';\n        let errorOutput = '';\n        let timedOut = false;\n        let _tempFile: string | null = null;\n        let tempStream: ReturnType<typeof createWriteStream> | null = null;\n        const useTempFile = false; // Disabled - stream directly\n\n        const effectiveTimeoutSec = Math.min(\n          MAX_SHELL_TIMEOUT,\n          Math.ceil(policy.timeoutMs / 1000),\n        );\n        const timeout = setTimeout(() => {\n          timedOut = true;\n          proc.kill('SIGKILL');\n        }, effectiveTimeoutSec * 1000);\n\n        const proc = spawn(p.command, [], {\n          shell: true,\n          cwd: policy.effectiveCwd,\n          env: {\n            ...policy.sanitizedEnv,\n            COLUMNS: '200',\n          },\n        });\n\n        proc.stdout?.on('data', (data) => {\n          const text = data.toString();\n          if (!useTempFile) output += text;\n        });\n\n        proc.stderr?.on('data', (data) => {\n          const text = data.toString();\n          errorOutput += text;\n        });\n\n        proc.on('close', (code) => {\n          clearTimeout(timeout);\n          tempStream?.end();\n\n          const fullOutput = errorOutput + output;\n          const truncation = truncateTail(fullOutput);\n\n          let resultText = truncation.content;\n          if (timedOut) {\n            resultText = `⏱️ Command timed out after ${MAX_SHELL_TIMEOUT}s\\n` + resultText;\n          }\n          if (truncation.truncated) {\n            resultText += `\\n\\n[Output truncated: ${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}]`;\n          }\n\n          const result: AgentToolResult<ShellDetails> = {\n            content: [{ type: 'text', text: resultText }],\n            details: {\n              exitCode: code,\n              timedOut,\n              truncated: truncation.truncated,\n              truncatedBy: truncation.truncatedBy,\n              outputBytes: truncation.outputBytes,\n            },\n          };\n          void Promise.resolve(options?.recordGoalEvidence?.({\n            kind: timedOut || code !== 0 ? 'command' : isLikelyTestCommand(p.command) ? 'test' : 'command',\n            title: `Command: ${p.command.slice(0, 120)}`,\n            summary: resultText.slice(0, 2000),\n            data: {\n              command: p.command,\n              exitCode: code,\n              timedOut,\n              truncated: truncation.truncated,\n              outputBytes: truncation.outputBytes,\n            },\n          })).finally(() => resolve(result));\n        });\n\n        proc.on('error', (err) => {\n          clearTimeout(timeout);\n          resolve({\n            content: [{ type: 'text', text: `Error: ${err.message}` }],\n            details: { exitCode: null, timedOut: false, truncated: false },\n          });\n        });\n      });\n    },\n  } as any;\n}\n"],"mappings":"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"}