@roj-ai/sdk 0.1.1 → 0.1.4

package/dist/testing/node-platform.js

@@ -0,0 +1,65 @@
+/**
+ * Test-only Platform impl backed by `node:fs/promises` + `node:child_process`.
+ *
+ * Mirrors the production adapter from `@roj-ai/sdk/bun-platform` but lives in this
+ * package so tests don't create a workspace cycle. Production SDK code MUST
+ * NOT import from here — use injected `Platform` from the caller instead.
+ */
+import { execFile as execFileCb, spawn as nodeSpawn } from 'node:child_process';
+import * as fsp from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { promisify } from 'node:util';
+const execFileP = promisify(execFileCb);
+export function createNodeFileSystem() {
+    return {
+        readFile: ((path, encoding) => encoding ? fsp.readFile(path, encoding) : fsp.readFile(path)),
+        writeFile: (path, data) => fsp.writeFile(path, data),
+        appendFile: (path, data) => fsp.appendFile(path, data),
+        mkdir: async (path, options) => {
+            await fsp.mkdir(path, options);
+        },
+        readdir: ((path, options) => options?.withFileTypes
+            ? fsp.readdir(path, { withFileTypes: true })
+            : fsp.readdir(path)),
+        stat: (path) => fsp.stat(path),
+        access: (path, mode) => fsp.access(path, mode),
+        unlink: (path) => fsp.unlink(path),
+        rm: (path, options) => fsp.rm(path, options),
+        cp: async (source, dest, options) => {
+            await fsp.cp(source, dest, options);
+        },
+        open: (path, flags) => fsp.open(path, flags),
+        exists: async (path) => {
+            try {
+                await fsp.access(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        realpath: (path) => fsp.realpath(path),
+    };
+}
+export function createNodeProcessRunner() {
+    return {
+        async execFile(file, args, options) {
+            const { stdout, stderr } = await execFileP(file, args, options ?? {});
+            return {
+                stdout: typeof stdout === 'string' ? stdout : Buffer.from(stdout).toString(),
+                stderr: typeof stderr === 'string' ? stderr : Buffer.from(stderr).toString(),
+            };
+        },
+        spawn(command, args, options) {
+            return nodeSpawn(command, args, options ?? {});
+        },
+    };
+}
+export function createNodePlatform() {
+    return {
+        fs: createNodeFileSystem(),
+        process: createNodeProcessRunner(),
+        tmpDir: tmpdir(),
+    };
+}
+//# sourceMappingURL=node-platform.js.map

package/dist/testing/node-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-platform.js","sourceRoot":"","sources":["../../src/testing/node-platform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,QAAQ,IAAI,UAAU,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGrC,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;AAEvC,MAAM,UAAU,oBAAoB;IACnC,OAAO;QACN,QAAQ,EAAE,CAAC,CAAC,IAAY,EAAE,QAA2B,EAAE,EAAE,CACxD,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA2B;QAExF,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;QACpD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;QAEtD,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC9B,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC/B,CAAC;QAED,OAAO,EAAE,CAAC,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE,CAC7D,OAAO,EAAE,aAAa;YACrB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC5C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAA0B;QAE/C,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;QAE9C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;QAC5C,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YACnC,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QAE5C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,IAAI,CAAC;gBACJ,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACtB,OAAO,IAAI,CAAA;YACZ,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,KAAK,CAAA;YACb,CAAC;QACF,CAAC;QAED,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;KACtC,CAAA;AACF,CAAC;AAED,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO;YACjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;YACrE,OAAO;gBACN,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;gBAC5E,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;aAC5E,CAAA;QACF,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO;YAC3B,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;QAC/C,CAAC;KACD,CAAA;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,EAAE,EAAE,oBAAoB,EAAE;QAC1B,OAAO,EAAE,uBAAuB,EAAE;QAClC,MAAM,EAAE,MAAM,EAAE;KAChB,CAAA;AACF,CAAC"}

package/dist/testing/notification-collector.js

@@ -0,0 +1,82 @@
+/**
+ * In-memory notification collector for testing.
+ * Captures PluginNotification instances emitted during session execution.
+ */
+export class NotificationCollector {
+    notifications = [];
+    waiters = [];
+    /**
+     * Push a notification into the collector.
+     * Wired to SessionManager's onUserOutput callback.
+     */
+    push(notification) {
+        this.notifications.push(notification);
+        // Check waiters
+        for (let i = this.waiters.length - 1; i >= 0; i--) {
+            const waiter = this.waiters[i];
+            if (waiter.predicate(notification)) {
+                clearTimeout(waiter.timer);
+                this.waiters.splice(i, 1);
+                waiter.resolve(notification);
+            }
+        }
+    }
+    /**
+     * Get all collected notifications.
+     */
+    getAll() {
+        return [...this.notifications];
+    }
+    /**
+     * Get notifications from a specific plugin.
+     */
+    getByPlugin(pluginName) {
+        return this.notifications.filter((n) => n.pluginName === pluginName);
+    }
+    /**
+     * Get notifications matching plugin name and type.
+     */
+    getByType(pluginName, type) {
+        return this.notifications.filter((n) => n.pluginName === pluginName && n.type === type);
+    }
+    /**
+     * Get agent messages (user-chat.agentMessage notifications) with extracted payload.
+     */
+    getAgentMessages() {
+        return this.getByType('user-chat', 'agentMessage').map((n) => {
+            const payload = n.payload;
+            return {
+                content: payload.content,
+                format: payload.format,
+                sessionId: payload.sessionId,
+            };
+        });
+    }
+    /**
+     * Wait for a notification matching the predicate.
+     * Checks already-collected notifications first, then waits for new ones.
+     */
+    waitFor(predicate, opts) {
+        // Check already-collected
+        const existing = this.notifications.find(predicate);
+        if (existing)
+            return Promise.resolve(existing);
+        const timeoutMs = opts?.timeoutMs ?? 5000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const idx = this.waiters.findIndex((w) => w.resolve === resolve);
+                if (idx !== -1)
+                    this.waiters.splice(idx, 1);
+                reject(new Error(`waitFor timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.waiters.push({ predicate, resolve, reject, timer });
+        });
+    }
+    /**
+     * Clear all collected notifications.
+     */
+    clear() {
+        this.notifications = [];
+    }
+}
+//# sourceMappingURL=notification-collector.js.map

package/dist/testing/notification-collector.js.map

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

package/dist/testing/preset-helpers.js

@@ -0,0 +1,37 @@
+import { ModelId } from '../core/llm/schema.js';
+/**
+ * Create a minimal test preset with sensible defaults.
+ * All agents get debounceMs: 0 and model: ModelId('mock').
+ */
+export function createTestPreset(overrides) {
+    const agents = overrides?.agents ?? [];
+    return {
+        id: overrides?.id ?? 'test',
+        name: 'Test Preset',
+        orchestrator: {
+            system: overrides?.orchestratorSystem ?? 'You are a test agent.',
+            model: ModelId('mock'),
+            tools: [],
+            agents: agents.map((a) => a.name),
+            debounceMs: 0,
+            plugins: overrides?.orchestratorPlugins,
+        },
+        agents: agents.map((a) => ({
+            ...a,
+            model: a.model ?? ModelId('mock'),
+            debounceMs: a.debounceMs ?? 0,
+        })),
+        plugins: overrides?.plugins,
+    };
+}
+/**
+ * Create a multi-agent test preset from agent definitions.
+ * The orchestrator can spawn all provided agents.
+ */
+export function createMultiAgentPreset(agents, overrides) {
+    return createTestPreset({
+        ...overrides,
+        agents,
+    });
+}
+//# sourceMappingURL=preset-helpers.js.map

package/dist/testing/preset-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-helpers.js","sourceRoot":"","sources":["../../src/testing/preset-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAO9C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAMhC;IACA,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,EAAE,CAAA;IAEtC,OAAO;QACN,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,MAAM;QAC3B,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE;YACb,MAAM,EAAE,SAAS,EAAE,kBAAkB,IAAI,uBAAuB;YAChE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;YACtB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACjC,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,SAAS,EAAE,mBAAmB;SACvC;QACD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;YACjC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;SAC7B,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,OAAO;KAC3B,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACrC,MAA6B,EAC7B,SAGC;IAED,OAAO,gBAAgB,CAAC;QACvB,GAAG,SAAS;QACZ,MAAM;KACN,CAAC,CAAA;AACH,CAAC"}

package/dist/testing/test-harness.js

@@ -0,0 +1,226 @@
+import { MemoryEventStore } from '../core/events/memory.js';
+import { SessionFileStore } from '../core/file-store/file-store.js';
+import { LoggingLLMProvider } from '../core/llm/logging-provider.js';
+import { MockLLMProvider } from '../core/llm/mock.js';
+import { SessionManager } from '../core/sessions/session-manager.js';
+import { ToolExecutor } from '../core/tools/executor.js';
+import { silentLogger } from '../lib/logger/logger.js';
+import { createNodePlatform } from './node-platform.js';
+import { agentsPlugin } from '../plugins/agents/plugin.js';
+import { filesystemPlugin } from '../plugins/filesystem/index.js';
+import { llmDebugPlugin } from '../plugins/llm-debug/plugin.js';
+import { logsPlugin } from '../plugins/logs/index.js';
+import { mailboxPlugin } from '../plugins/mailbox/plugin.js';
+import { presetsPlugin, sessionLifecyclePlugin } from '../plugins/session-lifecycle/index.js';
+import { uploadsPlugin } from '../plugins/uploads/plugin.js';
+import { userChatPlugin } from '../plugins/user-chat/plugin.js';
+import { NotificationCollector } from './notification-collector.js';
+import { waitForAllAgentsIdle } from './wait-helpers.js';
+/**
+ * Default system plugins for testing — same as builtinPlugins in bootstrap.ts.
+ */
+const defaultSystemPlugins = [
+    sessionLifecyclePlugin,
+    presetsPlugin,
+    mailboxPlugin,
+    agentsPlugin,
+    userChatPlugin,
+    uploadsPlugin,
+    llmDebugPlugin,
+    filesystemPlugin,
+    logsPlugin,
+];
+/**
+ * TestHarness — boots a real SessionManager with MemoryEventStore,
+ * MockLLMProvider, and in-memory notification collection.
+ *
+ * Enables full-flow integration tests without external dependencies.
+ */
+export class TestHarness {
+    eventStore;
+    llmProvider;
+    notifications;
+    sessionManager;
+    constructor(options) {
+        this.eventStore = options.eventStore ?? new MemoryEventStore();
+        if (options.llmProvider) {
+            this.llmProvider = options.llmProvider;
+        }
+        else if (options.mockHandler) {
+            this.llmProvider = new MockLLMProvider(options.mockHandler);
+        }
+        else {
+            // Default: echo back content with no tool calls
+            this.llmProvider = MockLLMProvider.withFixedResponse({
+                content: 'Mock response',
+                toolCalls: [],
+            });
+        }
+        this.notifications = new NotificationCollector();
+        const presetsMap = new Map(options.presets.map((p) => [p.id, p]));
+        // Override debounceMs: 0 on all preset agents for instant processing
+        for (const preset of presetsMap.values()) {
+            preset.orchestrator.debounceMs = 0;
+            if (preset.communicator) {
+                preset.communicator.debounceMs = 0;
+            }
+            for (const agent of preset.agents) {
+                agent.debounceMs = 0;
+            }
+        }
+        const basePath = `/tmp/roj-test-${Math.random().toString(36).slice(2)}`;
+        const toolExecutor = new ToolExecutor(silentLogger);
+        const platform = createNodePlatform();
+        const dataFileStore = new SessionFileStore(basePath, undefined, false, platform.fs, 'session');
+        // When llmLogger is provided, wrap the mock provider so calls get logged
+        const effectiveProvider = options.llmLogger
+            ? new LoggingLLMProvider(this.llmProvider, options.llmLogger)
+            : this.llmProvider;
+        this.sessionManager = new SessionManager({
+            eventStore: this.eventStore,
+            llmProvider: effectiveProvider,
+            toolExecutor,
+            presets: presetsMap,
+            logger: silentLogger,
+            basePath,
+            dataFileStore,
+            onUserOutput: (n) => this.notifications.push(n),
+            llmLogger: options.llmLogger,
+            platform,
+            systemPlugins: [...defaultSystemPlugins, ...(options.systemPlugins ?? [])],
+        });
+    }
+    /**
+     * Create a session and return a TestSession wrapper.
+     */
+    async createSession(presetId) {
+        const result = await this.sessionManager.createSession(presetId);
+        if (!result.ok) {
+            throw new Error(`Failed to create session: ${result.error.type} — ${result.error.message}`);
+        }
+        return new TestSession(result.value, this);
+    }
+    /**
+     * Open an existing session from the event store (replays events, runs onSessionReady hooks).
+     * Used to simulate server restart by pairing with another harness over the same eventStore.
+     */
+    async openSession(sessionId) {
+        const result = await this.sessionManager.getSession(sessionId);
+        if (!result.ok) {
+            throw new Error(`Failed to open session: ${result.error.type} — ${result.error.message}`);
+        }
+        return new TestSession(result.value, this);
+    }
+    /**
+     * Shutdown all sessions.
+     */
+    async shutdown() {
+        await this.sessionManager.shutdown();
+    }
+}
+/**
+ * TestSession — convenience wrapper around Session for integration tests.
+ */
+export class TestSession {
+    session;
+    harness;
+    sessionId;
+    constructor(session, harness) {
+        this.session = session;
+        this.harness = harness;
+        this.sessionId = session.id;
+    }
+    /**
+     * Send a message to the entry agent (communicator or orchestrator).
+     */
+    async sendMessage(content) {
+        const entryAgentId = this.session.getEntryAgentId();
+        if (!entryAgentId) {
+            throw new Error('No entry agent found');
+        }
+        await this.sendMessageToAgent(entryAgentId, content);
+    }
+    /**
+     * Send a message to a specific agent.
+     */
+    async sendMessageToAgent(agentId, content) {
+        const result = await this.session.callPluginMethod('user-chat.sendMessage', {
+            sessionId: String(this.sessionId),
+            content,
+            agentId: String(agentId),
+        });
+        if (!result.ok) {
+            throw new Error(`sendMessage failed: ${result.error.type} — ${result.error.message}`);
+        }
+    }
+    /**
+     * Wait for all agents to become idle.
+     */
+    async waitForIdle(opts) {
+        await waitForAllAgentsIdle(this.session, opts);
+    }
+    /**
+     * Send a message and wait for all agents to become idle.
+     */
+    async sendAndWaitForIdle(content, opts) {
+        await this.sendMessage(content);
+        await this.waitForIdle(opts);
+    }
+    /**
+     * Get all events from the event store for this session.
+     */
+    async getEvents() {
+        return this.harness.eventStore.load(this.sessionId);
+    }
+    async getEventsByType(factoryOrType, maybeType) {
+        const type = typeof factoryOrType === 'string' ? factoryOrType : maybeType;
+        return this.harness.eventStore.getEventsByType(this.sessionId, type);
+    }
+    /**
+     * Get notifications for this session.
+     */
+    getNotifications() {
+        return this.harness.notifications.getAll();
+    }
+    /**
+     * Get the current session state.
+     */
+    get state() {
+        return this.session.state;
+    }
+    /**
+     * Get the entry agent ID.
+     */
+    getEntryAgentId() {
+        return this.session.getEntryAgentId();
+    }
+    /**
+     * Close the session.
+     */
+    async close() {
+        const result = await this.session.close();
+        if (!result.ok) {
+            throw new Error(`close failed: ${result.error.type} — ${result.error.message}`);
+        }
+    }
+    /**
+     * Call a plugin method on the underlying session.
+     */
+    async callPluginMethod(method, input) {
+        return this.session.callPluginMethod(method, input);
+    }
+    /**
+     * Answer a user-chat question (convenience wrapper around callPluginMethod).
+     */
+    async answerQuestion(agentId, questionId, answer) {
+        const result = await this.session.callPluginMethod('user-chat.answerQuestion', {
+            agentId: String(agentId),
+            questionId,
+            answer,
+        });
+        if (!result.ok) {
+            throw new Error(`answerQuestion failed: ${result.error.type} — ${result.error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=test-harness.js.map

package/dist/testing/test-harness.js.map

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

package/dist/testing/test-harness.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from 'bun:test';
+import { MockLLMProvider } from '../core/llm/mock.js';
+import { ToolCallId } from '../core/tools/schema.js';
+import { createTestPreset, TestHarness } from './index.js';
+describe('TestHarness', () => {
+    it('sendMessage → tell_user → notification', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    content: null,
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hello!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hi');
+        const messages = harness.notifications.getAgentMessages();
+        expect(messages).toHaveLength(1);
+        expect(messages[0].content).toBe('Hello!');
+        await harness.shutdown();
+    });
+    it('creates session with correct state', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+        });
+        const session = await harness.createSession('test');
+        expect(session.state.status).toBe('active');
+        expect(session.state.presetId).toBe('test');
+        expect(session.getEntryAgentId()).not.toBeNull();
+        await harness.shutdown();
+    });
+    it('captures events from event store', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withFixedResponse({
+                content: 'Done',
+                toolCalls: [],
+            }),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Test');
+        const events = await session.getEvents();
+        const sessionCreated = await session.getEventsByType('session_created');
+        expect(events.length).toBeGreaterThan(0);
+        expect(sessionCreated).toHaveLength(1);
+        await harness.shutdown();
+    });
+});
+//# sourceMappingURL=test-harness.test.js.map

package/dist/testing/test-harness.test.js.map

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

package/dist/testing/wait-helpers.js

@@ -0,0 +1,64 @@
+const DEFAULT_TIMEOUT_MS = 5000;
+const POLL_INTERVAL_MS = 10;
+/**
+ * Wait for a specific agent to become idle.
+ * An agent is "idle" when: status === 'pending', no pendingToolCalls,
+ * no pendingToolResults, and not scheduled for processing.
+ */
+export async function waitForAgentIdle(session, agentId, opts) {
+    const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (isAgentIdle(session, agentId)) {
+            // Double-check after one poll interval to account for queueMicrotask re-entry
+            await sleep(POLL_INTERVAL_MS);
+            if (isAgentIdle(session, agentId)) {
+                return;
+            }
+        }
+        await sleep(POLL_INTERVAL_MS);
+    }
+    throw new Error(`waitForAgentIdle timed out after ${timeoutMs}ms for agent ${agentId}`);
+}
+/**
+ * Wait for all agents in a session to become idle.
+ */
+export async function waitForAllAgentsIdle(session, opts) {
+    const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (areAllAgentsIdle(session)) {
+            // Double-check after one poll interval
+            await sleep(POLL_INTERVAL_MS);
+            if (areAllAgentsIdle(session)) {
+                return;
+            }
+        }
+        await sleep(POLL_INTERVAL_MS);
+    }
+    throw new Error(`waitForAllAgentsIdle timed out after ${timeoutMs}ms`);
+}
+function isAgentIdle(session, agentId) {
+    const agent = session.getAgent(agentId);
+    if (!agent)
+        return true; // Agent doesn't exist, consider idle
+    const agentState = agent.state;
+    if (!agentState)
+        return true;
+    return (agentState.status === 'pending'
+        && agentState.pendingToolCalls.length === 0
+        && agentState.pendingToolResults.length === 0
+        && !agent.isScheduled());
+}
+function areAllAgentsIdle(session) {
+    for (const [agentId] of session.state.agents) {
+        if (!isAgentIdle(session, agentId)) {
+            return false;
+        }
+    }
+    return true;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=wait-helpers.js.map

package/dist/testing/wait-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-helpers.js","sourceRoot":"","sources":["../../src/testing/wait-helpers.ts"],"names":[],"mappings":"AAGA,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAC/B,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAE3B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,OAAgB,EAChB,OAAgB,EAChB,IAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,kBAAkB,CAAA;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAEvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC9B,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACnC,8EAA8E;YAC9E,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;YAC7B,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBACnC,OAAM;YACP,CAAC;QACF,CAAC;QACD,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,gBAAgB,OAAO,EAAE,CAAC,CAAA;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAAgB,EAChB,IAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,kBAAkB,CAAA;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAEvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC9B,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,uCAAuC;YACvC,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;YAC7B,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,OAAM;YACP,CAAC;QACF,CAAC;QACD,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,IAAI,CAAC,CAAA;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB,EAAE,OAAgB;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA,CAAC,qCAAqC;IAE7D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAA;IAC9B,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAE5B,OAAO,CACN,UAAU,CAAC,MAAM,KAAK,SAAS;WAC5B,UAAU,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;WACxC,UAAU,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC;WAC1C,CAAC,KAAK,CAAC,WAAW,EAAE,CACvB,CAAA;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACzC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACxB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACzD,CAAC"}

package/dist/transport/adapter/client-adapter.js

@@ -0,0 +1,64 @@
+/**
+ * Client Adapter
+ *
+ * Worker mode - agent connects to DO as WebSocket client.
+ * Simplified for broadcast-only communication (agent -> DO -> SPA).
+ * User messages and answers are handled via REST API.
+ *
+ * Authentication: Token is passed in the WebSocket URL as query parameter
+ * and Authorization header (handled by DO before upgrade).
+ */
+import { ClientConnection } from '@roj-ai/transport/client';
+export class ClientAdapter {
+    config;
+    connection;
+    logger;
+    heartbeatTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.logger = config.logger?.child({ component: 'ClientAdapter' });
+        this.connection = new ClientConnection({
+            url: config.url,
+            wsFactory: config.wsFactory,
+            reconnect: config.reconnect ?? {
+                baseDelayMs: 1000,
+                maxDelayMs: 30000,
+                maxAttempts: Infinity,
+                jitterFactor: 0.3,
+            },
+        });
+    }
+    async start() {
+        this.logger?.info('Connecting to DO', { url: this.config.url });
+        await this.connection.connect();
+        this.logger?.info('Connected to DO');
+        this.startHeartbeat();
+    }
+    async stop() {
+        this.stopHeartbeat();
+        this.logger?.info('Disconnecting from DO');
+        await this.connection.disconnect();
+        this.logger?.info('Disconnected from DO');
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            this.connection.send(JSON.stringify({ type: 'heartbeat', ts: Date.now() }));
+        }, 10_000);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    broadcast(notification) {
+        // Send as wire message — protocol validation happens at the DO side
+        this.connection.send(JSON.stringify({
+            type: notification.type,
+            payload: notification.payload,
+            ts: Date.now(),
+        }));
+    }
+}
+//# sourceMappingURL=client-adapter.js.map

