@recombine-ai/engine 1.0.0-beta-4 → 1.1.0

package/.github/workflows/linting.yml

@@ -11,12 +11,12 @@ jobs:
         timeout-minutes: 10
         steps:
             - name: Checkout
-              uses: actions/checkout@v4
+              uses: actions/checkout@v7
 
             - name: Setup Node.js
-              uses: actions/setup-node@v4
+              uses: actions/setup-node@v6
               with:
-                  node-version: 24
+                  node-version: '24.x'
                   cache: 'npm'
 
             - name: Install dependencies

package/.github/workflows/publish.yml

@@ -10,27 +10,27 @@ permissions:
     contents: read
 
 env:
-    NODE_VERSION: 20
+    NODE_VERSION: 24
 
 jobs:
     publish:
         runs-on: ubuntu-latest
 
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v7
               with:
                   fetch-depth: 0
 
             - name: 'Setup Node'
-              uses: actions/setup-node@v4
+              uses: actions/setup-node@v6
               with:
-                  node-version: 20
+                  node-version: '${{ env.NODE_VERSION }}.x'
                   cache: 'npm'
                   registry-url: 'https://registry.npmjs.org'
 
-            # Ensure npm 11.5.1 or later is installed
+            # Keep npm on a major compatible with Node 24.
             - name: Update npm
-              run: npm install -g npm@latest
+              run: npm install -g npm@^11
 
             - name: 'Install dependencies'
               run: npm ci

package/build/lib/bosun/action.d.ts

@@ -1,10 +1,22 @@
+/**
+ * @deprecated unused
+ */
 export interface Action {
     id: string;
     type: string;
     state: 'started' | 'completed' | 'failed';
     message: string;
 }
+/**
+ * @deprecated unused
+ */
 export type SendAction = (action: Action) => Promise<void>;
+/**
+ * @deprecated unused
+ */
 export declare function makeActionWrapper(sendAction: SendAction): (message: string, type: string, action: () => Promise<unknown>) => Promise<void>;
+/**
+ * @deprecated unused
+ */
 export declare function makeAction(sendAction: SendAction | undefined, type: string, message: string): (state?: Action["state"]) => Promise<void>;
 //# sourceMappingURL=action.d.ts.map

package/build/lib/bosun/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/action.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACzC,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,IAEhD,SAAS,MAAM,EACf,MAAM,MAAM,EACZ,QAAQ,MAAM,OAAO,CAAC,OAAO,CAAC,mBAiBrC;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAM1D,MAAM,CAAC,OAAO,CAAC,mBAQhD"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/action.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACzC,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,IAEhD,SAAS,MAAM,EACf,MAAM,MAAM,EACZ,QAAQ,MAAM,OAAO,CAAC,OAAO,CAAC,mBAiBrC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAM1D,MAAM,CAAC,OAAO,CAAC,mBAQhD"}

package/build/lib/bosun/action.js

@@ -3,6 +3,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeActionWrapper = makeActionWrapper;
 exports.makeAction = makeAction;
+/**
+ * @deprecated unused
+ */
 function makeActionWrapper(sendAction) {
     return async function wrapAction(message, type, action) {
         const id = Math.random().toString();
@@ -21,6 +24,9 @@ function makeActionWrapper(sendAction) {
         });
     };
 }
