@snoglobe/helios 0.3.5 → 0.4.0

package/dist/store/session-store.js

@@ -1,21 +1,27 @@
 import { nanoid } from "nanoid";
-import { getDb } from "./database.js";
+import { StmtCache } from "./database.js";
 import { truncate } from "../ui/format.js";
+const EPHEMERAL_PREFIX = "eph-";
 /** Create an in-memory session that is NOT persisted to the database. */
 export function createEphemeralSession(providerId) {
     const now = Date.now();
-    return { id: `eph-${nanoid()}`, providerId, createdAt: now, lastActiveAt: now };
+    return { id: `${EPHEMERAL_PREFIX}${nanoid()}`, providerId, createdAt: now, lastActiveAt: now };
+}
+/** Check if a session is ephemeral (not persisted). */
+export function isEphemeralSession(session) {
+    return session.id.startsWith(EPHEMERAL_PREFIX);
 }
 export class SessionStore {
     agentId;
+    stmts = new StmtCache();
+    stmt(sql) { return this.stmts.stmt(sql); }
     constructor(agentId = "") {
         this.agentId = agentId;
     }
     createSession(provider, model, providerSessionId) {
         const id = nanoid();
         const now = Date.now();
-        const db = getDb();
-        db.prepare(`INSERT INTO sessions (id, provider, provider_session_id, model, status, created_at, last_active_at, agent_id)
+        this.stmt(`INSERT INTO sessions (id, provider, provider_session_id, model, status, created_at, last_active_at, agent_id)
        VALUES (?, ?, ?, ?, 'active', ?, ?, ?)`).run(id, provider, providerSessionId ?? null, model ?? null, now, now, this.agentId);
         return {
             id,
@@ -26,9 +32,7 @@ export class SessionStore {
         };
     }
     getSession(id) {
-        const db = getDb();
-        const row = db
-            .prepare("SELECT * FROM sessions WHERE id = ?")
+        const row = this.stmt("SELECT * FROM sessions WHERE id = ?")
             .get(id);
         if (!row)
             return null;
@@ -40,23 +44,28 @@ export class SessionStore {
             lastActiveAt: row.last_active_at,
         };
     }
+    updateProviderSessionId(sessionId, providerSessionId) {
+        this.stmt("UPDATE sessions SET provider_session_id = ? WHERE id = ?").run(providerSessionId, sessionId);
+    }
+    updateProvider(sessionId, provider) {
+        this.stmt("UPDATE sessions SET provider = ?, provider_session_id = NULL WHERE id = ?").run(provider, sessionId);
+    }
     updateLastActive(sessionId) {
-        const db = getDb();
-        db.prepare("UPDATE sessions SET last_active_at = ? WHERE id = ?").run(Date.now(), sessionId);
+        this.stmt("UPDATE sessions SET last_active_at = ? WHERE id = ?").run(Date.now(), sessionId);
     }
     addCost(sessionId, costUsd, inputTokens, outputTokens) {
-        const db = getDb();
-        db.prepare(`UPDATE sessions SET cost_usd = cost_usd + ?, input_tokens = input_tokens + ?, output_tokens = output_tokens + ? WHERE id = ?`).run(costUsd, inputTokens, outputTokens, sessionId);
+        this.stmt(`UPDATE sessions SET cost_usd = cost_usd + ?, input_tokens = input_tokens + ?, output_tokens = output_tokens + ? WHERE id = ?`).run(costUsd, inputTokens, outputTokens, sessionId);
     }
     addMessage(sessionId, role, content, toolCalls, tokenCount) {
-        const db = getDb();
-        db.prepare(`INSERT INTO messages (session_id, role, content, tool_calls, token_count, timestamp)
+        this.stmt(`INSERT INTO messages (session_id, role, content, tool_calls, token_count, timestamp)
        VALUES (?, ?, ?, ?, ?, ?)`).run(sessionId, role, content, toolCalls ?? null, tokenCount ?? null, Date.now());
     }
+    hasMessages(sessionId) {
+        const row = this.stmt("SELECT 1 FROM messages WHERE session_id = ? LIMIT 1").get(sessionId);
+        return row !== undefined;
+    }
     getMessages(sessionId, limit = 100) {
-        const db = getDb();
-        const rows = db
-            .prepare(`SELECT * FROM messages WHERE session_id = ? ORDER BY timestamp ASC LIMIT ?`)
+        const rows = this.stmt(`SELECT * FROM messages WHERE session_id = ? ORDER BY timestamp ASC LIMIT ?`)
             .all(sessionId, limit);
         return rows.map((row) => ({
             id: row.id,
@@ -69,9 +78,7 @@ export class SessionStore {
         }));
     }
     listSessions(limit = 20) {
-        const db = getDb();
-        const rows = db
-            .prepare(`SELECT * FROM sessions s
+        const rows = this.stmt(`SELECT * FROM sessions s
          WHERE s.agent_id = ?
            AND EXISTS (SELECT 1 FROM messages m WHERE m.session_id = s.id)
          ORDER BY s.last_active_at DESC LIMIT ?`)
@@ -85,9 +92,7 @@ export class SessionStore {
         }));
     }
     listSessionSummaries(limit = 20) {
-        const db = getDb();
-        const rows = db
-            .prepare(`SELECT
+        const rows = this.stmt(`SELECT
            s.id,
            s.provider,
            s.model,

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

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/store/session-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/store/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAyB3C,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,EAAE,EAAE,EAAE,GAAG,gBAAgB,GAAG,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AACjG,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,OAAO,YAAY;IACf,OAAO,CAAS;IAChB,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAW,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE1D,YAAY,OAAO,GAAG,EAAE;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,KAAc,EACd,iBAA0B;QAE1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,CAAC,IAAI,CACP;8CACwC,CACzC,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,iBAAiB,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtF,OAAO;YACL,EAAE;YACF,UAAU,EAAE,QAAQ;YACpB,iBAAiB;YACjB,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,GAAG;SAClB,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAC;aACzD,GAAG,CAAC,EAAE,CAAwC,CAAC;QAElD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,UAAU,EAAE,GAAG,CAAC,QAAkB;YAClC,iBAAiB,EAAE,GAAG,CAAC,mBAAyC;YAChE,SAAS,EAAE,GAAG,CAAC,UAAoB;YACnC,YAAY,EAAE,GAAG,CAAC,cAAwB;SAC3C,CAAC;IACJ,CAAC;IAED,uBAAuB,CAAC,SAAiB,EAAE,iBAAyB;QAClE,IAAI,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC,GAAG,CACvE,iBAAiB,EACjB,SAAS,CACV,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,QAAgB;QAChD,IAAI,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC,GAAG,CACxF,QAAQ,EACR,SAAS,CACV,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,SAAiB;QAChC,IAAI,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,GAAG,CAClE,IAAI,CAAC,GAAG,EAAE,EACV,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,OAAe,EAAE,WAAmB,EAAE,YAAoB;QACnF,IAAI,CAAC,IAAI,CACP,8HAA8H,CAC/H,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,UAAU,CACR,SAAiB,EACjB,IAA2B,EAC3B,OAAe,EACf,SAAkB,EAClB,UAAmB;QAEnB,IAAI,CAAC,IAAI,CACP;iCAC2B,CAC5B,CAAC,GAAG,CACH,SAAS,EACT,IAAI,EACJ,OAAO,EACP,SAAS,IAAI,IAAI,EACjB,UAAU,IAAI,IAAI,EAClB,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5F,OAAO,GAAG,KAAK,SAAS,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,KAAK,GAAG,GAAG;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAClB,4EAA4E,CAC7E;aACA,GAAG,CAAC,SAAS,EAAE,KAAK,CAA8B,CAAC;QAEtD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,SAAS,EAAE,GAAG,CAAC,UAAoB;YACnC,IAAI,EAAE,GAAG,CAAC,IAA6B;YACvC,OAAO,EAAE,GAAG,CAAC,OAAiB;YAC9B,SAAS,EAAE,GAAG,CAAC,UAAgC;YAC/C,UAAU,EAAE,GAAG,CAAC,WAAiC;YACjD,SAAS,EAAE,GAAG,CAAC,SAAmB;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,YAAY,CAAC,KAAK,GAAG,EAAE;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAClB;;;gDAGwC,CACzC;aACA,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAA8B,CAAC;QAEzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,UAAU,EAAE,GAAG,CAAC,QAAkB;YAClC,iBAAiB,EAAE,GAAG,CAAC,mBAAyC;YAChE,SAAS,EAAE,GAAG,CAAC,UAAoB;YACnC,YAAY,EAAE,GAAG,CAAC,cAAwB;SAC3C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,oBAAoB,CAAC,KAAK,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAClB;;;;;;;;;;;;;;;;;;;iBAmBS,CACV;aACA,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAA8B,CAAC;QAEzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAkB;YAChC,KAAK,EAAG,GAAG,CAAC,KAAuB,IAAI,IAAI;YAC3C,SAAS,EAAE,GAAG,CAAC,UAAoB;YACnC,YAAY,EAAE,GAAG,CAAC,cAAwB;YAC1C,YAAY,EAAE,GAAG,CAAC,aAAuB;YACzC,OAAO,EAAG,GAAG,CAAC,QAAmB,IAAI,CAAC;YACtC,WAAW,EAAG,GAAG,CAAC,YAAuB,IAAI,CAAC;YAC9C,YAAY,EAAG,GAAG,CAAC,aAAwB,IAAI,CAAC;YAChD,gBAAgB,EAAE,GAAG,CAAC,kBAAkB;gBACtC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAA4B,EAAE,EAAE,EAAE,IAAI,CAAC;gBACtD,CAAC,CAAC,IAAI;SACT,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/store/session-store.test.d.ts

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

package/dist/store/session-store.test.d.ts.map

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

package/dist/store/session-store.test.js

@@ -0,0 +1,125 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { createTestDb } from "../__tests__/db-helper.js";
+const mockDb = { current: createTestDb() };
+vi.mock("./database.js", () => {
+    const getDb = () => mockDb.current;
+    class StmtCache {
+        cache = new Map();
+        stmt(sql) {
+            let s = this.cache.get(sql);
+            if (!s) {
+                s = getDb().prepare(sql);
+                this.cache.set(sql, s);
+            }
+            return s;
+        }
+    }
+    return { getDb, StmtCache, getHeliosDir: () => "/tmp/helios-test" };
+});
+const { SessionStore, createEphemeralSession } = await import("./session-store.js");
+describe("SessionStore", () => {
+    beforeEach(() => {
+        mockDb.current = createTestDb();
+    });
+    it("creates and retrieves a session", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude", "opus");
+        expect(session.id).toBeTruthy();
+        expect(session.providerId).toBe("claude");
+        const retrieved = store.getSession(session.id);
+        expect(retrieved).not.toBeNull();
+        expect(retrieved.id).toBe(session.id);
+        expect(retrieved.providerId).toBe("claude");
+    });
+    it("returns null for missing session", () => {
+        const store = new SessionStore("agent1");
+        expect(store.getSession("nonexistent")).toBeNull();
+    });
+    it("updates provider session ID", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        store.updateProviderSessionId(session.id, "sdk-123");
+        const retrieved = store.getSession(session.id);
+        expect(retrieved.providerSessionId).toBe("sdk-123");
+    });
+    it("adds and retrieves messages", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        store.addMessage(session.id, "user", "Hello");
+        store.addMessage(session.id, "assistant", "Hi there");
+        const messages = store.getMessages(session.id);
+        expect(messages).toHaveLength(2);
+        expect(messages[0].role).toBe("user");
+        expect(messages[0].content).toBe("Hello");
+        expect(messages[1].role).toBe("assistant");
+    });
+    it("getMessages respects limit", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        for (let i = 0; i < 10; i++) {
+            store.addMessage(session.id, "user", `msg ${i}`);
+        }
+        const messages = store.getMessages(session.id, 3);
+        expect(messages).toHaveLength(3);
+    });
+    it("tracks cost accumulation", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        store.addCost(session.id, 0.01, 100, 50);
+        store.addCost(session.id, 0.02, 200, 100);
+        const summaries = store.listSessionSummaries();
+        // No messages yet, so summary might not show. Add a message first.
+        store.addMessage(session.id, "user", "test");
+        const s = store.listSessionSummaries();
+        expect(s).toHaveLength(1);
+        expect(s[0].costUsd).toBeCloseTo(0.03);
+        expect(s[0].inputTokens).toBe(300);
+        expect(s[0].outputTokens).toBe(150);
+    });
+    it("listSessions filters by agent ID", () => {
+        const store1 = new SessionStore("agent1");
+        const store2 = new SessionStore("agent2");
+        const s1 = store1.createSession("claude");
+        store1.addMessage(s1.id, "user", "hi");
+        const s2 = store2.createSession("openai");
+        store2.addMessage(s2.id, "user", "hi");
+        expect(store1.listSessions()).toHaveLength(1);
+        expect(store1.listSessions()[0].id).toBe(s1.id);
+    });
+    it("listSessions excludes empty sessions", () => {
+        const store = new SessionStore("agent1");
+        store.createSession("claude"); // no messages
+        expect(store.listSessions()).toHaveLength(0);
+    });
+    it("listSessionSummaries includes first user message", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        store.addMessage(session.id, "user", "Train a model to classify cats");
+        store.addMessage(session.id, "assistant", "Sure!");
+        const summaries = store.listSessionSummaries();
+        expect(summaries[0].firstUserMessage).toContain("Train a model");
+    });
+    it("updates lastActiveAt", () => {
+        const store = new SessionStore("agent1");
+        const session = store.createSession("claude");
+        const before = session.lastActiveAt;
+        // Small delay to ensure timestamp changes
+        store.updateLastActive(session.id);
+        const updated = store.getSession(session.id);
+        expect(updated.lastActiveAt).toBeGreaterThanOrEqual(before);
+    });
+});
+describe("createEphemeralSession", () => {
+    it("creates session with eph- prefix", () => {
+        const session = createEphemeralSession("claude");
+        expect(session.id).toMatch(/^eph-/);
+        expect(session.providerId).toBe("claude");
+    });
+    it("sets timestamps", () => {
+        const before = Date.now();
+        const session = createEphemeralSession("openai");
+        expect(session.createdAt).toBeGreaterThanOrEqual(before);
+        expect(session.lastActiveAt).toBeGreaterThanOrEqual(before);
+    });
+});
+//# sourceMappingURL=session-store.test.js.map

package/dist/store/session-store.test.js.map

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

package/dist/subagent/executor.d.ts

@@ -0,0 +1,21 @@
+import type { SubagentInfo, SubagentSpawnConfig } from "./types.js";
+import type { ToolDefinition } from "../providers/types.js";
+import type { Orchestrator } from "../core/orchestrator.js";
+import type { MemoryStore } from "../memory/memory-store.js";
+import type { SubagentManager } from "./manager.js";
+export interface SubagentExecContext {
+    orchestrator: Orchestrator;
+    allTools: ToolDefinition[];
+    parentMemory: MemoryStore;
+    parentSessionId: string;
+    depth: number;
+    subagentManager: SubagentManager;
+}
+/** Infer provider from model name. */
+export declare function resolveProviderForModel(model: string | undefined, provider: string | undefined, orchestrator: Orchestrator): {
+    provider: "claude" | "openai";
+    model: string;
+};
+/** Run a subagent in the background. Mutates `info` with status/result/cost. */
+export declare function runSubagent(info: SubagentInfo, config: SubagentSpawnConfig, ctx: SubagentExecContext): Promise<void>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/subagent/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/subagent/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AASpD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,sCAAsC;AACtC,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,YAAY,GACzB;IAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkBlD;AAoDD,gFAAgF;AAChF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/subagent/executor.js

@@ -0,0 +1,136 @@
+import { ScopedMemoryStore } from "./scoped-memory.js";
+import { createMemoryTools } from "../tools/memory-tools.js";
+import { formatError } from "../ui/format.js";
+import { debugLog } from "../paths.js";
+/** Tools that subagents should never have access to. */
+const ALWAYS_DENY = new Set(["sleep", "start_monitor", "stop_monitor"]);
+/** Infer provider from model name. */
+export function resolveProviderForModel(model, provider, orchestrator) {
+    if (provider === "claude" || provider === "openai") {
+        return {
+            provider,
+            model: model ?? (provider === "claude" ? "claude-sonnet-4-6" : "gpt-5.2"),
+        };
+    }
+    if (model) {
+        if (model.startsWith("claude"))
+            return { provider: "claude", model };
+        if (model.startsWith("gpt-") || model.startsWith("o1") || model.startsWith("o3") || model.startsWith("o4")) {
+            return { provider: "openai", model };
+        }
+    }
+    // Inherit parent
+    return {
+        provider: orchestrator.currentProvider?.name ?? "claude",
+        model: model ?? orchestrator.currentModel ?? "claude-sonnet-4-6",
+    };
+}
+/** Build the filtered tool set for a subagent. */
+function buildTools(allTools, config, scopedMemory, depth, maxDepth, subagentManager, orchestrator, parentMemory) {
+    let tools = allTools.filter((t) => !ALWAYS_DENY.has(t.name));
+    // Apply user deny list
+    if (config.tools_deny) {
+        const denied = new Set(config.tools_deny);
+        tools = tools.filter((t) => !denied.has(t.name));
+    }
+    // Replace memory tools with scoped versions
+    tools = tools.filter((t) => !t.name.startsWith("memory_"));
+    tools.push(...createMemoryTools(scopedMemory));
+    // Replace subagent tools — include if depth allows
+    tools = tools.filter((t) => !t.name.startsWith("subagent"));
+    if (maxDepth === 0 || depth + 1 < maxDepth) {
+        // Lazy import to avoid circular dependency — the tool factories are lightweight
+        const { createSubagentTools } = require("../tools/subagent.js");
+        tools.push(...createSubagentTools(subagentManager, orchestrator, parentMemory));
+    }
+    return tools;
+}
+function buildSystemPrompt(info, config) {
+    return `You are a Helios subagent (ID: ${info.id}, depth: ${info.depth}).
+
+## Your Task
+${config.task}
+
+## Memory
+Your memory is scoped — writes go to /subagents/${info.id}/ in the parent's memory tree.
+You can read the parent's memory for context (goal, observations, experiments, etc.).
+When done, write a clear result summary to memory.
+
+## Completion
+When your task is complete, state your conclusion clearly in your final message.
+Be thorough but concise — the parent agent will read your result.`;
+}
+/** Run a subagent in the background. Mutates `info` with status/result/cost. */
+export async function runSubagent(info, config, ctx) {
+    const providerInstance = ctx.orchestrator.getProvider(info.provider);
+    if (!providerInstance)
+        throw new Error(`Provider "${info.provider}" not available`);
+    // Ensure authenticated
+    if (!(await providerInstance.isAuthenticated())) {
+        await providerInstance.authenticate();
+    }
+    // Temporarily set model for session creation
+    const originalModel = providerInstance.currentModel;
+    providerInstance.currentModel = info.model;
+    const session = await providerInstance.createSession({
+        systemPrompt: buildSystemPrompt(info, config),
+        model: info.model,
+        ephemeral: true,
+    });
+    // Restore model immediately — session already captured it
+    providerInstance.currentModel = originalModel;
+    const scopedMemory = new ScopedMemoryStore(ctx.parentMemory, info.id);
+    const tools = buildTools(ctx.allTools, config, scopedMemory, ctx.depth, ctx.subagentManager.maxDepth, ctx.subagentManager, ctx.orchestrator, ctx.parentMemory);
+    const maxTurns = config.max_turns ?? 50;
+    let lastText = "";
+    try {
+        // The provider's send() handles the full tool loop internally.
+        // We just drain events and track cost.
+        for (let turn = 0; turn < maxTurns; turn++) {
+            if (info.abortController.signal.aborted)
+                break;
+            let turnText = "";
+            let hadToolCalls = false;
+            const message = turn === 0 ? config.task : "Continue.";
+            for await (const event of providerInstance.send(session, message, tools)) {
+                if (info.abortController.signal.aborted)
+                    break;
+                if (event.type === "text" && event.delta) {
+                    turnText += event.delta;
+                }
+                if (event.type === "tool_call") {
+                    hadToolCalls = true;
+                }
+                if (event.type === "done" && event.usage) {
+                    const cost = event.usage.costUsd ?? 0;
+                    info.costUsd += cost;
+                    info.inputTokens += event.usage.inputTokens;
+                    info.outputTokens += event.usage.outputTokens;
+                    ctx.orchestrator.addCost(cost, event.usage.inputTokens, event.usage.outputTokens);
+                }
+            }
+            if (turnText)
+                lastText = turnText;
+            // If the provider didn't make any tool calls, the agent is done
+            if (!hadToolCalls)
+                break;
+        }
+        const result = lastText || "(subagent produced no text output)";
+        info.result = result;
+        scopedMemory.write("/result", `Subagent ${info.id} result`, result);
+        info.status = "completed";
+        info.completedAt = Date.now();
+        debugLog("subagent", "completed", { id: info.id, cost: info.costUsd });
+    }
+    catch (err) {
+        info.error = formatError(err);
+        info.status = info.abortController.signal.aborted ? "cancelled" : "failed";
+        info.completedAt = Date.now();
+        scopedMemory.write("/result", `Subagent ${info.id} failed`, `Error: ${info.error}`);
+        debugLog("subagent", "failed", { id: info.id, error: info.error });
+    }
+    finally {
+        await providerInstance.closeSession(session).catch(() => { });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/subagent/executor.js.map

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

package/dist/subagent/manager.d.ts

@@ -0,0 +1,20 @@
+import { EventEmitter } from "node:events";
+import type { SubagentInfo, SubagentSpawnConfig } from "./types.js";
+import type { Orchestrator } from "../core/orchestrator.js";
+import type { MemoryStore } from "../memory/memory-store.js";
+import type { ToolDefinition } from "../providers/types.js";
+export declare class SubagentManager extends EventEmitter {
+    private agents;
+    readonly maxDepth: number;
+    constructor(maxDepth?: number);
+    /** Spawn a subagent. Returns immediately — the agent runs in the background. */
+    spawn(config: SubagentSpawnConfig, orchestrator: Orchestrator, allTools: ToolDefinition[], parentMemory: MemoryStore, parentSessionId: string, depth?: number): SubagentInfo;
+    get(id: string): SubagentInfo | undefined;
+    listActive(): SubagentInfo[];
+    listAll(): SubagentInfo[];
+    listForSession(parentSessionId: string): SubagentInfo[];
+    cancel(id: string): boolean;
+    /** Remove completed/failed agents older than maxAgeMs (default: 30 min). */
+    prune(maxAgeMs?: number): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/subagent/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/subagent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAmC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,SAAI;IAKxB,gFAAgF;IAChF,KAAK,CACH,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,cAAc,EAAE,EAC1B,YAAY,EAAE,WAAW,EACzB,eAAe,EAAE,MAAM,EACvB,KAAK,SAAI,GACR,YAAY;IA6Df,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,UAAU,IAAI,YAAY,EAAE;IAI5B,OAAO,IAAI,YAAY,EAAE;IAIzB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,EAAE;IAIvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B,4EAA4E;IAC5E,KAAK,CAAC,QAAQ,SAAc,GAAG,IAAI;CAQpC"}

package/dist/subagent/manager.js

@@ -0,0 +1,98 @@
+import { EventEmitter } from "node:events";
+import { nanoid } from "nanoid";
+import { runSubagent, resolveProviderForModel } from "./executor.js";
+import { debugLog } from "../paths.js";
+export class SubagentManager extends EventEmitter {
+    agents = new Map();
+    maxDepth;
+    constructor(maxDepth = 0) {
+        super();
+        this.maxDepth = maxDepth;
+    }
+    /** Spawn a subagent. Returns immediately — the agent runs in the background. */
+    spawn(config, orchestrator, allTools, parentMemory, parentSessionId, depth = 0) {
+        if (this.maxDepth > 0 && depth >= this.maxDepth) {
+            throw new Error(`Subagent depth limit reached (max: ${this.maxDepth})`);
+        }
+        const resolved = resolveProviderForModel(config.model, config.provider, orchestrator);
+        const id = nanoid(8);
+        const info = {
+            id,
+            parentSessionId,
+            depth,
+            task: config.task,
+            model: resolved.model,
+            provider: resolved.provider,
+            status: "running",
+            createdAt: Date.now(),
+            costUsd: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            memoryPrefix: `/subagents/${id}`,
+            abortController: new AbortController(),
+        };
+        this.agents.set(id, info);
+        debugLog("subagent", "spawned", { id, model: resolved.model, provider: resolved.provider, depth });
+        this.emit("spawned", info);
+        // Fire-and-forget — run in background
+        const ctx = {
+            orchestrator,
+            allTools,
+            parentMemory,
+            parentSessionId,
+            depth,
+            subagentManager: this,
+        };
+        runSubagent(info, config, ctx)
+            .then(() => {
+            if (info.status === "completed") {
+                this.emit("completed", info);
+            }
+            else if (info.status === "cancelled") {
+                this.emit("cancelled", info);
+            }
+            else {
+                this.emit("failed", info);
+            }
+        })
+            .catch((err) => {
+            // Safety net — runSubagent should handle its own errors
+            if (info.status === "running") {
+                info.status = "failed";
+                info.error = String(err);
+                info.completedAt = Date.now();
+                this.emit("failed", info);
+            }
+        });
+        return info;
+    }
+    get(id) {
+        return this.agents.get(id);
+    }
+    listActive() {
+        return [...this.agents.values()].filter((a) => a.status === "running");
+    }
+    listAll() {
+        return [...this.agents.values()];
+    }
+    listForSession(parentSessionId) {
+        return [...this.agents.values()].filter((a) => a.parentSessionId === parentSessionId);
+    }
+    cancel(id) {
+        const info = this.agents.get(id);
+        if (!info || info.status !== "running")
+            return false;
+        info.abortController.abort();
+        return true;
+    }
+    /** Remove completed/failed agents older than maxAgeMs (default: 30 min). */
+    prune(maxAgeMs = 30 * 60_000) {
+        const cutoff = Date.now() - maxAgeMs;
+        for (const [id, info] of this.agents) {
+            if (info.status !== "running" && (info.completedAt ?? 0) < cutoff) {
+                this.agents.delete(id);
+            }
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/subagent/manager.js.map

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

package/dist/subagent/scoped-memory.d.ts

@@ -0,0 +1,28 @@
+import { MemoryStore, type MemoryNode } from "../memory/memory-store.js";
+/**
+ * Memory wrapper for subagents. Writes are scoped under /subagents/{id}/
+ * in the parent's memory. Reads check own scope first, then fall through
+ * to the parent for read-only access to the broader context.
+ *
+ * Follows the same override pattern as GlobalMemoryRouter.
+ */
+export declare class ScopedMemoryStore extends MemoryStore {
+    private parent;
+    private prefix;
+    constructor(parent: MemoryStore, subagentId: string);
+    private toScoped;
+    private isOwn;
+    write(path: string, gist: string, content?: string | null): void;
+    read(path: string): MemoryNode | null;
+    exists(path: string): boolean;
+    ls(dirPath?: string): MemoryNode[];
+    tree(dirPath?: string): Array<{
+        path: string;
+        gist: string;
+        isDir: boolean;
+    }>;
+    rm(path: string): number;
+    clear(): void;
+    count(): number;
+}
+//# sourceMappingURL=scoped-memory.d.ts.map

package/dist/subagent/scoped-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-memory.d.ts","sourceRoot":"","sources":["../../src/subagent/scoped-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM;IAOnD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,KAAK;IAMJ,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMhE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAarC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO7B,EAAE,CAAC,OAAO,SAAM,GAAG,UAAU,EAAE;IAkC/B,IAAI,CAAC,OAAO,SAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAgC1E,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIxB,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,MAAM;CAIzB"}