@roj-ai/sdk 0.0.2

package/dist/prompts/builder.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Prompt builder pattern for constructing system prompts dynamically.
+ */
+import { TONE_INSTRUCTIONS } from './base.js';
+export type ToneType = keyof typeof TONE_INSTRUCTIONS;
+/**
+ * Agent role determines which briefing to include in the system prompt.
+ * - "entry": Orchestrator without communicator (talks to user directly)
+ * - "orchestrator": Orchestrator with communicator (talks to communicator, not user)
+ * - "child": Spawned by parent, reports results back
+ * - "communicator": Handles user communication, relays to orchestrator
+ */
+export type AgentRole = 'entry' | 'orchestrator' | 'child' | 'communicator';
+/**
+ * Builder for constructing prompts with various sections.
+ */
+export declare class PromptBuilder {
+    private sections;
+    /**
+     * Add a section to the prompt.
+     */
+    add(content: string | undefined | null): this;
+    /**
+     * Add a section only if a condition is met.
+     */
+    addIf(condition: boolean, content: string): this;
+    /**
+     * Add multiple sections at once, filtering out empty values.
+     */
+    addAll(...contents: (string | undefined | null)[]): this;
+    /**
+     * Build the final prompt by joining sections with double newlines.
+     */
+    build(): string;
+    /**
+     * Reset the builder for reuse.
+     */
+    reset(): this;
+}
+/**
+ * Environment info for system prompt injection.
+ */
+export interface PromptEnvironment {
+    /** Path the agent sees for session directory */
+    sessionPath: string;
+    /** Path the agent sees for workspace directory (optional) */
+    workspacePath?: string;
+}
+/**
+ * Build environment section for system prompt.
+ */
+export declare function buildEnvironmentSection(env: PromptEnvironment): string;
+/**
+ * Build a complete system prompt for an agent.
+ *
+ * Structure:
+ * 1. BASE BRIEFING - For all agents, technical minimum
+ * 2. ROLE BRIEFING - Entry agent vs Child agent vs Communicator
+ * 3. ENVIRONMENT - Working directories
+ * 4. CUSTOM PROMPT - From preset, purely role/tasks without tech details
+ *
+ * @param role - Agent role: "entry", "child", or "communicator"
+ * @param customPrompt - Custom prompt from preset (role/tasks only)
+ * @param environment - Optional environment info for directory roots
+ */
+export declare function buildSystemPrompt(role: AgentRole, customPrompt: string, environment?: PromptEnvironment): string;
+/**
+ * Wrap a summary in the standard context summary format.
+ * @param summary - The summary text
+ * @param historyPath - Optional path to offloaded full history
+ */
+export declare function wrapContextSummary(summary: string, historyPath?: string): string;
+//# sourceMappingURL=builder.d.ts.map

package/dist/prompts/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/prompts/builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAON,iBAAiB,EACjB,MAAM,WAAW,CAAA;AAMlB,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,GAAG,cAAc,CAAA;AAM3E;;GAEG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAe;IAE/B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI;IAO7C;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOhD;;OAEG;IACH,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI;IAOxD;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAmBtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,SAAS,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,iBAAiB,GAC7B,MAAM,CAqCR;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhF"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Prompts module - centralized location for base prompts and prompt builders.
+ *
+ * This module consolidates prompt templates that are used across the codebase.
+ * Preset-specific prompts remain in their respective preset files.
+ */
+export { AGENT_BASE_BRIEFING, CHILD_AGENT_BRIEFING, COMMUNICATOR_BRIEFING, CONTEXT_SUMMARY_PROMPT, CONTEXT_SUMMARY_WRAPPER, ENTRY_AGENT_BRIEFING, ORCHESTRATOR_BRIEFING, REASONING_INSTRUCTIONS, TONE_INSTRUCTIONS, } from './base.js';
+export { type AgentRole, buildEnvironmentSection, buildSystemPrompt, PromptBuilder, type PromptEnvironment, type ToneType, wrapContextSummary, } from './builder.js';
+export { agentVars, processPromptMacros } from './macros.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEN,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EAErB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EAEtB,iBAAiB,GACjB,MAAM,WAAW,CAAA;AAElB,OAAO,EACN,KAAK,SAAS,EAEd,uBAAuB,EACvB,iBAAiB,EAEjB,aAAa,EACb,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EACb,kBAAkB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/prompts/macros.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Process simple conditional macros in prompt templates.
+ *
+ * Syntax: `{{#if varName}}...content...{{/if}}`
+ * - If `vars[varName]` is `true`, the content is kept (tags removed).
+ * - Otherwise the entire block (including tags) is stripped.
+ */
+export declare function processPromptMacros(prompt: string, vars: Record<string, boolean>): string;
+/**
+ * Convert an array of agent names into macro variables.
+ *
+ * `['design-tokens', 'common-blocks']` → `{ 'agent:design-tokens': true, 'agent:common-blocks': true }`
+ */
+export declare function agentVars(agents: readonly string[]): Record<string, boolean>;
+//# sourceMappingURL=macros.d.ts.map

