@prestyj/cli 4.2.15

package/dist/core/compaction/compactor.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect } from "vitest";
+import { shouldCompact, findRecentCutPoint } from "./compactor.js";
+import { estimateConversationTokens } from "./token-estimator.js";
+function makeMessage(role, content) {
+    return { role, content };
+}
+function makeToolCallMessage() {
+    return {
+        role: "assistant",
+        content: [{ type: "tool_call", id: "t1", name: "read", args: { path: "foo.ts" } }],
+    };
+}
+function makeToolResultMessage() {
+    return {
+        role: "tool",
+        content: [{ type: "tool_result", toolCallId: "t1", content: "file contents" }],
+    };
+}
+// ── shouldCompact ──────────────────────────────────────────
+describe("shouldCompact", () => {
+    it("returns false when under threshold", () => {
+        const messages = [makeMessage("system", "sys"), makeMessage("user", "hello")];
+        // Estimated tokens ~= 13, contextWindow 200k, threshold 0.8 → 160k
+        expect(shouldCompact(messages, 200_000, 0.8)).toBe(false);
+    });
+    it("returns true when over threshold", () => {
+        // Create a message with enough content to exceed a small context window
+        const bigContent = "x".repeat(1000); // ~250 tokens
+        const messages = [makeMessage("system", bigContent), makeMessage("user", bigContent)];
+        // Total ~508 tokens, window=500, threshold 0.8 → 400
+        expect(shouldCompact(messages, 500, 0.8)).toBe(true);
+    });
+    it("uses default threshold of 0.8", () => {
+        const content = "x".repeat(400); // ~100 tokens + 4 overhead = 104
+        const messages = [makeMessage("user", content)];
+        const estimated = estimateConversationTokens(messages);
+        // With window = estimated / 0.7 → should be under 0.8 threshold
+        expect(shouldCompact(messages, Math.ceil(estimated / 0.7))).toBe(false);
+        // With window = estimated / 0.9 → should be over 0.8 threshold
+        expect(shouldCompact(messages, Math.ceil(estimated / 0.9))).toBe(true);
+    });
+    it("handles custom threshold", () => {
+        const content = "x".repeat(200); // ~50 tokens + 4 = 54
+        const messages = [makeMessage("user", content)];
+        const estimated = estimateConversationTokens(messages);
+        // Tight threshold: 0.5 → need window > estimated/0.5 to not compact
+        expect(shouldCompact(messages, estimated * 3, 0.5)).toBe(false);
+        expect(shouldCompact(messages, estimated, 0.5)).toBe(true);
+    });
+});
+// ── findRecentCutPoint ─────────────────────────────────────
+describe("findRecentCutPoint", () => {
+    it("keeps all messages when total tokens are under budget", () => {
+        const messages = [
+            makeMessage("system", "sys"),
+            makeMessage("user", "hello"),
+            makeMessage("assistant", "hi"),
+        ];
+        // All messages are small, budget is huge
+        const cut = findRecentCutPoint(messages, 100_000);
+        expect(cut).toBe(1); // Only system (index 0) is excluded
+    });
+    it("keeps only recent messages when total exceeds budget", () => {
+        const big = "x".repeat(400); // ~100 tokens each
+        const messages = [
+            makeMessage("system", "sys"),
+            makeMessage("user", big), // ~104 tokens
+            makeMessage("assistant", big), // ~104 tokens
+            makeMessage("user", big), // ~104 tokens
+            makeMessage("assistant", big), // ~104 tokens
+            makeMessage("user", "last"), // ~5 tokens
+        ];
+        // Budget of 120 tokens — should keep last ~1-2 messages
+        const cut = findRecentCutPoint(messages, 120);
+        expect(cut).toBeGreaterThan(1);
+        expect(cut).toBeLessThan(messages.length);
+    });
+    it("never cuts at index 0 (system message)", () => {
+        const messages = [makeMessage("system", "sys"), makeMessage("user", "hi")];
+        const cut = findRecentCutPoint(messages, 100_000);
+        expect(cut).toBeGreaterThanOrEqual(1);
+    });
+    it("does not split tool_call and tool_result pairs", () => {
+        const big = "x".repeat(400); // ~100 tokens
+        const messages = [
+            makeMessage("system", "sys"),
+            makeMessage("user", big),
+            makeToolCallMessage(), // assistant with tool_call
+            makeToolResultMessage(), // tool result
+            makeMessage("user", "thanks"),
+        ];
+        // Budget that would normally cut at the tool result (index 3)
+        // should back up to include the tool_call (index 2)
+        const cut = findRecentCutPoint(messages, 50);
+        // The cut should NOT leave a tool result as the first kept message
+        if (cut < messages.length) {
+            expect(messages[cut].role).not.toBe("tool");
+        }
+    });
+    it("handles conversation with only system message", () => {
+        const messages = [makeMessage("system", "sys")];
+        const cut = findRecentCutPoint(messages, 100);
+        expect(cut).toBe(1); // Nothing to keep beyond system
+    });
+    it("returns length when budget is 0", () => {
+        const messages = [
+            makeMessage("system", "sys"),
+            makeMessage("user", "hello"),
+            makeMessage("assistant", "hi"),
+        ];
+        const cut = findRecentCutPoint(messages, 0);
+        // Can't fit anything — cut at the end
+        expect(cut).toBe(messages.length);
+    });
+});
+//# sourceMappingURL=compactor.test.js.map

