@recombine-ai/engine 0.5.0 → 0.7.0

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

@@ -1,15 +1,18 @@
-import { AIEngine } from '../ai';
+import { Message } from '../ai';
 import { Logger, Scheduler } from '../interfaces';
 import { SendAction } from './action';
 import { Context } from './context';
+import { Tracer } from './tracer';
+import { StepTracer } from './stepTracer';
 /**
- * Bosun is a UI for testing Recombine AI agents. It enables testing complex agent interactions with multiple steps, error handling, and state management.
+ * Bosun is a UI for testing Recombine AI agents. It enables testing complex agent interactions with
+ * multiple steps, error handling, and state management.
  *
  * @example
  * ```typescript
  * // In workflows.ts
  * const agents = {
- *     "testbot": createTestAgentFactory((props) => {
+ *     "testBot": createTestAgentFactory((props) => {
  *         return {
  *             start: async () => { ... },
  *             reactOnMessage: async () => { ... },
@@ -21,26 +24,33 @@ import { Context } from './context';
  * export agents;
  * ```
  */
-export declare namespace Bosun {
-    type DefaultContext = Record<string, any>;
-    export interface TesAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
-        logger: Logger;
-        scheduler: Scheduler.Scheduler;
-        ai: AIEngine.AIEngine;
-        getMessages: () => AIEngine.Message[];
-        sendMessage: (message: string) => Promise<void>;
-        sendAction: SendAction;
-        ctx: Context<CTX>;
-    }
-    export interface TestAgent {
-        start: () => Promise<unknown>;
-        reactOnMessage: () => Promise<unknown>;
-        respondToMessage: () => Promise<unknown>;
-        isAssigned: () => Promise<boolean>;
-        onFatalError: (error: Error) => Promise<unknown>;
-    }
-    export type TestAgentFactory<T extends DefaultContext = DefaultContext> = (props: TesAgentFactoryProps<T>) => TestAgent;
-    export function createTestAgentFactory<T extends DefaultContext>(creator: TestAgentFactory<T>): TestAgentFactory<T>;
-    export {};
+type DefaultContext = Record<string, any>;
+export interface TestAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    tracer: Tracer;
+    stepTracer: StepTracer;
+    logger: Logger;
+    scheduler: Scheduler;
+    getMessages: () => Message[];
+    sendMessage: (message: string | Message) => Promise<void>;
+    sendAction: SendAction;
+    ctx: Context<CTX>;
 }
+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>;
+    resetContext: () => Promise<unknown>;
+}
+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/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,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,yBAAiB,KAAK,CAAA;IAClB,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzC,MAAM,WAAW,oBAAoB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;QAC7E,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,SAAS,CAAC,SAAS,CAAA;QAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAA;QACrB,WAAW,EAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;QACrC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/C,UAAU,EAAE,UAAU,CAAA;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;KACpB;IAED,MAAM,WAAW,SAAS;QACtB,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QAC7B,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,gBAAgB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QACxC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QAClC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KACnD;IAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CACtE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAC7B,SAAS,CAAA;IAEd,MAAM,UAAU,sBAAsB,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,uBAE5F;;CAEJ"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,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,UAAU,EAAE,UAAU,CAAA;IACtB,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"}

package/build/lib/bosun/agent.js

@@ -1,29 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Bosun = void 0;
-/**
- * Bosun is a UI for testing Recombine AI agents. It enables testing complex agent interactions with multiple steps, error handling, and state management.
- *
- * @example
- * ```typescript
- * // In workflows.ts
- * const agents = {
- *     "testbot": createTestAgentFactory((props) => {
- *         return {
- *             start: async () => { ... },
- *             reactOnMessage: async () => { ... },
- *             respondToMessage: async () => { ... }
- *         }
- *     })
- * }
- *
- * export agents;
- * ```
- */
-var Bosun;
-(function (Bosun) {
-    function createTestAgentFactory(creator) {
-        return creator;
-    }
-    Bosun.createTestAgentFactory = createTestAgentFactory;
-})(Bosun || (exports.Bosun = Bosun = {}));
+exports.createTestAgentFactory = createTestAgentFactory;
+function createTestAgentFactory(creator) {
+    return creator;
+}

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;;gBAGX,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;IAmBxB,GAAG;IAIH,gCAAgC;IAChC,IAAI,CAAC,UAAU,EAAE,CAAC;IAIlB,SAAS,aAAc,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,mBAG1C;CACJ;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;;gBAGX,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,aAAc,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,mBAG1C;CACJ;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/lib/bosun/context.js

