joonecli 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+<div align="center">
+
+# ⚡ Joone
+
+**An autonomous coding agent powered by prompt caching, harness engineering, and secure sandboxing.**
+
+[![npm version](https://img.shields.io/npm/v/joone.svg)](https://npmjs.org/package/joone)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+
+</div>
+
+---
+
+**Joone** is a highly capable autonomous AI coding assistant that runs directly in your terminal. It leverages a hybrid environment: it has read/write access to your local project files for seamless editing, but all code execution, testing, and dependency installations happen securely inside an isolated cloud sandbox (powered by E2B).
+
+## ✨ Features
+
+- **🧠 Pluggable Intelligence**: Seamlessly switch between Anthropic (Claude 3.5 Sonnet, Opus), OpenAI (GPT-4o, o1), Google (Gemini 1.5/pro), Mistral, Groq, local Ollama models, and more.
+- **🔌 User-Local Provider Plugins**: Heavy LLM SDKs (like `@langchain/google-genai`) are dynamically installed into `~/.joone/providers`. This keeps the base Joone installation incredibly lightweight while supporting every major AI provider.
+- **🛡️ Secure Execution Sandbox**: Joone cannot accidentally delete your local database or run malicious `npm install` scripts on your host machine. All execution happens in an isolated E2B cloud sandbox that syncs seamlessly with your local workspace.
+- **🖥️ Beautiful Terminal UI**: Built with React and Ink, Joone provides a rich, interactive TUI (Terminal User Interface) with spinners, syntax highlighting, and progress tracking.
+- **🔍 Deep Insights**: Integrated with LangSmith for comprehensive session tracing, token counting, and performance analysis.
+- **🔁 Agent Resilience**: Includes loop detection, command sanitization, backoff retries, and a human-in-the-loop (HITL) permission middleware (`auto`, `ask_dangerous`, `ask_all`).
+
+---
+
+## 🚀 Getting Started
+
+### Installation
+
+Install Joone globally via npm:
+
+```bash
+npm install -g joone
+```
+
+### Configuration
+
+Run the automated onboarding wizard to configure your preferred LLM provider, models, and API keys:
+
+```bash
+joone config
+```
+
+_This will prompt you for your LLM API Key and optionally your E2B Sandbox API key. Keys are securely stored in `~/.joone/config.json`._
+
+### Start Joone
+
+To start an autonomous session in your current project directory:
+
+```bash
+joone start
+```
+
+Or, if you want to skip global installation altogether, run it on-demand:
+
+```bash
+npx joone@latest start
+```
+
+### Uninstallation
+
+Since Joone manages its own user-local plugins and settings, completely removing Joone from your system is a two-step process:
+
+1. **Wipe User Data**: First, use Joone's built-in cleanup command to safely delete your configurations, traces, and dynamically installed LLM provider dependencies stored in `~/.joone`:
+   ```bash
+   joone cleanup
+   ```
+2. **Remove the App**: Next, uninstall the base package using the package manager you originally used:
+   ```bash
+   npm uninstall -g joone
+   # OR
+   brew uninstall joone
+   ```
+
+---
+
+## 🛠️ Commands
+
+| Command                        | Description                                                                     |
+| ------------------------------ | ------------------------------------------------------------------------------- |
+| `joone start`                  | Start a new Joone agent session in the current directory.                       |
+| `joone start --resume <id>`    | Resume a previously saved persistent session.                                   |
+| `joone config`                 | Run the configuration wizard (Providers, API Keys, etc.).                       |
+| `joone sessions`               | List all available persistent sessions for resumption.                          |
+| `joone provider add <name>`    | Manually download a dynamic LLM provider package (e.g., `google`, `anthropic`). |
+| `joone provider remove <name>` | Uninstall a provider package locally.                                           |
+| `joone analyze [sessionId]`    | Analyze a session trace for token usage and performance insights.               |
+| `joone eval`                   | Run automated offline evaluation against the LangSmith dataset.                 |
+| `joone cleanup`                | Wipe all Joone configurations, keys, traces, and plugins from your machine.     |
+
+---
+
+## 🏗️ Architecture
+
+Joone is built around the **Execution Harness** pattern.
+
+1. **Prompt Builder**: Dynamically constructs LLM prompts using Anthropic/LangChain's prompt caching features to save tokens over long sessions.
+2. **Middleware Pipeline**: Tool calls pass through a robust middleware stack (Loop Detection, Command Sanitization, Permissions) before executing.
+3. **Dynamic Sandbox**: Tools executing terminal commands or running dev servers are routed via `@langchain/core` directly into a temporary E2B sandbox. File modifications are synchronized back to your local machine via a bidirectional sync layer.
+
+## 🤝 Contributing
+
+We welcome contributions!
+
+1. Clone the repository
+2. Run `npm install`
+3. Make your changes in `src/`
+4. Compile with `npm run build`
+5. Test your changes locally using `npm run dev -- start`
+
+## 📝 License
+
+ISC License. See `LICENSE` for more information.

package/dist/__tests__/bootstrap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/bootstrap.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { LazyInstaller } from "../sandbox/bootstrap.js";
+// Mock SandboxManager
+const createMockSandbox = () => ({
+    exec: vi.fn(),
+    isActive: vi.fn().mockReturnValue(true),
+    create: vi.fn(),
+    destroy: vi.fn(),
+    uploadFile: vi.fn(),
+    getSandbox: vi.fn(),
+});
+describe("LazyInstaller", () => {
+    let mockSandbox;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSandbox = createMockSandbox();
+    });
+    // ─── Test #34: Custom template skips all installs ───
+    it("skips installation when using a custom template", async () => {
+        const installer = new LazyInstaller(true);
+        expect(installer.isGeminiCliReady()).toBe(true);
+        expect(installer.isOsvScannerReady()).toBe(true);
+        // Should not call exec at all
+        const result = await installer.ensureGeminiCli(mockSandbox);
+        expect(result).toBe(true);
+        expect(mockSandbox.exec).not.toHaveBeenCalled();
+    });
+    // ─── Test #35: Dev mode installs Gemini CLI on first use ───
+    it("installs Gemini CLI on first call in dev mode", async () => {
+        const installer = new LazyInstaller(false);
+        // First check fails (not installed), then install succeeds, then extension succeeds
+        mockSandbox.exec
+            .mockRejectedValueOnce(new Error("not found")) // version check
+            .mockResolvedValueOnce({ exitCode: 0, stdout: "installed", stderr: "" }) // npm install
+            .mockResolvedValueOnce({ exitCode: 0, stdout: "ok", stderr: "" }); // extension install
+        const result = await installer.ensureGeminiCli(mockSandbox);
+        expect(result).toBe(true);
+        expect(installer.isGeminiCliReady()).toBe(true);
+    });
+    // ─── Test #36: Caches install state — second call is a no-op ───
+    it("does not re-install on second call (cached)", async () => {
+        const installer = new LazyInstaller(false);
+        // First: fails check, succeeds install + extension
+        mockSandbox.exec
+            .mockRejectedValueOnce(new Error("not found"))
+            .mockResolvedValueOnce({ exitCode: 0, stdout: "", stderr: "" })
+            .mockResolvedValueOnce({ exitCode: 0, stdout: "", stderr: "" });
+        await installer.ensureGeminiCli(mockSandbox);
+        mockSandbox.exec.mockClear();
+        // Second call — should return immediately
+        const result = await installer.ensureGeminiCli(mockSandbox);
+        expect(result).toBe(true);
+        expect(mockSandbox.exec).not.toHaveBeenCalled();
+    });
+    // ─── Test #37: Returns false if install fails ───
+    it("returns false if Gemini CLI installation fails", async () => {
+        const installer = new LazyInstaller(false);
+        mockSandbox.exec
+            .mockRejectedValueOnce(new Error("not found")) // version check
+            .mockResolvedValueOnce({ exitCode: 1, stdout: "", stderr: "error" }); // install fails
+        const result = await installer.ensureGeminiCli(mockSandbox);
+        expect(result).toBe(false);
+        expect(installer.isGeminiCliReady()).toBe(false);
+    });
+    // ─── Test #38: OSV-Scanner install attempt ───
+    it("installs OSV-Scanner via curl when not available", async () => {
+        const installer = new LazyInstaller(false);
+        mockSandbox.exec
+            .mockRejectedValueOnce(new Error("not found")) // version check
+            .mockResolvedValueOnce({ exitCode: 0, stdout: "", stderr: "" }); // curl install
+        const result = await installer.ensureOsvScanner(mockSandbox);
+        expect(result).toBe(true);
+        expect(installer.isOsvScannerReady()).toBe(true);
+    });
+});
+//# sourceMappingURL=bootstrap.test.js.map

