patchwork-os 0.2.0-alpha.0

package/dist/tools/stackTraceParser.js

@@ -0,0 +1,139 @@
+import path from "node:path";
+/**
+ * Heuristic stack-trace parser. Recognises:
+ *   Node/V8: `    at fn (/abs/path/file.ts:123:45)`
+ *            `    at /abs/path/file.ts:123:45`
+ *   Browser: `fn@http://host/path/file.js:123:45`
+ *            `http://host/path/file.js:123:45`
+ *   Python:  `  File "/path/file.py", line 123, in fn`
+ *   Generic: any `file:line:column` or `file:line` inside the text.
+ *
+ * Frames are returned in the order they appear — the first frame is the
+ * top of the stack (where the error was thrown / re-raised last).
+ */
+export function parseStackTrace(text) {
+    const frames = [];
+    const seen = new Set();
+    const push = (f) => {
+        const key = `${f.file}:${f.line}:${f.column ?? ""}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        frames.push(f);
+    };
+    // Iterate line-by-line so we preserve stack order and keep per-frame regexes
+    // anchored (no cross-line bleed).
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Node/V8: `at fn (path:L:C)` or `at path:L:C`
+        const nodeParen = /^at\s+(.+?)\s+\((.+?):(\d+)(?::(\d+))?\)$/.exec(trimmed);
+        if (nodeParen) {
+            push({
+                raw: trimmed,
+                function: nodeParen[1] ?? null,
+                file: nodeParen[2] ?? "",
+                line: Number.parseInt(nodeParen[3] ?? "0", 10),
+                column: nodeParen[4] ? Number.parseInt(nodeParen[4], 10) : null,
+                language: "node",
+            });
+            continue;
+        }
+        const nodeBare = /^at\s+(.+?):(\d+)(?::(\d+))?$/.exec(trimmed);
+        if (nodeBare) {
+            push({
+                raw: trimmed,
+                function: null,
+                file: nodeBare[1] ?? "",
+                line: Number.parseInt(nodeBare[2] ?? "0", 10),
+                column: nodeBare[3] ? Number.parseInt(nodeBare[3], 10) : null,
+                language: "node",
+            });
+            continue;
+        }
+        // Python: `File "path", line N, in fn`
+        const py = /^File\s+"([^"]+)",\s+line\s+(\d+)(?:,\s+in\s+(.+))?$/.exec(trimmed);
+        if (py) {
+            push({
+                raw: trimmed,
+                function: py[3] ?? null,
+                file: py[1] ?? "",
+                line: Number.parseInt(py[2] ?? "0", 10),
+                column: null,
+                language: "python",
+            });
+            continue;
+        }
+        // Browser: `fn@url:L:C` (Firefox/Safari format)
+        const browserAt = /^(.+?)@(.+?):(\d+)(?::(\d+))?$/.exec(trimmed);
+        if (browserAt && !browserAt[2]?.includes(" ")) {
+            push({
+                raw: trimmed,
+                function: browserAt[1] ?? null,
+                file: browserAt[2] ?? "",
+                line: Number.parseInt(browserAt[3] ?? "0", 10),
+                column: browserAt[4] ? Number.parseInt(browserAt[4], 10) : null,
+                language: "browser",
+            });
+            continue;
+        }
+        // Generic fallback: first `file:line:col` or `file:line` in the text.
+        const generic = /([^\s:()]+):(\d+)(?::(\d+))?/.exec(trimmed);
+        if (generic) {
+            const file = generic[1] ?? "";
+            // Skip bare numbers, URLs without paths, and obviously-non-code (e.g. timestamps).
+            if (file.length < 2 || /^\d+$/.test(file))
+                continue;
+            push({
+                raw: trimmed,
+                function: null,
+                file,
+                line: Number.parseInt(generic[2] ?? "0", 10),
+                column: generic[3] ? Number.parseInt(generic[3], 10) : null,
+                language: "generic",
+            });
+        }
+    }
+    return frames;
+}
+/**
+ * Resolve a parsed frame's `file` to an absolute path inside `workspace`.
+ * Handles:
+ *   - absolute paths inside the workspace → pass through
+ *   - workspace-relative paths → joined with workspace
+ *   - URL-form paths (http://host/a/b/file.ts) → strip scheme+host, try as relative
+ *
+ * Returns `null` for paths that resolve outside the workspace (security
+ * guard — we don't want to blame files outside the project root).
+ */
+export function resolveFrameFile(workspace, file) {
+    if (!file)
+        return null;
+    // Strip URL scheme + host → treat as workspace-relative path (leading `/`
+    // from the URL path is stripped so it doesn't become root-absolute).
+    let candidate = file;
+    let wasUrl = false;
+    const urlMatch = /^[a-z]+:\/\/[^/]+\/(.*)$/i.exec(candidate);
+    if (urlMatch?.[1] !== undefined) {
+        candidate = urlMatch[1];
+        wasUrl = true;
+    }
+    // Strip webpack-style prefixes: "webpack://app/./src/..." → "src/..."
+    const webpack = /^webpack:\/\/[^/]*\/\.?\/?(.+)$/.exec(candidate);
+    if (webpack?.[1]) {
+        candidate = webpack[1];
+        wasUrl = true;
+    }
+    const absolute = !wasUrl && path.isAbsolute(candidate)
+        ? candidate
+        : path.resolve(workspace, candidate);
+    const normalizedWorkspace = path.resolve(workspace) + path.sep;
+    const normalized = path.resolve(absolute);
+    if (normalized !== path.resolve(workspace) &&
+        !normalized.startsWith(normalizedWorkspace)) {
+        return null;
+    }
+    return normalized;
+}
+//# sourceMappingURL=stackTraceParser.js.map

package/dist/tools/stackTraceParser.js.map

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

package/dist/tools/terminal.d.ts

@@ -0,0 +1,352 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetTerminalOutputTool(extensionClient: ExtensionClient, terminalPrefix?: string): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                index: {
+                    type: "integer";
+                    description: string;
+                };
+                lines: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                output: {
+                    type: string;
+                };
+                lines: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createCreateTerminalTool(workspace: string, extensionClient: ExtensionClient, terminalPrefix?: string): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                cwd: {
+                    type: "string";
+                    description: string;
+                };
+                env: {
+                    type: "object";
+                    description: string;
+                    additionalProperties: {
+                        type: "string";
+                    };
+                };
+                show: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                name: {
+                    type: string;
+                };
+                index: {
+                    type: string;
+                };
+            };
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createWaitForTerminalOutputTool(extensionClient: ExtensionClient, terminalPrefix?: string): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                pattern: {
+                    type: "string";
+                    description: string;
+                };
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                index: {
+                    type: "integer";
+                    description: string;
+                };
+                timeout: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                matched: {
+                    type: string;
+                };
+                matchedLine: {
+                    type: string;
+                };
+                elapsed: {
+                    type: string;
+                };
+                timedOut: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createRunInTerminalTool(workspace: string, extensionClient: ExtensionClient, commandAllowlist: string[], terminalPrefix?: string): {
+    schema: {
+        name: string;
+        annotations: {
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                command: {
+                    type: "string";
+                    description: string;
+                };
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                index: {
+                    type: "integer";
+                    description: string;
+                };
+                timeout: {
+                    type: "integer";
+                    description: string;
+                };
+                show: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                exitCode: {
+                    type: string;
+                };
+                stdout: {
+                    type: string;
+                };
+                stderr: {
+                    type: string;
+                };
+                fallback: {
+                    type: string;
+                };
+            };
+        };
+    };
+    timeoutMs: number;
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createDisposeTerminalTool(extensionClient: ExtensionClient, terminalPrefix?: string): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                index: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                disposed: {
+                    type: string;
+                };
+            };
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};
+export declare function createSendTerminalCommandTool(extensionClient: ExtensionClient, commandAllowlist: string[], terminalPrefix?: string): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        annotations: {
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                text: {
+                    type: "string";
+                    description: string;
+                };
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                index: {
+                    type: "integer";
+                    description: string;
+                };
+                addNewline: {
+                    type: "boolean";
+                    description: string;
+                };
+                isCommand: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                sent: {
+                    type: string;
+                };
+            };
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};