joonecli 0.1.0

package/dist/skills/loader.js

@@ -0,0 +1,132 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * SkillLoader — discovers and loads skills from multiple directories.
+ *
+ * Discovery paths (priority order — project overrides user):
+ * 1. Project root: ./skills/, ./.agents/skills/, ./.agent/skills/
+ * 2. User home: ~/.joone/skills/, ~/.agents/skills/
+ *
+ * On Windows, ~ resolves to %USERPROFILE%.
+ *
+ * Skills are folders containing a SKILL.md with YAML frontmatter:
+ * ---
+ * name: my-skill
+ * description: What this skill does
+ * ---
+ * ## Instructions
+ * ...
+ */
+export class SkillLoader {
+    projectRoot;
+    userHome;
+    cachedSkills = null;
+    constructor(projectRoot, userHome) {
+        this.projectRoot = projectRoot ?? process.cwd();
+        this.userHome = userHome ?? os.homedir();
+    }
+    /**
+     * Returns all skill discovery directories in priority order.
+     * Project-level directories come first (higher priority).
+     */
+    getDiscoveryPaths() {
+        const home = this.userHome;
+        return [
+            // Project-level (highest priority)
+            { path: path.join(this.projectRoot, "skills"), source: "project" },
+            { path: path.join(this.projectRoot, ".agents", "skills"), source: "project" },
+            { path: path.join(this.projectRoot, ".agent", "skills"), source: "project" },
+            // User-level
+            { path: path.join(home, ".joone", "skills"), source: "user" },
+            { path: path.join(home, ".agents", "skills"), source: "user" },
+        ];
+    }
+    /**
+     * Parses YAML frontmatter from a SKILL.md content string.
+     * Simple parser — handles `name:` and `description:` fields.
+     */
+    parseFrontmatter(content) {
+        const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!match)
+            return {};
+        const yaml = match[1];
+        const nameMatch = yaml.match(/^name:\s*(.+)$/m);
+        const descMatch = yaml.match(/^description:\s*(.+)$/m);
+        return {
+            name: nameMatch?.[1]?.trim(),
+            description: descMatch?.[1]?.trim(),
+        };
+    }
+    /**
+     * Discovers all available skills from all discovery paths.
+     * Deduplicates by name — project-level skills override user-level.
+     * Results are cached per session.
+     */
+    discoverSkills() {
+        if (this.cachedSkills)
+            return this.cachedSkills;
+        const skills = new Map();
+        const paths = this.getDiscoveryPaths();
+        for (const { path: dir, source } of paths) {
+            if (!fs.existsSync(dir))
+                continue;
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillMdPath = path.join(dir, entry.name, "SKILL.md");
+                if (!fs.existsSync(skillMdPath))
+                    continue;
+                try {
+                    const content = fs.readFileSync(skillMdPath, "utf-8");
+                    const frontmatter = this.parseFrontmatter(content);
+                    const name = frontmatter.name || entry.name;
+                    // Only add if not already found (project overrides user)
+                    if (!skills.has(name)) {
+                        skills.set(name, {
+                            name,
+                            description: frontmatter.description || `Skill: ${name}`,
+                            path: skillMdPath,
+                            source,
+                        });
+                    }
+                }
+                catch {
+                    // Skip unreadable skills
+                }
+            }
+        }
+        this.cachedSkills = Array.from(skills.values());
+        return this.cachedSkills;
+    }
+    /**
+     * Loads the full content of a specific skill's SKILL.md.
+     * Returns undefined if the skill is not found.
+     */
+    loadSkill(name) {
+        const skills = this.discoverSkills();
+        const skill = skills.find((s) => s.name === name);
+        if (!skill)
+            return undefined;
+        try {
+            return fs.readFileSync(skill.path, "utf-8");
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Clears the cached skills. Call when skills directory contents may have changed.
+     */
+    clearCache() {
+        this.cachedSkills = null;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/tools.d.ts

@@ -0,0 +1,5 @@
+import { DynamicToolInterface } from "../tools/index.js";
+import { SkillLoader } from "./loader.js";
+export declare function bindSkillLoader(loader: SkillLoader): void;
+export declare const SearchSkillsTool: DynamicToolInterface;
+export declare const LoadSkillTool: DynamicToolInterface;

package/dist/skills/tools.js

@@ -0,0 +1,78 @@
+import { SkillLoader } from "./loader.js";
+// ─── Shared SkillLoader instance ──────────────────────────────────────────────
+let _loader = null;
+export function bindSkillLoader(loader) {
+    _loader = loader;
+}
+function getLoader() {
+    if (!_loader) {
+        _loader = new SkillLoader();
+    }
+    return _loader;
+}
+// ─── SearchSkillsTool ───────────────────────────────────────────────────────────
+export const SearchSkillsTool = {
+    name: "search_skills",
+    description: "Search for available skills. Skills provide specialized instructions for specific tasks " +
+        "(e.g., deployment workflows, testing strategies, coding patterns).",
+    schema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query to match against skill names and descriptions (optional — omit to list all)",
+            },
+        },
+    },
+    execute: async (args) => {
+        const loader = getLoader();
+        let skills = loader.discoverSkills();
+        if (args?.query) {
+            const q = args.query.toLowerCase();
+            skills = skills.filter((s) => s.name.toLowerCase().includes(q) ||
+                s.description.toLowerCase().includes(q));
+        }
+        if (skills.length === 0) {
+            return {
+                content: args?.query
+                    ? `No skills found matching "${args.query}".`
+                    : "No skills found. Create a skill by adding a folder with SKILL.md to ./skills/ or ~/.joone/skills/."
+            };
+        }
+        const list = skills
+            .map((s) => `- **${s.name}** (${s.source}): ${s.description}`)
+            .join("\n");
+        return {
+            content: `Found ${skills.length} skill(s):\n${list}\n\n` +
+                `To load a skill, call \`load_skill\` with the skill name.`
+        };
+    },
+};
+// ─── LoadSkillTool ──────────────────────────────────────────────────────────────
+export const LoadSkillTool = {
+    name: "load_skill",
+    description: "Loads a specific skill's full instructions (SKILL.md content). " +
+        "Use search_skills first to discover available skills.",
+    schema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "The name of the skill to load",
+            },
+        },
+        required: ["name"],
+    },
+    execute: async (args) => {
+        const loader = getLoader();
+        const content = loader.loadSkill(args.name);
+        if (!content) {
+            return {
+                content: `Error: Skill "${args.name}" not found. Use search_skills to see available skills.`,
+                isError: true
+            };
+        }
+        return { content };
+    },
+};
+//# sourceMappingURL=tools.js.map

