klaus-agent 0.1.0

package/dist/multi-agent/labor-market.js

@@ -0,0 +1,40 @@
+// LaborMarket — fixed + dynamic subagent registry
+export class LaborMarket {
+    _fixed = new Map();
+    _dynamic = new Map();
+    addFixed(name, agent, description) {
+        if (this._fixed.has(name) || this._dynamic.has(name)) {
+            throw new Error(`Subagent "${name}" already exists`);
+        }
+        this._fixed.set(name, { agent, description });
+    }
+    addDynamic(name, agent, description) {
+        if (this._fixed.has(name) || this._dynamic.has(name)) {
+            throw new Error(`Subagent "${name}" already exists`);
+        }
+        this._dynamic.set(name, { agent, description });
+    }
+    get(name) {
+        return this._fixed.get(name)?.agent ?? this._dynamic.get(name)?.agent;
+    }
+    getDescription(name) {
+        return this._fixed.get(name)?.description ?? this._dynamic.get(name)?.description;
+    }
+    listAll() {
+        const result = [];
+        for (const [name, entry] of this._fixed) {
+            result.push({ name, description: entry.description, type: "fixed" });
+        }
+        for (const [name, entry] of this._dynamic) {
+            result.push({ name, description: entry.description, type: "dynamic" });
+        }
+        return result;
+    }
+    removeDynamic(name) {
+        return this._dynamic.delete(name);
+    }
+    has(name) {
+        return this._fixed.has(name) || this._dynamic.has(name);
+    }
+}
+//# sourceMappingURL=labor-market.js.map

package/dist/multi-agent/labor-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labor-market.js","sourceRoot":"","sources":["../../src/multi-agent/labor-market.ts"],"names":[],"mappings":"AAAA,kDAAkD;AASlD,MAAM,OAAO,WAAW;IACd,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1C,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEpD,QAAQ,CAAC,IAAY,EAAE,KAAY,EAAE,WAAmB;QACtD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,kBAAkB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,KAAY,EAAE,WAAmB;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,kBAAkB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IACpF,CAAC;IAED,OAAO;QACL,MAAM,MAAM,GAAuE,EAAE,CAAC;QACtF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/multi-agent/task-executor.d.ts

@@ -0,0 +1,12 @@
+import type { LaborMarket } from "./labor-market.js";
+import type { AgentMessage, AgentEvent, AssistantMessage } from "../types.js";
+export interface TaskResult {
+    messages: AgentMessage[];
+    lastAssistantMessage?: AssistantMessage;
+}
+export declare class TaskExecutor {
+    private _laborMarket;
+    private _onEvent?;
+    constructor(_laborMarket: LaborMarket, _onEvent?: ((subagentName: string, event: AgentEvent) => void) | undefined);
+    execute(subagentName: string, prompt: string): Promise<TaskResult>;
+}

package/dist/multi-agent/task-executor.js

@@ -0,0 +1,38 @@
+// TaskExecutor — run subagent with isolated context, pipe approval back
+export class TaskExecutor {
+    _laborMarket;
+    _onEvent;
+    constructor(_laborMarket, _onEvent) {
+        this._laborMarket = _laborMarket;
+        this._onEvent = _onEvent;
+    }
+    async execute(subagentName, prompt) {
+        const agent = this._laborMarket.get(subagentName);
+        if (!agent) {
+            throw new Error(`Subagent "${subagentName}" not found`);
+        }
+        // Subscribe to subagent events and forward them
+        let unsubscribe;
+        if (this._onEvent) {
+            const handler = this._onEvent;
+            unsubscribe = agent.subscribe((event) => handler(subagentName, event));
+        }
+        try {
+            const messages = await agent.prompt(prompt);
+            // Extract last assistant message as the "result"
+            let lastAssistantMessage;
+            for (let i = messages.length - 1; i >= 0; i--) {
+                const msg = messages[i];
+                if (msg && typeof msg === "object" && "role" in msg && msg.role === "assistant") {
+                    lastAssistantMessage = msg;
+                    break;
+                }
+            }
+            return { messages, lastAssistantMessage };
+        }
+        finally {
+            unsubscribe?.();
+        }
+    }
+}
+//# sourceMappingURL=task-executor.js.map

