plugsuits 1.0.0

package/dist/tools/execute/shell-execute.test.js

@@ -0,0 +1,86 @@
+import { afterAll, beforeAll, describe, expect, it } from "bun:test";
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { executeCommand } from "./shell-execute";
+describe("executeCommand", () => {
+    let tempDir;
+    beforeAll(() => {
+        tempDir = mkdtempSync(join(tmpdir(), "shell-test-"));
+    });
+    afterAll(() => {
+        if (existsSync(tempDir)) {
+            rmSync(tempDir, { recursive: true });
+        }
+    });
+    describe("basic execution", () => {
+        it("executes simple echo command", async () => {
+            const result = await executeCommand('echo "hello world"');
+            expect(result.output).toContain("hello world");
+            expect(result.exitCode).toBe(0);
+        });
+        it("captures multiline output", async () => {
+            const result = await executeCommand("printf 'line1\\nline2\\nline3'");
+            expect(result.output).toContain("line1");
+            expect(result.output).toContain("line2");
+            expect(result.output).toContain("line3");
+        });
+        it("combines stdout and stderr", async () => {
+            const result = await executeCommand('echo "stdout" && echo "stderr" >&2');
+            expect(result.output).toContain("stdout");
+            expect(result.output).toContain("stderr");
+        });
+        it("handles empty output", async () => {
+            const result = await executeCommand("true");
+            expect(result.output).toBe("");
+            expect(result.exitCode).toBe(0);
+        });
+        it("executes command in specified workdir", async () => {
+            const result = await executeCommand("pwd", { workdir: tempDir });
+            expect(result.output).toContain("shell-test-");
+            expect(result.exitCode).toBe(0);
+        });
+    });
+    describe("exit code propagation", () => {
+        it("returns non-zero exit code for failed command", async () => {
+            const result = await executeCommand("exit 42");
+            expect(result.exitCode).toBe(42);
+        });
+        it("returns zero for successful command", async () => {
+            const result = await executeCommand("echo ok");
+            expect(result.exitCode).toBe(0);
+        });
+        it("returns exit code from last command in chain", async () => {
+            const result = await executeCommand("true && exit 5");
+            expect(result.exitCode).toBe(5);
+        });
+    });
+    describe("timeout formatting", () => {
+        it("includes [TIMEOUT] prefix when command exceeds timeout", async () => {
+            const result = await executeCommand("sleep 10", { timeoutMs: 200 });
+            expect(result.output).toContain("[TIMEOUT]");
+            expect(result.exitCode).toBe(124);
+        }, 5000);
+        it("includes timeout duration in timeout message", async () => {
+            const result = await executeCommand("sleep 10", { timeoutMs: 300 });
+            expect(result.output).toContain("300ms");
+        }, 5000);
+    });
+    describe("background process detection", () => {
+        it("wraps output with background message for commands ending with &", async () => {
+            const result = await executeCommand("sleep 0.1 &");
+            expect(result.exitCode).toBe(0);
+            expect(result.output).toContain("[Background process started]");
+        });
+        it("does not treat && as background operator", async () => {
+            const result = await executeCommand('echo "first" && echo "second"');
+            expect(result.output).toContain("first");
+            expect(result.output).not.toContain("[Background process started]");
+        });
+        it("does not treat mid-command & as background", async () => {
+            const result = await executeCommand("sleep 0.1 & wait");
+            expect(result.output).not.toContain("[Background process started]");
+        });
+    });
+});
+//# sourceMappingURL=shell-execute.test.js.map

package/dist/tools/execute/shell-execute.test.js.map

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

package/dist/tools/execute/shell-interact.d.ts

@@ -0,0 +1,10 @@
+export declare function parseKeys(input: string): string[];
+export interface InteractResult {
+    output: string;
+    success: boolean;
+}
+export declare const shellInteractTool: import("ai").Tool<{
+    keystrokes: string;
+    timeout_ms?: number | undefined;
+}, InteractResult>;
+//# sourceMappingURL=shell-interact.d.ts.map

package/dist/tools/execute/shell-interact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-interact.d.ts","sourceRoot":"","sources":["../../../src/tools/execute/shell-interact.ts"],"names":[],"mappings":"AA0DA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0CjD;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD,eAAO,MAAM,iBAAiB;;;kBAyB5B,CAAC"}