package/dist/skills/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/skills/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,iFAAiF;AAEjF,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mFAAmF;AAEnF,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,0FAA0F;QAC1F,oEAAoE;IACtE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0FAA0F;aAC7F;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAyB,EAAuB,EAAE;QAChE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAErC,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAChC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC1C,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,IAAI,EAAE,KAAK;oBAClB,CAAC,CAAC,6BAA6B,IAAI,CAAC,KAAK,IAAI;oBAC7C,CAAC,CAAC,oGAAoG;aACzG,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EACL,SAAS,MAAM,CAAC,MAAM,eAAe,IAAI,MAAM;gBAC/C,2DAA2D;SAC9D,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,mFAAmF;AAEnF,MAAM,CAAC,MAAM,aAAa,GAAyB;IACjD,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,iEAAiE;QACjE,uDAAuD;IACzD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,IAAsB,EAAuB,EAAE;QAC7D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,iBAAiB,IAAI,CAAC,IAAI,yDAAyD;gBAC5F,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/skills/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Skill metadata parsed from SKILL.md YAML frontmatter.
+ */
+export interface SkillMeta {
+    /** Human-readable name (from YAML `name` field). */
+    name: string;
+    /** Short description (from YAML `description` field). */
+    description: string;
+    /** Absolute path to the SKILL.md file. */
+    path: string;
+    /** Where this skill was discovered. */
+    source: "project" | "user";
+}

package/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/test_cache.d.ts

@@ -0,0 +1 @@
+import "dotenv/config";

package/dist/test_cache.js