package/dist/core/compaction/compactor.test.js.map

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

package/dist/core/compaction/token-estimator.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from "@prestyj/ai";
+export declare function estimateTokens(text: string): number;
+export declare function estimateMessageTokens(message: Message): number;
+export declare function estimateConversationTokens(messages: Message[]): number;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/core/compaction/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/token-estimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,aAAa,CAAC;AAKpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqB9D;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAMtE"}

package/dist/core/compaction/token-estimator.js

@@ -0,0 +1,36 @@
+const CHARS_PER_TOKEN = 4;
+const PER_MESSAGE_OVERHEAD = 4; // tokens
+export function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+export function estimateMessageTokens(message) {
+    let tokens = PER_MESSAGE_OVERHEAD;
+    if (typeof message.content === "string") {
+        tokens += estimateTokens(message.content);
+    }
+    else if (Array.isArray(message.content)) {
+        for (const part of message.content) {
+            if ("text" in part && typeof part.text === "string") {
+                tokens += estimateTokens(part.text);
+            }
+            else if ("type" in part && part.type === "tool_call") {
+                const tc = part;
+                tokens += estimateTokens(tc.name);
+                tokens += estimateTokens(JSON.stringify(tc.args));
+            }
+            else if ("type" in part && part.type === "tool_result") {
+                const tr = part;
+                tokens += estimateTokens(tr.content);
+            }
+        }
+    }
+    return tokens;
+}
+export function estimateConversationTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        total += estimateMessageTokens(msg);
+    }
+    return total;
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/core/compaction/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../../src/core/compaction/token-estimator.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,oBAAoB,GAAG,CAAC,CAAC,CAAC,SAAS;AAEzC,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,IAAI,MAAM,GAAG,oBAAoB,CAAC;IAElC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACvD,MAAM,EAAE,GAAG,IAA2C,CAAC;gBACvD,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzD,MAAM,EAAE,GAAG,IAA6B,CAAC;gBACzC,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAmB;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/compaction/token-estimator.test.d.ts

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

package/dist/core/compaction/token-estimator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.test.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/token-estimator.test.ts"],"names":[],"mappings":""}