package/dist/prompts/macros.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macros.d.ts","sourceRoot":"","sources":["../../src/prompts/macros.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAIzF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5E"}

package/dist/prompts/macros.test.d.ts

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

package/dist/prompts/macros.test.d.ts.map

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

package/dist/testing/bootstrap-for-testing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test-only bootstrap helper: wires memory persistence, mock LLM, and a
+ * node-backed Platform so integration tests don't need a runtime package.
+ *
+ * Production callers should use `bootstrap()` directly and pass a Platform
+ * from their runtime package (e.g. `@roj-ai/sdk/bun-platform`).
+ */
+import { type Services } from '../bootstrap.js';
+import type { MockInferenceHandler } from '../core/llm/mock.js';
+import type { Preset } from '../core/preset/index.js';
+export declare function bootstrapForTesting(mockHandler?: MockInferenceHandler, presets?: Preset[]): Services;
+//# sourceMappingURL=bootstrap-for-testing.d.ts.map

package/dist/testing/bootstrap-for-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-for-testing.d.ts","sourceRoot":"","sources":["../../src/testing/bootstrap-for-testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAGpD,wBAAgB,mBAAmB,CAClC,WAAW,CAAC,EAAE,oBAAoB,EAClC,OAAO,CAAC,EAAE,MAAM,EAAE,GAChB,QAAQ,CAqBV"}

package/dist/testing/index.d.ts

@@ -0,0 +1,8 @@
+export { bootstrapForTesting } from './bootstrap-for-testing.js';
+export { createNodeFileSystem, createNodePlatform, createNodeProcessRunner } from './node-platform.js';
+export { NotificationCollector } from './notification-collector.js';
+export { createMultiAgentPreset, createTestPreset } from './preset-helpers.js';
+export type { TestAgentDefinition } from './preset-helpers.js';
+export { TestHarness, TestSession } from './test-harness.js';
+export { waitForAgentIdle, waitForAllAgentsIdle } from './wait-helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACtG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/testing/node-platform.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 type { FileSystem, Platform, ProcessRunner } from '../platform/index.js';
+export declare function createNodeFileSystem(): FileSystem;
+export declare function createNodeProcessRunner(): ProcessRunner;
+export declare function createNodePlatform(): Platform;
+//# sourceMappingURL=node-platform.d.ts.map

package/dist/testing/node-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-platform.d.ts","sourceRoot":"","sources":["../../src/testing/node-platform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAI9E,wBAAgB,oBAAoB,IAAI,UAAU,CAuCjD;AAED,wBAAgB,uBAAuB,IAAI,aAAa,CAcvD;AAED,wBAAgB,kBAAkB,IAAI,QAAQ,CAM7C"}

package/dist/testing/notification-collector.d.ts