@@ -0,0 +1,55 @@
+import "dotenv/config";
+import { ChatAnthropic } from "@langchain/anthropic";
+import { ExecutionHarness } from "./core/agentLoop.js";
+import { HumanMessage } from "@langchain/core/messages";
+async function runCacheTest() {
+    console.log("=== Starting Prompt Caching Test ===\n");
+    // We need Anthropic API Key for this to actually hit the network and measure cache
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.warn("WARNING: ANTHROPIC_API_KEY is not set in .env file. The LLM call will fail.");
+    }
+    const model = new ChatAnthropic({
+        modelName: "claude-3-5-sonnet-20241022",
+        temperature: 0,
+        maxTokens: 4096,
+    }); // No tools needed for this basic string test
+    const harness = new ExecutionHarness(model, []);
+    // 1. Create a massive static prefix (simulating a lot of project context)
+    // We repeat a string many times to ensure we pass the 1024 token minimum for Anthropic caching.
+    const massiveProjectMemory = Array(500).fill("Project Rule: Always write clean, modular TypeScript code with strict typings. ").join("\n");
+    const state = {
+        globalSystemInstructions: "You are a helpful coding assistant. You remember rules carefully.",
+        projectMemory: massiveProjectMemory,
+        sessionContext: "User OS: Windows 11",
+        conversationHistory: []
+    };
+    console.log("Turn 1: Initial Query (Should create cache)");
+    state.conversationHistory.push(new HumanMessage("Hello! What is one of the project rules?"));
+    const response1 = await harness.step(state);
+    state.conversationHistory.push(response1);
+    // In @langchain/anthropic, the actual usage stats (including cache hits/misses) 
+    // are stored in the response_metadata of the AIMessage.
+    console.log(`Response 1: ${response1.content}`);
+    console.log(`Token Usage 1: ${JSON.stringify(response1.response_metadata?.usage, null, 2)}\n`);
+    // --- TURN 2 ---
+    console.log("Turn 2: Follow-up Query (Should hit cache)");
+    // We DO NOT change the globalSystemInstructions, projectMemory, or sessionContext.
+    // We only append to the conversation history. This preserves the prefix!
+    state.conversationHistory.push(new HumanMessage("Could you summarize the rule again briefly?"));
+    const response2 = await harness.step(state);
+    state.conversationHistory.push(response2);
+    console.log(`Response 2: ${response2.content}`);
+    console.log(`Token Usage 2: ${JSON.stringify(response2.response_metadata?.usage, null, 2)}\n`);
+    // --- TURN 3: The System Reminder Pattern ---
+    console.log("Turn 3: Using <system-reminder> to simulate environment change without breaking cache");
+    // If a file changed, we DON'T update `state.projectMemory`. We inject a reminder.
+    state.conversationHistory.push(new HumanMessage("<system-reminder>\nThe file 'auth.ts' has just been deleted by the user.\n</system-reminder>\nWhat should we do if we need auth now?"));
+    const response3 = await harness.step(state);
+    state.conversationHistory.push(response3);
+    console.log(`Response 3: ${response3.content}`);
+    console.log(`Token Usage 3: ${JSON.stringify(response3.response_metadata?.usage, null, 2)}\n`);
+}
+if (require.main === module) {
+    runCacheTest().catch(console.error);
+}
+//# sourceMappingURL=test_cache.js.map

package/dist/test_cache.js.map

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

package/dist/test_google.js

@@ -0,0 +1,93 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var google_genai_1 = require("@langchain/google-genai");
+var messages_1 = require("@langchain/core/messages");
+var dotenv = require("dotenv");
+dotenv.config();
+function main() {
+    return __awaiter(this, void 0, void 0, function () {
+        var model, messagesGrouped, e_1, messagesMidstream, e_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    model = new google_genai_1.ChatGoogleGenerativeAI({
+                        model: "gemini-2.5-flash",
+                    });
+                    messagesGrouped = [
+                        new messages_1.SystemMessage("You are a helpful assistant."),
+                        new messages_1.SystemMessage("Also, be concise."),
+                        new messages_1.HumanMessage("Hello!"),
+                    ];
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, model.invoke(messagesGrouped)];
+                case 2:
+                    _a.sent();
+                    console.log("Success: Grouped SystemMessages at the start work perfectly.");
+                    return [3 /*break*/, 4];
+                case 3:
+                    e_1 = _a.sent();
+                    console.error("Grouped systems failed:", e_1.message);
+                    return [3 /*break*/, 4];
+                case 4:
+                    messagesMidstream = [
+                        new messages_1.SystemMessage("You are a helpful assistant."),
+                        new messages_1.HumanMessage("Hello!"),
+                        new messages_1.SystemMessage("System recovery hint here."),
+                        new messages_1.HumanMessage("What did I say?"),
+                    ];
+                    _a.label = 5;
+                case 5:
+                    _a.trys.push([5, 7, , 8]);
+                    return [4 /*yield*/, model.invoke(messagesMidstream)];
+                case 6:
+                    _a.sent();
+                    console.log("Success: Mid-stream SystemMessages work.");
+                    return [3 /*break*/, 8];
+                case 7:
+                    e_2 = _a.sent();
+                    console.error("Midstream systems failed:", e_2.message);
+                    return [3 /*break*/, 8];
+                case 8: return [2 /*return*/];
+            }
+        });
+    });
+}
+main();

