@recombine-ai/bosun-lib 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# Bosun Lib
+
+Bosun conversational agents IDE bindings to agents build on Recombine platform

package/build/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/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/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/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/context.spec.d.ts

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

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

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

package/build/context.spec.js

@@ -0,0 +1,21 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createContext } from './context';
+describe('ws-server/context', () => {
+    it('sets a value at a path', () => {
+        const ctx = createContext({ a: { b: 1 } });
+        ctx.set(['a', 'b'], 2);
+        expect(ctx.get()).toEqual({ a: { b: 2 } });
+    });
+    it('sets a new context', () => {
+        const ctx = createContext({ a: { b: 1 } });
+        ctx.set({ a: { b: 2 } });
+        expect(ctx.get()).toEqual({ a: { b: 2 } });
+    });
+    it('subscribes to context changes', () => {
+        const ctx = createContext({ a: { b: 1 } });
+        const listener = vi.fn();
+        ctx.subscribe(listener);
+        ctx.set(['a', 'b'], 2);
+        expect(listener).toHaveBeenCalledWith({ a: { b: 2 } });
+    });
+});

package/build/index.d.ts

@@ -0,0 +1,7 @@
+export * from './interfaces/agent';
+export * from './context';
+export * from './mock';
+export * from './test-agent';
+export * from './std-mocks/platform';
+export * from './std-mocks/rc-voice';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/build/index.js

@@ -0,0 +1,6 @@
+export * from './interfaces/agent';
+export * from './context';
+export * from './mock';
+export * from './test-agent';
+export * from './std-mocks/platform';
+export * from './std-mocks/rc-voice';

package/build/index.test.d.ts

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

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

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

package/build/interfaces/agent.d.ts

@@ -0,0 +1,39 @@
+import { Message, Scheduler, StepRegistry } from '@recombine-ai/engine';
+import type { ApiCallTracer, ConversationalTracer, StepTracer } from '@recombine-ai/telescope';
+import { Context } from '../context';
+import { Logger } from './dockyard';
+type DefaultContext = Record<string, any>;
+export interface TestAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    stepRegistry: StepRegistry;
+    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/interfaces/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAE9F,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAuBnC,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IAC9E,YAAY,EAAE,YAAY,CAAA;IAM1B,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/interfaces/agent.js

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

package/build/interfaces/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/interfaces/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/interfaces/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/interfaces/dockyard.d.ts