package/dist/transport/adapter/client-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-adapter.js","sourceRoot":"","sources":["../../../src/transport/adapter/client-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAW3D,MAAM,OAAO,aAAa;IACR,MAAM,CAAqB;IAC3B,UAAU,CAA4C;IACtD,MAAM,CAAS;IACxB,cAAc,GAA0C,IAAI,CAAA;IAEpE,YAAY,MAA2B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAA;QAClE,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC;YACtC,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI;gBAC9B,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAE,KAAK;gBACjB,WAAW,EAAE,QAAQ;gBACrB,YAAY,EAAE,GAAG;aACjB;SACD,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;QAC/D,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAA;QAC/B,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACpC,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACT,IAAI,CAAC,aAAa,EAAE,CAAA;QACpB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAA;QAC1C,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA;QAClC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAA;IAC1C,CAAC;IAEO,cAAc;QACrB,IAAI,CAAC,aAAa,EAAE,CAAA;QACpB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;QAC5E,CAAC,EAAE,MAAM,CAAC,CAAA;IACX,CAAC;IAEO,aAAa;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC3B,CAAC;IACF,CAAC;IAED,SAAS,CAAC,YAAgC;QACzC,oEAAoE;QACpE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YACnC,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;SACd,CAAC,CAAC,CAAA;IACJ,CAAC;CACD"}

package/dist/transport/adapter/index.js

@@ -0,0 +1,24 @@
+/**
+ * Transport Adapter Module
+ *
+ * Simplified for broadcast-only WebSocket communication.
+ * User messages and answers are handled via REST API.
+ */
+export { ServerAdapter } from './server-adapter.js';
+export { ClientAdapter } from './client-adapter.js';
+// ============================================================================
+// Factory
+// ============================================================================
+import { ClientAdapter } from './client-adapter.js';
+import { ServerAdapter } from './server-adapter.js';
+export function createAgentTransport(config) {
+    if (config.mode === 'standalone') {
+        const { mode: _mode, ...rest } = config;
+        return new ServerAdapter(rest);
+    }
+    else {
+        const { mode: _mode, ...rest } = config;
+        return new ClientAdapter(rest);
+    }
+}
+//# sourceMappingURL=index.js.map