package/dist/tools/askUser.d.ts

@@ -0,0 +1,10 @@
+import { DynamicToolInterface } from "./index.js";
+/**
+ * AskUserQuestionTool — allows the agent to ask the user a clarifying question mid-turn.
+ *
+ * Use cases:
+ * - Resolving ambiguous requirements before coding.
+ * - Getting user preferences (framework choice, styling, naming).
+ * - Requesting approval of an implementation plan before proceeding.
+ */
+export declare const AskUserQuestionTool: DynamicToolInterface;

package/dist/tools/askUser.js

@@ -0,0 +1,42 @@
+import { HITLBridge } from "../hitl/bridge.js";
+/**
+ * AskUserQuestionTool — allows the agent to ask the user a clarifying question mid-turn.
+ *
+ * Use cases:
+ * - Resolving ambiguous requirements before coding.
+ * - Getting user preferences (framework choice, styling, naming).
+ * - Requesting approval of an implementation plan before proceeding.
+ */
+export const AskUserQuestionTool = {
+    name: "ask_user_question",
+    description: "Ask the user a question and wait for their response. " +
+        "Use this when you need clarification on the task, user preferences, " +
+        "or approval before proceeding with a significant change. " +
+        "You may optionally provide a list of answer choices.",
+    schema: {
+        type: "object",
+        properties: {
+            question: {
+                type: "string",
+                description: "The question to ask the user.",
+            },
+            options: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional list of predefined answer choices.",
+            },
+        },
+        required: ["question"],
+    },
+    async execute(args) {
+        const question = args.question;
+        const options = args.options;
+        if (!question || question.trim() === "") {
+            return { content: "Error: You must provide a non-empty question.", isError: true };
+        }
+        const bridge = HITLBridge.getInstance();
+        const answer = await bridge.askUser(question, options);
+        return { content: answer };
+    },
+};
+//# sourceMappingURL=askUser.js.map

package/dist/tools/askUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUser.js","sourceRoot":"","sources":["../../src/tools/askUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACrD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACP,uDAAuD;QACvD,sEAAsE;QACtE,2DAA2D;QAC3D,sDAAsD;IAC1D,MAAM,EAAE;QACJ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACR,QAAQ,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC/C;YACD,OAAO,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,6CAA6C;aAC7D;SACJ;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACzB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAkB,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAA+B,CAAC;QAErD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,+CAA+C,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;CACJ,CAAC"}

package/dist/tools/browser.d.ts

@@ -0,0 +1,19 @@
+import { SandboxManager } from "../sandbox/manager.js";
+import { LazyInstaller } from "../sandbox/bootstrap.js";
+import { DynamicToolInterface } from "./index.js";
+export declare function bindBrowserSandbox(sandbox: SandboxManager, installer: LazyInstaller): void;
+/**
+ * Web Browser Tool — wraps Vercel Labs' `agent-browser` CLI.
+ *
+ * Provides compact accessibility-tree output optimized for LLMs
+ * (low token usage vs raw HTML). Runs inside the E2B sandbox.
+ *
+ * Supported actions:
+ * - navigate: Go to a URL
+ * - snapshot: Get the accessibility tree (compact text representation)
+ * - click: Click an element by ref
+ * - type: Type text into a form field by ref
+ * - screenshot: Capture a screenshot
+ * - scroll: Scroll the page up or down
+ */
+export declare const BrowserTool: DynamicToolInterface;

package/dist/tools/browser.js

