visionclaw 0.1.211-beta.6 → 0.1.211

package/dist/agent/engines/openai/file-tools.js

@@ -0,0 +1,194 @@
+/**
+ * Local Shell and Editor adapters for the OpenAI Agents SDK's `shellTool`
+ * and `applyPatchTool`.
+ *
+ * VisionClaw runs autonomously and Claude already has broad local tool
+ * access, so these adapters intentionally allow broad filesystem scope
+ * (bounded only by OS/user permissions). They still apply practical
+ * runtime limits (timeout + output truncation) and log every invocation
+ * so we have an audit trail.
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { applyDiff, } from "@openai/agents-core";
+import { logger } from "../../../logger.js";
+/**
+ * Hard ceiling for a single shell tool call regardless of what the model
+ * requests. Prevents the agent from hanging the turn on a runaway command.
+ */
+const SHELL_DEFAULT_TIMEOUT_MS = 60_000;
+const SHELL_MAX_TIMEOUT_MS = 5 * 60_000;
+/**
+ * Hard ceiling on stdout/stderr length per command. Anything beyond this
+ * gets a truncation marker so the model is aware. Keeps a runaway command
+ * from blowing the context window.
+ */
+const SHELL_DEFAULT_MAX_OUTPUT = 16_000;
+const SHELL_MAX_OUTPUT_HARD = 64_000;
+function clampNumber(value, fallback, max) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.min(value, max);
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    const head = text.slice(0, max);
+    const dropped = text.length - max;
+    return `${head}\n…[truncated ${dropped} bytes]`;
+}
+function isFileExistsError(err) {
+    return Boolean(err && typeof err === "object" && err.code === "EEXIST");
+}
+/**
+ * Run a single shell command line via `/bin/sh -c <cmd>` and capture its
+ * stdout/stderr. Returns the SDK-shaped `ShellOutputResult`.
+ */
+async function runOne(command, timeoutMs, maxOutputLength) {
+    return new Promise((resolve) => {
+        // `detached: true` puts the child shell in its own process group, so on
+        // timeout we can SIGKILL the whole group (`-pid`) and clean up any
+        // descendants the model spawned (e.g. backgrounded servers, pipelines).
+        const child = spawn("/bin/sh", ["-c", command], {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+            detached: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const killGroup = () => {
+            if (typeof child.pid !== "number") {
+                return;
+            }
+            try {
+                // Negative pid => signal the entire process group.
+                process.kill(-child.pid, "SIGKILL");
+            }
+            catch {
+                // Group already gone (or never created on this platform). Fall
+                // back to killing just the immediate child.
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch {
+                    // ignore — process already gone
+                }
+            }
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killGroup();
+        }, timeoutMs);
+        child.stdout.setEncoding("utf-8");
+        child.stderr.setEncoding("utf-8");
+        child.stdout.on("data", (chunk) => {
+            if (stdout.length < maxOutputLength)
+                stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            if (stderr.length < maxOutputLength)
+                stderr += chunk;
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolve({
+                stdout: truncate(stdout, maxOutputLength),
+                stderr: truncate(stderr + (stderr ? "\n" : "") + (err instanceof Error ? err.message : String(err)), maxOutputLength),
+                outcome: { type: "exit", exitCode: null },
+            });
+        });
+        child.on("close", (code, signal) => {
+            clearTimeout(timer);
+            if (timedOut) {
+                resolve({
+                    stdout: truncate(stdout, maxOutputLength),
+                    stderr: truncate(stderr + (stderr ? "\n" : "") + `Command timed out after ${timeoutMs}ms (signal=${signal ?? "SIGKILL"})`, maxOutputLength),
+                    outcome: { type: "timeout" },
+                });
+                return;
+            }
+            resolve({
+                stdout: truncate(stdout, maxOutputLength),
+                stderr: truncate(stderr, maxOutputLength),
+                outcome: { type: "exit", exitCode: typeof code === "number" ? code : null },
+            });
+        });
+    });
+}
+/**
+ * Local Shell adapter: executes each command sequentially, capturing
+ * stdout/stderr with a per-command timeout and output cap.
+ */
+export class LocalShell {
+    async run(action) {
+        const timeoutMs = clampNumber(action.timeoutMs, SHELL_DEFAULT_TIMEOUT_MS, SHELL_MAX_TIMEOUT_MS);
+        const maxOutputLength = clampNumber(action.maxOutputLength, SHELL_DEFAULT_MAX_OUTPUT, SHELL_MAX_OUTPUT_HARD);
+        const output = [];
+        for (const command of action.commands) {
+            logger.info(`[openai/shell] $ ${command}`);
+            const result = await runOne(command, timeoutMs, maxOutputLength);
+            const exitCode = result.outcome.type === "exit" ? result.outcome.exitCode : "timeout";
+            logger.info(`[openai/shell] exit=${String(exitCode)} stdout=${result.stdout.length}B stderr=${result.stderr.length}B`);
+            output.push(result);
+        }
+        return { output, maxOutputLength };
+    }
+}
+/**
+ * Local Editor adapter: handles `create_file`, `update_file`, and
+ * `delete_file` ApplyPatch operations using the SDK's `applyDiff` helper
+ * for V4A patch semantics.
+ */
+export class LocalEditor {
+    async createFile(operation) {
+        const target = path.resolve(process.cwd(), operation.path);
+        logger.info(`[openai/apply_patch] create ${target}`);
+        try {
+            await fs.mkdir(path.dirname(target), { recursive: true });
+            const content = applyDiff("", operation.diff, "create");
+            // `wx` => fail if the file already exists. V4A `create_file` is meant
+            // for new files; if the target exists the model should use
+            // `update_file` instead so we don't silently clobber data.
+            await fs.writeFile(target, content, { encoding: "utf-8", flag: "wx" });
+            return { status: "completed", output: `Created ${operation.path}` };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const detail = isFileExistsError(err)
+                ? `${operation.path} already exists; use update_file to modify it`
+                : message;
+            return { status: "failed", output: `Failed to create ${operation.path}: ${detail}` };
+        }
+    }
+    async updateFile(operation) {
+        const target = path.resolve(process.cwd(), operation.path);
+        logger.info(`[openai/apply_patch] update ${target}`);
+        try {
+            const original = await fs.readFile(target, "utf-8");
+            const updated = applyDiff(original, operation.diff, "default");
+            await fs.writeFile(target, updated, "utf-8");
+            return { status: "completed", output: `Updated ${operation.path}` };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { status: "failed", output: `Failed to update ${operation.path}: ${message}` };
+        }
+    }
+    async deleteFile(operation) {
+        const target = path.resolve(process.cwd(), operation.path);
+        logger.info(`[openai/apply_patch] delete ${target}`);
+        try {
+            await fs.unlink(target);
+            return { status: "completed", output: `Deleted ${operation.path}` };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { status: "failed", output: `Failed to delete ${operation.path}: ${message}` };
+        }
+    }
+}
+//# sourceMappingURL=file-tools.js.map

package/dist/agent/engines/openai/file-tools.js.map

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

package/dist/agent/engines/openai/session.d.ts

@@ -0,0 +1,55 @@
+import type { MessageParam } from "@anthropic-ai/sdk/resources";
+import type { SessionMode } from "../../mailbox.js";
+import type { AgentSessionConstructorArgs, AgentSessionLike, AgentStreamMessage, CurrentQueryLike, InjectMessageOptions, SendAndStreamOptions, UsageSnapshot } from "../session-types.js";
+export declare class OpenAIAgentSession implements AgentSessionLike {
+    private readonly config;
+    private readonly buildSystemPrompt;
+    private readonly runtimeSurface;
+    private readonly getDualSessionEnabled;
+    private readonly getAndroidUseEnabled;
+    private readonly getCardAvailable;
+    private dynamicMcpServers;
+    private readonly client;
+    private readonly runner;
+    private readonly underlyingSession;
+    private readonly session;
+    private abortController;
+    private inputClosed;
+    private stopRequested;
+    private lastUsageSnapshot;
+    private currentRun;
+    private sessionId;
+    readonly hasOrphanedInjections = false;
+    readonly mode: SessionMode;
+    constructor({ config, buildSystemPrompt, runtimeSurface, sessionContext, }: AgentSessionConstructorArgs);
+    warmUp(): Promise<void>;
+    discardWarmQuery(): void;
+    sendAndStream(content: MessageParam["content"], _options?: SendAndStreamOptions): AsyncIterable<AgentStreamMessage>;
+    injectMessage(_content: MessageParam["content"], _options?: InjectMessageOptions): boolean;
+    closeInput(): void;
+    requestStop(): void;
+    clearStop(): void;
+    isStopRequested(): boolean;
+    /**
+     * Update the persisted session ID.
+     *
+     * Only saves on first capture (null/empty → id). Once set, a different ID
+     * from the SDK is ignored — it means the resume failed and the SDK created
+     * a throwaway conversation.
+     */
+    captureSessionId(id: string | undefined): void;
+    captureUsageSnapshot(snapshot: UsageSnapshot): void;
+    capturePostCompactionSnapshot(_postCompactionTokens: number): void;
+    requestCompaction(): Promise<void>;
+    maybeCompact(): Promise<void>;
+    getSessionId(): string | null;
+    resetForNewSession(_summary?: string): void;
+    getTranscriptPath(): string | null;
+    getUsageSnapshot(): UsageSnapshot | null;
+    getCurrentQuery(): CurrentQueryLike | null;
+    setDynamicMcpServers(servers: Record<string, Record<string, unknown>>): void;
+    getDynamicMcpServers(): Record<string, Record<string, unknown>>;
+    get isInputClosed(): boolean;
+    private streamMessages;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/agent/engines/openai/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/agent/engines/openai/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,OAAO,KAAK,EACV,2BAA2B,EAE3B,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EAEpB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAkB7B,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,SAAS,CAAS;IAC1B,QAAQ,CAAC,qBAAqB,SAAS;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,EACV,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,EAAE,2BAA2B;IAqCxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,gBAAgB,IAAI,IAAI;IAIxB,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,kBAAkB,CAAC;IAcnH,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO;IAK1F,UAAU,IAAI,IAAI;IAIlB,WAAW,IAAI,IAAI;IAMnB,SAAS,IAAI,IAAI;IAKjB,eAAe,IAAI,OAAO;IAI1B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAM9C,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAYnD,6BAA6B,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI;IAI5D,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAK3C,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,eAAe,IAAI,gBAAgB,GAAG,IAAI;IAI1C,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAI5E,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/D,IAAI,aAAa,IAAI,OAAO,CAE3B;YAEc,cAAc;CA6D9B"}