@roj-ai/sdk 0.1.3 → 0.1.4

package/dist/core/plugins/plugin-builder.js

@@ -0,0 +1,321 @@
+import { createStateSlice } from '../sessions/reducer.js';
+import { createTool } from '../tools/definition.js';
+export const DEFAULT_CALLER = { source: 'client', meta: {} };
+export const AGENT_CALLER = { source: 'agent', meta: {} };
+// ============================================================================
+// PluginBuilder
+// ============================================================================
+export class PluginBuilder {
+    /** @internal */
+    _cfg;
+    /** @internal */
+    _name;
+    constructor(name, cfg) {
+        this._name = name;
+        this._cfg = cfg ?? {
+            name,
+            events: [],
+            dependencyNames: [],
+            stateConfig: undefined,
+            contextFactory: undefined,
+            isSessionEnabledFn: undefined,
+            methods: {},
+            managerMethods: {},
+            notifications: {},
+            staticTools: [],
+            dynamicTools: undefined,
+            statusFn: undefined,
+            systemPromptFn: undefined,
+            agentHooks: {},
+            sessionHooks: {},
+            isEnabledFn: undefined,
+            dequeueHook: undefined,
+        };
+    }
+    // --- Setup ---
+    pluginConfig() {
+        return this;
+    }
+    events(factories) {
+        this._cfg.events = factories;
+        return this;
+    }
+    state(config) {
+        this._cfg.stateConfig = config;
+        return this;
+    }
+    context(factory) {
+        this._cfg.contextFactory = factory;
+        return this;
+    }
+    agentConfig() {
+        return this;
+    }
+    // --- Dependencies ---
+    /**
+     * Declare dependencies on other plugins. The dependency plugins' session-level methods
+     * become available as `ctx.deps.pluginName.methodName(input)` in all handler contexts.
+     */
+    dependencies(plugins) {
+        this._cfg.dependencyNames = plugins.map((p) => p.name);
+        return this;
+    }
+    // --- Methods ---
+    method(name, def) {
+        this._cfg.methods[name] = def;
+        return this;
+    }
+    // --- Manager Methods ---
+    managerMethod(name, def) {
+        this._cfg.managerMethods[name] = def;
+        return this;
+    }
+    // --- Notifications ---
+    notification(name, def) {
+        this._cfg.notifications[name] = def;
+        return this;
+    }
+    // --- Tools ---
+    tool(name, def) {
+        this._cfg.staticTools.push({
+            name,
+            description: def.description,
+            input: def.input,
+            // Erase TInput → unknown at the boundary (PluginBuilder → BuilderConfig)
+            execute: def.execute,
+        });
+        return this;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ToolDefinition<TInput> is contravariant, need any for assignment
+    tools(fn) {
+        this._cfg.dynamicTools = fn;
+        return this;
+    }
+    // --- Status ---
+    status(fn) {
+        this._cfg.statusFn = fn;
+        return this;
+    }
+    // --- System Prompt ---
+    systemPrompt(fn) {
+        this._cfg.systemPromptFn = fn;
+        return this;
+    }
+    // --- Hooks ---
+    hook(name, fn) {
+        ;
+        this._cfg.agentHooks[name] = fn;
+        return this;
+    }
+    sessionHook(name, fn) {
+        ;
+        this._cfg.sessionHooks[name] = fn;
+        return this;
+    }
+    // --- Conditional activation ---
+    /**
+     * Define a function to determine if this plugin is enabled at session level.
+     * Called once when building plugins for a session.
+     *
+     * @param fn Function that receives plugin config and returns true if plugin should be active
+     */
+    isSessionEnabled(fn) {
+        this._cfg.isSessionEnabledFn = fn;
+        return this;
+    }
+    /**
+     * Define a function to determine if this plugin is enabled for a specific agent.
+     * Called once when creating agent plugins.
+     *
+     * @param fn Function that receives context and returns true if plugin should be active
+     */
+    isEnabled(fn) {
+        this._cfg.isEnabledFn = fn;
+        return this;
+    }
+    // --- Dequeue ---
+    dequeue(hook) {
+        this._cfg.dequeueHook = hook;
+        return this;
+    }
+    // --- Build ---
+    build() {
+        const cfg = this._cfg;
+        // Build session method schemas (input/output only, no handlers)
+        const sessionMethods = {};
+        for (const [name, method] of Object.entries(cfg.methods)) {
+            sessionMethods[name] = { input: method.input, output: method.output };
+        }
+        const name = this._name;
+        const def = {
+            name,
+            create: ((...args) => {
+                const pluginConfig = args[0];
+                return buildConfiguredPlugin(cfg, pluginConfig);
+            }),
+            configure: ((...args) => ({
+                pluginName: name,
+                config: args[0],
+                definition: def,
+            })),
+            configureAgent: ((...args) => ({
+                pluginName: name,
+                config: args[0],
+            })),
+            managerMethods: cfg.managerMethods,
+            sessionMethods,
+        };
+        return def;
+    }
+}
+// ============================================================================
+// Build configured plugin — binds config into all closures
+// ============================================================================
+function buildConfiguredPlugin(cfg, pluginConfig) {
+    let slice;
+    if (cfg.stateConfig) {
+        const stateReduce = cfg.stateConfig.reduce;
+        slice = createStateSlice({
+            key: cfg.stateConfig.key,
+            events: cfg.events,
+            initialState: cfg.stateConfig.initial,
+            apply: (state, event, sessionState) => stateReduce(state, event, sessionState, pluginConfig),
+        });
+    }
+    const agentHookEntries = Object.entries(cfg.agentHooks);
+    const agentHooks = agentHookEntries.length > 0
+        ? Object.fromEntries(agentHookEntries.map(([name, fn]) => [
+            name,
+            // Agent.ts provides the full context with extra fields (pendingMessages, turnNumber, etc.)
+            // — this wrapper just injects pluginConfig at the boundary
+            (ctx) => fn({ ...ctx, pluginConfig }),
+        ]))
+        : undefined;
+    const sessionHookEntries = Object.entries(cfg.sessionHooks);
+    const sessionHooks = sessionHookEntries.length > 0
+        ? Object.fromEntries(sessionHookEntries.map(([name, fn]) => [
+            name,
+            (ctx) => fn({ ...ctx, pluginConfig }),
+        ]))
+        : undefined;
+    // Combine static + dynamic tools
+    const staticToolSpecs = cfg.staticTools;
+    const dynamicToolsFn = cfg.dynamicTools;
+    let getTools;
+    if (staticToolSpecs.length > 0 || dynamicToolsFn) {
+        getTools = (ctx) => {
+            const enrichedCtx = { ...ctx, pluginConfig };
+            const tools = [];
+            // Static tools — create ToolDefinition from StaticToolSpec using closure
+            for (const spec of staticToolSpecs) {
+                tools.push(createTool({
+                    name: spec.name,
+                    description: spec.description,
+                    input: spec.input,
+                    execute: (input, toolCtx) => spec.execute(input, toolCtx, enrichedCtx),
+                }));
+            }
+            // Dynamic tools
+            if (dynamicToolsFn) {
+                tools.push(...dynamicToolsFn(enrichedCtx));
+            }
+            return tools;
+        };
+    }
+    // Wrap createContext to pass pluginConfig
+    const contextFactory = cfg.contextFactory;
+    const wrappedContextFactory = contextFactory
+        ? (ctx) => contextFactory(ctx, pluginConfig)
+        : undefined;
+    // Wrap status/systemPrompt/dequeue to inject pluginConfig
+    const statusFn = cfg.statusFn;
+    const wrappedStatus = statusFn
+        ? (ctx) => statusFn({ ...ctx, pluginConfig })
+        : undefined;
+    const systemPromptFn = cfg.systemPromptFn;
+    const wrappedSystemPrompt = systemPromptFn
+        ? (ctx) => systemPromptFn({ ...ctx, pluginConfig })
+        : undefined;
+    const dequeueHook = cfg.dequeueHook;
+    const wrappedDequeue = dequeueHook
+        ? {
+            hasPendingMessages: (ctx) => dequeueHook.hasPendingMessages({ ...ctx, pluginConfig }),
+            getPendingMessages: (ctx) => dequeueHook.getPendingMessages({ ...ctx, pluginConfig }),
+            markConsumed: (ctx, token) => dequeueHook.markConsumed({ ...ctx, pluginConfig }, token),
+        }
+        : undefined;
+    // Wrap isEnabled to pass pluginConfig
+    const wrappedIsEnabled = cfg.isEnabledFn
+        ? (ctx) => {
+            return cfg.isEnabledFn({ ...ctx, pluginConfig });
+        }
+        : undefined;
+    // Wrap isSessionEnabled to pass pluginConfig
+    const wrappedIsSessionEnabled = cfg.isSessionEnabledFn
+        ? (ctx) => {
+            return cfg.isSessionEnabledFn({ ...ctx, pluginConfig });
+        }
+        : undefined;
+    // Wrap method handlers to inject pluginConfig
+    const wrappedMethods = {};
+    for (const [name, method] of Object.entries(cfg.methods)) {
+        wrappedMethods[name] = {
+            input: method.input,
+            output: method.output,
+            handler: (ctx, input) => method.handler({ ...ctx, pluginConfig }, input),
+        };
+    }
+    return {
+        name: cfg.name,
+        methods: wrappedMethods,
+        notifications: cfg.notifications,
+        dependencyNames: cfg.dependencyNames,
+        createContext: wrappedContextFactory,
+        state: cfg.stateConfig
+            ? {
+                key: cfg.stateConfig.key,
+                events: cfg.events,
+                initialState: cfg.stateConfig.initial,
+                reduce: (state, event, sessionState) => cfg.stateConfig.reduce(state, event, sessionState, pluginConfig),
+            }
+            : undefined,
+        agentHooks,
+        sessionHooks,
+        getTools,
+        getStatus: wrappedStatus,
+        getSystemPrompt: wrappedSystemPrompt,
+        dequeue: wrappedDequeue,
+        slice,
+        isEnabled: wrappedIsEnabled,
+        isSessionEnabled: wrappedIsSessionEnabled,
+    };
+}
+/**
+ * Build a `deps` object for a plugin at runtime.
+ * Creates proxy-like method callers for each dependency plugin.
+ *
+ * @param dependencyNames - Plugin names this plugin depends on
+ * @param allPlugins - All configured plugins in the session (to discover method names)
+ * @param callMethod - Callback that routes to the session's callPluginMethod
+ */
+export function buildPluginDeps(dependencyNames, allPlugins, callMethod) {
+    const deps = {};
+    for (const depName of dependencyNames) {
+        const depPlugin = allPlugins.find((p) => p.name === depName);
+        if (!depPlugin)
+            continue;
+        const methods = {};
+        for (const methodName of Object.keys(depPlugin.methods)) {
+            methods[methodName] = (input) => callMethod(depName, methodName, input);
+        }
+        deps[depName] = methods;
+    }
+    return deps;
+}
+// ============================================================================
+// Entry point
+// ============================================================================
+export function definePlugin(name) {
+    return new PluginBuilder(name);
+}
+//# sourceMappingURL=plugin-builder.js.map

package/dist/core/plugins/plugin-builder.js.map

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

package/dist/core/preset/config.js

@@ -0,0 +1,54 @@
+import { collectFromTree } from './preset-builder.js';
+/**
+ * Create a preset with automatic collection.
+ *
+ * Recursively walks the orchestrator (and communicator) tree to collect
+ * all agents. Then validates with `validatePreset()`.
+ *
+ * @throws Error if preset validation fails
+ */
+export function createPreset(input) {
+    const collected = collectFromTree(input.orchestrator);
+    if (input.communicator) {
+        const commCollected = collectFromTree(input.communicator);
+        for (const a of commCollected.agents) {
+            if (!collected.agents.includes(a))
+                collected.agents.push(a);
+        }
+    }
+    const preset = {
+        ...input,
+        agents: collected.agents,
+    };
+    const errors = validatePreset(preset);
+    if (errors.length > 0) {
+        throw new Error(`Invalid preset "${preset.id}":\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    }
+    return preset;
+}
+/**
+ * Validates a preset configuration, checking that all referenced agents, and services exist.
+ * @param preset The preset to validate
+ * @returns Array of error messages (empty if valid)
+ */
+export const validatePreset = (preset) => {
+    const errors = [];
+    // Collect all defined agent names
+    const agentNames = new Set(preset.agents.map((a) => a.name));
+    // Check orchestrator spawnable agents
+    for (const name of preset.orchestrator.agents ?? []) {
+        if (!agentNames.has(name)) {
+            errors.push(`Orchestrator references unknown agent: ${name}`);
+        }
+    }
+    // Check each agent's spawnable agents and workers
+    for (const agent of preset.agents) {
+        for (const name of agent.agents ?? []) {
+            if (!agentNames.has(name)) {
+                errors.push(`Agent '${agent.name}' references unknown agent: ${name}`);
+            }
+        }
+    }
+    return errors;
+};
+//# sourceMappingURL=config.js.map

package/dist/core/preset/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/preset/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AA8CrD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACpD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAErD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QACzD,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5D,CAAC;IACF,CAAC;IAED,MAAM,MAAM,GAAqB;QAChC,GAAG,KAAK;QACR,MAAM,EAAE,SAAS,CAAC,MAAM;KACxB,CAAA;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/F,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAwB,EAAY,EAAE;IACpE,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,kCAAkC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAE5D,sCAAsC;IACtC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAA;QAC9D,CAAC;IACF,CAAC;IAED,kDAAkD;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,+BAA+B,IAAI,EAAE,CAAC,CAAA;YACvE,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC,CAAA"}

package/dist/core/preset/index.js

@@ -0,0 +1,6 @@
+/**
+ * Preset module - type-safe preset builder and configuration
+ */
+export { createPreset, validatePreset } from './config.js';
+export { createOrchestrator, defineAgent } from './preset-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/core/preset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/preset/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAI1D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/core/preset/preset-builder.js

@@ -0,0 +1,63 @@
+/**
+ * Type-safe preset builder for Roj SDK.
+ *
+ * Replaces string-based cross-references (spawnableAgents)
+ * with object references, catching typos and renames at compile time.
+ *
+ * `createPreset` recursively collects agents from the orchestrator tree.
+ */
+// ============================================================================
+// Internal: ref storage & resolution
+// ============================================================================
+/** Stores original object refs for each resolved config, keyed by identity */
+const refStore = new WeakMap();
+function resolveAndStore(refs, resolved) {
+    refStore.set(resolved, refs);
+    return resolved;
+}
+function resolveRefs(refs) {
+    return {
+        agents: (refs.agents ?? []).map((a) => a.name),
+    };
+}
+/** Recursively collect agents from a config node */
+export function collectFromTree(root) {
+    const agents = new Set();
+    function visit(node) {
+        const refs = refStore.get(node);
+        if (!refs)
+            return;
+        for (const agent of refs.agents ?? []) {
+            if (!agents.has(agent)) {
+                agents.add(agent);
+                visit(agent);
+            }
+        }
+    }
+    visit(root);
+    return { agents: [...agents] };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Define an agent with type-safe object references.
+ *
+ * Accepts `agents`  as object references
+ * and resolves them to string names for the runtime.
+ */
+export function defineAgent(input) {
+    const { agents, ...rest } = input;
+    return resolveAndStore({ agents }, { ...rest, ...resolveRefs({ agents }) });
+}
+/**
+ * Create an orchestrator config with type-safe object references.
+ *
+ * Accepts `agents` as object references
+ * and resolves them to string names for the runtime.
+ */
+export function createOrchestrator(input) {
+    const { agents, ...rest } = input;
+    return resolveAndStore({ agents }, { ...rest, ...resolveRefs({ agents }) });
+}
+//# sourceMappingURL=preset-builder.js.map

package/dist/core/preset/preset-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-builder.js","sourceRoot":"","sources":["../../../src/core/preset/preset-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkCH,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAsB,CAAA;AAElD,SAAS,eAAe,CACvB,IAAgB,EAChB,QAAW;IAEX,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC5B,OAAO,QAAQ,CAAA;AAChB,CAAC;AAMD,SAAS,WAAW,CAAC,IAAgB;IACpC,OAAO;QACN,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KAC9C,CAAA;AACF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAA;IAE5C,SAAS,KAAK,CAAC,IAAY;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBACjB,KAAK,CAAC,KAAK,CAAC,CAAA;YACb,CAAC;QACF,CAAC;IACF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAA;IACX,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAA;AAC/B,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAmB,KAA+B;IAC5E,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjC,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAChE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjC,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AAC5E,CAAC"}

package/dist/core/session-lifecycle.integration.test.js

@@ -0,0 +1,159 @@
+import { describe, expect, it } from 'bun:test';
+import { agentEvents } from '../core/agents/state.js';
+import { MockLLMProvider } from '../core/llm/mock.js';
+import { ModelId } from '../core/llm/schema.js';
+import { SessionId } from '../core/sessions/schema.js';
+import { sessionEvents } from '../core/sessions/state.js';
+import { createTestPreset, TestHarness } from '../testing/index.js';
+describe('core: session lifecycle', () => {
+    it('create session → session_created event emitted', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        const events = await session.getEventsByType(sessionEvents, 'session_created');
+        expect(events).toHaveLength(1);
+        expect(events[0].presetId).toBe('test');
+        await harness.shutdown();
+    });
+    it('create session → orchestrator agent spawned automatically', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        const spawnEvents = await session.getEventsByType(agentEvents, 'agent_spawned');
+        expect(spawnEvents.length).toBeGreaterThanOrEqual(1);
+        // The orchestrator should be the entry agent
+        const entryAgentId = session.getEntryAgentId();
+        expect(entryAgentId).not.toBeNull();
+        const agentState = session.state.agents.get(entryAgentId);
+        expect(agentState).toBeDefined();
+        await harness.shutdown();
+    });
+    it('create session with communicator config → both communicator and orchestrator spawned', async () => {
+        const harness = new TestHarness({
+            presets: [{
+                    id: 'test-comm',
+                    name: 'Test with communicator',
+                    orchestrator: {
+                        system: 'Orchestrator.',
+                        model: ModelId('mock'),
+                        tools: [],
+                        agents: [],
+                        debounceMs: 0,
+                    },
+                    communicator: {
+                        system: 'Communicator.',
+                        model: ModelId('mock'),
+                        debounceMs: 0,
+                    },
+                    agents: [],
+                }],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test-comm');
+        const spawnEvents = await session.getEventsByType(agentEvents, 'agent_spawned');
+        // Should have both communicator and orchestrator
+        expect(spawnEvents.length).toBeGreaterThanOrEqual(2);
+        // Entry agent should be the communicator
+        const entryAgentId = session.getEntryAgentId();
+        expect(entryAgentId).not.toBeNull();
+        // Both agents should exist in state
+        expect(session.state.agents.size).toBeGreaterThanOrEqual(2);
+        await harness.shutdown();
+    });
+    it('close session → session_closed event → status becomes closed', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hi');
+        await session.close();
+        // Reload the session to check state
+        const reloaded = await harness.sessionManager.getSession(session.sessionId);
+        expect(reloaded.ok).toBe(true);
+        if (reloaded.ok) {
+            expect(reloaded.value.state.status).toBe('closed');
+            const closedEvents = await harness.eventStore.getEventsByType(session.sessionId, 'session_closed');
+            expect(closedEvents).toHaveLength(1);
+        }
+        await harness.shutdown();
+    });
+    it('reopen session → session_reopened event → agents can process again', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hi');
+        // Close
+        await session.close();
+        // Reopen via plugin method (need to reload first)
+        const reloaded = await harness.sessionManager.getSession(session.sessionId);
+        expect(reloaded.ok).toBe(true);
+        if (reloaded.ok) {
+            const reopenResult = await reloaded.value.callPluginMethod('sessions.reopen', {});
+            expect(reopenResult.ok).toBe(true);
+            const reopenedEvents = await harness.eventStore.getEventsByType(session.sessionId, 'session_reopened');
+            expect(reopenedEvents).toHaveLength(1);
+            // Session should be active again
+            expect(reloaded.value.state.status).toBe('active');
+        }
+        await harness.shutdown();
+    });
+    it('session state reconstructed correctly from events', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const originalState = session.state;
+        const originalAgentCount = originalState.agents.size;
+        const originalPresetId = originalState.presetId;
+        // Reload session from event store (simulates restart)
+        const reloaded = await harness.sessionManager.getSession(session.sessionId);
+        expect(reloaded.ok).toBe(true);
+        if (reloaded.ok) {
+            const reloadedState = reloaded.value.state;
+            expect(reloadedState.presetId).toBe(originalPresetId);
+            expect(reloadedState.agents.size).toBe(originalAgentCount);
+            expect(reloadedState.status).toBe('active');
+        }
+        await harness.shutdown();
+    });
+    it('fork session → new session with events up to fork point, independent processing', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({ content: 'Ok', toolCalls: [] }),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Message 1');
+        await session.sendAndWaitForIdle('Message 2');
+        const originalEvents = await session.getEvents();
+        // Fork at roughly half the events
+        const forkIndex = Math.floor(originalEvents.length / 2);
+        const forkResult = await harness.sessionManager.callManagerMethod('sessions.fork', {
+            sessionId: String(session.sessionId),
+            eventIndex: forkIndex,
+        });
+        expect(forkResult.ok).toBe(true);
+        if (forkResult.ok) {
+            expect(forkResult.value).toMatchObject({ sessionId: expect.any(String) });
+        }
+        if (forkResult.ok && typeof forkResult.value === 'object' && forkResult.value !== null && 'sessionId' in forkResult.value) {
+            const forkedSessionId = SessionId(String(forkResult.value.sessionId));
+            // Forked session should have fewer events than the original
+            const forkedEvents = await harness.eventStore.load(forkedSessionId);
+            expect(forkedEvents.length).toBeLessThan(originalEvents.length);
+            // Original session should be unaffected
+            const originalEventsAfter = await session.getEvents();
+            expect(originalEventsAfter.length).toBe(originalEvents.length);
+        }
+        await harness.shutdown();
+    });
+});
+//# sourceMappingURL=session-lifecycle.integration.test.js.map

package/dist/core/session-lifecycle.integration.test.js.map

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