joonecli 0.2.0 → 0.2.1

package/dist/middleware/pipeline.js

@@ -1,62 +0,0 @@
-/**
- * Executes tool calls through a chain of middleware hooks.
- *
- * Execution flow:
- * 1. Run all `before()` hooks in registration order.
- *    - If any returns a string → short-circuit (tool is NOT executed).
- * 2. Execute the actual tool function.
- * 3. Run all `after()` hooks in reverse registration order.
- *    - Each can transform the result before it enters conversation history.
- */
-export class MiddlewarePipeline {
-    middlewares = [];
-    /**
-     * Register a middleware. Middlewares run in the order they are added.
-     */
-    use(middleware) {
-        this.middlewares.push(middleware);
-    }
-    /**
-     * Returns the number of registered middlewares.
-     */
-    get length() {
-        return this.middlewares.length;
-    }
-    /**
-     * Execute a tool call through the middleware pipeline.
-     *
-     * @param ctx - The tool call context (name, args, callId).
-     * @param executeFn - The actual tool execution function.
-     * @returns The final result string (possibly transformed by after-hooks).
-     */
-    async run(ctx, executeFn) {
-        // ── Before phase: run hooks in order ──
-        let currentCtx = ctx;
-        for (const mw of this.middlewares) {
-            if (mw.before) {
-                const result = await mw.before(currentCtx);
-                if (typeof result === "string") {
-                    // Short-circuit: middleware rejected the call
-                    return result;
-                }
-                if (result !== undefined) {
-                    currentCtx = result;
-                }
-            }
-        }
-        // ── Execute the tool ──
-        let output = await executeFn(currentCtx);
-        // ── After phase: run hooks in reverse order ──
-        for (let i = this.middlewares.length - 1; i >= 0; i--) {
-            const mw = this.middlewares[i];
-            if (mw.after) {
-                const transformed = await mw.after(currentCtx, output);
-                if (transformed !== undefined) {
-                    output = transformed;
-                }
-            }
-        }
-        return output.content;
-    }
-}
-//# sourceMappingURL=pipeline.js.map

package/dist/middleware/pipeline.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/middleware/pipeline.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACrB,WAAW,GAAqB,EAAE,CAAC;IAE3C;;OAEG;IACH,GAAG,CAAC,UAA0B;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CACP,GAAoB,EACpB,SAAqE;QAErE,yCAAyC;QACzC,IAAI,UAAU,GAAG,GAAG,CAAC;QAErB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAE3C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,8CAA8C;oBAC9C,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,UAAU,GAAG,MAAM,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,MAAM,GAAe,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QAErD,gDAAgD;QAChD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACvD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,MAAM,GAAG,WAAW,CAAC;gBACvB,CAAC;YACH,CAAC;QAAI,CAAC;QAER,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;CACF"}

package/dist/middleware/preCompletion.d.ts

@@ -1,29 +0,0 @@
-import { ToolCallContext, ToolMiddleware } from "./types.js";
-import { ToolResult } from "../tools/index.js";
-/**
- * Prevents the agent from marking a task as "done" without running tests.
- *
- * Tracks whether any test command has been executed during the session.
- * If the agent attempts to signal completion without running tests first,
- * the middleware intercepts and forces verification.
- *
- * Reference: docs/02_edge_cases_and_mitigations.md — "The Fake Success Verification"
- */
-export declare class PreCompletionMiddleware implements ToolMiddleware {
-    readonly name = "PreCompletion";
-    private testsPassed;
-    /** Patterns in bash commands that count as "running tests". */
-    private readonly testPatterns;
-    /** Tool names that signal the agent is trying to complete the task. */
-    private readonly completionSignals;
-    before(ctx: ToolCallContext): ToolCallContext | string;
-    after(ctx: ToolCallContext, result: ToolResult): void;
-    /**
-     * Returns whether tests have been run and passed in this session.
-     */
-    hasPassedTests(): boolean;
-    /**
-     * Resets state. Useful for testing or session boundaries.
-     */
-    reset(): void;
-}

package/dist/middleware/preCompletion.js