package/dist/__tests__/bootstrap.test.js.map

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

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/config.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+// We will import these once they exist — test-first.
+import { loadConfig, saveConfig, DEFAULT_CONFIG } from "../cli/config.js";
+describe("Config Manager", () => {
+    // Use a temp directory so we never touch the real ~/.joone
+    let tempDir;
+    let configPath;
+    let savedAnthropicKey;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "joone-test-"));
+        configPath = path.join(tempDir, "config.json");
+        // Isolate from vitest.config.ts env vars
+        savedAnthropicKey = process.env.ANTHROPIC_API_KEY;
+        delete process.env.ANTHROPIC_API_KEY;
+    });
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        // Restore env var
+        if (savedAnthropicKey !== undefined) {
+            process.env.ANTHROPIC_API_KEY = savedAnthropicKey;
+        }
+    });
+    // ─── RED Test #1: loadConfig returns defaults when file doesn't exist ───
+    it("returns default config when config file does not exist", () => {
+        const config = loadConfig(configPath);
+        expect(config.provider).toBe("anthropic");
+        expect(config.model).toBe("claude-sonnet-4-20250514");
+        expect(config.apiKey).toBeUndefined();
+        expect(config.maxTokens).toBe(4096);
+        expect(config.temperature).toBe(0);
+        expect(config.streaming).toBe(true);
+    });
+    // ─── RED Test #2: saveConfig roundtrips with loadConfig ───
+    it("saves config to disk and loads it back correctly", () => {
+        const custom = {
+            ...DEFAULT_CONFIG,
+            provider: "openai",
+            model: "gpt-4o",
+            apiKey: "sk-test-key-123",
+            streaming: false,
+        };
+        saveConfig(configPath, custom);
+        // File should exist now
+        expect(fs.existsSync(configPath)).toBe(true);
+        // Load it back — should match what was saved
+        const loaded = loadConfig(configPath);
+        expect(loaded.provider).toBe("openai");
+        expect(loaded.model).toBe("gpt-4o");
+        expect(loaded.apiKey).toBe("sk-test-key-123");
+        expect(loaded.streaming).toBe(false);
+        // Fields we didn't override should keep defaults
+        expect(loaded.maxTokens).toBe(4096);
+        expect(loaded.temperature).toBe(0);
+    });
+    // ─── RED Test #3: loadConfig uses env var fallback for API key ───
+    it("falls back to ANTHROPIC_API_KEY env var when apiKey is missing from config", () => {
+        // Save a config WITHOUT an apiKey
+        const noKeyConfig = {
+            ...DEFAULT_CONFIG,
+            provider: "anthropic",
+        };
+        saveConfig(configPath, noKeyConfig);
+        // Set the env var
+        const originalEnv = process.env.ANTHROPIC_API_KEY;
+        process.env.ANTHROPIC_API_KEY = "sk-ant-from-env";
+        try {
+            const config = loadConfig(configPath);
+            expect(config.apiKey).toBe("sk-ant-from-env");
+        }
+        finally {
+            // Restore env
+            if (originalEnv === undefined) {
+                delete process.env.ANTHROPIC_API_KEY;
+            }
+            else {
+                process.env.ANTHROPIC_API_KEY = originalEnv;
+            }
+        }
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

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

package/dist/__tests__/m55.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/m55.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { BrowserTool } from "../tools/browser.js";
+import { WebSearchTool, bindValyuApiKey } from "../tools/webSearch.js";
+import { SkillLoader } from "../skills/loader.js";
+import { SearchSkillsTool, LoadSkillTool, bindSkillLoader, } from "../skills/tools.js";
+import { ToolRouter, ToolTarget } from "../tools/router.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// 5.5a: Browser Tool
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("BrowserTool", () => {
+    // ─── Test #70: Builds navigate command ───
+    it("has the correct schema with all supported actions", () => {
+        expect(BrowserTool.name).toBe("browser");
+        expect(BrowserTool.schema.properties.action.enum).toContain("navigate");
+        expect(BrowserTool.schema.properties.action.enum).toContain("snapshot");
+        expect(BrowserTool.schema.properties.action.enum).toContain("click");
+        expect(BrowserTool.schema.properties.action.enum).toContain("type");
+        expect(BrowserTool.schema.properties.action.enum).toContain("screenshot");
+        expect(BrowserTool.schema.properties.action.enum).toContain("scroll");
+    });
+    // ─── Test #71: Rejects without sandbox ───
+    it("throws when sandbox is not active", async () => {
+        const result = await BrowserTool.execute({ action: "navigate", url: "https://example.com" });
+        expect(result.isError).toBe(true);
+        expect(result.content).toMatch(/sandbox/i);
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// 5.5b: Web Search Tool
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("WebSearchTool", () => {
+    // ─── Test #72: Returns error if no API key ───
+    it("returns error when API key is not configured", async () => {
+        bindValyuApiKey(undefined);
+        const result = await WebSearchTool.execute({ query: "test" });
+        expect(result.content).toMatch(/api key not configured/i);
+    });
+    // ─── Test #73: Schema includes all sources ───
+    it("schema includes all search sources", () => {
+        const sources = WebSearchTool.schema.properties.source.enum;
+        expect(sources).toContain("web");
+        expect(sources).toContain("papers");
+        expect(sources).toContain("finance");
+        expect(sources).toContain("patents");
+        expect(sources).toContain("sec");
+        expect(sources).toContain("companies");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// 5.5c: Skills System
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("SkillLoader", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "joone-skills-test-"));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    const createSkill = (dir, name, content) => {
+        const skillDir = path.join(dir, name);
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(path.join(skillDir, "SKILL.md"), content);
+    };
+    // ─── Test #74: Discovers skills from project root ───
+    it("discovers skills from a directory", () => {
+        const skillsDir = path.join(tmpDir, "skills");
+        createSkill(skillsDir, "deploy", "---\nname: deploy\ndescription: Deploy to Vercel\n---\n## Steps\n1. Run vercel deploy");
+        const loader = new SkillLoader(tmpDir);
+        const skills = loader.discoverSkills();
+        expect(skills.length).toBeGreaterThanOrEqual(1);
+        const deploy = skills.find((s) => s.name === "deploy");
+        expect(deploy).toBeDefined();
+        expect(deploy.description).toBe("Deploy to Vercel");
+        expect(deploy.source).toBe("project");
+    });
+    // ─── Test #75: Parses YAML frontmatter ───
+    it("parses YAML frontmatter correctly", () => {
+        const loader = new SkillLoader(tmpDir);
+        const result = loader.parseFrontmatter("---\nname: test-skill\ndescription: A test skill\n---\n# Instructions");
+        expect(result.name).toBe("test-skill");
+        expect(result.description).toBe("A test skill");
+    });
+    // ─── Test #76: Project skills override user skills with same name ───
+    it("project skills override user-level skills with the same name", () => {
+        // Create user-level skill in the mocked home directory (tmpDir)
+        const userSkillsDir = path.join(tmpDir, ".joone", "skills");
+        createSkill(userSkillsDir, "deploy", "---\nname: deploy\ndescription: User deploy\n---\n");
+        // Create project-level skill
+        const projectSkillsDir = path.join(tmpDir, "skills");
+        createSkill(projectSkillsDir, "deploy", "---\nname: deploy\ndescription: Project deploy\n---\n");
+        // Pass tmpDir as both projectRoot and userHome
+        const loader = new SkillLoader(tmpDir, tmpDir);
+        const skills = loader.discoverSkills();
+        const deploy = skills.find((s) => s.name === "deploy");
+        expect(deploy).toBeDefined();
+        expect(deploy.source).toBe("project");
+        expect(deploy.description).toBe("Project deploy");
+        // Ensure we only discovered one deploy skill
+        const deployCount = skills.filter((s) => s.name === "deploy").length;
+        expect(deployCount).toBe(1);
+    });
+    // ─── Test #77: loadSkill reads full content ───
+    it("loads the full content of a skill", () => {
+        const skillsDir = path.join(tmpDir, "skills");
+        const content = "---\nname: tdd\ndescription: Test-driven development\n---\n## Red-Green-Refactor\n1. Write failing test";
+        createSkill(skillsDir, "tdd", content);
+        const loader = new SkillLoader(tmpDir);
+        const loaded = loader.loadSkill("tdd");
+        expect(loaded).toBe(content);
+    });
+});
+describe("Skills Tools", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "joone-skills-tools-test-"));
+        const skillsDir = path.join(tmpDir, "skills");
+        const skillDir = path.join(skillsDir, "deploy");
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(path.join(skillDir, "SKILL.md"), "---\nname: deploy\ndescription: Deploy to production\n---\n## Steps");
+        bindSkillLoader(new SkillLoader(tmpDir));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // ─── Test #78: search_skills returns matching skills ───
+    it("search_skills finds matching skills", async () => {
+        const result = await SearchSkillsTool.execute({ query: "deploy" });
+        expect(result.content).toContain("deploy");
+        expect(result.content).toContain("production");
+    });
+    // ─── Test #79: load_skill reads full content ───
+    it("load_skill returns the full SKILL.md content", async () => {
+        const result = await LoadSkillTool.execute({ name: "deploy" });
+        expect(result.content).toContain("## Steps");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// Routing
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("ToolRouter (M5.5 additions)", () => {
+    const router = new ToolRouter();
+    // ─── Test #80: Browser routes to sandbox ───
+    it("routes browser to sandbox", () => {
+        expect(router.getTarget("browser")).toBe(ToolTarget.SANDBOX);
+    });
+    // ─── Test #81: web_search routes to host ───
+    it("routes web_search to host", () => {
+        expect(router.getTarget("web_search")).toBe(ToolTarget.HOST);
+    });
+    // ─── Test #82: skills tools route to host ───
+    it("routes search_skills and load_skill to host", () => {
+        expect(router.getTarget("search_skills")).toBe(ToolTarget.HOST);
+        expect(router.getTarget("load_skill")).toBe(ToolTarget.HOST);
+    });
+});
+//# sourceMappingURL=m55.test.js.map

package/dist/__tests__/m55.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"m55.test.js","sourceRoot":"","sources":["../../src/__tests__/m55.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE5D,kFAAkF;AAClF,qBAAqB;AACrB,kFAAkF;AAElF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,4CAA4C;IAE5C,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC1E,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAE5C,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,kFAAkF;AAClF,wBAAwB;AACxB,kFAAkF;AAElF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,gDAAgD;IAEhD,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAEhD,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;QAE5D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,kFAAkF;AAClF,sBAAsB;AACtB,kFAAkF;AAElF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,CAClB,GAAW,EACX,IAAY,EACZ,OAAe,EACT,EAAE;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF,uDAAuD;IAEvD,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,WAAW,CACT,SAAS,EACT,QAAQ,EACR,uFAAuF,CACxF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAEvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAE5C,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CACpC,uEAAuE,CACxE,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,uEAAuE;IAEvE,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,gEAAgE;QAChE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,WAAW,CACT,aAAa,EACb,QAAQ,EACR,oDAAoD,CACrD,CAAC;QAEF,6BAA6B;QAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,WAAW,CACT,gBAAgB,EAChB,QAAQ,EACR,uDAAuD,CACxD,CAAC;QAEF,+CAA+C;QAC/C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,MAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEnD,6CAA6C;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACrE,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,iDAAiD;IAEjD,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,OAAO,GACX,yGAAyG,CAAC;QAC5G,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAE5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAC/B,qEAAqE,CACtE,CAAC;QAEF,eAAe,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,0DAA0D;IAE1D,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAElD,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,kFAAkF;AAClF,UAAU;AACV,kFAAkF;AAElF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAEhC,8CAA8C;IAE9C,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAE9C,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAE/C,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/middleware.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/middleware.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect, vi } from "vitest";
+import { MiddlewarePipeline } from "../middleware/pipeline.js";
+import { LoopDetectionMiddleware } from "../middleware/loopDetection.js";
+import { CommandSanitizerMiddleware } from "../middleware/commandSanitizer.js";
+import { PreCompletionMiddleware } from "../middleware/preCompletion.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pipeline Core
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("MiddlewarePipeline", () => {
+    const makeCtx = (overrides) => ({
+        toolName: "bash",
+        args: { command: "echo hello" },
+        callId: "call-1",
+        ...overrides,
+    });
+    // ─── Test #44: Runs before/after hooks in order ───
+    it("runs before hooks in registration order and after hooks in reverse", async () => {
+        const order = [];
+        const pipeline = new MiddlewarePipeline();
+        pipeline.use({
+            name: "A",
+            before: (ctx) => { order.push("A:before"); return ctx; },
+            after: (_ctx, r) => { order.push("A:after"); return r; },
+        });
+        pipeline.use({
+            name: "B",
+            before: (ctx) => { order.push("B:before"); return ctx; },
+            after: (_ctx, r) => { order.push("B:after"); return r; },
+        });
+        const executeFn = vi.fn(async () => ({ content: "result" }));
+        await pipeline.run(makeCtx(), executeFn);
+        expect(order).toEqual(["A:before", "B:before", "B:after", "A:after"]);
+        expect(executeFn).toHaveBeenCalledOnce();
+    });
+    // ─── Test #45: Short-circuits when before returns string ───
+    it("short-circuits and does NOT execute the tool when before returns a string", async () => {
+        const pipeline = new MiddlewarePipeline();
+        pipeline.use({
+            name: "Blocker",
+            before: () => "⚠ Blocked!",
+        });
+        const executeFn = vi.fn(async () => ({ content: "should not reach this" }));
+        const result = await pipeline.run(makeCtx(), executeFn);
+        expect(result).toBe("⚠ Blocked!");
+        expect(executeFn).not.toHaveBeenCalled();
+    });
+    // ─── Test #46: After hooks can transform the result ───
+    it("after hooks can transform the tool result", async () => {
+        const pipeline = new MiddlewarePipeline();
+        pipeline.use({
+            name: "Uppercaser",
+            after: (_ctx, result) => { result.content = result.content.toUpperCase(); return result; },
+        });
+        const result = await pipeline.run(makeCtx(), async () => ({ content: "hello" }));
+        expect(result).toBe("HELLO");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// LoopDetectionMiddleware
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("LoopDetectionMiddleware", () => {
+    const makeCtx = (cmd = "echo hello") => ({
+        toolName: "bash",
+        args: { command: cmd },
+        callId: "call-x",
+    });
+    // ─── Test #47: Allows first 2 identical calls ───
+    it("allows calls below the threshold", () => {
+        const mw = new LoopDetectionMiddleware(3);
+        expect(mw.before(makeCtx())).toEqual(makeCtx());
+        expect(mw.before(makeCtx())).toEqual(makeCtx());
+    });
+    // ─── Test #48: Blocks on 3rd identical call ───
+    it("blocks on the Nth identical consecutive call", () => {
+        const mw = new LoopDetectionMiddleware(3);
+        mw.before(makeCtx());
+        mw.before(makeCtx());
+        const result = mw.before(makeCtx());
+        expect(typeof result).toBe("string");
+        expect(result).toMatch(/loop detected/i);
+    });
+    // ─── Test #49: Resets when args change ───
+    it("resets the count when a different call is made", () => {
+        const mw = new LoopDetectionMiddleware(3);
+        mw.before(makeCtx("echo a"));
+        mw.before(makeCtx("echo a"));
+        // Different call breaks the streak
+        mw.before(makeCtx("echo b"));
+        // Back to "echo a" — only 1 in a row now
+        const result = mw.before(makeCtx("echo a"));
+        expect(typeof result).not.toBe("string");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// CommandSanitizerMiddleware
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("CommandSanitizerMiddleware", () => {
+    const mw = new CommandSanitizerMiddleware();
+    const makeCtx = (cmd) => ({
+        toolName: "bash",
+        args: { command: cmd },
+        callId: "call-x",
+    });
+    // ─── Test #50: Blocks rm -rf / ───
+    it("blocks rm -rf /", () => {
+        const result = mw.before(makeCtx("rm -rf /"));
+        expect(typeof result).toBe("string");
+        expect(result).toMatch(/blocked/i);
+    });
+    // ─── Test #51: Blocks interactive commands ───
+    it("blocks interactive commands like vim", () => {
+        const result = mw.before(makeCtx("vim src/index.ts"));
+        expect(typeof result).toBe("string");
+        expect(result).toMatch(/interactive/i);
+    });
+    // ─── Test #52: Allows safe commands ───
+    it("allows safe commands through", () => {
+        const result = mw.before(makeCtx("npm test"));
+        expect(result).toEqual(makeCtx("npm test"));
+    });
+    // ─── Test #53: Ignores non-bash tools ───
+    it("ignores non-bash tool calls entirely", () => {
+        const ctx = {
+            toolName: "read_file",
+            args: { path: "/etc/passwd" },
+            callId: "call-x",
+        };
+        expect(mw.before(ctx)).toEqual(ctx);
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════════
+// PreCompletionMiddleware
+// ═══════════════════════════════════════════════════════════════════════════════
+describe("PreCompletionMiddleware", () => {
+    // ─── Test #54: Blocks completion without tests ───
+    it("blocks task_complete when no tests have been run", () => {
+        const mw = new PreCompletionMiddleware();
+        const ctx = {
+            toolName: "task_complete",
+            args: {},
+            callId: "call-x",
+        };
+        const result = mw.before(ctx);
+        expect(typeof result).toBe("string");
+        expect(result).toMatch(/must run tests/i);
+    });
+    // ─── Test #55: Allows completion after tests ───
+    it("allows task_complete after a test command has been run", () => {
+        const mw = new PreCompletionMiddleware();
+        // Simulate running tests
+        const testCtx = {
+            toolName: "bash",
+            args: { command: "npm test" },
+            callId: "call-1",
+        };
+        mw.before(testCtx);
+        mw.after(testCtx, { content: "tests passed", metadata: { exitCode: 0 }, isError: false });
+        expect(mw.hasPassedTests()).toBe(true);
+        // Now try completion
+        const completeCtx = {
+            toolName: "task_complete",
+            args: {},
+            callId: "call-2",
+        };
+        const result = mw.before(completeCtx);
+        expect(result).toEqual(completeCtx);
+    });
+});
+//# sourceMappingURL=middleware.test.js.map