@recombine-ai/platform 0.2.6-test.9 → 0.4.0

package/README.md

@@ -1,3 +1,28 @@
-# Bosun Lib
+# @recombine-ai/platform
 
-Bosun conversational agents IDE bindings to agents build on Recombine platform
+The core library for Recombine agent applications. One package holds the areas that were separate
+packages before. Each area has a subpath export:
+
+| Subpath                                      | Area                                                                      |
+| -------------------------------------------- | ------------------------------------------------------------------------- |
+| `@recombine-ai/platform`                     | The platform shapes and their factories, plus the telescope re-export.    |
+| `@recombine-ai/platform/agent`               | The voice and text agent contracts and their factories.                   |
+| `@recombine-ai/platform/engine`              | Agentic workflows: steps, conversations, prompts, Zod structured outputs. |
+| `@recombine-ai/platform/telescope`           | Observability: step, API call, conversational, and latency tracers.       |
+| `@recombine-ai/platform/dockyard`            | The logger, with request context and redaction.                           |
+| `@recombine-ai/platform/call-control`        | LiveKit SIP trunk setup, call control, and transfers.                     |
+| `@recombine-ai/platform/context-cache`       | The per-conversation context cache, in memory or in Redis.                |
+| `@recombine-ai/platform/token-storage`       | The port for a secret token read.                                         |
+| `@recombine-ai/platform/timeout-manager`     | Timeouts for active calls, backed by a context cache.                     |
+| `@recombine-ai/platform/notifications`       | The notification router and its transports.                               |
+| `@recombine-ai/platform/voice-agent-api`     | The HTTP layer of a voice agent service.                                  |
+| `@recombine-ai/platform/text-agent-handlers` | The handlers and ports of a text agent service.                           |
+| `@recombine-ai/platform/steps`               | Reusable workflow steps.                                                  |
+| `@recombine-ai/platform/bosun`               | The bindings that let the Bosun IDE run agents built on this package.     |
+| `@recombine-ai/platform/build`               | The esbuild bundler for the deployable artifacts, run with `rc-build`.    |
+
+An area exports its public names only through its index file. The larger areas have their own
+README with usage examples in their directory under `src/`.
+
+The package holds no cloud SDK. The vendor implementations of the ports are in
+`@recombine-ai/aws-adapters`.