package/dist/tools/execute/shell-interact.js

@@ -0,0 +1,122 @@
+import { tool } from "ai";
+import { z } from "zod";
+import SHELL_INTERACT_DESCRIPTION from "./shell-interact.txt";
+const SPECIAL_KEYS = {
+    enter: "Enter",
+    tab: "Tab",
+    escape: "Escape",
+    esc: "Escape",
+    backspace: "BSpace",
+    delete: "DC",
+    del: "DC",
+    up: "Up",
+    down: "Down",
+    left: "Left",
+    right: "Right",
+    home: "Home",
+    end: "End",
+    pageup: "PPage",
+    pagedown: "NPage",
+    space: "Space",
+    "ctrl+c": "C-c",
+    "ctrl+d": "C-d",
+    "ctrl+z": "C-z",
+    "ctrl+l": "C-l",
+    "ctrl+a": "C-a",
+    "ctrl+e": "C-e",
+    "ctrl+k": "C-k",
+    "ctrl+u": "C-u",
+    "ctrl+w": "C-w",
+    "ctrl+r": "C-r",
+};
+const HTML_TOKEN_START = "<";
+const HTML_TOKEN_END = ">";
+const HTML_AMP_PATTERN = /&/gi;
+const CTRL_DASH_SHORTCUT_PATTERN = /^c-[a-z]$/;
+const CTRL_DASH_PATTERN = /^ctrl-[a-z]$/;
+function normalizeSpecialToken(token) {
+    const compact = token.toLowerCase().replace(/\s+/g, "");
+    if (CTRL_DASH_SHORTCUT_PATTERN.test(compact)) {
+        return `ctrl+${compact[2]}`;
+    }
+    if (CTRL_DASH_PATTERN.test(compact)) {
+        return `ctrl+${compact[5]}`;
+    }
+    return compact;
+}
+function mapSpecialToken(token) {
+    const normalizedToken = normalizeSpecialToken(token);
+    return SPECIAL_KEYS[normalizedToken];
+}
+export function parseKeys(input) {
+    const keys = [];
+    let i = 0;
+    while (i < input.length) {
+        const current = input[i];
+        if (current === "<") {
+            const closingIndex = input.indexOf(">", i + 1);
+            if (closingIndex !== -1) {
+                const token = input.slice(i + 1, closingIndex);
+                const mappedKey = mapSpecialToken(token);
+                if (mappedKey) {
+                    keys.push(mappedKey);
+                    i = closingIndex + 1;
+                    continue;
+                }
+            }
+        }
+        if (input.startsWith(HTML_TOKEN_START, i)) {
+            const tokenStart = i + HTML_TOKEN_START.length;
+            const encodedClosingIndex = input.indexOf(HTML_TOKEN_END, tokenStart);
+            if (encodedClosingIndex !== -1) {
+                const encodedToken = input.slice(tokenStart, encodedClosingIndex);
+                const token = encodedToken.replace(HTML_AMP_PATTERN, "&");
+                const mappedKey = mapSpecialToken(token);
+                if (mappedKey) {
+                    keys.push(mappedKey);
+                    i = encodedClosingIndex + HTML_TOKEN_END.length;
+                    continue;
+                }
+            }
+        }
+        keys.push(current);
+        i++;
+    }
+    return keys;
+}
+const DEFAULT_SHELL_EXECUTE_TIMEOUT_SEC = 120;
+const CTRL_C_GUIDANCE = [
+    "No retained terminal context exists. Each shell_execute command runs independently.",
+    `To interrupt a long-running command, wait for its timeout (default: ${DEFAULT_SHELL_EXECUTE_TIMEOUT_SEC}s) or use shell_execute to kill the process by PID:`,
+    '  shell_execute({ command: "kill -SIGINT <PID>" })',
+].join("\n");
+const GENERIC_GUIDANCE = [
+    "No retained terminal context exists. Each shell_execute command runs independently.",
+    "To run a command, use shell_execute directly:",
+    '  shell_execute({ command: "your command here" })',
+].join("\n");
+function hasCtrlC(parsedKeys) {
+    return parsedKeys.includes("C-c");
+}
+export const shellInteractTool = tool({
+    description: SHELL_INTERACT_DESCRIPTION,
+    inputSchema: z.object({
+        keystrokes: z
+            .string()
+            .describe("Keystrokes to send. Use <SpecialKey> syntax. " +
+            "Examples: 'y<Enter>', '<Ctrl+C>', 'ls<Enter>'"),
+        timeout_ms: z
+            .number()
+            .optional()
+            .describe("Wait time after sending keys (default: 500)"),
+    }),
+    execute: ({ keystrokes }) => {
+        const parsedKeys = parseKeys(keystrokes);
+        const guidance = hasCtrlC(parsedKeys) ? CTRL_C_GUIDANCE : GENERIC_GUIDANCE;
+        return Promise.resolve({
+            success: true,
+            output: guidance,
+        });
+    },
+});
+//# sourceMappingURL=shell-interact.js.map