@@ -1,82 +0,0 @@
-/**
- * Prevents the agent from marking a task as "done" without running tests.
- *
- * Tracks whether any test command has been executed during the session.
- * If the agent attempts to signal completion without running tests first,
- * the middleware intercepts and forces verification.
- *
- * Reference: docs/02_edge_cases_and_mitigations.md — "The Fake Success Verification"
- */
-export class PreCompletionMiddleware {
-    name = "PreCompletion";
-    testsPassed = false;
-    /** Patterns in bash commands that count as "running tests". */
-    testPatterns = [
-        /\bvitest\b/,
-        /\bjest\b/,
-        /\bpytest\b/,
-        /\bmocha\b/,
-        /\bnpm\s+test\b/,
-        /\bnpm\s+run\s+test\b/,
-        /\byarn\s+test\b/,
-        /\bpnpm\s+test\b/,
-        /\bgo\s+test\b/,
-        /\bcargo\s+test\b/,
-    ];
-    /** Tool names that signal the agent is trying to complete the task. */
-    completionSignals = new Set([
-        "task_complete",
-        "attempt_completion",
-        "finish_task",
-        "submit_result",
-    ]);
-    before(ctx) {
-        // When a test command is initiated, assume it hasn't passed yet
-        if (ctx.toolName === "bash" && typeof ctx.args.command === "string") {
-            for (const pattern of this.testPatterns) {
-                if (pattern.test(ctx.args.command)) {
-                    this.testsPassed = false;
-                    break;
-                }
-            }
-        }
-        // Intercept completion attempts
-        if (this.completionSignals.has(ctx.toolName)) {
-            if (!this.testsPassed) {
-                return ("⚠ You must run tests before completing the task, AND they must pass.\n" +
-                    "Use the bash tool to execute your test suite (e.g., `npm test`, `vitest`, `pytest`).\n" +
-                    "If tests fail, fix the issues. Once tests pass cleanly, you may attempt completion again.");
-            }
-        }
-        return ctx;
-    }
-    after(ctx, result) {
-        if (ctx.toolName === "bash" && typeof ctx.args.command === "string") {
-            for (const pattern of this.testPatterns) {
-                if (pattern.test(ctx.args.command)) {
-                    // Robustly check the exact exit code from the tool metadata
-                    if (result.metadata?.exitCode === 0) {
-                        this.testsPassed = true;
-                    }
-                    else {
-                        this.testsPassed = false;
-                    }
-                    break;
-                }
-            }
-        }
-    }
-    /**
-     * Returns whether tests have been run and passed in this session.
-     */
-    hasPassedTests() {
-        return this.testsPassed;
-    }
-    /**
-     * Resets state. Useful for testing or session boundaries.
-     */
-    reset() {
-        this.testsPassed = false;
-    }
-}
-//# sourceMappingURL=preCompletion.js.map

package/dist/middleware/preCompletion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"preCompletion.js","sourceRoot":"","sources":["../../src/middleware/preCompletion.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,eAAe,CAAC;IAExB,WAAW,GAAG,KAAK,CAAC;IAE5B,+DAA+D;IAC9C,YAAY,GAAG;QAC9B,YAAY;QACZ,UAAU;QACV,YAAY;QACZ,WAAW;QACX,gBAAgB;QAChB,sBAAsB;QACtB,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,kBAAkB;KACnB,CAAC;IAEF,uEAAuE;IACtD,iBAAiB,GAAG,IAAI,GAAG,CAAC;QAC3C,eAAe;QACf,oBAAoB;QACpB,aAAa;QACb,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAoB;QACzB,gEAAgE;QAChE,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;oBACzB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,OAAO,CACL,wEAAwE;oBACxE,wFAAwF;oBACxF,2FAA2F,CAC5F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAoB,EAAE,MAAkB;QAC5C,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnC,4DAA4D;oBAC5D,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,EAAE,CAAC;wBACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;oBAC1B,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;oBAC3B,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF"}

package/dist/middleware/types.d.ts

@@ -1,40 +0,0 @@
-/**
- * Middleware types for the tool execution pipeline.
- *
- * Each middleware can hook into both the "before" and "after" phases
- * of a tool call. The pipeline chains them in order.
- */
-import { ToolResult } from "../tools/index.js";
-/**
- * Context object passed through the middleware chain for each tool call.
- */
-export interface ToolCallContext {
-    /** Name of the tool being called (e.g., "bash", "read_file"). */
-    toolName: string;
-    /** Arguments passed to the tool. */
-    args: Record<string, any>;
-    /** Unique ID of this tool call (from the LLM response). */
-    callId: string;
-}
-/**
- * A middleware that can intercept tool calls before and after execution.
- *
- * - `before()`: Runs before the tool executes. Return the (possibly modified)
- *   context to continue, or a `string` to short-circuit with an error/warning.
- * - `after()`: Runs after the tool executes. Can transform the result before
- *   it enters the conversation history.
- */
-export interface ToolMiddleware {
-    /** Human-readable name for logging and debugging. */
-    name: string;
-    /**
-     * Pre-execution hook.
-     * @returns ToolCallContext to mutate, a string to short-circuit, or void to pass through unmodified.
-     */
-    before?(ctx: ToolCallContext): Promise<ToolCallContext | string | void> | ToolCallContext | string | void;
-    /**
-     * Post-execution hook.
-     * @returns The transformed tool result object, or void to pass through unmodified.
-     */
-    after?(ctx: ToolCallContext, result: ToolResult): Promise<ToolResult | void> | ToolResult | void;
-}