package/bin/bosun.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+// @ts-check
+import { ChildProcess, spawn } from 'child_process'
+import dotenv from 'dotenv'
+import { existsSync, readFileSync } from 'fs'
+import { createServer } from 'net'
+import { resolve, dirname } from 'path'
+import { createRequire } from 'module'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const rootDir = resolve(__dirname, '..')
+
+const args = process.argv.slice(2)
+
+/* ========= Print version and exit ===== */
+if (args.includes('--version') || args.includes('-v')) {
+	const packagePath = resolve(rootDir, 'package.json')
+	const packageJson = JSON.parse(readFileSync(packagePath, 'utf8'))
+	console.log(packageJson.version, isLinked() ? '(linked)' : '')
+	process.exit(0)
+}
+
+/* ========= Start Bosun ============== */
+/** @type {ChildProcess | null} */
+let backendProcess = null
+
+/** @type {ChildProcess | null} */
+let frontendProcess = null
+
+let isShuttingDown = false
+
+const BACKEND_RESTART_EXIT_CODE = 75
+
+const envPath = resolve(process.cwd(), '.env')
+const envConfig = existsSync(envPath) ? dotenv.parse(readFileSync(envPath)) : {}
+const baseEnv = { ...process.env, ...envConfig }
+
+/** @type {{ frontend: number, ws: number, trpc: number } | null} */
+let ports = null
+
+main()
+
+/* ========= Implementation =========== */
+
+async function main() {
+	// Initial start
+	try {
+		ports = await selectPorts()
+
+		// Start backend
+		backendProcess = startBackend()
+
+		if (!args.includes('--backend-only')) {
+			// Start frontend once
+			frontendProcess = startFrontend()
+		}
+		console.log('✅ Bosun started')
+		if (!args.includes('--backend-only')) {
+			console.log(`UI: http://localhost:${ports.frontend}`)
+		}
+		console.log(`WebSocket: ws://localhost:${ports.ws}`)
+		console.log(`tRPC: http://localhost:${ports.trpc}`)
+	} catch (error) {
+		console.error('❌ Error:', String(error))
+		process.exit(1)
+	}
+}
+
+function startBackend() {
+	if (!ports) throw new Error('Ports were not selected before starting the backend.')
+
+	// tsx runs the bundled backend so that the dynamic import of the project workflows
+	// file, which is TypeScript, keeps working.
+	const tsxCli = createRequire(import.meta.url).resolve('tsx/cli')
+	const serverPath = resolve(rootDir, 'build', 'bosun-app', 'backend', 'server.js')
+	const command = process.execPath
+	const commandArgs = [tsxCli, serverPath]
+
+	const child = spawn(command, commandArgs, {
+		cwd: process.cwd(),
+		stdio: 'inherit',
+		env: {
+			...baseEnv,
+			BOSUN_WS_PORT: String(ports.ws),
+			BOSUN_TRPC_PORT: String(ports.trpc),
+			PUBLIC_WS_HOST: `ws://localhost:${ports.ws}`,
+			PUBLIC_WS_PORT: String(ports.ws),
+			PUBLIC_TRPC_URL: `http://localhost:${ports.trpc}`,
+			PUBLIC_TRPC_PORT: String(ports.trpc),
+			BOSUN_NPX_RUN: 'true'
+		},
+		shell: process.platform === 'win32'
+	})
+	watchChild(child, 'backend')
+	return child
+}
+
+function startFrontend() {
+	if (!ports) throw new Error('Ports were not selected before starting the frontend.')
+
+	const frontPath = resolve(rootDir, 'build', 'bosun-app', 'frontend', 'index.js')
+	const bodySizeLimit = baseEnv.BODY_SIZE_LIMIT || 'Infinity'
+
+	const child = spawn(process.execPath, [frontPath], {
+		cwd: process.cwd(),
+		stdio: 'inherit',
+		env: {
+			...baseEnv,
+			HOST: 'localhost',
+			PORT: String(ports.frontend),
+			PUBLIC_WS_HOST: `ws://localhost:${ports.ws}`,
+			PUBLIC_WS_HOSTNAME: 'localhost',
+			PUBLIC_WS_PORT: String(ports.ws),
+			PUBLIC_TRPC_URL: `http://localhost:${ports.trpc}`,
+			PUBLIC_TRPC_HOSTNAME: 'localhost',
+			PUBLIC_TRPC_PORT: String(ports.trpc),
+			// Latency recordings are uploaded as WAV files and can be large.
+			BODY_SIZE_LIMIT: bodySizeLimit
+		},
+		shell: process.platform === 'win32'
+	})
+	watchChild(child, 'frontend')
+	return child
+}
+
+async function selectPorts() {
+	const reserved = new Set()
+
+	const frontend = await findAvailablePort(
+		readPreferredPort(['BOSUN_FRONTEND_PORT', 'BOSUN_PORT'], 5177),
+		reserved
+	)
+	reserved.add(frontend)
+
+	const ws = await findAvailablePort(
+		readPreferredPort(
+			['BOSUN_WS_PORT', 'PUBLIC_WS_PORT'],
+			portFromUrl(baseEnv.PUBLIC_WS_HOST) ?? 8080
+		),
+		reserved
+	)
+	reserved.add(ws)
+
+	const trpc = await findAvailablePort(
+		readPreferredPort(
+			['BOSUN_TRPC_PORT', 'PUBLIC_TRPC_PORT'],
+			portFromUrl(baseEnv.PUBLIC_TRPC_URL) ?? 2022
+		),
+		reserved
+	)
+
+	return { frontend, ws, trpc }
+}
+
+/**
+ * @param {string[]} names
+ * @param {number} fallback
+ */
+function readPreferredPort(names, fallback) {
+	for (const name of names) {
+		const value = baseEnv[name]
+		if (value) return parsePort(value, name)
+	}
+	return fallback
+}
+
+/**
+ * @param {string | undefined} value
+ */
+function portFromUrl(value) {
+	if (!value) return null
+	try {
+		const url = new URL(value)
+		return url.port ? parsePort(url.port, value) : null
+	} catch {
+		return null
+	}
+}
+
+/**
+ * @param {string | number} value
+ * @param {string} source
+ */
+function parsePort(value, source) {
+	const port = Number(value)
+	if (!Number.isInteger(port) || port < 1 || port > 65535) {
+		throw new Error(`Invalid port for ${source}: ${value}`)
+	}
+	return port
+}
+
+/**
+ * @param {number} preferredPort
+ * @param {Set<number>} reserved
+ */
+async function findAvailablePort(preferredPort, reserved) {
+	for (let port = preferredPort; port <= 65535; port++) {
+		if (reserved.has(port)) continue
+		if (await isPortAvailable(port)) return port
+	}
+	throw new Error(`Cannot find an available port at or above ${preferredPort}.`)
+}
+
+/**
+ * @param {number} port
+ */
+function isPortAvailable(port) {
+	return Promise.all([
+		canListenOnPort(port),
+		canListenOnPort(port, '127.0.0.1'),
+		canListenOnPort(port, '::1')
+	]).then((checks) => checks.every(Boolean))
+}
+
+/**
+ * @param {number} port
+ * @param {string} [host]
+ */
+function canListenOnPort(port, host) {
+	return new Promise((resolveAvailable) => {
+		const server = createServer()
+
+		server.once('error', (error) => {
+			if (host === '::1' && isUnsupportedIpv6Error(error)) {
+				resolveAvailable(true)
+				return
+			}
+			resolveAvailable(false)
+		})
+
+		server.once('listening', () => {
+			server.close(() => resolveAvailable(true))
+		})
+
+		server.listen(host ? { port, host } : { port })
+	})
+}
+
+/**
+ * @param {unknown} error
+ */
+function isUnsupportedIpv6Error(error) {
+	return (
+		error instanceof Error &&
+		'code' in error &&
+		(error.code === 'EAFNOSUPPORT' || error.code === 'EINVAL')
+	)
+}
+
+/**
+ * @param {ChildProcess} child
+ * @param {string} name
+ */
+function watchChild(child, name) {
+	child.on('error', (error) => {
+		if (isShuttingDown) return
+		console.error(`❌ Bosun ${name} failed to start:`, error.message)
+		shutdown(1)
+	})
+
+	child.on('exit', (code, signal) => {
+		if (isShuttingDown) return
+		if (name === 'backend' && code === BACKEND_RESTART_EXIT_CODE && !signal) {
+			console.log('🔄 Bosun backend restarting to load project changes')
+			backendProcess = startBackend()
+			return
+		}
+
+		const reason = signal ? `signal ${signal}` : `exit code ${code ?? 1}`
+		console.error(`❌ Bosun ${name} stopped unexpectedly (${reason}).`)
+		shutdown(code ?? 1)
+	})
+}
+
+// Handle cleanup
+process.on('SIGINT', () => shutdown(0))
+process.on('SIGTERM', () => shutdown(0))
+
+/**
+ * @param {number} code
+ */
+function shutdown(code) {
+	isShuttingDown = true
+	if (backendProcess) backendProcess.kill()
+	if (frontendProcess) frontendProcess.kill()
+	process.exit(code)
+}
+
+function isLinked() {
+	return !__filename.includes('node_modules/@recombine-ai/platform')
+}
+
+/**
+ * @param {number} ms
+ */
+function sleep(ms) {
+	return new Promise((r) => setTimeout(r, ms))
+}