package/dist/core/compaction/token-estimator.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect } from "vitest";
+import { estimateTokens, estimateMessageTokens, estimateConversationTokens, } from "./token-estimator.js";
+describe("estimateTokens", () => {
+    it("returns 0 for empty string", () => {
+        expect(estimateTokens("")).toBe(0);
+    });
+    it("estimates at ~4 chars per token", () => {
+        expect(estimateTokens("abcd")).toBe(1);
+        expect(estimateTokens("abcdefgh")).toBe(2);
+        expect(estimateTokens("abc")).toBe(1); // ceil(3/4) = 1
+    });
+    it("handles long text", () => {
+        const text = "a".repeat(1000);
+        expect(estimateTokens(text)).toBe(250);
+    });
+});
+describe("estimateMessageTokens", () => {
+    it("estimates string content message", () => {
+        const msg = { role: "user", content: "Hello world" };
+        const tokens = estimateMessageTokens(msg);
+        // ceil(11/4) = 3 + 4 overhead = 7
+        expect(tokens).toBe(7);
+    });
+    it("includes per-message overhead", () => {
+        const msg = { role: "user", content: "" };
+        // 0 content + 4 overhead
+        expect(estimateMessageTokens(msg)).toBe(4);
+    });
+    it("estimates text content parts", () => {
+        const msg = {
+            role: "assistant",
+            content: [{ type: "text", text: "Hello" }],
+        };
+        const tokens = estimateMessageTokens(msg);
+        // ceil(5/4) = 2 + 4 overhead = 6
+        expect(tokens).toBe(6);
+    });
+    it("estimates tool call parts", () => {
+        const msg = {
+            role: "assistant",
+            content: [
+                {
+                    type: "tool_call",
+                    id: "tc1",
+                    name: "read_file",
+                    args: { path: "/foo/bar.ts" },
+                },
+            ],
+        };
+        const tokens = estimateMessageTokens(msg);
+        // name "read_file" = ceil(9/4) = 3
+        // args JSON '{"path":"/foo/bar.ts"}' = ceil(21/4) = 6
+        // + 4 overhead = 13
+        expect(tokens).toBe(13);
+    });
+    it("estimates tool result parts", () => {
+        const msg = {
+            role: "tool",
+            content: [
+                {
+                    type: "tool_result",
+                    toolCallId: "tc1",
+                    content: "file contents here",
+                },
+            ],
+        };
+        const tokens = estimateMessageTokens(msg);
+        // "file contents here" = ceil(18/4) = 5 + 4 overhead = 9
+        expect(tokens).toBe(9);
+    });
+    it("sums multiple content parts", () => {
+        const msg = {
+            role: "assistant",
+            content: [
+                { type: "text", text: "Here is the result:" },
+                { type: "text", text: "Done" },
+            ],
+        };
+        const tokens = estimateMessageTokens(msg);
+        // ceil(19/4) = 5 + ceil(4/4) = 1 + 4 overhead = 10
+        expect(tokens).toBe(10);
+    });
+});
+describe("estimateConversationTokens", () => {
+    it("returns 0 for empty array", () => {
+        expect(estimateConversationTokens([])).toBe(0);
+    });
+    it("sums all message estimates", () => {
+        const messages = [
+            { role: "system", content: "You are helpful." }, // ceil(16/4)=4 + 4 = 8
+            { role: "user", content: "Hi" }, // ceil(2/4)=1 + 4 = 5
+        ];
+        expect(estimateConversationTokens(messages)).toBe(13);
+    });
+    it("handles a full conversation with tool calls", () => {
+        const messages = [
+            { role: "system", content: "sys" },
+            { role: "user", content: "read foo" },
+            {
+                role: "assistant",
+                content: [{ type: "tool_call", id: "t1", name: "read", args: { p: "foo" } }],
+            },
+            {
+                role: "tool",
+                content: [{ type: "tool_result", toolCallId: "t1", content: "bar" }],
+            },
+            { role: "assistant", content: "The file contains: bar" },
+        ];
+        const total = estimateConversationTokens(messages);
+        expect(total).toBeGreaterThan(0);
+        // Each message has at least 4 overhead tokens
+        expect(total).toBeGreaterThanOrEqual(5 * 4);
+    });
+});
+//# sourceMappingURL=token-estimator.test.js.map

package/dist/core/compaction/token-estimator.test.js.map

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

package/dist/core/custom-commands.d.ts