@@ -0,0 +1,6 @@
+export interface Logger {
+    log: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+//# sourceMappingURL=dockyard.d.ts.map

package/build/interfaces/dockyard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockyard.d.ts","sourceRoot":"","sources":["../../src/interfaces/dockyard.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACnB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAClC"}

package/build/interfaces/dockyard.js

@@ -0,0 +1 @@
+export {};

package/build/interfaces/mock.d.ts

@@ -0,0 +1,6 @@
+import { 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/interfaces/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/interfaces/mock.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,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"}

package/build/interfaces/other.d.ts

@@ -0,0 +1,19 @@
+export type ScheduleAction = (delay: Date, phone: string) => Promise<void>;
+export interface Scheduler {
+    registerAction: (actionName: string, action: (phone: string) => Promise<unknown>) => ScheduleAction;
+    clearAllPendingActions: (phone: string) => Promise<unknown>;
+}
+export interface PromptFile {
+    type: 'file';
+    content: () => Promise<string>;
+    path: string;
+}
+export interface PromptFS {
+    loadFile(path: string): PromptFile;
+}
+export interface Message {
+    sender: 'user' | 'agent' | 'system';
+    text: string;
+    imageUrl?: string;
+}
+//# sourceMappingURL=other.d.ts.map

package/build/interfaces/other.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../src/interfaces/other.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1E,MAAM,WAAW,SAAS;IAOtB,cAAc,EAAE,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC1C,cAAc,CAAA;IAKnB,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;CACrC;AASD,MAAM,WAAW,OAAO;IAEpB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAEnC,IAAI,EAAE,MAAM,CAAA;IAEZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/build/interfaces/step-registry.d.ts

@@ -0,0 +1,16 @@
+import { type ZodType } from 'zod';
+import { PromptFile } from './other';
+export interface PromptString {
+    type: 'string';
+    content: () => Promise<string>;
+}
+export interface StepDef {
+    name: string;
+    type: 'streaming-response' | 'streaming-detect' | 'text';
+    prompt: PromptFile | PromptString;
+    schema?: ZodType;
+}
+export interface StepRegistry {
+    addStep(def: StepDef): void;
+}
+//# sourceMappingURL=step-registry.d.ts.map

package/build/interfaces/step-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-registry.d.ts","sourceRoot":"","sources":["../../src/interfaces/step-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,MAAM,CAAA;IACxD,MAAM,EAAE,UAAU,GAAG,YAAY,CAAA;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;CAC9B"}

package/build/mock.d.ts

@@ -0,0 +1,6 @@
+import { Logger } from './interfaces/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/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C,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"}

package/build/mock.js

@@ -0,0 +1,28 @@
+import { inspect } from 'node:util';
+export function createMock(logger, constructor, overrides) {
+    const mock = Object.create(constructor.prototype);
+    const properties = Object.getOwnPropertyDescriptors(constructor.prototype);
+    for (const [key, descriptor] of Object.entries(properties)) {
+        if (typeof descriptor.value === 'function' && key !== 'constructor') {
+            mock[key] = function (...args) {
+                let returnValue = {};
+                if (overrides && key in overrides && typeof overrides[key] === 'function') {
+                    returnValue = overrides[key](...args);
+                }
+                const logs = [`${constructor.name}.${key}\n\tCalled with:`, prettyArgs(args)];
+                if (returnValue) {
+                    logs.push(`\n\tReturning: ${prettyInspect(returnValue)}`);
+                }
+                logger.log(...logs);
+                return returnValue;
+            };
+        }
+    }
+    return mock;
+}
+function prettyArgs(args) {
+    return args.map((arg) => (typeof arg === 'object' ? prettyInspect(arg) : arg)).join(' ');
+}
+function prettyInspect(obj) {
+    return inspect(obj, { depth: null }).split('\n').join('\n\t');
+}

package/build/std-mocks/platform.d.ts

@@ -0,0 +1,8 @@
+import { IModels, Platform } from '@recombine-ai/platform';
+import { TestAgentFactoryProps, TestVoiceAgent } from '../interfaces/agent';
+export declare function getPlatformMocks<TContext extends {}, TModels extends IModels>(props: TestAgentFactoryProps<any>, models: TModels, basePath: string): Promise<{
+    platform: Platform<TContext, TModels>;
+    setLoopBack(this: void, bosunAgent: TestVoiceAgent): void;
+    waitForIdle: () => Promise<void>;
+}>;
+//# sourceMappingURL=platform.d.ts.map

package/build/std-mocks/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/std-mocks/platform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAuC,MAAM,wBAAwB,CAAA;AAE/F,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAG3E,wBAAsB,gBAAgB,CAAC,QAAQ,SAAS,EAAE,EAAE,OAAO,SAAS,OAAO,EAC/E,KAAK,EAAE,qBAAqB,CAAC,GAAG,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM;;sBAoCM,IAAI,cAAc,cAAc;;GAMzD"}

package/build/std-mocks/platform.js

@@ -0,0 +1,37 @@
+import { createAIEngine, createAIStreamEngine, createLocalFS } from '@recombine-ai/engine';
+import { TimeoutManager, createInMemoryCache } from '@recombine-ai/platform';
+import { createRcVoiceMock } from './rc-voice';
+export async function getPlatformMocks(props, models, basePath) {
+    const streamAi = createAIStreamEngine({
+        logger: props.logger,
+        stepRegistry: props.stepRegistry,
+        stepTracer: props.stepTracer,
+    });
+    const ai = createAIEngine({
+        logger: props.logger,
+        stepRegistry: props.stepRegistry,
+        stepTracer: props.stepTracer,
+    });
+    const rcVoiceMock = createRcVoiceMock(props);
+    const platform = {
+        streamAi,
+        ai,
+        fs: createLocalFS({
+            logger: props.logger,
+            basePath,
+        }),
+        logger: props.logger,
+        rcVoice: rcVoiceMock.rcVoice,
+        timeoutManager: new TimeoutManager(createInMemoryCache(), props.logger, !props.config.enableTimers),
+        contextCache: createInMemoryCache(),
+        ...models,
+    };
+    return {
+        platform,
+        setLoopBack(bosunAgent) {
+            rcVoiceMock.setCallEnd(bosunAgent.onCallEnd);
+            rcVoiceMock.setReload(bosunAgent.streamResponse);
+        },
+        waitForIdle: rcVoiceMock.waitForIdle,
+    };
+}

package/build/std-mocks/rc-voice.d.ts

@@ -0,0 +1,11 @@
+import { IRcVoice, VoiceAgentConnector } from '@recombine-ai/platform';
+import { TestAgentFactoryProps } from '../interfaces/agent';
+interface RcVoiceCompatibleMock {
+    rcVoice: IRcVoice & VoiceAgentConnector;
+    waitForIdle: () => Promise<void>;
+    setReload: (_onReload: () => Promise<unknown>) => void;
+    setCallEnd: (_onReload: () => Promise<unknown>) => void;
+}
+export declare function createRcVoiceMock(props: TestAgentFactoryProps<object>): RcVoiceCompatibleMock;
+export {};
+//# sourceMappingURL=rc-voice.d.ts.map

package/build/std-mocks/rc-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-voice.d.ts","sourceRoot":"","sources":["../../src/std-mocks/rc-voice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAkB,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,UAAU,qBAAqB;IAC3B,OAAO,EAAE,QAAQ,GAAG,mBAAmB,CAAA;IACvC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IACtD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAC1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAiI7F"}

package/build/std-mocks/rc-voice.js

@@ -0,0 +1,137 @@
+export function createRcVoiceMock(props) {
+    let onReload;
+    let onCallEnd;
+    let inFlight = 0;
+    let idleResolvers = [];
+    function trackReload() {
+        inFlight++;
+        setTimeout(() => {
+            onReload?.()
+                .catch((err) => {
+                props.logger.error('RcVoice: reload failed', { err });
+            })
+                .finally(() => {
+                inFlight--;
+                if (inFlight === 0) {
+                    const resolvers = idleResolvers;
+                    idleResolvers = [];
+                    resolvers.forEach((r) => r());
+                }
+            });
+        });
+    }
+    function waitForIdle() {
+        if (inFlight === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => idleResolvers.push(resolve));
+    }
+    return {
+        rcVoice: {
+            async hangup(callId) {
+                await onCallEnd?.();
+                props.conversationalTracer?.addConversationalTrace({
+                    conversationId: callId,
+                    eventName: 'hangup-requested',
+                    role: 'agent',
+                    medium: 'phone',
+                    content: 'hangup',
+                    createdAt: Date.now(),
+                });
+                await props.conversationalTracer?.flush();
+            },
+            async transfer(destOrName, callIdOdDest, headersOrCallId) {
+                let callId = callIdOdDest;
+                let destination = destOrName;
+                if (typeof headersOrCallId === 'string') {
+                    callId = headersOrCallId;
+                    destination = callIdOdDest;
+                }
+                props.conversationalTracer?.addConversationalTrace({
+                    conversationId: callId,
+                    eventName: 'transfer-requested',
+                    role: 'agent',
+                    medium: 'phone',
+                    content: destination,
+                    createdAt: Date.now(),
+                });
+                await props.conversationalTracer?.flush();
+            },
+            async reload(_) {
+                props.logger.log('RcVoice: reload');
+                await sleep(100);
+                trackReload();
+            },
+            async addMessage(_, message) {
+                await sleep(500);
+                await props.sendMessage(message);
+            },
+            async steer(_, payload) {
+                props.logger.log('RcVoice: steer');
+                await sleep(500);
+                for (const message of payload.addMessages ?? []) {
+                    await props.sendMessage(message);
+                }
+                if (payload.respond) {
+                    trackReload();
+                }
+            },
+            async getCallDetails() {
+                props.logger.log('RcVoice: getCallDetails');
+                return {
+                    callId: '',
+                    callDuration: 102,
+                    callEnd: '',
+                    callStart: '',
+                    endedReason: '',
+                    messages: props.getMessages(),
+                    error: null,
+                    recording: null,
+                    transcript: props
+                        .getMessages()
+                        .filter((m) => m.sender !== 'system')
+                        .map(mapToTranscript),
+                };
+            },
+            async setVoiceSetting(settings) {
+                props.logger.log('RcVoice: setVoiceSetting', { settings });
+            },
+            async setUpSip(...args) {
+                if (args.length) {
+                    props.logger.log('RcVoice: setUpSip', { name: args[0], trunks: args[1] });
+                }
+                else {
+                    props.logger.log('RcVoice: setUpSip');
+                }
+            },
+            async freeze() {
+                props.logger.log('RcVoice: freeze');
+            },
+            async unfreeze() {
+                props.logger.log('RcVoice: unfreeze');
+            },
+            async setVoiceSettings(settings) {
+                props.logger.log('RcVoice: setVoiceSettings', { settings });
+            },
+        },
+        setReload(_onReload) {
+            onReload = _onReload;
+        },
+        setCallEnd(_onCallEnd) {
+            onCallEnd = _onCallEnd;
+        },
+        waitForIdle,
+    };
+}
+function sleep(t) {
+    if (process.env.IS_TEST === 'true')
+        return Promise.resolve();
+    return new Promise((r) => setTimeout(r, t));
+}
+function mapToTranscript(m) {
+    return {
+        text: m.text,
+        role: m.sender === 'agent' ? 'Agent' : 'User',
+        time: 'unknown',
+        duration: 0,
+    };
+}

package/build/stubs.d.ts

@@ -0,0 +1,4 @@
+import { Logger } from './interfaces/dockyard';
+import { StepRegistry } from './interfaces/step-registry';
+export declare function createStubRegistry(logger: Logger): StepRegistry;
+//# sourceMappingURL=stubs.d.ts.map

package/build/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../src/stubs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAKzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM/D"}

package/build/test-agent.d.ts

@@ -0,0 +1,4 @@
+import { CallInfo, VoiceAgent } from '@recombine-ai/platform';
+import { TestAgentFactoryProps, TestVoiceAgent } from './interfaces/agent';
+export declare function makeTestVoiceAgent(props: TestAgentFactoryProps<any>, agent: VoiceAgent, waitForIdle: () => Promise<void>, testCall: CallInfo): TestVoiceAgent;
+//# sourceMappingURL=test-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-agent.d.ts","sourceRoot":"","sources":["../src/test-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG1E,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,qBAAqB,CAAC,GAAG,CAAC,EACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAChC,QAAQ,EAAE,QAAQ,GACnB,cAAc,CAmEhB"}

package/build/test-agent.js

@@ -0,0 +1,70 @@
+import { collectStream } from './utils';
+export function makeTestVoiceAgent(props, agent, waitForIdle, testCall) {
+    async function streamResponse() {
+        const messages = props.getMessages();
+        if (props.conversationalTracer) {
+            const lastMessage = messages.at(-1);
+            const lastText = lastMessage?.text ?? '';
+            const lastRole = lastMessage?.sender ?? 'user';
+            try {
+                props.conversationalTracer.addConversationalTrace({
+                    conversationId: testCall.callId,
+                    eventName: 'llm-handler-stream-requested',
+                    role: lastRole,
+                    medium: 'phone',
+                    content: lastText,
+                    createdAt: Date.now(),
+                });
+                await props.conversationalTracer.flush();
+            }
+            catch (err) {
+                props.logger.error('Failed to write conversational trace', { err });
+            }
+        }
+        const reply = await collectStream(await agent.streamResponse(messages, testCall));
+        await props.sendMessage(reply);
+        try {
+            props.conversationalTracer?.addConversationalTrace({
+                conversationId: testCall.callId,
+                eventName: 'finished-main-streaming-step',
+                role: 'agent',
+                medium: 'phone',
+                content: reply,
+                createdAt: Date.now(),
+            });
+            await props.conversationalTracer?.flush();
+        }
+        catch (err) {
+            props.logger.error('Failed to write conversational trace', { err });
+        }
+        await agent.onAgentSpeechDone(props.getMessages(), testCall);
+    }
+    return {
+        streamResponse: streamResponse,
+        onCallStart: async () => {
+            await agent.onCallStart(testCall);
+            await agent.onCallReady(testCall);
+        },
+        onCallEnd: async () => {
+            try {
+                props.conversationalTracer?.addConversationalTrace({
+                    conversationId: testCall.callId,
+                    eventName: 'hangup-requested',
+                    role: 'agent',
+                    medium: 'phone',
+                    content: 'hangup',
+                    createdAt: Date.now(),
+                });
+                await props.conversationalTracer?.flush();
+            }
+            catch (err) {
+                props.logger.error('Failed to write conversational trace', { err });
+            }
+            await agent.onCallEnd(testCall);
+        },
+        waitForIdle,
+        async onFatalError(error) {
+            props.logger.error(error);
+        },
+    };
+}

package/build/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function collectStream(stream: ReadableStream<{
+    delta: string;
+}>): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

package/build/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,mBAM5E"}

package/build/utils.js

@@ -0,0 +1,7 @@
+export async function collectStream(stream) {
+    const result = [];
+    for await (const chunk of stream) {
+        result.push(chunk.delta);
+    }
+    return result.join('');
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "@recombine-ai/bosun-lib",
+    "version": "0.1.0",
+    "description": "Bosun conversational agents IDE bindings to agents build on Recombine platform",
+    "license": "EULA",
+    "author": "recombine.ai",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/recombine-ai/platform.git",
+        "directory": "packages/bosun-lib"
+    },
+    "files": [
+        "build"
+    ],
+    "type": "module",
+    "dependencies": {
+        "@recombine-ai/engine": "1.0.0",
+        "@recombine-ai/telescope": "0.1.0",
+        "zod": "^4.4.3"
+    },
+    "exports": {
+        ".": "./src/index.ts"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org"
+    },
+    "devDependencies": {
+        "@types/node": "^25.2.3"
+    }
+}