package/dist/middleware/types.js

@@ -1,8 +0,0 @@
-/**
- * Middleware types for the tool execution pipeline.
- *
- * Each middleware can hook into both the "before" and "after" phases
- * of a tool call. The pipeline chains them in order.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/middleware/types.js.map

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

package/dist/skills/loader.d.ts

@@ -1,55 +0,0 @@
-import { SkillMeta } from "./types.js";
-/**
- * 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 declare class SkillLoader {
-    private projectRoot;
-    private userHome;
-    private cachedSkills;
-    constructor(projectRoot?: string, userHome?: string);
-    /**
-     * Returns all skill discovery directories in priority order.
-     * Project-level directories come first (higher priority).
-     */
-    getDiscoveryPaths(): {
-        path: string;
-        source: "project" | "user";
-    }[];
-    /**
-     * Parses YAML frontmatter from a SKILL.md content string.
-     * Simple parser — handles `name:` and `description:` fields.
-     */
-    parseFrontmatter(content: string): {
-        name?: string;
-        description?: string;
-    };
-    /**
-     * Discovers all available skills from all discovery paths.
-     * Deduplicates by name — project-level skills override user-level.
-     * Results are cached per session.
-     */
-    discoverSkills(): SkillMeta[];
-    /**
-     * Loads the full content of a specific skill's SKILL.md.
-     * Returns undefined if the skill is not found.
-     */
-    loadSkill(name: string): string | undefined;
-    /**
-     * Clears the cached skills. Call when skills directory contents may have changed.
-     */
-    clearCache(): void;
-}

package/dist/skills/loader.js

@@ -1,132 +0,0 @@
-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

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

package/dist/skills/tools.d.ts

@@ -1,5 +0,0 @@
-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

@@ -1,78 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/test_cache.d.ts

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

package/dist/test_cache.js

@@ -1,55 +0,0 @@
-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

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

package/dist/test_google.d.ts

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

package/dist/test_google.js

@@ -1,36 +0,0 @@
-import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
-import { HumanMessage, SystemMessage } from "@langchain/core/messages";
-import * as dotenv from "dotenv";
-dotenv.config();
-async function main() {
-    const model = new ChatGoogleGenerativeAI({
-        model: "gemini-2.5-flash",
-    });
-    const messagesGrouped = [
-        new SystemMessage("You are a helpful assistant."),
-        new SystemMessage("Also, be concise."),
-        new HumanMessage("Hello!"),
-    ];
-    try {
-        await model.invoke(messagesGrouped);
-        console.log("Success: Grouped SystemMessages at the start work perfectly.");
-    }
-    catch (e) {
-        console.error("Grouped systems failed:", e.message);
-    }
-    const messagesMidstream = [
-        new SystemMessage("You are a helpful assistant."),
-        new HumanMessage("Hello!"),
-        new SystemMessage("System recovery hint here."),
-        new HumanMessage("What did I say?"),
-    ];
-    try {
-        await model.invoke(messagesMidstream);
-        console.log("Success: Mid-stream SystemMessages work.");
-    }
-    catch (e) {
-        console.error("Midstream systems failed:", e.message);
-    }
-}
-main();
-//# sourceMappingURL=test_google.js.map

package/dist/test_google.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test_google.js","sourceRoot":"","sources":["../src/test_google.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,IAAI,sBAAsB,CAAC;QACvC,KAAK,EAAE,kBAAkB;KAC1B,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG;QACtB,IAAI,aAAa,CAAC,8BAA8B,CAAC;QACjD,IAAI,aAAa,CAAC,mBAAmB,CAAC;QACtC,IAAI,YAAY,CAAC,QAAQ,CAAC;KAC3B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,IAAI,aAAa,CAAC,8BAA8B,CAAC;QACjD,IAAI,YAAY,CAAC,QAAQ,CAAC;QAC1B,IAAI,aAAa,CAAC,4BAA4B,CAAC;QAC/C,IAAI,YAAY,CAAC,iBAAiB,CAAC;KACpC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/tools/browser.d.ts

@@ -1,19 +0,0 @@
-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;