package/dist/multi-agent/task-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.js","sourceRoot":"","sources":["../../src/multi-agent/task-executor.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAWxE,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,YAAyB,EACzB,QAA4D;QAD5D,iBAAY,GAAZ,YAAY,CAAa;QACzB,aAAQ,GAAR,QAAQ,CAAoD;IACnE,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,YAAoB,EAAE,MAAc;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,aAAa,CAAC,CAAC;QAC1D,CAAC;QAED,gDAAgD;QAChD,IAAI,WAAqC,CAAC;QAC1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE5C,iDAAiD;YACjD,IAAI,oBAAkD,CAAC;YACvD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAK,GAAW,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACzF,oBAAoB,GAAG,GAAuB,CAAC;oBAC/C,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/multi-agent/task-tool.d.ts

@@ -0,0 +1,4 @@
+import type { AgentTool } from "../tools/types.js";
+import type { LaborMarket } from "./labor-market.js";
+import type { TaskExecutor } from "./task-executor.js";
+export declare function createTaskTool(laborMarket: LaborMarket, taskExecutor: TaskExecutor): AgentTool;

package/dist/multi-agent/task-tool.js

@@ -0,0 +1,46 @@
+// Built-in TaskTool — allows LLM to delegate work to subagents
+import { Type } from "@sinclair/typebox";
+export function createTaskTool(laborMarket, taskExecutor) {
+    return {
+        name: "delegate_task",
+        label: "Delegate Task",
+        description: buildTaskToolDescription(laborMarket),
+        parameters: Type.Object({
+            subagent: Type.String({ description: "Name of the subagent to delegate to" }),
+            prompt: Type.String({ description: "The task prompt for the subagent" }),
+        }),
+        async execute(toolCallId, params, context) {
+            const { subagent, prompt } = params;
+            if (!laborMarket.has(subagent)) {
+                const available = laborMarket.listAll().map((s) => s.name).join(", ");
+                return {
+                    content: [{ type: "text", text: `Unknown subagent: "${subagent}". Available: ${available || "none"}` }],
+                };
+            }
+            try {
+                const result = await taskExecutor.execute(subagent, prompt);
+                const responseText = result.lastAssistantMessage?.content
+                    .filter((b) => b.type === "text")
+                    .map((b) => b.text)
+                    .join("\n") ?? "(no response)";
+                return {
+                    content: [{ type: "text", text: responseText }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Subagent error: ${err instanceof Error ? err.message : String(err)}` }],
+                };
+            }
+        },
+    };
+}
+function buildTaskToolDescription(laborMarket) {
+    const agents = laborMarket.listAll();
+    if (agents.length === 0) {
+        return "Delegate a task to a subagent.";
+    }
+    const list = agents.map((a) => `- ${a.name}: ${a.description}`).join("\n");
+    return `Delegate a task to a subagent. Available subagents:\n${list}`;
+}
+//# sourceMappingURL=task-tool.js.map

package/dist/multi-agent/task-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-tool.js","sourceRoot":"","sources":["../../src/multi-agent/task-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,IAAI,EAAgB,MAAM,mBAAmB,CAAC;AAKvD,MAAM,UAAU,cAAc,CAAC,WAAwB,EAAE,YAA0B;IACjF,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wBAAwB,CAAC,WAAW,CAAC;QAClD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;YAC7E,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;SACzE,CAAC;QAEF,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,MAA4C,EAC5C,OAA6B;YAE7B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;YAEpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtE,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,QAAQ,iBAAiB,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC;iBACxG,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,oBAAoB,EAAE,OAAO;qBACtD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;qBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAsB,CAAC,IAAI,CAAC;qBACxC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;gBAEjC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;iBAChD,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;iBACzG,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,WAAwB;IACxD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,wDAAwD,IAAI,EAAE,CAAC;AACxE,CAAC"}

package/dist/multi-agent/types.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTool } from "../tools/types.js";
+export interface SubagentConfig {
+    name: string;
+    systemPrompt: string | (() => string | Promise<string>);
+    tools?: AgentTool[];
+    description: string;
+}

package/dist/multi-agent/types.js

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

package/dist/multi-agent/types.js.map

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

package/dist/session/session-context-builder.d.ts

@@ -0,0 +1,2 @@
+import type { SessionEntry, SessionContext } from "./types.js";
+export declare function buildSessionContext(branch: SessionEntry[]): SessionContext;

package/dist/session/session-context-builder.js

@@ -0,0 +1,52 @@
+// Build session context by walking the branch from root to leaf
+export function buildSessionContext(branch) {
+    const messages = [];
+    let compactionSummary;
+    let compactionFirstKeptId = null;
+    let pastCompactionCutoff = false;
+    // First pass: find the latest compaction entry
+    for (let i = branch.length - 1; i >= 0; i--) {
+        const entry = branch[i];
+        if (entry.type === "compaction") {
+            compactionSummary = entry.summary;
+            compactionFirstKeptId = entry.firstKeptEntryId;
+            break;
+        }
+    }
+    // If no compaction, include all messages
+    if (!compactionFirstKeptId) {
+        pastCompactionCutoff = true;
+    }
+    // Second pass: build messages
+    for (const entry of branch) {
+        // If we have a compaction, skip entries before the kept point
+        if (!pastCompactionCutoff) {
+            if (entry.type === "compaction" && entry.firstKeptEntryId === compactionFirstKeptId) {
+                // This is the compaction entry — inject summary and start keeping
+                pastCompactionCutoff = true;
+                if (compactionSummary) {
+                    const summaryMsg = {
+                        role: "user",
+                        content: `<compaction-summary>${compactionSummary}</compaction-summary>`,
+                    };
+                    messages.push(summaryMsg);
+                }
+                continue;
+            }
+            continue; // Skip pre-compaction entries
+        }
+        if (entry.type === "message") {
+            messages.push(entry.message);
+        }
+        else if (entry.type === "branch_summary") {
+            const summaryMsg = {
+                role: "user",
+                content: `[Branch summary] ${entry.summary}`,
+            };
+            messages.push(summaryMsg);
+        }
+        // checkpoint, model_change, thinking_level_change, custom — not included in LLM context
+    }
+    return { messages, compactionSummary };
+}
+//# sourceMappingURL=session-context-builder.js.map

package/dist/session/session-context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-builder.js","sourceRoot":"","sources":["../../src/session/session-context-builder.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAWhE,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,iBAAqC,CAAC;IAC1C,IAAI,qBAAqB,GAAkB,IAAI,CAAC;IAChD,IAAI,oBAAoB,GAAG,KAAK,CAAC;IAEjC,+CAA+C;IAC/C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,iBAAiB,GAAI,KAAyB,CAAC,OAAO,CAAC;YACvD,qBAAqB,GAAI,KAAyB,CAAC,gBAAgB,CAAC;YACpE,MAAM;QACR,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,oBAAoB,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,8BAA8B;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,8DAA8D;QAC9D,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAK,KAAyB,CAAC,gBAAgB,KAAK,qBAAqB,EAAE,CAAC;gBACzG,kEAAkE;gBAClE,oBAAoB,GAAG,IAAI,CAAC;gBAC5B,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,UAAU,GAAgB;wBAC9B,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,uBAAuB,iBAAiB,uBAAuB;qBACzE,CAAC;oBACF,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBACD,SAAS;YACX,CAAC;YACD,SAAS,CAAC,8BAA8B;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAE,KAA6B,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAgB;gBAC9B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,oBAAqB,KAA4B,CAAC,OAAO,EAAE;aACrE,CAAC;YACF,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,wFAAwF;IAC1F,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;AACzC,CAAC"}

package/dist/session/session-manager.d.ts

@@ -0,0 +1,30 @@
+import type { SessionEntry, SessionTreeNode, SessionContext, SessionConfig } from "./types.js";
+import type { AgentMessage } from "../types.js";
+export declare class SessionManager {
+    private _entries;
+    private _entriesById;
+    private _leafId;
+    private _sessionId;
+    private _filePath;
+    private _persist;
+    constructor(config?: SessionConfig);
+    private _initialized;
+    init(): Promise<void>;
+    appendMessage(message: AgentMessage): Promise<string>;
+    appendCompaction(summary: string, firstKeptEntryId: string, tokensBefore: number): Promise<string>;
+    appendBranchSummary(fromId: string, summary: string): Promise<string>;
+    appendModelChange(provider: string, modelId: string): Promise<string>;
+    appendThinkingLevelChange(thinkingLevel: string): Promise<string>;
+    appendCheckpoint(checkpointId: number): Promise<string>;
+    appendCustomEntry(customType: string, data?: unknown): Promise<string>;
+    getLeafId(): string | null;
+    getEntry(id: string): SessionEntry | undefined;
+    getEntries(): SessionEntry[];
+    getBranch(fromId?: string | null): SessionEntry[];
+    getTree(): SessionTreeNode[];
+    branch(branchFromId: string): void;
+    buildSessionContext(): SessionContext;
+    getSessionId(): string;
+    private _append;
+    private _load;
+}

package/dist/session/session-manager.js

@@ -0,0 +1,209 @@
+// Session manager — JSONL tree with append, branch, navigate
+import { join } from "node:path";
+import { mkdirSync, existsSync } from "node:fs";
+import { generateId } from "../utils/id.js";
+import { readJSONL, appendJSONL, writeJSONLHeader } from "../utils/jsonl.js";
+import { buildSessionContext } from "./session-context-builder.js";
+const SESSION_VERSION = 1;
+export class SessionManager {
+    _entries = [];
+    _entriesById = new Map();
+    _leafId = null;
+    _sessionId;
+    _filePath;
+    _persist;
+    constructor(config) {
+        this._persist = config?.persist ?? false;
+        this._sessionId = config?.sessionId ?? generateId();
+        if (this._persist && config?.directory) {
+            mkdirSync(config.directory, { recursive: true });
+            this._filePath = join(config.directory, `${this._sessionId}.jsonl`);
+        }
+        else {
+            this._filePath = null;
+        }
+    }
+    // --- Init ---
+    _initialized = false;
+    async init() {
+        if (this._initialized)
+            return;
+        this._initialized = true;
+        if (this._filePath && existsSync(this._filePath)) {
+            await this._load();
+        }
+        else if (this._filePath) {
+            const header = {
+                type: "session",
+                version: SESSION_VERSION,
+                id: this._sessionId,
+                timestamp: new Date().toISOString(),
+            };
+            await writeJSONLHeader(this._filePath, header);
+        }
+    }
+    // --- Append operations ---
+    async appendMessage(message) {
+        const entry = {
+            type: "message",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            message,
+        };
+        return this._append(entry);
+    }
+    async appendCompaction(summary, firstKeptEntryId, tokensBefore) {
+        const entry = {
+            type: "compaction",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            summary,
+            firstKeptEntryId,
+            tokensBefore,
+        };
+        return this._append(entry);
+    }
+    async appendBranchSummary(fromId, summary) {
+        const entry = {
+            type: "branch_summary",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            fromId,
+            summary,
+        };
+        return this._append(entry);
+    }
+    async appendModelChange(provider, modelId) {
+        const entry = {
+            type: "model_change",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            provider,
+            modelId,
+        };
+        return this._append(entry);
+    }
+    async appendThinkingLevelChange(thinkingLevel) {
+        const entry = {
+            type: "thinking_level_change",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            thinkingLevel,
+        };
+        return this._append(entry);
+    }
+    async appendCheckpoint(checkpointId) {
+        const entry = {
+            type: "checkpoint",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            checkpointId,
+        };
+        return this._append(entry);
+    }
+    async appendCustomEntry(customType, data) {
+        const entry = {
+            type: "custom",
+            id: generateId(),
+            parentId: this._leafId,
+            timestamp: new Date().toISOString(),
+            customType,
+            data,
+        };
+        return this._append(entry);
+    }
+    // --- Tree navigation ---
+    getLeafId() {
+        return this._leafId;
+    }
+    getEntry(id) {
+        return this._entriesById.get(id);
+    }
+    getEntries() {
+        return [...this._entries];
+    }
+    getBranch(fromId) {
+        const leafId = fromId ?? this._leafId;
+        if (!leafId)
+            return [];
+        const branch = [];
+        let currentId = leafId;
+        while (currentId) {
+            const entry = this._entriesById.get(currentId);
+            if (!entry)
+                break;
+            branch.unshift(entry);
+            currentId = entry.parentId;
+        }
+        return branch;
+    }
+    getTree() {
+        // Build tree from entries
+        const childrenMap = new Map();
+        for (const entry of this._entries) {
+            const parentId = entry.parentId;
+            if (!childrenMap.has(parentId)) {
+                childrenMap.set(parentId, []);
+            }
+            childrenMap.get(parentId).push(entry);
+        }
+        function buildNode(entry) {
+            const children = (childrenMap.get(entry.id) ?? []).map(buildNode);
+            return { entry, children };
+        }
+        // Root entries have parentId === null
+        const roots = childrenMap.get(null) ?? [];
+        return roots.map(buildNode);
+    }
+    branch(branchFromId) {
+        if (!this._entriesById.has(branchFromId)) {
+            throw new Error(`Entry ${branchFromId} not found`);
+        }
+        this._leafId = branchFromId;
+    }
+    // --- Context building ---
+    buildSessionContext() {
+        const branch = this.getBranch();
+        return buildSessionContext(branch);
+    }
+    // --- Accessors ---
+    getSessionId() {
+        return this._sessionId;
+    }
+    // --- Internal ---
+    async _append(entry) {
+        this._entries.push(entry);
+        this._entriesById.set(entry.id, entry);
+        this._leafId = entry.id;
+        if (this._filePath) {
+            await appendJSONL(this._filePath, entry);
+        }
+        return entry.id;
+    }
+    async _load() {
+        if (!this._filePath)
+            return;
+        const records = await readJSONL(this._filePath);
+        if (records.length === 0)
+            return;
+        // First record is header
+        const header = records[0];
+        if (header.type === "session") {
+            this._sessionId = header.id;
+        }
+        // Rest are entries
+        for (let i = 1; i < records.length; i++) {
+            const entry = records[i];
+            this._entries.push(entry);
+            this._entriesById.set(entry.id, entry);
+            this._leafId = entry.id;
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,61 @@
+import type { AgentMessage } from "../types.js";
+export interface SessionEntryBase {
+    type: string;
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+}
+export interface SessionHeader {
+    type: "session";
+    version: number;
+    id: string;
+    timestamp: string;
+    cwd?: string;
+}
+export interface SessionMessageEntry extends SessionEntryBase {
+    type: "message";
+    message: AgentMessage;
+}
+export interface CompactionEntry extends SessionEntryBase {
+    type: "compaction";
+    summary: string;
+    firstKeptEntryId: string;
+    tokensBefore: number;
+}
+export interface BranchSummaryEntry extends SessionEntryBase {
+    type: "branch_summary";
+    fromId: string;
+    summary: string;
+}
+export interface ModelChangeEntry extends SessionEntryBase {
+    type: "model_change";
+    provider: string;
+    modelId: string;
+}
+export interface ThinkingLevelChangeEntry extends SessionEntryBase {
+    type: "thinking_level_change";
+    thinkingLevel: string;
+}
+export interface CheckpointEntry extends SessionEntryBase {
+    type: "checkpoint";
+    checkpointId: number;
+}
+export interface CustomEntry extends SessionEntryBase {
+    type: "custom";
+    customType: string;
+    data?: unknown;
+}
+export type SessionEntry = SessionMessageEntry | CompactionEntry | BranchSummaryEntry | ModelChangeEntry | ThinkingLevelChangeEntry | CheckpointEntry | CustomEntry;
+export interface SessionTreeNode {
+    entry: SessionEntry;
+    children: SessionTreeNode[];
+}
+export interface SessionContext {
+    messages: AgentMessage[];
+    compactionSummary?: string;
+}
+export interface SessionConfig {
+    persist?: boolean;
+    directory?: string;
+    sessionId?: string;
+}

package/dist/session/types.js

@@ -0,0 +1,3 @@
+// Session persistence types — tree-based JSONL
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

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

package/dist/skills/discovery.d.ts

@@ -0,0 +1,2 @@
+import type { Skill, SkillSource } from "./types.js";
+export declare function discoverSkills(sources: SkillSource[]): Promise<Skill[]>;

package/dist/skills/discovery.js

@@ -0,0 +1,29 @@
+// Skill discovery — scan directories, parse frontmatter from markdown
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { loadSkill } from "./loader.js";
+export async function discoverSkills(sources) {
+    const skills = [];
+    for (const source of sources) {
+        if (!existsSync(source.directory))
+            continue;
+        const pattern = source.pattern ?? ".md";
+        const files = await readdir(source.directory);
+        for (const file of files) {
+            if (!file.endsWith(pattern))
+                continue;
+            const filePath = join(source.directory, file);
+            try {
+                const skill = await loadSkill(filePath);
+                if (skill)
+                    skills.push(skill);
+            }
+            catch {
+                // Skip invalid skill files
+            }
+        }
+    }
+    return skills;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/skills/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/skills/discovery.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB;IACzD,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,SAAS;QAE5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACxC,IAAI,KAAK;oBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,3 @@
+import type { Skill } from "./types.js";
+export declare function loadSkill(filePath: string): Promise<Skill | null>;
+export declare function renderSkillTemplate(content: string, vars: Record<string, string>): string;

package/dist/skills/loader.js

@@ -0,0 +1,46 @@
+// Skill loader — read markdown, parse frontmatter, render templates
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+export async function loadSkill(filePath) {
+    const raw = await readFile(filePath, "utf-8");
+    const match = raw.match(FRONTMATTER_REGEX);
+    let frontmatter;
+    let content;
+    if (match) {
+        frontmatter = parseFrontmatter(match[1]);
+        content = match[2].trim();
+    }
+    else {
+        // No frontmatter — use filename as name
+        frontmatter = { name: basename(filePath, ".md") };
+        content = raw.trim();
+    }
+    if (!content)
+        return null;
+    return {
+        name: frontmatter.name,
+        description: frontmatter.description ?? "",
+        content,
+        source: filePath,
+    };
+}
+function parseFrontmatter(raw) {
+    const result = {};
+    for (const line of raw.split("\n")) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx < 0)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, "");
+        result[key] = value;
+    }
+    return {
+        name: result.name ?? "unnamed",
+        description: result.description,
+    };
+}
+export function renderSkillTemplate(content, vars) {
+    return content.replace(/\{\{\s*(\w+)\s*\}\}/g, (_, key) => vars[key] ?? `{{${key}}}`);
+}
+//# sourceMappingURL=loader.js.map