package/bin/rc-build.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// The package compiles with extensionless ESM imports, so the bin resolves them through tsx,
+// like the bosun bin.
+import { register } from 'tsx/esm/api'
+
+register()
+const { runCli } = await import('../build/build/cli.js')
+
+runCli(process.argv.slice(2)).catch((error) => {
+    console.error(error instanceof Error ? error.message : error)
+    process.exit(1)
+})

package/build/agent/index.d.ts

@@ -0,0 +1,5 @@
+export { createVoiceAgent } from './voice-agent';
+export type { CallInfo, VoiceAgent } from './voice-agent';
+export { createTextAgent } from './text-agent';
+export type { TextAgent } from './text-agent';
+//# sourceMappingURL=index.d.ts.map

package/build/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/build/agent/index.js

@@ -0,0 +1,2 @@
+export { createVoiceAgent } from './voice-agent';
+export { createTextAgent } from './text-agent';

package/build/agent/text-agent.d.ts

@@ -0,0 +1,14 @@
+import { IModels, TextPlatform } from '../core';
+import { Event } from '../text-agent-handlers';
+export interface TextAgent<TMeta> {
+    name: string;
+    sender: string;
+    startWorkflow(conversationId: string): Promise<void>;
+    isAssigned(conversationId: string): Promise<boolean>;
+    onChatReady(conversationId: string, meta: TMeta): Promise<void>;
+    reactOnMessage(event: Event<TMeta>): Promise<boolean>;
+    respondToMessage(event: Event<TMeta>): Promise<void>;
+    onFatalError(error: Error | string, conversationId?: string): Promise<void>;
+}
+export declare function createTextAgent<TContext extends object, TServices, TMeta, TModels extends IModels>(creator: (platform: TextPlatform<TContext, TModels>, services: TServices) => TextAgent<TMeta>): (platform: TextPlatform<TContext, TModels>, services: TServices) => TextAgent<TMeta>;
+//# sourceMappingURL=text-agent.d.ts.map