package/dist/tools/execute/shell-interact.js.map

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

package/dist/tools/execute/shell-interact.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell-interact.test.d.ts.map

package/dist/tools/execute/shell-interact.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-interact.test.d.ts","sourceRoot":"","sources":["../../../src/tools/execute/shell-interact.test.ts"],"names":[],"mappings":""}

package/dist/tools/execute/shell-interact.test.js

@@ -0,0 +1,175 @@
+import { describe, expect, it } from "bun:test";
+import { parseKeys, shellInteractTool, } from "./shell-interact";
+async function interact(keystrokes, timeout_ms = 200) {
+    const execute = shellInteractTool.execute;
+    if (!execute) {
+        throw new Error("shellInteractTool.execute is undefined");
+    }
+    const result = await execute({ keystrokes, timeout_ms }, {
+        toolCallId: `test-${Date.now()}`,
+        messages: [],
+        abortSignal: new AbortController().signal,
+    });
+    if (Symbol.asyncIterator in result) {
+        throw new Error("Unexpected async iterable result");
+    }
+    return result;
+}
+describe("shellInteractTool", () => {
+    describe("result shape", () => {
+        it("returns { success: true, output: string }", async () => {
+            const result = await interact("echo test");
+            expect(result.success).toBe(true);
+            expect(typeof result.output).toBe("string");
+            expect(result.output.length).toBeGreaterThan(0);
+        });
+        it("always succeeds regardless of keystrokes", async () => {
+            const result = await interact("anything at all");
+            expect(result.success).toBe(true);
+        });
+    });
+    describe("Ctrl+C guidance", () => {
+        it("returns Ctrl+C guidance for <Ctrl+C>", async () => {
+            const result = await interact("<Ctrl+C>");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("No retained terminal context exists");
+            expect(result.output).toContain("kill -SIGINT");
+        });
+        it("returns Ctrl+C guidance for <CTRL+C> (uppercase)", async () => {
+            const result = await interact("<CTRL+C>");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("kill -SIGINT");
+        });
+        it("returns Ctrl+C guidance for <C-c> (dash syntax)", async () => {
+            const result = await interact("<C-c>");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("kill -SIGINT");
+        });
+        it("returns Ctrl+C guidance for html-encoded &lt;Ctrl+C&gt;", async () => {
+            const result = await interact("&lt;Ctrl+C&gt;");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("kill -SIGINT");
+        });
+        it("Ctrl+C guidance mentions timeout", async () => {
+            const result = await interact("<Ctrl+C>");
+            expect(result.output).toContain("120s");
+        });
+    });
+    describe("generic guidance for other keystrokes", () => {
+        it("returns generic guidance for plain text", async () => {
+            const result = await interact("ls -la");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("No retained terminal context exists");
+            expect(result.output).toContain("shell_execute");
+            expect(result.output).not.toContain("kill -SIGINT");
+        });
+        it("returns generic guidance for Enter key", async () => {
+            const result = await interact("echo hello<Enter>");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("shell_execute");
+            expect(result.output).not.toContain("kill -SIGINT");
+        });
+        it("returns generic guidance for Ctrl+D", async () => {
+            const result = await interact("<Ctrl+D>");
+            expect(result.success).toBe(true);
+            expect(result.output).not.toContain("kill -SIGINT");
+        });
+        it("returns generic guidance for empty keystrokes", async () => {
+            const result = await interact("");
+            expect(result.success).toBe(true);
+            expect(result.output).toContain("shell_execute");
+        });
+        it("explains no retained terminal context exists", async () => {
+            const result = await interact("any command");
+            expect(result.output).toContain("No retained terminal context exists. Each shell_execute command runs independently.");
+        });
+    });
+    describe("tool metadata", () => {
+        it("has description mentioning shell_execute", () => {
+            expect(shellInteractTool.description).toContain("shell_execute");
+        });
+        it("accepts keystrokes in inputSchema", () => {
+            expect(shellInteractTool.inputSchema).toBeDefined();
+        });
+    });
+    describe("parseKeys utility", () => {
+        it("parses plain text as individual characters", () => {
+            const result = parseKeys("abc");
+            expect(result).toEqual(["a", "b", "c"]);
+        });
+        it("parses <Enter> to Enter", () => {
+            const result = parseKeys("<Enter>");
+            expect(result).toEqual(["Enter"]);
+        });
+        it("parses <Ctrl+C> to C-c", () => {
+            const result = parseKeys("<Ctrl+C>");
+            expect(result).toEqual(["C-c"]);
+        });
+        it("parses <Tab> to Tab", () => {
+            const result = parseKeys("<Tab>");
+            expect(result).toEqual(["Tab"]);
+        });
+        it("parses <Escape> and <ESC>", () => {
+            expect(parseKeys("<Escape>")).toEqual(["Escape"]);
+            expect(parseKeys("<ESC>")).toEqual(["Escape"]);
+        });
+        it("parses <Up> <Down> <Left> <Right>", () => {
+            expect(parseKeys("<Up>")).toEqual(["Up"]);
+            expect(parseKeys("<Down>")).toEqual(["Down"]);
+            expect(parseKeys("<Left>")).toEqual(["Left"]);
+            expect(parseKeys("<Right>")).toEqual(["Right"]);
+        });
+        it("parses <Home> and <End>", () => {
+            expect(parseKeys("<Home>")).toEqual(["Home"]);
+            expect(parseKeys("<End>")).toEqual(["End"]);
+        });
+        it("parses <Backspace> and <Delete>", () => {
+            expect(parseKeys("<Backspace>")).toEqual(["BSpace"]);
+            expect(parseKeys("<Delete>")).toEqual(["DC"]);
+        });
+        it("parses <Space>", () => {
+            expect(parseKeys("<Space>")).toEqual(["Space"]);
+        });
+        it("parses mixed text and special keys", () => {
+            const result = parseKeys("echo<Space>hello<Enter>");
+            expect(result).toEqual([
+                "e",
+                "c",
+                "h",
+                "o",
+                "Space",
+                "h",
+                "e",
+                "l",
+                "l",
+                "o",
+                "Enter",
+            ]);
+        });
+        it("parses <C-c> dash syntax to C-c", () => {
+            const result = parseKeys("<C-c>");
+            expect(result).toEqual(["C-c"]);
+        });
+        it("parses <ctrl-c> dash syntax to C-c", () => {
+            const result = parseKeys("<ctrl-c>");
+            expect(result).toEqual(["C-c"]);
+        });
+        it("handles html-encoded &lt;Ctrl+C&gt;", () => {
+            const result = parseKeys("&lt;Ctrl+C&gt;");
+            expect(result).toEqual(["C-c"]);
+        });
+        it("preserves HTML entities in plain text (non-special)", () => {
+            const parsed = parseKeys("echo '&lt;entity-preserve-tag&gt; &amp; preserve-amp'");
+            expect(parsed.join("")).toBe("echo '&lt;entity-preserve-tag&gt; &amp; preserve-amp'");
+        });
+        it("treats unknown <token> as literal characters", () => {
+            const result = parseKeys("<unknown>");
+            expect(result.join("")).toBe("<unknown>");
+        });
+        it("parses <PageUp> and <PageDown>", () => {
+            expect(parseKeys("<PageUp>")).toEqual(["PPage"]);
+            expect(parseKeys("<PageDown>")).toEqual(["NPage"]);
+        });
+    });
+});
+//# sourceMappingURL=shell-interact.test.js.map