+/**
+ * @deprecated unused
+ */
 function makeAction(sendAction, type, message) {
     if (!sendAction) {
         // noop

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

@@ -1,6 +1,6 @@
 import { Logger, Message, Scheduler } from '../interfaces';
 import { Context } from './context';
-import { StepRegistry } from './step-registry';
+import { StepRegistry } from '../step-registry';
 import { StepTracer } from './step-tracer';
 import { ApiCallTracer } from './api-call-tracer';
 import { ConversationalTracer } from './conversational-tracer';
@@ -25,6 +25,9 @@ import { ConversationalTracer } from './conversational-tracer';
  * ```
  */
 type DefaultContext = Record<string, any>;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export interface TestAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
     stepRegistry: StepRegistry;
     /**
@@ -46,6 +49,9 @@ export interface TestAgentFactoryProps<CTX extends DefaultContext = DefaultConte
     sendMessage: (message: string | Message) => Promise<void>;
     ctx: Context<CTX>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export interface TestTextAgent {
     start: () => Promise<unknown>;
     reactOnMessage: () => Promise<unknown>;
@@ -53,6 +59,9 @@ export interface TestTextAgent {
     isAssigned: () => Promise<boolean>;
     onFatalError: (error: Error) => Promise<unknown>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export interface TestVoiceAgent {
     streamResponse: () => Promise<unknown>;
     onCallEnd: () => Promise<unknown>;
@@ -60,8 +69,17 @@ export interface TestVoiceAgent {
     onFatalError: (error: Error) => Promise<unknown>;
     resetContext: () => Promise<unknown>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export type TestAgent = TestTextAgent | TestVoiceAgent;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export type TestAgentFactory<T extends DefaultContext = DefaultContext> = (props: TestAgentFactoryProps<T>) => Promise<TestAgent>;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export declare function createTestAgentFactory<T extends DefaultContext>(creator: TestAgentFactory<T>): TestAgentFactory<T>;
 export {};
 //# sourceMappingURL=agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,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;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,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;CACpB;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;AACD,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;IAEhD,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CACvC;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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IAC9E,YAAY,EAAE,YAAY,CAAA;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,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;CACpB;AAED;;GAEG;AACH,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;AACD;;GAEG;AACH,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;IAEhD,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,CAAA;AAEtD;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CACtE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,SAAS,CAAC,CAAA;AAEvB;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,uBAE5F"}

package/build/lib/bosun/agent.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTestAgentFactory = createTestAgentFactory;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 function createTestAgentFactory(creator) {
     return creator;
 }

package/build/lib/bosun/api-call-tracer.d.ts

@@ -6,6 +6,9 @@ import { Logger } from '../interfaces';
  * your domain "call"/"conversation" identifier. To get a per-call UI timeline, scope your tracer in the app
  * layer by injecting `conversationId` onto every `ApiCallTrace` before passing it to the SDK.
  */
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export type ApiCallTrace = {
     /** Unique ID for the trace */
     traceId?: string;
@@ -29,10 +32,16 @@ export type ApiCallTrace = {
     /** Timestamp in milliseconds */
     createdAt: number;
 };
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export interface ApiCallTracer {
     addApiCallTrace(trace: ApiCallTrace): void;
     flush(): Promise<void>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export declare function createStubApiCallTracer(logger: Logger): {
     addApiCallTrace(trace: ApiCallTrace): void;
     flush(): Promise<void>;

package/build/lib/bosun/api-call-tracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-call-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/api-call-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IAEZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,WAAW,aAAa;IAC1B,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;2BAEvB,YAAY;;EAQ1C"}
+{"version":3,"file":"api-call-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/api-call-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;;;;;GAMG;AACH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IAEZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;2BAEvB,YAAY;;EAQ1C"}

package/build/lib/bosun/api-call-tracer.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStubApiCallTracer = createStubApiCallTracer;
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 function createStubApiCallTracer(logger) {
     return {
         addApiCallTrace(trace) {

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

@@ -15,10 +15,16 @@ declare class Context<T extends Ctx> {
     setPromptContextMapper(promptMapper: (ctx: T) => object): void;
     getPromptContextMapper(): (ctx: T) => object;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 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>>;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export type { PublicContext as Context };
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/lib/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;IAIH,gCAAgC;IAChC,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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/lib/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;IAIH,gCAAgC;IAChC,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;;GAEG;AACH,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;;GAEG;AACH,YAAY,EAAE,aAAa,IAAI,OAAO,EAAE,CAAA"}

package/build/lib/bosun/context.js

@@ -41,6 +41,9 @@ class Context {
         return this.#promptMapper;
     }
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 function createContext(context) {
     return new Context(context);
 }

package/build/lib/bosun/conversational-tracer.d.ts

@@ -4,6 +4,9 @@ import { Logger } from '../interfaces';
  * message received/sent, streaming finished, handler invoked) that UIs may want to show on the same
  * per-conversation timeline.
  */
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export type ConversationalTrace = {
     /** Unique ID for the trace */
     traceId?: string;
@@ -23,10 +26,16 @@ export type ConversationalTrace = {
     createdAt: number;
     error?: unknown;
 };
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export interface ConversationalTracer {
     addConversationalTrace(trace: ConversationalTrace): void;
     flush(): Promise<void>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export declare function createStubConversationalTracer(logger: Logger): {
     addConversationalTrace(trace: ConversationalTrace): void;
     flush(): Promise<void>;

package/build/lib/bosun/conversational-tracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversational-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/conversational-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,wCAAwC;IACxC,SAAS,EACH,8BAA8B,GAC9B,8BAA8B,GAC9B,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,CAAA;IAExB,sDAAsD;IACtD,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAEjD,qDAAqD;IACrD,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAE5C,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IAEf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,oBAAoB;IACjC,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM;kCAEvB,mBAAmB;;EAKxD"}
+{"version":3,"file":"conversational-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/conversational-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;;;GAIG;AACH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,wCAAwC;IACxC,SAAS,EACH,8BAA8B,GAC9B,8BAA8B,GAC9B,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,CAAA;IAExB,sDAAsD;IACtD,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAEjD,qDAAqD;IACrD,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAE5C,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IAEf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM;kCAEvB,mBAAmB;;EAKxD"}

package/build/lib/bosun/conversational-tracer.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStubConversationalTracer = createStubConversationalTracer;
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 function createStubConversationalTracer(logger) {
     return {
         addConversationalTrace(trace) {

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

@@ -1,9 +1,33 @@
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export * from './action';
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export * from './context';
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export * from './agent';
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 export * from './mock';
-export { PromptString, StepDef, StepRegistry } from './step-registry';
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
+export { PromptString, StepDef, StepRegistry } from '../step-registry';
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export * from './step-tracer';
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export * from './api-call-tracer';
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export * from './conversational-tracer';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACrE,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAA;AACxB;;GAEG;AACH,cAAc,WAAW,CAAA;AACzB;;GAEG;AACH,cAAc,SAAS,CAAA;AACvB;;GAEG;AACH,cAAc,QAAQ,CAAA;AACtB;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACtE;;GAEG;AACH,cAAc,eAAe,CAAA;AAC7B;;GAEG;AACH,cAAc,mBAAmB,CAAA;AACjC;;GAEG;AACH,cAAc,yBAAyB,CAAA"}

package/build/lib/bosun/index.js

@@ -14,10 +14,31 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 __exportStar(require("./action"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 __exportStar(require("./context"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 __exportStar(require("./agent"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 __exportStar(require("./mock"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 __exportStar(require("./step-tracer"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 __exportStar(require("./api-call-tracer"), exports);
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 __exportStar(require("./conversational-tracer"), exports);

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

@@ -1,6 +1,9 @@
 import { Logger } from '../interfaces';
 type ConstructorType<T> = new (...args: any[]) => T;
 type InstanceType<T extends ConstructorType<any>> = T extends new (...args: any[]) => infer R ? R : never;
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 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/lib/bosun/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/mock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,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"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/mock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,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;;GAEG;AACH,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/lib/bosun/mock.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMock = createMock;
 const node_util_1 = require("node:util");
+/**
+ * @deprecated Use the analog from @recombine-ai/bosun-lib instead.
+ */
 function createMock(logger, constructor, overrides) {
     const mock = Object.create(constructor.prototype);
     const properties = Object.getOwnPropertyDescriptors(constructor.prototype);

package/build/lib/bosun/step-tracer.d.ts

@@ -1,12 +1,17 @@
 import { type ZodType } from 'zod';
-import { PromptFile } from '../prompt-fs';
 import { Logger } from '../interfaces';
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export type LlmUsage = {
     promptTokens?: number;
     completionTokens?: number;
     totalTokens?: number;
     cachedPromptTokens?: number;
 };
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export type StepTrace = {
     /** Unique ID for the trace */
     traceId?: string;
@@ -20,7 +25,7 @@ export type StepTrace = {
     name: string;
     renderedPrompt?: string;
     receivedContext?: Record<string, unknown> | unknown;
-    receivedPrompt?: string | PromptFile | File;
+    receivedPrompt?: string;
     stringifiedConversation?: string;
     schema?: ZodType;
     model?: string;
@@ -31,6 +36,9 @@ export type StepTrace = {
     createdAt: number;
     error?: Error;
 };
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export interface StepTracer {
     /**
      * Add a step trace
@@ -42,6 +50,9 @@ export interface StepTracer {
      */
     flush(): Promise<void>;
 }
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 export declare function createStubStepTracer(logger: Logger): {
     addStepTrace(trace: StepTrace): void;
     flush(): Promise<void>;

package/build/lib/bosun/step-tracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/step-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,KAAK,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,MAAM,QAAQ,GAAG;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAA;IAErB,IAAI,EAAE,MAAM,CAAA;IAEZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAA;IACnD,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;IAE3C,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAED,MAAM,WAAW,UAAU;IACvB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM;wBAEvB,SAAS;;EA2BpC"}
+{"version":3,"file":"step-tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/step-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,KAAK,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAA;IAErB,IAAI,EAAE,MAAM,CAAA;IAEZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAA;IACnD,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM;wBAEvB,SAAS;;EA2BpC"}

package/build/lib/bosun/step-tracer.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStubStepTracer = createStubStepTracer;
 const zod_1 = require("zod");
+/**
+ * @deprecated Use the analog from @recombine-ai/telescope instead.
+ */
 function createStubStepTracer(logger) {
     return {
         addStepTrace(trace) {

package/build/lib/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lib/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAEH,YAAY,EAGZ,OAAO,EAEP,WAAW,EAKd,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,GAAE,YAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,CA+NxF;AAuDD,wBAAgB,kBAAkB,CAAC,eAAe,GAAE,OAAO,EAAO,GAAG,YAAY,CA2ChF;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAG,OAAO,KAAK,WAAW,CAAC,GAAG,CAAC,CAEhE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lib/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAEH,YAAY,EAGZ,OAAO,EAEP,WAAW,EAKd,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAK5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,GAAE,YAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAkQxF;AAuDD,wBAAgB,kBAAkB,CAAC,eAAe,GAAE,OAAO,EAAO,GAAG,YAAY,CA2ChF;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAG,OAAO,KAAK,WAAW,CAAC,GAAG,CAAC,CAEhE"}

package/build/lib/engine.js

@@ -44,7 +44,8 @@ const crypto_1 = require("crypto");
 const nunjucks_1 = __importDefault(require("nunjucks"));
 const Zod = __importStar(require("zod"));
 const step_tracer_1 = require("./bosun/step-tracer");
-const step_registry_1 = require("./bosun/step-registry");
+const step_registry_1 = require("./step-registry");
+const STRUCTURED_RESPONSE_MAX_ATTEMPTS = 3;
 /**
  * Creates an AI Engine with the given configuration.
  *
@@ -146,30 +147,9 @@ function createAIEngine(cfg = {}) {
                 });
                 stepTrace.stringifiedConversation = stringifiedMessages;
                 if ('schema' in step) {
-                    const stringResponse = await runLLM(step.model, prompt, stringifiedMessages, step.schema);
-                    stepTrace.response = stringResponse;
-                    let parsedJsonResponse = undefined;
-                    try {
-                        parsedJsonResponse = JSON.parse(stringResponse);
-                        response = step.schema.parse(parsedJsonResponse);
-                    }
-                    catch (err) {
-                        if (err instanceof SyntaxError) {
-                            logger.error(`AI-generated response is not valid JSON in step ${step.name}`, {
-                                response: stringResponse,
-                                schema: Zod.toJSONSchema(step.schema),
-                            });
-                            throw new Error(`Response is not valid JSON for step ${step.name}`);
-                        }
-                        else {
-                            logger.error(`AI-generated response in step ${step.name} violates schema`, {
-                                response: stringResponse,
-                                schema: Zod.toJSONSchema(step.schema),
-                                errors: step.schema.safeParse(parsedJsonResponse).error,
-                            });
-                            throw new Error(`Response validation failed for step ${step.name}`);
-                        }
-                    }
+                    const { parsedResponse, rawResponse } = await runStructuredStepWithRetries(step.model, prompt, stringifiedMessages, step.name, step.schema);
+                    response = parsedResponse;
+                    stepTrace.response = rawResponse;
                 }
                 else {
                     response = await runLLM(step.model, prompt, stringifiedMessages, undefined);
@@ -239,6 +219,49 @@ function createAIEngine(cfg = {}) {
         });
         return nunjucks_1.default.renderString(prompt, context ?? {});
     }
+    async function runStructuredStepWithRetries(model, prompt, stringifiedMessages, stepName, schema) {
+        for (let attempt = 1; attempt <= STRUCTURED_RESPONSE_MAX_ATTEMPTS; attempt++) {
+            const stringResponse = await runLLM(model, prompt, stringifiedMessages, schema);
+            let parsedJsonResponse = undefined;
+            try {
+                parsedJsonResponse = JSON.parse(stringResponse);
+            }
+            catch {
+                const hasAttemptsLeft = attempt < STRUCTURED_RESPONSE_MAX_ATTEMPTS;
+                if (hasAttemptsLeft) {
+                    logger.debug(`AI-generated response is not valid JSON in step ${stepName}, retry ${attempt}/${STRUCTURED_RESPONSE_MAX_ATTEMPTS}`);
+                    continue;
+                }
+                logger.error(`AI-generated response is not valid JSON in step ${stepName}`, {
+                    response: stringResponse,
+                    schema: Zod.toJSONSchema(schema),
+                });
+                throw new Error(`Response is not valid JSON for step ${stepName}`);
+            }
+            const parsedResponse = schema.safeParse(parsedJsonResponse);
+            if (parsedResponse.success) {
+                return {
+                    parsedResponse: parsedResponse.data,
+                    rawResponse: stringResponse,
+                };
+            }
+            const hasAttemptsLeft = attempt < STRUCTURED_RESPONSE_MAX_ATTEMPTS;
+            if (hasAttemptsLeft) {
+                logger.debug(`AI-generated response in step ${stepName} violates schema, retry ${attempt}/${STRUCTURED_RESPONSE_MAX_ATTEMPTS}`, {
+                    response: stringResponse,
+                    errors: parsedResponse.error,
+                });
+                continue;
+            }
+            logger.error(`AI-generated response in step ${stepName} violates schema`, {
+                response: stringResponse,
+                schema: Zod.toJSONSchema(schema),
+                errors: parsedResponse.error,
+            });
+            throw new Error(`Response validation failed for step ${stepName}`);
+        }
+        throw new Error(`Response validation failed for step ${stepName}`);
+    }
     return {
         createWorkflow,
         createConversation,

package/build/lib/{bosun/step-registry.d.ts → step-registry.d.ts}

@@ -1,6 +1,6 @@
 import { type ZodType } from 'zod';
-import { PromptFile } from '../prompt-fs';
-import { Logger } from '../interfaces';
+import { PromptFile } from './prompt-fs';
+import { Logger } from './interfaces';
 export interface PromptString {
     type: 'string';
     content: () => Promise<string>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-registry.d.ts","sourceRoot":"","sources":["../../src/lib/step-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,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;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM/D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,6BAQpD"}

package/build/lib/stream/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/engine.ts"],"names":[],"mappings":"AAKA,OAAO,EAGH,cAAc,EAEd,qBAAqB,EAGxB,MAAM,eAAe,CAAA;AAItB,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,EAAE,EAC/C,GAAG,EAAE,qBAAqB,GAC3B,cAAc,CAAC,GAAG,CAAC,CAgJrB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/lib/stream/engine.ts"],"names":[],"mappings":"AAKA,OAAO,EAGH,cAAc,EAEd,qBAAqB,EAGxB,MAAM,eAAe,CAAA;AAItB,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,EAAE,EAC/C,GAAG,EAAE,qBAAqB,GAC3B,cAAc,CAAC,GAAG,CAAC,CAwIrB"}

package/build/lib/stream/engine.js

@@ -7,7 +7,7 @@ exports.createAIStreamEngine = createAIStreamEngine;
 // cspell:words TTFT lstrip
 const nunjucks_1 = __importDefault(require("nunjucks"));
 const bosun_1 = require("../bosun");
-const step_registry_1 = require("../bosun/step-registry");
+const step_registry_1 = require("../step-registry");
 const token_transformers_1 = require("./token-transformers");
 function createAIStreamEngine(cfg) {
     function createWorkflow({ name, prompt, model, tokenTransformers = [token_transformers_1.agentFilter], onError, }) {
@@ -25,6 +25,14 @@ function createAIStreamEngine(cfg) {
             const startTime = performance.now();
             const transcript = createTranscript(logger, messages);
             const initiatedTransformers = tokenTransformers.map((init) => init());
+            const template = typeof prompt === 'string' ? prompt : await prompt.content();
+            nunjucks_1.default.configure({
+                autoescape: true,
+                trimBlocks: true,
+                lstripBlocks: true,
+            });
+            const renderedPrompt = nunjucks_1.default.renderString(template, ctx || {});
+            const stringifiedConversation = transcript.toString();
             // Create step trace for telescope
             const mainStepTrace = {
                 workflowId: name,
@@ -33,11 +41,11 @@ function createAIStreamEngine(cfg) {
                 model: JSON.stringify(model.getOptions()),
                 createdAt: Date.now(),
                 response: '',
+                receivedContext: ctx,
+                receivedPrompt: template,
+                renderedPrompt: renderedPrompt,
+                stringifiedConversation: stringifiedConversation,
             };
-            const renderedPrompt = await renderPrompt(prompt, ctx);
-            const stringifiedConversation = transcript.toString();
-            mainStepTrace.renderedPrompt = renderedPrompt;
-            mainStepTrace.stringifiedConversation = stringifiedConversation;
             let mainStepStream;
             try {
                 mainStepStream = await model.generateStream(renderedPrompt, stringifiedConversation);
@@ -109,20 +117,6 @@ function createAIStreamEngine(cfg) {
                 },
             });
         }
-        async function renderPrompt(prompt, context) {
-            logger.debug('Streaming AI, CONTEXT:', context);
-            const template = typeof prompt === 'string' ? prompt : await prompt.content();
-            if (context) {
-                logger.debug('Loaded context: ', context);
-                nunjucks_1.default.configure({
-                    autoescape: true,
-                    trimBlocks: true,
-                    lstripBlocks: true,
-                });
-                return nunjucks_1.default.renderString(template, context);
-            }
-            return template;
-        }
         return {
             run,
         };

package/changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+### 1.0.0 → 1.1.0
+
+- Added retries on broken JSON in structured responses.
+
 ### 0.11.4 → 1.0.0
 
 - **Breaking:** `model` field on `LLMStep` is now required and must be an `LlmAdapter` (string model names removed)
@@ -13,6 +17,7 @@
 - Added `createOpenAIStreamAdapter` to `llm-adapters`
 - Added `createMockAdapter` to `llm-adapters` for testing without OpenAI keys
 - Added streaming engine (`createAIStreamEngine`) with filter support
+- Deprecated everything related to Bosun and Telescope in favor of `@recombine/bosun-lib` and `@recombine-ai/telescope`
 
 ### 0.11.3 → 0.11.4 (unstable)
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@recombine-ai/engine",
-    "version": "1.0.0-beta-4",
+    "version": "1.1.0",
     "description": "Recombine AI engine for creating conversational AI agents",
     "repository": {
         "url": "git+https://github.com/recombine-ai/engine.git"

package/build/lib/bosun/step-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-registry.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/step-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,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;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAM/D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,6BAQpD"}