@@ -0,0 +1,46 @@
+import type { PluginNotification } from '../core/plugins/plugin-builder.js';
+/**
+ * In-memory notification collector for testing.
+ * Captures PluginNotification instances emitted during session execution.
+ */
+export declare class NotificationCollector {
+    private notifications;
+    private waiters;
+    /**
+     * Push a notification into the collector.
+     * Wired to SessionManager's onUserOutput callback.
+     */
+    push(notification: PluginNotification): void;
+    /**
+     * Get all collected notifications.
+     */
+    getAll(): PluginNotification[];
+    /**
+     * Get notifications from a specific plugin.
+     */
+    getByPlugin(pluginName: string): PluginNotification[];
+    /**
+     * Get notifications matching plugin name and type.
+     */
+    getByType(pluginName: string, type: string): PluginNotification[];
+    /**
+     * Get agent messages (user-chat.agentMessage notifications) with extracted payload.
+     */
+    getAgentMessages(): Array<{
+        content: string;
+        format: string;
+        sessionId: string;
+    }>;
+    /**
+     * Wait for a notification matching the predicate.
+     * Checks already-collected notifications first, then waits for new ones.
+     */
+    waitFor(predicate: (n: PluginNotification) => boolean, opts?: {
+        timeoutMs?: number;
+    }): Promise<PluginNotification>;
+    /**
+     * Clear all collected notifications.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=notification-collector.d.ts.map

package/dist/testing/notification-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-collector.d.ts","sourceRoot":"","sources":["../../src/testing/notification-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAE1E;;;GAGG;AACH,qBAAa,qBAAqB;IACjC,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,OAAO,CAKR;IAEP;;;OAGG;IACH,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAc5C;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIrD;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIjE;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAWjF;;;OAGG;IACH,OAAO,CACN,SAAS,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,OAAO,EAC7C,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAkB9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb"}

package/dist/testing/preset-helpers.d.ts

@@ -0,0 +1,28 @@
+import type { AgentDefinition } from '../core/agents/config.js';
+import { ModelId } from '../core/llm/schema.js';
+import type { AgentPluginConfig, SessionPluginConfig } from '../core/plugins/plugin-builder.js';
+import type { Preset } from '../core/preset/index.js';
+/** AgentDefinition with model optional — defaults to ModelId('mock') in test helpers. */
+export type TestAgentDefinition<TInput = unknown> = Omit<AgentDefinition<TInput>, 'model'> & {
+    model?: ReturnType<typeof ModelId>;
+};
+/**
+ * Create a minimal test preset with sensible defaults.
+ * All agents get debounceMs: 0 and model: ModelId('mock').
+ */
+export declare function createTestPreset(overrides?: {
+    id?: string;
+    orchestratorSystem?: string;
+    agents?: TestAgentDefinition[];
+    plugins?: SessionPluginConfig[];
+    orchestratorPlugins?: AgentPluginConfig[];
+}): Preset;
+/**
+ * Create a multi-agent test preset from agent definitions.
+ * The orchestrator can spawn all provided agents.
+ */
+export declare function createMultiAgentPreset(agents: TestAgentDefinition[], overrides?: {
+    id?: string;
+    orchestratorSystem?: string;
+}): Preset;
+//# sourceMappingURL=preset-helpers.d.ts.map

package/dist/testing/preset-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-helpers.d.ts","sourceRoot":"","sources":["../../src/testing/preset-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,yFAAyF;AACzF,MAAM,MAAM,mBAAmB,CAAC,MAAM,GAAG,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAA;CAAE,CAAA;AAEnI;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC9B,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC/B,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACzC,GAAG,MAAM,CAqBT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,SAAS,CAAC,EAAE;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC3B,GACC,MAAM,CAKR"}

package/dist/testing/test-harness.d.ts

@@ -0,0 +1,117 @@
+import type { AgentId } from '../core/agents/schema.js';
+import type { DomainError } from '../core/errors.js';
+import { MemoryEventStore } from '../core/events/memory.js';
+import type { DomainEvent } from '../core/events/types.js';
+import type { LLMLogger } from '../core/llm/logger.js';
+import { MockLLMProvider } from '../core/llm/mock.js';
+import type { MockInferenceHandler } from '../core/llm/mock.js';
+import type { PluginDefinition, PluginNotification } from '../core/plugins/plugin-builder.js';
+import type { Preset } from '../core/preset/index.js';
+import type { SessionId } from '../core/sessions/schema.js';
+import { SessionManager } from '../core/sessions/session-manager.js';
+import type { Session } from '../core/sessions/session.js';
+import type { SessionState } from '../core/sessions/state.js';
+import type { Result } from '../lib/utils/result.js';
+import { NotificationCollector } from './notification-collector.js';
+/**
+ * TestHarness — boots a real SessionManager with MemoryEventStore,
+ * MockLLMProvider, and in-memory notification collection.
+ *
+ * Enables full-flow integration tests without external dependencies.
+ */
+export declare class TestHarness {
+    readonly eventStore: MemoryEventStore;
+    readonly llmProvider: MockLLMProvider;
+    readonly notifications: NotificationCollector;
+    readonly sessionManager: SessionManager;
+    constructor(options: {
+        presets: Preset[];
+        llmProvider?: MockLLMProvider;
+        mockHandler?: MockInferenceHandler;
+        /** Additional system plugins to register (merged with built-in defaults) */
+        systemPlugins?: readonly PluginDefinition<string, any, any, any, any>[];
+        /** Optional LLM logger — when provided, wraps the mock provider with LoggingLLMProvider */
+        llmLogger?: LLMLogger;
+        /** Optional pre-existing event store — lets multiple harnesses share persisted state (simulates server restart) */
+        eventStore?: MemoryEventStore;
+    });
+    /**
+     * Create a session and return a TestSession wrapper.
+     */
+    createSession(presetId: string): Promise<TestSession>;
+    /**
+     * 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.
+     */
+    openSession(sessionId: SessionId): Promise<TestSession>;
+    /**
+     * Shutdown all sessions.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * TestSession — convenience wrapper around Session for integration tests.
+ */
+export declare class TestSession {
+    private readonly session;
+    private readonly harness;
+    readonly sessionId: SessionId;
+    constructor(session: Session, harness: TestHarness);
+    /**
+     * Send a message to the entry agent (communicator or orchestrator).
+     */
+    sendMessage(content: string): Promise<void>;
+    /**
+     * Send a message to a specific agent.
+     */
+    sendMessageToAgent(agentId: AgentId, content: string): Promise<void>;
+    /**
+     * Wait for all agents to become idle.
+     */
+    waitForIdle(opts?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * Send a message and wait for all agents to become idle.
+     */
+    sendAndWaitForIdle(content: string, opts?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    /**
+     * Get all events from the event store for this session.
+     */
+    getEvents(): Promise<DomainEvent[]>;
+    /**
+     * Get events filtered by type.
+     * When called with an EventsFactory, returns fully typed events.
+     */
+    getEventsByType(type: string): Promise<DomainEvent[]>;
+    getEventsByType<TEventsMap extends Record<string, DomainEvent>, K extends string & keyof TEventsMap>(factory: {
+        Events: TEventsMap;
+    }, type: K): Promise<TEventsMap[K][]>;
+    /**
+     * Get notifications for this session.
+     */
+    getNotifications(): PluginNotification[];
+    /**
+     * Get the current session state.
+     */
+    get state(): SessionState;
+    /**
+     * Get the entry agent ID.
+     */
+    getEntryAgentId(): AgentId | null;
+    /**
+     * Close the session.
+     */
+    close(): Promise<void>;
+    /**
+     * Call a plugin method on the underlying session.
+     */
+    callPluginMethod(method: string, input: unknown): Promise<Result<unknown, DomainError>>;
+    /**
+     * Answer a user-chat question (convenience wrapper around callPluginMethod).
+     */
+    answerQuestion(agentId: AgentId, questionId: string, answer: unknown): Promise<void>;
+}
+//# sourceMappingURL=test-harness.d.ts.map

package/dist/testing/test-harness.d.ts.map

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

package/dist/testing/test-harness.test.d.ts

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

package/dist/testing/test-harness.test.d.ts.map

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

package/dist/testing/wait-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { AgentId } from '../core/agents/schema.js';
+import type { Session } from '../core/sessions/session.js';
+/**
+ * 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 declare function waitForAgentIdle(session: Session, agentId: AgentId, opts?: {
+    timeoutMs?: number;
+}): Promise<void>;
+/**
+ * Wait for all agents in a session to become idle.
+ */
+export declare function waitForAllAgentsIdle(session: Session, opts?: {
+    timeoutMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=wait-helpers.d.ts.map

package/dist/testing/wait-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-helpers.d.ts","sourceRoot":"","sources":["../../src/testing/wait-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAKzD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/transport/adapter/client-adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 type { IWebSocketFactory, ReconnectOptions } from '@roj-ai/transport';
+import type { Logger } from '../../lib/logger/logger.js';
+import type { IAgentTransport, PluginNotification } from './types.js';
+export interface ClientAdapterConfig {
+    url: string;
+    wsFactory: IWebSocketFactory;
+    reconnect?: Partial<ReconnectOptions>;
+    logger?: Logger;
+}
+export declare class ClientAdapter implements IAgentTransport {
+    private readonly config;
+    private readonly connection;
+    private readonly logger?;
+    private heartbeatTimer;
+    constructor(config: ClientAdapterConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private startHeartbeat;
+    private stopHeartbeat;
+    broadcast(notification: PluginNotification): void;
+}
+//# sourceMappingURL=client-adapter.d.ts.map

package/dist/transport/adapter/client-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-adapter.d.ts","sourceRoot":"","sources":["../../../src/transport/adapter/client-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAe,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAErE,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,iBAAiB,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,aAAc,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAQ;IAChC,OAAO,CAAC,cAAc,CAA8C;gBAExD,MAAM,EAAE,mBAAmB;IAejC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,SAAS,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;CAQjD"}

package/dist/transport/adapter/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transport Adapter Module
+ *
+ * Simplified for broadcast-only WebSocket communication.
+ * User messages and answers are handled via REST API.
+ */
+export type { IAgentTransport, PluginNotification } from './types.js';
+export { ServerAdapter } from './server-adapter.js';
+export type { ServerAdapterConfig } from './server-adapter.js';
+export { ClientAdapter } from './client-adapter.js';
+export type { ClientAdapterConfig } from './client-adapter.js';
+import { type ClientAdapterConfig } from './client-adapter.js';
+import { type ServerAdapterConfig } from './server-adapter.js';
+import type { IAgentTransport } from './types.js';
+export interface StandaloneConfig extends ServerAdapterConfig {
+    mode: 'standalone';
+}
+export interface WorkerConfig extends ClientAdapterConfig {
+    mode: 'worker';
+}
+export type AgentTransportConfig = StandaloneConfig | WorkerConfig;
+export declare function createAgentTransport(config: AgentTransportConfig): IAgentTransport;
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC5D,IAAI,EAAE,YAAY,CAAA;CAClB;AAED,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACxD,IAAI,EAAE,QAAQ,CAAA;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,CAAA;AAElE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAQlF"}

package/dist/transport/adapter/server-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Server Adapter
+ *
+ * Standalone mode - agent is the WebSocket server.
+ * Simplified for broadcast-only communication (agent -> SPA).
+ * User messages and answers are handled via REST API.
+ */
+import type { IServerWebSocket } from '@roj-ai/transport';
+import { ConnectionManager } from '@roj-ai/transport/server';
+import type { Logger } from '../../lib/logger/logger.js';
+import type { IAgentTransport, PluginNotification } from './types.js';
+export interface ServerAdapterConfig {
+    logger?: Logger;
+}
+export declare class ServerAdapter implements IAgentTransport {
+    private readonly connectionManager;
+    private readonly logger?;
+    private readonly wsToConnectionId;
+    constructor(config?: ServerAdapterConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    broadcast(notification: PluginNotification): void;
+    handleOpen(ws: IServerWebSocket, sessionId?: string): void;
+    handleClose(ws: IServerWebSocket, code: number, reason: string): void;
+    handleMessage(ws: IServerWebSocket, message: string): void;
+    handleError(_ws: IServerWebSocket, error: Error): void;
+    getConnectionManager(): ConnectionManager;
+}
+//# sourceMappingURL=server-adapter.d.ts.map

package/dist/transport/adapter/server-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-adapter.d.ts","sourceRoot":"","sources":["../../../src/transport/adapter/server-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,0BAA0B,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAErE,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,aAAc,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0C;gBAE/D,MAAM,GAAE,mBAAwB;IAKtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,SAAS,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAgBjD,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB1D,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASrE,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1D,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAItD,oBAAoB,IAAI,iBAAiB;CAGzC"}

package/dist/transport/adapter/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Agent Transport Types
+ *
+ * Simplified for broadcast-only WebSocket communication.
+ * User messages and answers are handled via REST API.
+ */
+import type { PluginNotification } from '../../core/plugins/plugin-builder.js';
+export type { PluginNotification };
+export interface IAgentTransport {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    broadcast(notification: PluginNotification): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/adapter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/transport/adapter/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAE1E,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAMlC,MAAM,WAAW,eAAe;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,SAAS,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAA;CACjD"}

package/dist/transport/http/app.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Hono App Setup
+ *
+ * Creates the main HTTP application with middleware and routes.
+ */
+import { Hono } from 'hono';
+import type { PreprocessorRegistry } from '../../plugins/uploads/preprocessor.js';
+import type { Services } from '../../bootstrap.js';
+import type { SessionManager } from '../../core/sessions/session-manager.js';
+/**
+ * Extended services with SessionManager for HTTP routes.
+ */
+export type AppServices = Services & {
+    sessionRuntime: SessionManager;
+    /** Bearer token for authenticating HTTP requests. Optional - only used in worker mode. */
+    agentToken?: string;
+    /** File preprocessor registry for upload routes. Optional - only available when uploads plugin is configured. */
+    preprocessorRegistry?: PreprocessorRegistry;
+};
+/**
+ * Environment type for Hono app with injected services.
+ */
+export type AppEnv = {
+    Variables: {
+        services: AppServices;
+    };
+};
+/**
+ * Hono context type for routes.
+ */
+export type AppContext = import('hono').Context<AppEnv>;
+/**
+ * Type-safe accessor for services from Hono context.
+ * Guarantees services are present (set by middleware).
+ */
+export declare function getServices(c: AppContext): AppServices;
+/**
+ * Creates the Hono application with all middleware and routes.
+ */
+export declare function createApp(services: AppServices): Hono<AppEnv>;
+//# sourceMappingURL=app.d.ts.map

package/dist/transport/http/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/transport/http/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAQ5E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG;IACpC,cAAc,EAAE,cAAc,CAAA;IAC9B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iHAAiH;IACjH,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAC3C,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE;QACV,QAAQ,EAAE,WAAW,CAAA;KACrB,CAAA;CACD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW,CAEtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CA0E7D"}

package/dist/transport/http/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HTTP module exports
+ */
+export { createApp } from './app.js';
+export type { AppEnv } from './app.js';
+export { errorHandler } from './middleware/error-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/http/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/transport/http/middleware/bearer-auth.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bearer Auth Middleware
+ *
+ * Validates Authorization: Bearer <token> header against configured agentToken.
+ * Only active when agentToken is configured (worker mode).
+ */
+import type { MiddlewareHandler } from 'hono';
+import type { AppEnv } from '../app.js';
+/**
+ * Creates bearer auth middleware.
+ * Returns 401 if token is invalid or missing (when required).
+ *
+ * @param expectedToken - The expected bearer token. If undefined, middleware is a no-op.
+ */
+export declare function createBearerAuth(expectedToken: string | undefined): MiddlewareHandler<AppEnv>;
+//# sourceMappingURL=bearer-auth.d.ts.map

package/dist/transport/http/middleware/bearer-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bearer-auth.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/middleware/bearer-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAuB7F"}

package/dist/transport/http/middleware/error-handler.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error Handler Middleware
+ *
+ * Handles all errors thrown during request processing:
+ * - HTTPException from Hono
+ * - Domain errors from business logic (self-describing with httpStatus)
+ * - Validation errors from Zod
+ * - Unknown errors (logged and returned as 500)
+ */
+import type { Context } from 'hono';
+import type { AppEnv } from '../app.js';
+/**
+ * Global error handler for Hono app.
+ */
+export declare const errorHandler: (error: Error, c: Context<AppEnv>) => Response & import("hono").TypedResponse<{
+    error: {
+        type: string;
+        message: string;
+    };
+}, 400 | 100 | 500 | 404 | 409 | -1 | 429 | 401 | 200 | 501 | 201 | 102 | 103 | 202 | 203 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 305 | 306 | 307 | 308 | 402 | 403 | 405 | 406 | 407 | 408 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 431 | 451 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511, "json">;
+//# sourceMappingURL=error-handler.d.ts.map