@@ -0,0 +1,111 @@
+// ─── Sandbox + Installer references ─────────────────────────────────────────
+let _sandboxManager = null;
+let _installer = null;
+export function bindBrowserSandbox(sandbox, installer) {
+    _sandboxManager = sandbox;
+    _installer = installer;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────────
+/**
+ * Escapes a string so it can be safely used as an argument in a Bash shell command.
+ * It wraps the string in single quotes and safely escapes internal single quotes.
+ */
+function escapeBashArg(arg) {
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+// ─── BrowserTool ────────────────────────────────────────────────────────────────
+/**
+ * Web Browser Tool — wraps Vercel Labs' `agent-browser` CLI.
+ *
+ * Provides compact accessibility-tree output optimized for LLMs
+ * (low token usage vs raw HTML). Runs inside the E2B sandbox.
+ *
+ * Supported actions:
+ * - navigate: Go to a URL
+ * - snapshot: Get the accessibility tree (compact text representation)
+ * - click: Click an element by ref
+ * - type: Type text into a form field by ref
+ * - screenshot: Capture a screenshot
+ * - scroll: Scroll the page up or down
+ */
+export const BrowserTool = {
+    name: "browser",
+    description: "Interact with web pages using a headless browser. Actions: navigate, snapshot, click, type, screenshot, scroll. " +
+        "Returns compact accessibility-tree text output optimized for AI consumption.",
+    schema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["navigate", "snapshot", "click", "type", "screenshot", "scroll"],
+                description: "The browser action to perform",
+            },
+            url: {
+                type: "string",
+                description: "URL to navigate to (required for 'navigate')",
+            },
+            ref: {
+                type: "string",
+                description: "Element reference from the accessibility tree (required for 'click' and 'type')",
+            },
+            text: {
+                type: "string",
+                description: "Text to type (required for 'type')",
+            },
+            direction: {
+                type: "string",
+                enum: ["up", "down"],
+                description: "Scroll direction for 'scroll' action (optional, defaults to 'down')",
+            },
+        },
+        required: ["action"],
+    },
+    execute: async (args) => {
+        if (!_sandboxManager || !_sandboxManager.isActive()) {
+            return { content: "Sandbox is not active. Cannot use browser tool.", isError: true };
+        }
+        // Build the CLI command
+        let command;
+        switch (args.action) {
+            case "navigate":
+                if (!args.url)
+                    return { content: "Error: 'url' is required for navigate action.", isError: true };
+                command = `agent-browser navigate ${escapeBashArg(args.url)} 2>&1`;
+                break;
+            case "snapshot":
+                command = "agent-browser snapshot 2>&1";
+                break;
+            case "click":
+                if (!args.ref)
+                    return { content: "Error: 'ref' is required for click action.", isError: true };
+                command = `agent-browser click ${escapeBashArg(args.ref)} 2>&1`;
+                break;
+            case "type":
+                if (!args.ref)
+                    return { content: "Error: 'ref' is required for type action.", isError: true };
+                if (!args.text)
+                    return { content: "Error: 'text' is required for type action.", isError: true };
+                command = `agent-browser type ${escapeBashArg(args.ref)} ${escapeBashArg(args.text)} 2>&1`;
+                break;
+            case "screenshot":
+                command = "agent-browser screenshot 2>&1";
+                break;
+            case "scroll":
+                const dir = args.direction || "down";
+                command = `agent-browser scroll ${escapeBashArg(dir)} 2>&1`;
+                break;
+            default:
+                return { content: `Error: Unknown action "${args.action}". Use: navigate, snapshot, click, type, screenshot, scroll.`, isError: true };
+        }
+        const result = await _sandboxManager.exec(command);
+        if (result.exitCode !== 0) {
+            return {
+                content: `Browser action failed (exit code ${result.exitCode}):\n${result.stdout}\n${result.stderr}`,
+                metadata: { exitCode: result.exitCode },
+                isError: true
+            };
+        }
+        return { content: result.stdout || "(no output)", metadata: { exitCode: result.exitCode }, isError: false };
+    },
+};
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,27 @@
+import { SandboxManager } from "../sandbox/manager.js";
+import { FileSync } from "../sandbox/sync.js";
+export interface ToolResult {
+    content: string;
+    metadata?: Record<string, any>;
+    isError?: boolean;
+}
+export interface DynamicToolInterface {
+    name: string;
+    description: string;
+    schema: Record<string, any>;
+    execute: (args: any) => Promise<ToolResult> | ToolResult;
+}
+/**
+ * Binds the tools to a SandboxManager and FileSync instance.
+ * Must be called at session start before any tool executions.
+ */
+export declare function bindSandbox(sandbox: SandboxManager, fileSync: FileSync): void;
+/**
+ * Security: Validates that a resolved path is strictly inside the given workspace dir.
+ * Prevents directory traversal attacks from accessing sensitive host files.
+ */
+export declare function isPathInsideWorkspace(resolvedPath: string, workspaceDir?: string): boolean;
+export declare const BashTool: DynamicToolInterface;
+export declare const ReadFileTool: DynamicToolInterface;
+export declare const WriteFileTool: DynamicToolInterface;
+export declare const CORE_TOOLS: DynamicToolInterface[];