@recombine-ai/bosun 0.16.0 → 0.16.2-cloud-1

package/dist/types/lib/steps.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Recognises the name of an agent's primary conversational step. This is the single definition of
+ * that convention in Bosun — everywhere else should call this rather than test names inline, so the
+ * convention can change in one place.
+ *
+ * Projects name the step `main`, or `main[<anything>]` when they need several variants of it — for
+ * example one per region. **The bracket contents are opaque to Bosun.** What a project puts inside
+ * is its own business, so Bosun recognises the shape and never parses the inside. It follows that
+ * Bosun cannot tell which variant is "active"; where one has to be chosen, it simply takes the
+ * first match.
+ *
+ * `mainReply` is kept as a legacy alias for projects that used it.
+ */
+export declare function isMainStepName(name: string | null | undefined): boolean;

package/dist/types/lib/tests/pii-sanitized-test-draft.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const TraceTestSeedSchema: z.ZodObject<{
+    pinned: z.ZodLiteral<"TRUE">;
+    step: z.ZodOptional<z.ZodString>;
+    evaluation_mode: z.ZodEnum<{
+        assertion: "assertion";
+        "json-deep-equal": "json-deep-equal";
+    }>;
+    context_mode: z.ZodLiteral<"replace">;
+    assertion_type: z.ZodLiteral<"llm-rubric">;
+    assertion_value: z.ZodString;
+    conversation: z.ZodString;
+    expected_output: z.ZodString;
+    similarity_threshold: z.ZodString;
+    timeout: z.ZodString;
+    context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    mocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type TraceTestSeed = z.infer<typeof TraceTestSeedSchema>;
+export declare const TraceTestReviewContentSchema: z.ZodObject<{
+    conversation: z.ZodString;
+    expected_output: z.ZodString;
+    context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    mocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type TraceTestReviewContent = z.infer<typeof TraceTestReviewContentSchema>;
+export declare const PIIFindingCategorySchema: z.ZodEnum<{
+    person: "person";
+    contact: "contact";
+    address: "address";
+    date_of_birth: "date_of_birth";
+    account_identifier: "account_identifier";
+    vehicle_identifier: "vehicle_identifier";
+    financial: "financial";
+    special_category: "special_category";
+    other: "other";
+}>;
+export declare const PIIFindingSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        person: "person";
+        contact: "contact";
+        address: "address";
+        date_of_birth: "date_of_birth";
+        account_identifier: "account_identifier";
+        vehicle_identifier: "vehicle_identifier";
+        financial: "financial";
+        special_category: "special_category";
+        other: "other";
+    }>;
+    paths: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type PIIFinding = z.infer<typeof PIIFindingSchema>;

package/dist/types/lib/ws-message.d.ts

@@ -0,0 +1,41 @@
+import type { Message } from '@recombine-ai/engine';
+import type { ConversationEntry } from './conversation';
+export type Severity = 'INFO' | 'DEBUG' | 'ERROR' | 'WARNING';
+export interface LogEntry {
+    message: string;
+    severity: Severity;
+}
+export type PromptOverrides = Record<string, string>;
+/** Browser -> server. Every request carries everything the server needs to run one turn. */
+export type WsRequest = {
+    type: 'start';
+    agentId: string;
+    conversationId: string;
+    promptOverrides?: PromptOverrides;
+} | {
+    type: 'message';
+    agentId: string;
+    conversationId: string;
+    message: Message;
+    promptOverrides?: PromptOverrides;
+} | {
+    type: 'hangup';
+    agentId: string;
+    conversationId: string;
+};
+/** Server -> browser. `conversationId` lets a client ignore turns it is not looking at. */
+export type WsEvent = {
+    type: 'turn-started';
+    conversationId: string;
+} | {
+    type: 'turn-finished';
+    conversationId: string;
+} | {
+    type: 'entry';
+    conversationId: string;
+    entry: ConversationEntry;
+} | {
+    type: 'error';
+    conversationId: string | null;
+    message: string;
+};

package/package.json

@@ -1,26 +1,26 @@
 {
 	"name": "@recombine-ai/bosun",
 	"author": "recombine.ai",
-	"version": "0.16.0",
+	"version": "0.16.2-cloud-1",
 	"license": "EULA",
-	"bin": {
-		"bosun": "./bin/bosun.js"
-	},
 	"type": "module",
+	"exports": {
+		".": {
+			"bosun-dev": "./src/backend/index.ts",
+			"types": "./dist/types/backend/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
 	"files": [
+		"dist",
 		"build",
-		"bin",
-		"src/backend",
-		"src/lib",
-		".svelte-kit/tsconfig.json",
-		"tsconfig.json",
 		"README.md"
 	],
 	"scripts": {
-		"dev": "concurrently -n front,back 'npm dev:vite' 'npm dev:ws'",
-		"dev:vite": "vite dev",
-		"dev:ws": "tsx src/backend/server.ts",
-		"build": "vite build",
+		"dev": "vite dev",
+		"build": "npm run build:ui && npm run build:package",
+		"build:ui": "vite build",
+		"build:package": "node scripts/build-package.js && tsc -p tsconfig.build.json",
 		"prepublishOnly": "npm run build",
 		"prepare": "husky",
 		"preview": "vite preview",
@@ -33,15 +33,9 @@
 		"test:unit": "vitest",
 		"test": "npm test:unit -- --run && npm test:e2e",
 		"test:e2e": "playwright test",
-		"start": "concurrently -n front,back 'vite preview --host' 'tsx src/backend/server.ts'",
-		"kill": "kill -9 $(lsof -t -i:${PUBLIC_WS_PORT:-8080}) || true",
 		"eslint": "eslint --quiet",
 		"eslint:fix": "eslint --fix"
 	},
-	"engines": {
-		"node": ">=24",
-		"npm": ">=11"
-	},
 	"overrides": {
 		"glob@<10": ">=10.4.5",
 		"rimraf@<5": ">=5.0.0",
@@ -49,70 +43,72 @@
 		"fetch-blob": ">=4.0.0",
 		"formdata-node": ">=6.0.0",
 		"esbuild@<=0.24.2": ">=0.25.0",
-		"cookie@<0.7.0": ">=0.7.0",
+		"cookie@<0.7.0": "^0.7.0",
 		"tmp@<=0.2.3": ">=0.2.4"
 	},
 	"devDependencies": {
 		"@eslint/js": "^9.26.0",
-		"@sveltejs/adapter-auto": "^3.0.0",
-		"@sveltejs/adapter-node": "^5.2.9",
+		"@iconify/svelte": "^5.0.2",
+		"@popperjs/core": "^2.11.8",
+		"@recombine-ai/bosun-lib": "0.2.2",
+		"@recombine-ai/engine": "^1.1.0",
+		"@recombine-ai/telescope": "0.2.1",
+		"@sveltejs/adapter-static": "^3.0.10",
 		"@sveltejs/kit": "^2.0.0",
-		"@sveltejs/vite-plugin-svelte": "^4.0.0",
+		"@sveltejs/vite-plugin-svelte": "^7.3.0",
+		"@tailwindcss/forms": "^0.5.9",
+		"@tailwindcss/typography": "^0.5.15",
 		"@types/he": "^1.2.3",
 		"@types/js-yaml": "^4.0.9",
 		"@types/nunjucks": "^3.2.6",
+		"@types/papaparse": "^5.3.16",
 		"@types/ws": "^8.5.14",
 		"@typescript-eslint/eslint-plugin": "^8.32.0",
 		"autoprefixer": "^10.4.20",
-		"concurrently": "^9.1.2",
+		"bits-ui": "^1.0.0",
+		"deep-object-diff": "^1.1.9",
+		"deepmerge": "^4.3.1",
 		"esbuild": "^0.27.0",
 		"eslint": "^9.26.0",
 		"husky": "^9.1.7",
 		"lint-staged": "^16.2.4",
-		"prettier": "^3.3.2",
+		"moment": "^2.30.1",
+		"monaco-editor": "^0.52.2",
+		"nunjucks": "^3.2.4",
+		"openai": "^6.49.0",
+		"papaparse": "^5.5.3",
+		"prettier": "3.4.2",
 		"prettier-plugin-svelte": "^3.2.6",
 		"prettier-plugin-tailwindcss": "^0.6.5",
 		"svelte": "^5.0.0",
 		"svelte-check": "^4.0.0",
+		"svelte-dnd-action": "^0.9.50",
+		"tailwindcss": "^3.4.9",
 		"tsconfig-paths": "^4.2.0",
+		"tsx": "^4.20.6",
 		"typescript": "^5.0.0",
 		"typescript-eslint": "^8.32.0",
-		"vite": "^5.4.11",
-		"vitest": "^2.0.4"
+		"vis-data": "^8.0.3",
+		"vis-timeline": "^8.5.0",
+		"vite": "^8.2.2",
+		"vitest": "^4.1.11",
+		"xss": "^1.0.15"
+	},
+	"peerDependencies": {
+		"@recombine-ai/bosun-lib": "^0.2.2",
+		"@recombine-ai/engine": "^1.1.0",
+		"@recombine-ai/telescope": "^0.2.1",
+		"openai": "^6"
 	},
 	"dependencies": {
-		"@iconify/svelte": "^5.0.2",
-		"@popperjs/core": "^2.11.8",
-		"@recombine-ai/bosun-lib": "0.2.2",
-		"@recombine-ai/engine": "1.0.0",
-		"@recombine-ai/telescope": "0.2.1",
-		"@tailwindcss/forms": "^0.5.9",
-		"@tailwindcss/typography": "^0.5.15",
 		"@trpc/client": "^11.7.1",
 		"@trpc/server": "^11.7.1",
-		"@types/papaparse": "^5.3.16",
-		"bits-ui": "^1.0.0",
-		"deep-object-diff": "^1.1.9",
-		"deepmerge": "^4.3.1",
-		"dotenv": "^17.2.2",
-		"glob": "^11.0.3",
-		"googleapis": "^159.0.0",
 		"he": "^1.2.0",
 		"js-yaml": "^4.1.0",
-		"moment": "^2.30.1",
-		"monaco-editor": "^0.52.2",
-		"nunjucks": "^3.2.4",
-		"openai": "^4.78.1",
-		"papaparse": "^5.5.3",
-		"promptfoo": "0.112.3",
-		"svelte-dnd-action": "^0.9.50",
-		"tailwindcss": "^3.4.9",
-		"tsx": "^4.20.6",
-		"vis-data": "^8.0.3",
-		"vis-timeline": "^8.5.0",
+		"promptfoo": "^0.122.0",
+		"sirv": "^3.0.2",
 		"ws": "^8.18.0",
-		"xss": "^1.0.15",
-		"zod": "3.24.1"
+		"zod": "^4.4.3"
 	},
 	"husky": {
 		"hooks": {}

package/.svelte-kit/tsconfig.json

@@ -1,59 +0,0 @@
-{
-	"compilerOptions": {
-		"paths": {
-			"$lib": [
-				"../src/lib"
-			],
-			"$lib/*": [
-				"../src/lib/*"
-			],
-			"$app/types": [
-				"./types/index.d.ts"
-			]
-		},
-		"rootDirs": [
-			"..",
-			"./types"
-		],
-		"verbatimModuleSyntax": true,
-		"isolatedModules": true,
-		"lib": [
-			"esnext",
-			"DOM",
-			"DOM.Iterable"
-		],
-		"moduleResolution": "bundler",
-		"module": "esnext",
-		"noEmit": true,
-		"target": "esnext",
-		"types": [
-			"node"
-		]
-	},
-	"include": [
-		"ambient.d.ts",
-		"env.d.ts",
-		"non-ambient.d.ts",
-		"./types/**/$types.d.ts",
-		"../vite.config.js",
-		"../vite.config.ts",
-		"../src/**/*.js",
-		"../src/**/*.ts",
-		"../src/**/*.svelte",
-		"../test/**/*.js",
-		"../test/**/*.ts",
-		"../test/**/*.svelte",
-		"../tests/**/*.js",
-		"../tests/**/*.ts",
-		"../tests/**/*.svelte"
-	],
-	"exclude": [
-		"../node_modules/**",
-		"../src/service-worker.js",
-		"../src/service-worker/**/*.js",
-		"../src/service-worker.ts",
-		"../src/service-worker/**/*.ts",
-		"../src/service-worker.d.ts",
-		"../src/service-worker/**/*.d.ts"
-	]
-}

package/bin/bosun.js

@@ -1,319 +0,0 @@
-#!/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 { 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 {
-		checkBosunLibVersionMatch()
-		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.')
-
-	const tsxBin = process.platform === 'win32' ? 'tsx.cmd' : 'tsx'
-	const tsxPath = resolve(rootDir, 'node_modules', '.bin', tsxBin)
-	const serverPath = resolve(rootDir, 'src', 'backend', 'server.ts')
-	const command = process.platform === 'win32' ? tsxPath : process.execPath
-	const commandArgs = process.platform === 'win32' ? [serverPath] : [tsxPath, 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', '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/bosun')
-}
-
-function checkBosunLibVersionMatch() {
-	const pkg = '@recombine-ai/bosun-lib'
-
-	const rootPkgPath = resolve(rootDir, 'package.json')
-	const rootPkg = JSON.parse(readFileSync(rootPkgPath, 'utf8'))
-	const rootVersion = (rootPkg.dependencies ?? {})[pkg] ?? (rootPkg.devDependencies ?? {})[pkg]
-
-	const cwdPkgPath = resolve(process.cwd(), 'package.json')
-	if (!existsSync(cwdPkgPath)) return
-	const cwdPkg = JSON.parse(readFileSync(cwdPkgPath, 'utf8'))
-	const cwdVersion = (cwdPkg.dependencies ?? {})[pkg] ?? (cwdPkg.devDependencies ?? {})[pkg]
-
-	if (rootVersion !== cwdVersion) {
-		throw new Error(
-			`Version mismatch for ${pkg}: Bosun requires ${rootVersion} but the project uses ${cwdVersion}. ` +
-				`Update one of them so they match.`
-		)
-	}
-}
-
-/**
- * @param {number} ms
- */
-function sleep(ms) {
-	return new Promise((r) => setTimeout(r, ms))
-}