@@ -5,12 +5,9 @@ class Context {
     #listeners = new Set();
     #context;
     constructor(context) {
-        this.#context = context;
+        this.#context = context || {};
     }
     set(pathOrContext, value) {
-        if (!this.#context) {
-            return;
-        }
         if (!Array.isArray(pathOrContext)) {
             this.#context = pathOrContext;
         }

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

@@ -2,4 +2,6 @@ export * from './action';
 export * from './context';
 export * from './agent';
 export * from './mock';
+export { PromptString, StepTraceDef, Tracer } from './tracer';
+export * from './stepTracer';
 //# 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"}
+{"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,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC7D,cAAc,cAAc,CAAA"}

package/build/lib/bosun/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./action"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./agent"), exports);
 __exportStar(require("./mock"), exports);
+__exportStar(require("./stepTracer"), exports);

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

@@ -0,0 +1,14 @@
+import { ZodSchema } from 'zod';
+export type StepTrace = {
+    name: string;
+    renderedPrompt?: string;
+    receivedContext?: Record<string, unknown>;
+    receivedPrompt?: string | File;
+    stringifiedConversation?: string;
+    schema?: ZodSchema;
+    model?: string;
+};
+export interface StepTracer {
+    addStepTrace(stepTrace: StepTrace): void;
+}
+//# sourceMappingURL=stepTracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepTracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/stepTracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAG/B,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,WAAW,UAAU;IACvB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAC3C"}

package/build/lib/bosun/stepTracer.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,19 @@
+import { ZodSchema } from 'zod';
+import { PromptFile } from '../prompt-fs';
+import { Logger } from '../interfaces';
+export interface PromptString {
+    type: 'string';
+    content: () => Promise<string>;
+}
+export interface StepTraceDef {
+    name: string;
+    type: 'streaming-response' | 'streaming-detect' | 'text';
+    prompt: PromptFile | PromptString;
+    schema?: ZodSchema;
+}
+export interface Tracer {
+    addStep(def: StepTraceDef): void;
+}
+export declare function createConsoleTracer(logger: Logger): Tracer;
+export declare function stdPrompt(prompt: PromptFile | string): PromptFile | PromptString;
+//# sourceMappingURL=tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAC/B,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,YAAY;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,MAAM,CAAA;IACxD,MAAM,EAAE,UAAU,GAAG,YAAY,CAAA;IACjC,MAAM,CAAC,EAAE,SAAS,CAAA;CACrB;AACD,MAAM,WAAW,MAAM;IACnB,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAA;CACnC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,6BAQpD"}

package/build/lib/bosun/tracer.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConsoleTracer = createConsoleTracer;
+exports.stdPrompt = stdPrompt;
+function createConsoleTracer(logger) {
+    return {
+        addStep(def) {
+            logger.debug('Tracer, step added:', def);
+        },
+    };
+}
+function stdPrompt(prompt) {
+    if (typeof prompt === 'string') {
+        return {
+            type: 'string',
+            content: async () => prompt,
+        };
+    }
+    return prompt;
+}

package/build/lib/interfaces.d.ts

@@ -3,26 +3,24 @@ export interface Logger {
     debug: (...args: any[]) => void;
     error: (...args: any[]) => void;
 }