@@ -0,0 +1,13 @@
+export interface CustomCommand {
+    name: string;
+    description: string;
+    prompt: string;
+    filePath: string;
+}
+/**
+ * Load custom slash commands from {cwd}/.ezcoder/commands/*.md
+ * Each .md file becomes a slash command. Frontmatter provides name/description,
+ * and the body becomes the prompt injected into the agent.
+ */
+export declare function loadCustomCommands(cwd: string): Promise<CustomCommand[]>;
+//# sourceMappingURL=custom-commands.d.ts.map

package/dist/core/custom-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands.d.ts","sourceRoot":"","sources":["../../src/core/custom-commands.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA+B9E"}

package/dist/core/custom-commands.js

@@ -0,0 +1,40 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parseSkillFile } from "./skills.js";
+/**
+ * Load custom slash commands from {cwd}/.ezcoder/commands/*.md
+ * Each .md file becomes a slash command. Frontmatter provides name/description,
+ * and the body becomes the prompt injected into the agent.
+ */
+export async function loadCustomCommands(cwd) {
+    const commandsDir = path.join(cwd, ".ezcoder", "commands");
+    const commands = [];
+    let files;
+    try {
+        files = await fs.readdir(commandsDir);
+    }
+    catch {
+        return commands;
+    }
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        const filePath = path.join(commandsDir, file);
+        try {
+            const raw = await fs.readFile(filePath, "utf-8");
+            const parsed = parseSkillFile(raw, "project");
+            const name = parsed.name || path.basename(file, ".md");
+            commands.push({
+                name,
+                description: parsed.description || `Custom command from .ezcoder/commands/${file}`,
+                prompt: parsed.content,
+                filePath,
+            });
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return commands;
+}
+//# sourceMappingURL=custom-commands.js.map

package/dist/core/custom-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands.js","sourceRoot":"","sources":["../../src/core/custom-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAS7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,yCAAyC,IAAI,EAAE;gBAClF,MAAM,EAAE,MAAM,CAAC,OAAO;gBACtB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,89 @@
+import type { AgentEvent } from "@prestyj/agent";
+export interface BusEventMap {
+    text_delta: {
+        text: string;
+    };
+    thinking_delta: {
+        text: string;
+    };
+    tool_call_start: {
+        toolCallId: string;
+        name: string;
+        args: Record<string, unknown>;
+    };
+    tool_call_update: {
+        toolCallId: string;
+        update: unknown;
+    };
+    tool_call_end: {
+        toolCallId: string;
+        result: string;
+        isError: boolean;
+        durationMs: number;
+    };
+    turn_end: {
+        turn: number;
+        stopReason: string;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheRead?: number;
+            cacheWrite?: number;
+        };
+    };
+    agent_done: {
+        totalTurns: number;
+        totalUsage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheRead?: number;
+            cacheWrite?: number;
+        };
+    };
+    error: {
+        error: Error;
+    };
+    server_tool_call: {
+        id: string;
+        name: string;
+        input: unknown;
+    };
+    server_tool_result: {
+        toolUseId: string;
+        resultType: string;
+        data: unknown;
+    };
+    session_start: {
+        sessionId: string;
+    };
+    model_change: {
+        provider: string;
+        model: string;
+    };
+    compaction_start: {
+        messageCount: number;
+    };
+    compaction_end: {
+        originalCount: number;
+        newCount: number;
+    };
+    user_input: {
+        content: string;
+    };
+    slash_command: {
+        name: string;
+        args: string;
+    };
+}
+type EventKey = keyof BusEventMap;
+type EventHandler<K extends EventKey> = (payload: BusEventMap[K]) => void;
+export declare class EventBus {
+    private listeners;
+    on<K extends EventKey>(event: K, handler: EventHandler<K>): () => void;
+    off<K extends EventKey>(event: K, handler: EventHandler<K>): void;
+    emit<K extends EventKey>(event: K, payload: BusEventMap[K]): void;
+    once<K extends EventKey>(event: K, handler: EventHandler<K>): () => void;
+    forwardAgentEvent(event: AgentEvent): void;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

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

package/dist/core/event-bus.js

@@ -0,0 +1,92 @@
+// ── EventBus ───────────────────────────────────────────────
+export class EventBus {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    listeners = new Map();
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+    emit(event, payload) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        for (const handler of handlers) {
+            handler(payload);
+        }
+    }
+    once(event, handler) {
+        const wrapper = (payload) => {
+            this.off(event, wrapper);
+            handler(payload);
+        };
+        return this.on(event, wrapper);
+    }
+    forwardAgentEvent(event) {
+        switch (event.type) {
+            case "text_delta":
+                this.emit("text_delta", { text: event.text });
+                break;
+            case "thinking_delta":
+                this.emit("thinking_delta", { text: event.text });
+                break;
+            case "tool_call_start":
+                this.emit("tool_call_start", {
+                    toolCallId: event.toolCallId,
+                    name: event.name,
+                    args: event.args,
+                });
+                break;
+            case "tool_call_update":
+                this.emit("tool_call_update", {
+                    toolCallId: event.toolCallId,
+                    update: event.update,
+                });
+                break;
+            case "tool_call_end":
+                this.emit("tool_call_end", {
+                    toolCallId: event.toolCallId,
+                    result: event.result,
+                    isError: event.isError,
+                    durationMs: event.durationMs,
+                });
+                break;
+            case "turn_end":
+                this.emit("turn_end", {
+                    turn: event.turn,
+                    stopReason: event.stopReason,
+                    usage: event.usage,
+                });
+                break;
+            case "agent_done":
+                this.emit("agent_done", {
+                    totalTurns: event.totalTurns,
+                    totalUsage: event.totalUsage,
+                });
+                break;
+            case "server_tool_call":
+                this.emit("server_tool_call", {
+                    id: event.id,
+                    name: event.name,
+                    input: event.input,
+                });
+                break;
+            case "server_tool_result":
+                this.emit("server_tool_result", {
+                    toolUseId: event.toolUseId,
+                    resultType: event.resultType,
+                    data: event.data,
+                });
+                break;
+            case "error":
+                this.emit("error", { error: event.error });
+                break;
+        }
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

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

package/dist/core/extensions/loader.d.ts

@@ -0,0 +1,8 @@
+import type { Extension, ExtensionContext } from "./types.js";
+export declare class ExtensionLoader {
+    private loaded;
+    loadAll(extensionsDir: string, context: ExtensionContext): Promise<void>;
+    getLoaded(): Extension[];
+    deactivateAll(): Promise<void>;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/extensions/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAEhF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAmB;IAE3B,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC9E,SAAS,IAAI,SAAS,EAAE;IAIlB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAUrC"}

package/dist/core/extensions/loader.js

@@ -0,0 +1,48 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export class ExtensionLoader {
+    loaded = [];
+    async loadAll(extensionsDir, context) {
+        let files;
+        try {
+            files = await fs.readdir(extensionsDir);
+        }
+        catch {
+            return;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".js"))
+                continue;
+            const filePath = path.join(extensionsDir, file);
+            try {
+                const mod = await import(filePath);
+                const factory = typeof mod.default === "function" ? mod.default : mod.createExtension;
+                if (typeof factory !== "function") {
+                    console.error(`Extension ${file}: no default export or createExtension function`);
+                    continue;
+                }
+                const extension = factory();
+                await extension.activate(context);
+                this.loaded.push(extension);
+            }
+            catch (err) {
+                console.error(`Failed to load extension ${file}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    getLoaded() {
+        return [...this.loaded];
+    }
+    async deactivateAll() {
+        for (const ext of this.loaded) {
+            try {
+                await ext.deactivate?.();
+            }
+            catch {
+                // Ignore deactivation errors
+            }
+        }
+        this.loaded = [];
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/extensions/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/extensions/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,OAAO,eAAe;IAClB,MAAM,GAAgB,EAAE,CAAC;IAEjC,KAAK,CAAC,OAAO,CAAC,aAAqB,EAAE,OAAyB;QAC5D,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAEhD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACnC,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC;gBAExE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAClC,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,iDAAiD,CAAC,CAAC;oBAClF,SAAS;gBACX,CAAC;gBAED,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CACX,4BAA4B,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}