package/build/agent/text-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-agent.d.ts","sourceRoot":"","sources":["../../src/agent/text-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAG9C,MAAM,WAAW,SAAS,CAAC,KAAK;IAE5B,IAAI,EAAE,MAAM,CAAA;IAEZ,MAAM,EAAE,MAAM,CAAA;IAId,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAKpD,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAIpD,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAM/D,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAKrD,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAMpD,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9E;AAOD,wBAAgB,eAAe,CAAC,QAAQ,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,SAAS,OAAO,EAC9F,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,IAErF,UAAU,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,UAAU,SAAS,KAAG,SAAS,CAAC,KAAK,CAAC,CA4B5F"}

package/build/agent/text-agent.js

@@ -0,0 +1,28 @@
+import { emitAgentFatalError } from '../telescope';
+import { timed } from './timed';
+function regionOf(event) {
+    const region = event.metadata?.region;
+    return typeof region === 'string' ? region : undefined;
+}
+export function createTextAgent(creator) {
+    return (platform, services) => {
+        const agent = creator(platform, services);
+        const inner = agent.onFatalError.bind(agent);
+        agent.onFatalError = async (error, conversationId) => {
+            emitAgentFatalError(platform.telescope, agent.name, error, conversationId);
+            return inner(error, conversationId);
+        };
+        const innerRespond = agent.respondToMessage.bind(agent);
+        agent.respondToMessage = async (event) => timed(() => innerRespond(event), (latencyMs) => platform.telescope.getEventTracer().emit({
+            event: 'text.latency.full_response',
+            attributes: {
+                conversationId: event.conversationId,
+                agentId: agent.name,
+                latencyMs,
+                channel: event.channel,
+                region: regionOf(event),
+            },
+        }));
+        return agent;
+    };
+}

package/build/agent/timed.d.ts

@@ -0,0 +1,2 @@
+export declare function timed<T>(run: () => Promise<T>, emit: (durationMs: number) => void): Promise<T>;
+//# sourceMappingURL=timed.d.ts.map

package/build/agent/timed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed.d.ts","sourceRoot":"","sources":["../../src/agent/timed.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,CAAC,EACzB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GACnC,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/build/agent/timed.js

