oh-my-claude-sisyphus 3.2.5 → 3.3.1

package/dist/tools/python-repl/socket-client.js

@@ -0,0 +1,157 @@
+import * as net from 'net';
+import { randomUUID } from 'crypto';
+/**
+ * Custom error types for socket communication
+ */
+export class SocketConnectionError extends Error {
+    socketPath;
+    originalError;
+    constructor(message, socketPath, originalError) {
+        super(message);
+        this.socketPath = socketPath;
+        this.originalError = originalError;
+        this.name = 'SocketConnectionError';
+    }
+}
+export class SocketTimeoutError extends Error {
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+        this.name = 'SocketTimeoutError';
+    }
+}
+export class JsonRpcError extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'JsonRpcError';
+    }
+}
+/**
+ * Send a JSON-RPC 2.0 request over Unix socket
+ *
+ * @param socketPath - Path to the Unix socket
+ * @param method - JSON-RPC method name
+ * @param params - Optional parameters object
+ * @param timeout - Request timeout in milliseconds (default: 60000ms / 1 min)
+ * @returns Promise resolving to the result typed as T
+ *
+ * @throws {SocketConnectionError} If socket connection fails
+ * @throws {SocketTimeoutError} If request times out
+ * @throws {JsonRpcError} If server returns an error response
+ *
+ * @example
+ * ```typescript
+ * const result = await sendSocketRequest<ExecuteResult>(
+ *   '/tmp/omc/abc123/bridge.sock',
+ *   'execute',
+ *   { code: 'print("hello")' },
+ *   60000
+ * );
+ * ```
+ */
+export async function sendSocketRequest(socketPath, method, params, timeout = 60000) {
+    return new Promise((resolve, reject) => {
+        const id = randomUUID();
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            params: params ?? {},
+        };
+        const requestLine = JSON.stringify(request) + '\n';
+        let responseBuffer = '';
+        let timedOut = false;
+        const MAX_RESPONSE_SIZE = 2 * 1024 * 1024; // 2MB
+        // Timeout handler
+        const timer = setTimeout(() => {
+            timedOut = true;
+            socket.destroy();
+            reject(new SocketTimeoutError(`Request timeout after ${timeout}ms for method "${method}"`, timeout));
+        }, timeout);
+        // Cleanup helper
+        const cleanup = () => {
+            clearTimeout(timer);
+            socket.removeAllListeners();
+            socket.destroy();
+        };
+        // Create socket connection
+        const socket = net.createConnection({ path: socketPath });
+        // Connection established - send request
+        socket.on('connect', () => {
+            socket.write(requestLine);
+        });
+        // Receive data
+        socket.on('data', (chunk) => {
+            responseBuffer += chunk.toString();
+            // Prevent memory exhaustion from huge responses
+            if (responseBuffer.length > MAX_RESPONSE_SIZE) {
+                cleanup();
+                reject(new Error(`Response exceeded maximum size of ${MAX_RESPONSE_SIZE} bytes`));
+                return;
+            }
+            // Check for complete newline-delimited response
+            const newlineIndex = responseBuffer.indexOf('\n');
+            if (newlineIndex !== -1) {
+                const jsonLine = responseBuffer.slice(0, newlineIndex);
+                cleanup();
+                try {
+                    const response = JSON.parse(jsonLine);
+                    // Validate JSON-RPC 2.0 response format
+                    if (response.jsonrpc !== '2.0') {
+                        reject(new Error(`Invalid JSON-RPC version: expected "2.0", got "${response.jsonrpc}"`));
+                        return;
+                    }
+                    // Validate response ID matches request
+                    if (response.id !== id) {
+                        reject(new Error(`Response ID mismatch: expected "${id}", got "${response.id}"`));
+                        return;
+                    }
+                    // Handle error response
+                    if (response.error) {
+                        reject(new JsonRpcError(response.error.message, response.error.code, response.error.data));
+                        return;
+                    }
+                    // Success - return result
+                    resolve(response.result);
+                }
+                catch (e) {
+                    reject(new Error(`Failed to parse JSON-RPC response: ${e.message}`));
+                }
+            }
+        });
+        // Handle connection errors
+        socket.on('error', (err) => {
+            if (timedOut) {
+                return; // Timeout already handled
+            }
+            cleanup();
+            // Provide specific error messages for common cases
+            if (err.code === 'ENOENT') {
+                reject(new SocketConnectionError(`Socket does not exist at path: ${socketPath}`, socketPath, err));
+            }
+            else if (err.code === 'ECONNREFUSED') {
+                reject(new SocketConnectionError(`Connection refused - server not listening at: ${socketPath}`, socketPath, err));
+            }
+            else {
+                reject(new SocketConnectionError(`Socket connection error: ${err.message}`, socketPath, err));
+            }
+        });
+        // Handle connection close
+        socket.on('close', () => {
+            if (timedOut) {
+                return; // Timeout already handled
+            }
+            // If we haven't received a complete response, this is an error
+            if (responseBuffer.indexOf('\n') === -1) {
+                cleanup();
+                reject(new Error(`Socket closed without sending complete response (method: "${method}")`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=socket-client.js.map

package/dist/tools/python-repl/socket-client.js.map

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

package/dist/tools/python-repl/tool.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Python REPL Tool - Main handler implementation
+ *
+ * Provides a persistent Python REPL environment for code execution.
+ * JSON-RPC 2.0 over Unix socket with session locking and timeout escalation.
+ *
+ * Actions:
+ * - execute: Run Python code in the persistent environment
+ * - interrupt: Send interrupt to running code with signal escalation
+ * - reset: Clear the execution namespace
+ * - get_state: Get memory usage and variable list
+ *
+ * @module python-repl/tool
+ */
+import { z } from 'zod';
+import type { PythonReplInput } from './types.js';
+/**
+ * Input schema for the Python REPL tool.
+ * Validates and types all input parameters.
+ */
+export declare const pythonReplSchema: z.ZodObject<{
+    action: z.ZodEnum<["execute", "interrupt", "reset", "get_state"]>;
+    researchSessionID: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    executionLabel: z.ZodOptional<z.ZodString>;
+    executionTimeout: z.ZodDefault<z.ZodNumber>;
+    queueTimeout: z.ZodDefault<z.ZodNumber>;
+    projectDir: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "execute" | "interrupt" | "reset" | "get_state";
+    researchSessionID: string;
+    executionTimeout: number;
+    queueTimeout: number;
+    code?: string | undefined;
+    executionLabel?: string | undefined;
+    projectDir?: string | undefined;
+}, {
+    action: "execute" | "interrupt" | "reset" | "get_state";
+    researchSessionID: string;
+    code?: string | undefined;
+    executionLabel?: string | undefined;
+    executionTimeout?: number | undefined;
+    queueTimeout?: number | undefined;
+    projectDir?: string | undefined;
+}>;
+export type PythonReplSchemaInput = z.infer<typeof pythonReplSchema>;
+/**
+ * Get and increment the execution counter for a session.
+ * Used for tracking execution order in a session.
+ */
+declare function getNextExecutionCount(sessionId: string): number;
+/**
+ * Main handler for the Python REPL tool.
+ *
+ * @param input - Validated input from the tool call
+ * @returns Formatted string output for Claude
+ *
+ * @example
+ * ```typescript
+ * const output = await pythonReplHandler({
+ *   action: 'execute',
+ *   researchSessionID: 'my-session',
+ *   code: 'print("Hello, World!")',
+ * });
+ * ```
+ */
+export declare function pythonReplHandler(input: PythonReplInput): Promise<string>;
+/**
+ * Tool definition for registration with the tool registry.
+ */
+export declare const pythonReplTool: {
+    name: string;
+    description: string;
+    schema: {
+        action: z.ZodEnum<["execute", "interrupt", "reset", "get_state"]>;
+        researchSessionID: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        executionLabel: z.ZodOptional<z.ZodString>;
+        executionTimeout: z.ZodDefault<z.ZodNumber>;
+        queueTimeout: z.ZodDefault<z.ZodNumber>;
+        projectDir: z.ZodOptional<z.ZodString>;
+    };
+    handler: (args: unknown) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export { getNextExecutionCount };
+/**
+ * Reset the execution counter for a session.
+ * Useful for testing or when manually resetting state.
+ */
+export declare function resetExecutionCounter(sessionId: string): void;
+/**
+ * Get the current execution count for a session without incrementing.
+ */
+export declare function getExecutionCount(sessionId: string): number;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tools/python-repl/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/tools/python-repl/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,YAAY,CAAC;AAsBpB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EA6C3B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAQrE;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AA8YD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsJ/E;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;oBAQH,OAAO;;;;;;CAM9B,CAAC;AAMF,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D"}