-export declare namespace Scheduler {
+/**
+ * A function that schedules an action to be executed in the future
+ * @param delay – a date when the action should be executed use {@link delayFactory} to create a
+ * date
+ * @param phone – user's phone
+ */
+export type ScheduleAction = (delay: Date, phone: string) => Promise<void>;
+export interface Scheduler {
     /**
-     * A function that schedules an action to be executed in the future
-     * @param delay – a date when the action should be executed use {@link delayFactory} to create a
-     * date
-     * @param phone – user's phone
+     * Register a delayed action handler.
+     * @param actionName – a unique (inside one use-case) name for the action
+     * @param action – a function that will be called when the action is triggered
+     * @returns a function to schedule the action
      */
-    type ScheduleAction = (delay: Date, phone: string) => Promise<void>;
-    interface Scheduler {
-        /**
-         * Register a delayed action handler.
-         * @param actionName – a unique (inside one use-case) name for the action
-         * @param action – a function that will be called when the action is triggered
-         * @returns a function to schedule the action
-         */
-        registerAction: (actionName: string, action: (phone: string) => Promise<unknown>) => ScheduleAction;
-        /**
-         * Removes all actions for the given phone that were not executed yet.
-         */
-        clearAllPendingActions: (phone: string) => Promise<unknown>;
-    }
+    registerAction: (actionName: string, action: (phone: string) => Promise<unknown>) => ScheduleAction;
+    /**
+     * Removes all actions for the given phone that were not executed yet.
+     */
+    clearAllPendingActions: (phone: string) => Promise<unknown>;
 }
 //# sourceMappingURL=interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/lib/interfaces.ts"],"names":[],"mappings":"AAAA,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;AAED,yBAAiB,SAAS,CAAC;IACvB;;;;;OAKG;IACH,KAAY,cAAc,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,UAAiB,SAAS;QACtB;;;;;WAKG;QACH,cAAc,EAAE,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC1C,cAAc,CAAA;QAEnB;;WAEG;QACH,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAC9D;CACJ"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/lib/interfaces.ts"],"names":[],"mappings":"AAAA,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;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1E,MAAM,WAAW,SAAS;IACtB;;;;;OAKG;IACH,cAAc,EAAE,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC1C,cAAc,CAAA;IAEnB;;OAEG;IACH,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9D"}

package/build/lib/prompt-fs.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from './interfaces';
+export interface FsConfig {
+    logger?: Logger;
+    basePath: string;
+}
+export interface PromptFS {
+    loadFile(path: string): PromptFile;
+}
+export declare function createLocalFS(cfg: FsConfig): {
+    loadFile(path: string): PromptFile;
+};
+export interface PromptFile {
+    type: 'file';
+    content: () => Promise<string>;
+    path: string;
+}
+//# sourceMappingURL=prompt-fs.d.ts.map

package/build/lib/prompt-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-fs.d.ts","sourceRoot":"","sources":["../../src/lib/prompt-fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,MAAM,WAAW,QAAQ;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;CACrC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ;mBAGpB,MAAM,GAAG,UAAU;EAWzC;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;CACf"}

package/build/lib/prompt-fs.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalFS = createLocalFS;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = require("path");
+function createLocalFS(cfg) {
+    const logger = cfg.logger ?? console;
+    return {
+        loadFile(path) {
+            return {
+                type: 'file',
+                content: async () => {
+                    logger.debug('AI Engine: loading prompt:', path);
+                    return fs_1.default.promises.readFile((0, path_1.join)(cfg.basePath, path), 'utf-8');
+                },
+                path,
+            };
+        },
+    };
+}

package/build/lib/rc-fs.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from '@recombine-ai/engine';
+export interface FsConfig {
+    logger: Logger;
+    basePath: string;
+}
+export interface RcFS {
+    loadFile(path: string): PromptFile;
+}
+export declare function createLocalFS(cfg: FsConfig): {
+    loadFile(path: string): PromptFile;
+};
+export interface PromptFile {
+    type: 'file';
+    content: () => Promise<string>;
+    path: string;
+}
+//# sourceMappingURL=rc-fs.d.ts.map

package/build/lib/rc-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-fs.d.ts","sourceRoot":"","sources":["../../src/lib/rc-fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAI7C,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;CACrC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ;mBAEpB,MAAM,GAAG,UAAU;EAWzC;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;CACf"}

package/build/lib/rc-fs.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalFS = createLocalFS;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = require("path");
+function createLocalFS(cfg) {
+    return {
+        loadFile(path) {
+            return {
+                type: 'file',
+                content: async () => {
+                    cfg.logger.debug('AI Engine: loading prompt:', path);
+                    return fs_1.default.promises.readFile((0, path_1.join)(cfg.basePath, path), 'utf-8');
+                },
+                path,
+            };
+        },
+    };
+}

package/changelog.md

@@ -1,11 +1,40 @@
 # Changelog
 
+### 0.6.0 → 0.7.0 (unstable)
+
+Breaking changes:
+
+-   namespaces removed
+-   `TestAgentFactory` now returns a promise
+-   `TesAgentFactoryProps` now requires `Tracer` and doesn't require `AIEngine`
+-   `loadFile` method was removed in favor of `PromptFS`
+-   `workflow.run` now returns a string instead object as a response
+
+Other changes
+
+-   interface `TestVoiceAgent` added
+-   interface `Tracer` added
+-   interface `PromptFS` and function `createLocalFS` were added
+-   added `StepTracer` interface
+-   Engine config now accepts `tracer` and `stepTracer`
+
+### 0.5.0 → 0.6.0 (unstable)
+
+Breaking changes:
+
+-   `addDirective` is removed. Use `addMessage` with role: 'system' instead.
+-   `ignoreDirectives` → `ignoreAddedMessages`
+
+Other changes:
+
+-   `AIEngine.sendMessage` now accepts `Message` rather than a string
+
 ### 0.4.0 → 0.5.0 (unstable)
 
 Breaking changes:
 
 -   `schema` property replaced with `json` which can be boolean,
--   `setDirectiveFormatter` →
+-   `setDirectiveFormatter` removed
 
 Other changes:
 

package/eslint.config.mjs

@@ -0,0 +1,52 @@
+import eslint from '@eslint/js'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+    eslint.configs.recommended,
+    tseslint.configs.recommendedTypeChecked,
+    {
+        rules: {
+            '@typescript-eslint/no-floating-promises': 'error',
+            '@typescript-eslint/no-unsafe-assignment': 'warn',
+            '@typescript-eslint/no-unused-vars': [
+                'warn',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                    caughtErrorsIgnorePattern: '^_',
+                    destructuredArrayIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/no-unsafe-call': 'warn',
+            '@typescript-eslint/no-unsafe-member-access': 'warn',
+            '@typescript-eslint/require-await': 'off',
+            '@typescript-eslint/no-unsafe-return': 'warn',
+            '@typescript-eslint/no-explicit-any': 'warn',
+            'prefer-const': 'warn',
+            '@typescript-eslint/no-redundant-type-constituents': 'warn',
+            '@typescript-eslint/ban-ts-comment': 'warn',
+            '@typescript-eslint/no-unsafe-argument': 'warn',
+            '@typescript-eslint/no-empty-object-type': 'warn',
+        },
+    },
+    {
+        ignores: [
+            'dist/**/*.ts',
+            'dist/**',
+            '**/*.mjs',
+            'eslint.config.mjs',
+            '**/*.js',
+            'vitest.config.ts',
+            'deploy/cdk.out/**',
+            'drafts/**',
+        ],
+    },
+    {
+        languageOptions: {
+            parserOptions: {
+                projectService: true,
+                project: './tsconfig.json',
+            },
+        },
+    },
+)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@recombine-ai/engine",
-    "version": "0.5.0",
+    "version": "0.7.0",
     "description": "Recombine AI engine for creating conversational AI agents",
     "main": "build/index.js",
     "types": "build/index.d.ts",
@@ -12,19 +12,26 @@
         "build": "tsc",
         "prepublishOnly": "npm run build",
         "test": "vitest",
-        "docs": "cd docusaurus && yarn build --out-dir ../docs && cd .."
+        "docs": "cd docusaurus && yarn build --out-dir ../docs && cd ..",
+        "lint": "eslint",
+        "lint:fix": "eslint --fix",
+        "format": "prettier --write ."
     },
     "devDependencies": {
+        "@eslint/js": "^9.26.0",
         "@types/node": "^22.8.1",
         "@types/nunjucks": "^3.2.6",
+        "@typescript-eslint/eslint-plugin": "^8.32.0",
+        "eslint": "^9.26.0",
         "prettier": "^3.3.3",
-        "typescript": "^5.7.3",
+        "typescript": "^5.8.3",
+        "typescript-eslint": "^8.32.0",
         "vitest": "^3.0.6"
     },
     "dependencies": {
         "nunjucks": "^3.2.4",
         "openai": "^4.68.4",
         "zod": "3.23.8",
-        "zod-to-json-schema": "^3.23.5"
+        "zod-to-json-schema": "^3.24.6"
     }
 }