@@ -0,0 +1,9 @@
+export async function timed(run, emit) {
+    const startedAt = Date.now();
+    try {
+        return await run();
+    }
+    finally {
+        emit(Date.now() - startedAt);
+    }
+}

package/build/agent/voice-agent.d.ts

@@ -0,0 +1,24 @@
+import { ReadableStream } from 'node:stream/web';
+import type { IModels, VoicePlatform } from '../core';
+import { Message, ResponseChunk } from '../engine';
+export interface CallInfo<TMeta> {
+    callId: string;
+    phoneNumber?: string;
+    meta?: TMeta;
+}
+export interface VoiceAgent<TMeta> {
+    name: string;
+    onServiceStartup: () => Promise<void>;
+    onCallReady: (call: CallInfo<TMeta>) => Promise<void>;
+    onCallStart: (call: CallInfo<TMeta>) => Promise<{
+        initialMessage: string;
+        initialSettings?: Record<string, string | number | string[]>;
+    }>;
+    streamResponse: (messages: Message[], call: CallInfo<TMeta>) => Promise<ReadableStream<ResponseChunk>>;
+    onAgentSpeechDone: (messages: Message[], call: CallInfo<TMeta>) => Promise<void>;
+    onCallEnd: (call: CallInfo<TMeta>) => Promise<void>;
+    onFatalError: (call: CallInfo<TMeta>, err: string | Error) => Promise<void>;
+    handleNotification?: (callId: string, payload: unknown) => Promise<void>;
+}
+export declare function createVoiceAgent<TContext extends object, TServices, TMeta, TModels extends IModels>(creator: (platform: VoicePlatform<TContext, TModels>, services: TServices) => VoiceAgent<TMeta>): (platform: VoicePlatform<TContext, TModels>, services: TServices) => VoiceAgent<TMeta>;
+//# sourceMappingURL=voice-agent.d.ts.map

package/build/agent/voice-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-agent.d.ts","sourceRoot":"","sources":["../../src/agent/voice-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAIlD,MAAM,WAAW,QAAQ,CAAC,KAAK;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,KAAK,CAAA;CACf;AAED,MAAM,WAAW,UAAU,CAAC,KAAK;IAE7B,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC;QAC5C,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;KAC/D,CAAC,CAAA;IACF,cAAc,EAAE,CACZ,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KACpB,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChF,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAK3E,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E;AAID,wBAAgB,gBAAgB,CAC5B,QAAQ,SAAS,MAAM,EACvB,SAAS,EACT,KAAK,EACL,OAAO,SAAS,OAAO,EACzB,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,UAAU,CAAC,KAAK,CAAC,IACrF,UAAU,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,UAAU,SAAS,KAAG,UAAU,CAAC,KAAK,CAAC,CA0B9F"}

package/build/agent/voice-agent.js

@@ -0,0 +1,24 @@
+import { emitAgentFatalError } from '../telescope';
+import { timed } from './timed';
+const ANALYTICAL_WORKFLOW_NAME = 'onAgentSpeechDone';
+export function createVoiceAgent(creator) {
+    return (platform, services) => {
+        const agent = creator(platform, services);
+        const inner = agent.onFatalError.bind(agent);
+        agent.onFatalError = async (call, err) => {
+            emitAgentFatalError(platform.telescope, agent.name, err, call.callId);
+            return inner(call, err);
+        };
+        const innerSpeechDone = agent.onAgentSpeechDone.bind(agent);
+        agent.onAgentSpeechDone = async (messages, call) => timed(() => innerSpeechDone(messages, call), (durationMs) => platform.telescope.getEventTracer().emit({
+            event: 'workflow.analytical.latency',
+            attributes: {
+                conversationId: call.callId,
+                agentId: agent.name,
+                workflowName: ANALYTICAL_WORKFLOW_NAME,
+                durationMs,
+            },
+        }));
+        return agent;
+    };
+}

package/build/bosun/context.d.ts