package/dist/tools/execute/shell-interact.test.js.map

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

package/dist/tools/explore/glob.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+declare const inputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    respect_git_ignore: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type GlobInput = z.input<typeof inputSchema>;
+export declare function executeGlob({ pattern, path, respect_git_ignore, }: GlobInput): Promise<string>;
+export declare const globTool: import("ai").Tool<{
+    pattern: string;
+    respect_git_ignore: boolean;
+    path?: string | undefined;
+}, string>;
+export {};
+//# sourceMappingURL=glob.d.ts.map

package/dist/tools/explore/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/tools/explore/glob.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,QAAA,MAAM,WAAW;;;;iBAaf,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,wBAAsB,WAAW,CAAC,EAChC,OAAO,EACP,IAAI,EACJ,kBAAyB,GAC1B,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA+E7B;AAED,eAAO,MAAM,QAAQ;;;;UAInB,CAAC"}

package/dist/tools/explore/glob.js

@@ -0,0 +1,107 @@
+import { stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { tool } from "ai";
+import { z } from "zod";
+import { formatBlock, getIgnoreFilter } from "../utils/safety-utils";
+import GLOB_FILES_DESCRIPTION from "./glob-files.txt";
+const MAX_RESULTS = 500;
+const STAT_CONCURRENCY = 32;
+function insertTopByMtime(list, item) {
+    let insertAt = list.length;
+    for (let i = 0; i < list.length; i++) {
+        if (item.mtime.getTime() > list[i].mtime.getTime()) {
+            insertAt = i;
+            break;
+        }
+    }
+    list.splice(insertAt, 0, item);
+    if (list.length > MAX_RESULTS) {
+        list.pop();
+    }
+}
+const inputSchema = z.object({
+    pattern: z.string().describe("Glob pattern (e.g., '**/*.py', 'docs/*.md')"),
+    path: z
+        .string()
+        .optional()
+        .describe("Directory to search (default: current directory)"),
+    respect_git_ignore: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Respect ignore rules from .gitignore/.ignore/.fdignore (default: true)"),
+});
+export async function executeGlob({ pattern, path, respect_git_ignore = true, }) {
+    const searchDir = path ? resolve(path) : process.cwd();
+    const glob = new Bun.Glob(pattern);
+    const topFilesByMtime = [];
+    let totalMatches = 0;
+    let skippedUnreadable = 0;
+    const ignoreFilter = respect_git_ignore
+        ? await getIgnoreFilter(searchDir)
+        : null;
+    const pending = new Set();
+    const enqueueStat = (absolutePath) => {
+        const task = stat(absolutePath)
+            .then((stats) => {
+            totalMatches += 1;
+            insertTopByMtime(topFilesByMtime, {
+                path: absolutePath,
+                mtime: stats.mtime,
+            });
+        })
+            .catch(() => {
+            skippedUnreadable += 1;
+        })
+            .finally(() => {
+            pending.delete(task);
+        });
+        pending.add(task);
+    };
+    for await (const file of glob.scan({
+        cwd: searchDir,
+        absolute: false,
+        onlyFiles: true,
+    })) {
+        if (ignoreFilter?.ignores(file)) {
+            continue;
+        }
+        const absolutePath = join(searchDir, file);
+        enqueueStat(absolutePath);
+        if (pending.size >= STAT_CONCURRENCY) {
+            await Promise.race(pending);
+        }
+    }
+    await Promise.all(pending);
+    const truncated = totalMatches > MAX_RESULTS;
+    const displayFiles = topFilesByMtime;
+    const output = [
+        totalMatches > 0 ? "OK - glob" : "OK - glob (no matches)",
+        `pattern: "${pattern}"`,
+        `path: ${path ?? "."}`,
+        `respect_git_ignore: ${respect_git_ignore}`,
+        `file_count: ${totalMatches}`,
+        `truncated: ${truncated}`,
+        `skipped_unreadable: ${skippedUnreadable}`,
+        "sorted_by: mtime desc",
+        "",
+    ];
+    if (displayFiles.length > 0) {
+        const body = displayFiles
+            .map((f) => {
+            return f.path;
+        })
+            .join("\n");
+        output.push(formatBlock("glob results", body));
+    }
+    else {
+        output.push(formatBlock("glob results", "(no matches)"));
+    }
+    return output.join("\n");
+}
+export const globTool = tool({
+    description: GLOB_FILES_DESCRIPTION,
+    inputSchema,
+    execute: executeGlob,
+});
+//# sourceMappingURL=glob.js.map

package/dist/tools/explore/glob.js.map

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

package/dist/tools/explore/glob.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=glob.test.d.ts.map

package/dist/tools/explore/glob.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.test.d.ts","sourceRoot":"","sources":["../../../src/tools/explore/glob.test.ts"],"names":[],"mappings":""}