@@ -0,0 +1,23 @@
+type Ctx = Record<string, any>;
+type Paths<T> = T extends object ? {
+    [K in keyof T]: [K] | [K, ...Paths<T[K]>];
+}[keyof T] : never;
+type PathValue<T, P extends any[]> = P extends [infer First, ...infer Rest] ? First extends keyof T ? Rest['length'] extends 0 ? T[First] : PathValue<T[First], Rest> : never : never;
+declare class Context<T extends Ctx> {
+    #private;
+    constructor(context: T);
+    set<P extends Paths<T>>(path: P extends any[] ? P : never, value: PathValue<T, P>): void;
+    set(newContext: T): void;
+    get(): T;
+    swap(newContext: T): void;
+    subscribe: (listener: (context: T) => void) => () => boolean;
+    setPromptContextMapper(promptMapper: (ctx: T) => object): void;
+    getPromptContextMapper(): (ctx: T) => object;
+}
+export declare function createContext<T extends Ctx>(context: T): Context<T>;
+type Public<T> = {
+    [P in keyof T]: T[P];
+};
+type PublicContext<T extends Ctx> = Public<Context<T>>;
+export type { PublicContext as Context };
+//# sourceMappingURL=context.d.ts.map

package/build/bosun/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/bosun/context.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAC9B,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC1B;KACK,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC,MAAM,CAAC,CAAC,GACV,KAAK,CAAA;AAEX,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GACrE,KAAK,SAAS,MAAM,CAAC,GACjB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GACpB,CAAC,CAAC,KAAK,CAAC,GACR,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAC7B,KAAK,GACT,KAAK,CAAA;AAEX,cAAM,OAAO,CAAC,CAAC,SAAS,GAAG;;gBAIX,OAAO,EAAE,CAAC;IAItB,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IACxF,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI;IAgBxB,GAAG;IAKH,IAAI,CAAC,UAAU,EAAE,CAAC;IAIlB,SAAS,GAAI,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,mBAG1C;IAED,sBAAsB,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM;IAIvD,sBAAsB,UAxCD,CAAC,KAAK,MAAM;CA2CpC;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,OAAO,EAAE,CAAC,cAEtD;AAED,KAAK,MAAM,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAEzC,KAAK,aAAa,CAAC,CAAC,SAAS,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtD,YAAY,EAAE,aAAa,IAAI,OAAO,EAAE,CAAA"}

package/build/bosun/context.js

@@ -0,0 +1,41 @@
+class Context {
+    #listeners = new Set();
+    #context;
+    #promptMapper = (c) => c;
+    constructor(context) {
+        this.#context = context || {};
+    }
+    set(pathOrContext, value) {
+        if (!Array.isArray(pathOrContext)) {
+            this.#context = pathOrContext;
+        }
+        else {
+            const path = pathOrContext;
+            let current = this.#context;
+            for (let i = 0; i < path.length - 1; i++) {
+                current = current[path[i]];
+            }
+            current[path[path.length - 1]] = value;
+        }
+        this.#listeners.forEach((listener) => listener(this.#context));
+    }
+    get() {
+        return this.#context;
+    }
+    swap(newContext) {
+        this.#context = newContext;
+    }
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    };
+    setPromptContextMapper(promptMapper) {
+        this.#promptMapper = promptMapper;
+    }
+    getPromptContextMapper() {
+        return this.#promptMapper;
+    }
+}
+export function createContext(context) {
+    return new Context(context);
+}

package/build/bosun/index.d.ts

@@ -0,0 +1,11 @@
+export { createTestAgentFactory } from './interfaces/agent';
+export type { TestAgent, TestAgentFactory, TestAgentFactoryProps, TestTextAgent, TestVoiceAgent, } from './interfaces/agent';
+export { createContext } from './context';
+export type { Context } from './context';
+export { createMock } from './mock';
+export { makeTestVoiceAgent } from './test-agent';
+export { registerTestableSteps } from './test-step-registry';
+export type { RegisteredTestStep, TestStepInput, TestStepRegistry } from './test-step-registry';
+export { getPlatformMocks } from './std-mocks/platform';
+export { createCallControlMock } from './std-mocks/call-control';
+//# sourceMappingURL=index.d.ts.map

package/build/bosun/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bosun/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA"}

package/build/bosun/index.js

@@ -0,0 +1,7 @@
+export { createTestAgentFactory } from './interfaces/agent';
+export { createContext } from './context';
+export { createMock } from './mock';
+export { makeTestVoiceAgent } from './test-agent';
+export { registerTestableSteps } from './test-step-registry';
+export { getPlatformMocks } from './std-mocks/platform';
+export { createCallControlMock } from './std-mocks/call-control';

package/build/bosun/interfaces/agent.d.ts

@@ -0,0 +1,40 @@
+import type { Logger } from '../../dockyard';
+import { Message, Scheduler } from '../../engine';
+import type { ApiCallTracer, ConversationalTracer, StepTracer } from '../../telescope';
+import { Context } from '../context';
+import type { TestStepRegistry } from '../test-step-registry';
+type DefaultContext = Record<string, any>;
+export interface TestAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    stepRegistry: TestStepRegistry;
+    apiCallTracer?: ApiCallTracer;
+    conversationalTracer?: ConversationalTracer;
+    stepTracer: StepTracer;
+    logger: Logger;
+    scheduler: Scheduler;
+    getMessages: () => Message[];
+    sendMessage: (message: string | Message) => Promise<void>;
+    ctx: Context<CTX>;
+    config: {
+        isTest: boolean;
+        enableTimers: boolean;
+    };
+}
+export interface TestTextAgent {
+    start: () => Promise<unknown>;
+    reactOnMessage: () => Promise<unknown>;
+    respondToMessage: () => Promise<unknown>;
+    isAssigned: () => Promise<boolean>;
+    onFatalError: (error: Error) => Promise<unknown>;
+}
+export interface TestVoiceAgent {
+    streamResponse: () => Promise<unknown>;
+    onCallEnd: () => Promise<unknown>;
+    onCallStart: () => Promise<unknown>;
+    onFatalError: (error: Error) => Promise<unknown>;
+    waitForIdle: () => Promise<void>;
+}
+export type TestAgent = TestTextAgent | TestVoiceAgent;
+export type TestAgentFactory<T extends DefaultContext = DefaultContext> = (props: TestAgentFactoryProps<T>) => Promise<TestAgent>;
+export declare function createTestAgentFactory<T extends DefaultContext>(creator: TestAgentFactory<T>): TestAgentFactory<T>;
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/build/bosun/interfaces/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/bosun/interfaces/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAuB7D,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IAC9E,YAAY,EAAE,gBAAgB,CAAA;IAM9B,aAAa,CAAC,EAAE,aAAa,CAAA;IAM7B,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACjB,MAAM,EAAE;QACJ,MAAM,EAAE,OAAO,CAAA;QACf,YAAY,EAAE,OAAO,CAAA;KACxB,CAAA;CACJ;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7B,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,gBAAgB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,cAAc;IAC3B,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACjC,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,CAAA;AAEtD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CACtE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,SAAS,CAAC,CAAA;AAEvB,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,uBAE5F"}

package/build/bosun/interfaces/agent.js

@@ -0,0 +1,3 @@
+export function createTestAgentFactory(creator) {
+    return creator;
+}

package/build/bosun/mock.d.ts

@@ -0,0 +1,6 @@
+import type { Logger } from '../dockyard';
+type ConstructorType<T> = new (...args: any[]) => T;
+type InstanceType<T extends ConstructorType<any>> = T extends new (...args: any[]) => infer R ? R : never;
+export declare function createMock<T extends ConstructorType<any>>(logger: Logger, constructor: T, overrides?: Partial<InstanceType<T>>): InstanceType<T>;
+export {};
+//# sourceMappingURL=mock.d.ts.map

package/build/bosun/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/bosun/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,KAAK,eAAe,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AACnD,KAAK,YAAY,CAAC,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACvF,CAAC,GACD,KAAK,CAAA;AAEX,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACrD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,EACd,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACrC,YAAY,CAAC,CAAC,CAAC,CAuBjB"}