@recombine-ai/engine 0.1.1

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export { type AiEngine, createAIEngine } from './lib/ai';
+export { delayFactory, type Schedule } from './lib/schedule';
+export * from './lib/interfaces';
+export * from './lib/bosun';
+//# 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,OAAO,EAAE,KAAK,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE5D,cAAc,kBAAkB,CAAA;AAEhC,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+exports.delayFactory = exports.createAIEngine = void 0;
+var ai_1 = require("./lib/ai");
+Object.defineProperty(exports, "createAIEngine", { enumerable: true, get: function () { return ai_1.createAIEngine; } });
+var schedule_1 = require("./lib/schedule");
+Object.defineProperty(exports, "delayFactory", { enumerable: true, get: function () { return schedule_1.delayFactory; } });
+__exportStar(require("./lib/interfaces"), exports);
+__exportStar(require("./lib/bosun"), exports);

package/build/lib/ai.d.ts

@@ -0,0 +1,88 @@
+import { ZodSchema } from 'zod';
+import { Logger, Message } from './interfaces';
+import { SendAction } from './bosun/action';
+export interface Step {
+    /** Step name (used mainly for debugging) */
+    name: string;
+    /**
+     * Prompt can be a simple string or a link to a file, loaded with `loadFile` function which
+     * takes a path to the file relative to `src/use-cases` directory.
+     */
+    prompt: string | File;
+    /**
+     * In case you want a structured from LLM, define a schema using {@link zod https://zod.dev/}
+     * library.
+     */
+    schema?: ZodSchema;
+    /** Exclude directives from message history for this step */
+    ignoreDirectives?: boolean;
+    /** Additional data to be inserted into prompt */
+    context?: Record<string, unknown>;
+    /** Check a condition, whether the `execute` function should run or not */
+    shouldExecute?: (reply: string) => boolean | Promise<boolean>;
+    /** Check a condition, whether the whole step should be run or not */
+    runIf?: (messages: Messages) => boolean | Promise<boolean>;
+    /** Use when you need to do some action when LLM's response received */
+    execute: (reply: string) => Promise<unknown>;
+    /** Error handler called if an error occurred during LLM API call or in `execute` function */
+    onError: (error: string) => Promise<unknown>;
+    /**
+     * When provided, throws an error if the step is invoked more times than `maxAttempts`.
+     * Number of attempts taken is reset when `shouldExecute` returns `false`. Useful to limit
+     * rewinds by reviewers. NOTE that it doesn't work on steps without `shouldExecute` method.
+     */
+    maxAttempts?: number;
+}
+export interface DumbStep {
+    name: string;
+    runIf?: () => boolean | Promise<boolean>;
+    execute: () => Promise<unknown>;
+    onError: (error: string) => Promise<unknown>;
+}
+export type CreateStep = ReturnType<typeof createAIEngine>['createStep'];
+export type CreateWorkflow = ReturnType<typeof createAIEngine>['createWorkflow'];
+export type LoadFile = ReturnType<typeof createAIEngine>['loadFile'];
+export type MakeMessagesList = ReturnType<typeof createAIEngine>['makeMessagesList'];
+export type AiEngine = {
+    createWorkflow: CreateWorkflow;
+    createStep: CreateStep;
+    loadFile: LoadFile;
+    makeMessagesList: MakeMessagesList;
+};
+export interface Messages {
+    setUserName(name: string): void;
+    setAgentName(name: string): void;
+    toString: (ignoreDirectives?: boolean) => string;
+    addDirective: (message: string) => void;
+    addMessage: (name: Message['sender'], message: string) => void;
+    directiveFormat: (formatter: (message: Message) => string) => void;
+    proposedMessageFormat: (formatter: (message: string) => string) => void;
+    setProposedReply: (message: string) => void;
+    getProposedReply: () => string | null;
+    getHistory: () => Message[];
+}
+export interface File {
+    content: () => Promise<string>;
+}
+export interface EngineConfig {
+    tokenStorage?: {
+        getToken: () => Promise<string | null>;
+    };
+    basePath?: string;
+    logger?: Logger;
+    sendAction?: SendAction;
+}
+export declare function createAIEngine(cfg?: EngineConfig): {
+    createWorkflow: (...steps: Array<Step | DumbStep>) => Promise<{
+        terminate: () => void;
+        run: (messages: Messages) => Promise<string | null>;
+        rewindTo: (step: Step) => void;
+        beforeEach(callback: () => Promise<unknown>): void;
+    }>;
+    createStep: <T extends Step | DumbStep>(step: T) => T;
+    loadFile: (path: string) => {
+        content: () => Promise<string>;
+    };
+    makeMessagesList: (messages?: Message[]) => Messages;
+};
+//# sourceMappingURL=ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/lib/ai.ts"],"names":[],"mappings":"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"}

package/build/lib/ai.js

@@ -0,0 +1,234 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAIEngine = createAIEngine;
+// cspell:words lstripBlocks
+const fs_1 = __importDefault(require("fs"));
+const openai_1 = __importDefault(require("openai"));
+const path_1 = require("path");
+const nunjucks_1 = __importDefault(require("nunjucks"));
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const action_1 = require("./bosun/action");
+const core_1 = require("openai/core");
+function createAIEngine(cfg = {}) {
+    const logger = cfg.logger || globalThis.console;
+    const basePath = cfg.basePath || process.cwd();
+    const tokenStorage = cfg.tokenStorage || {
+        async getToken() {
+            if (process.env.OPENAI_API_KEY) {
+                return process.env.OPENAI_API_KEY;
+            }
+            throw new Error('OpenAI API key is not set');
+        },
+    };
+    function createStep(step) {
+        return step;
+    }
+    function makeMessagesList(messages = []) {
+        let directivesFormatter = (message) => `${message.sender}: ${message.text}`;
+        let proposedFormatter = (message) => `Proposed reply: ${message}`;
+        let proposedReply = null;
+        const names = {
+            agent: 'Agent',
+            user: 'User',
+            system: 'System',
+        };
+        return {
+            toString: (ignoreDirectives = false) => messages
+                .map((msg) => {
+                if (msg.sender === 'system') {
+                    return ignoreDirectives ? null : directivesFormatter(msg);
+                }
+                return `${names[msg.sender]}: ${msg.text}`;
+            })
+                .filter((msg) => msg !== null)
+                .join('\n') + (proposedReply ? `\n${proposedFormatter(proposedReply)}` : ''),
+            addMessage: (sender, text) => messages.push({ sender, text }),
+            addDirective: (message) => {
+                logger.debug(`AI Core: add directive: ${message}`);
+                messages.push({ sender: 'system', text: message });
+            },
+            directiveFormat: (formatter) => {
+                directivesFormatter = formatter;
+            },
+            proposedMessageFormat: (formatter) => {
+                proposedFormatter = formatter;
+            },
+            setProposedReply: (message) => (proposedReply = message),
+            getProposedReply: () => proposedReply,
+            getHistory: () => messages,
+            setUserName: (name) => {
+                names.user = name;
+            },
+            setAgentName: (name) => {
+                names.agent = name;
+            },
+        };
+    }
+    async function createWorkflow(...steps) {
+        const apiKey = await tokenStorage.getToken();
+        let shouldRun = true;
+        let currentStep = 0;
+        let beforeEachCallback = async () => Promise.resolve(null);
+        const attempts = new Map();
+        return {
+            terminate: () => {
+                logger.debug('AI Core: Terminating conversation...');
+                shouldRun = false;
+            },
+            run: async (messages) => {
+                for (; currentStep < steps.length; currentStep++) {
+                    await beforeEachCallback();
+                    const step = steps[currentStep];
+                    if (!shouldRun) {
+                        break;
+                    }
+                    if (!step.runIf || (await step.runIf(messages))) {
+                        const action = (0, action_1.makeAction)(cfg.sendAction, 'AI', step.name);
+                        await action('started');
+                        logger.debug(`AI Core: Step: ${step.name}`);
+                        if ('prompt' in step) {
+                            await runStep(step, messages);
+                        }
+                        else {
+                            await runDumbStep(step);
+                        }
+                        await action('completed');
+                    }
+                }
+                return shouldRun ? messages.getProposedReply() : null;
+            },
+            rewindTo: (step) => {
+                const index = steps.indexOf(step);
+                if (index === -1) {
+                    throw new Error(`Step ${step.name} not found`);
+                }
+                if (index > currentStep) {
+                    throw new Error(`Cannot rewind to a step ahead of the current step`);
+                }
+                currentStep = index - 1; // -1 because it will be incremented in the loop definition
+            },
+            beforeEach(callback) {
+                beforeEachCallback = callback;
+            },
+        };
+        async function runStep(step, messages) {
+            if (!apiKey) {
+                throw new Error('OpenAI API key is not set');
+            }
+            try {
+                let response = null;
+                let prompt = typeof step.prompt === 'string' ? step.prompt : await step.prompt.content();
+                logger.debug('AI Core: context', step.context);
+                logger.debug('AI Core: messages', messages.toString(step.ignoreDirectives || false));
+                if (step.context) {
+                    nunjucks_1.default.configure({ autoescape: true, trimBlocks: true, lstripBlocks: true });
+                    prompt = nunjucks_1.default.renderString(prompt, step.context);
+                }
+                response = await runLLM(apiKey, prompt, messages.toString(step.ignoreDirectives || false), step.schema);
+                if (!response) {
+                    throw new Error('No response from OpenAI');
+                }
+                logger.debug(`AI Core: response: ${response}`);
+                if (typeof step.shouldExecute === 'function') {
+                    if (await step.shouldExecute(response)) {
+                        logger.debug(`AI Core: executing`);
+                        checkAttempts(step);
+                        await step.execute(response);
+                    }
+                    else {
+                        resetAttempts(step);
+                        logger.debug(`AI Core: skipping`);
+                    }
+                }
+                else {
+                    logger.debug(`AI Core: replying`);
+                    await step.execute(response);
+                }
+            }
+            catch (error) {
+                // FIXME: this doesn't terminate the workflow
+                await step.onError(error.message);
+                shouldRun = false;
+            }
+        }
+        async function runDumbStep(step) {
+            try {
+                if (!step.runIf || (await step.runIf())) {
+                    await step.execute();
+                }
+            }
+            catch (error) {
+                console.error(`AI Core: error in dumb step ${step.name}: ${error.message}`);
+                await step.onError(error.message);
+                shouldRun = false;
+            }
+        }
+        function checkAttempts(step) {
+            if (step.maxAttempts) {
+                if (!attempts.has(step)) {
+                    attempts.set(step, 0);
+                }
+                attempts.set(step, attempts.get(step) + 1);
+                if (attempts.get(step) > step.maxAttempts) {
+                    throw new Error(`Max attempts reached for step ${step.name}`);
+                }
+            }
+        }
+        function resetAttempts(step) {
+            attempts.set(step, 0);
+        }
+    }
+    async function runLLM(apiKey, systemPrompt, messages, schema) {
+        if (apiKey === '__TESTING__') {
+            await (0, core_1.sleep)(100);
+            return schema
+                ? JSON.stringify({ message: 'canned response', reasons: [] })
+                : 'canned response';
+        }
+        const client = new openai_1.default({ apiKey });
+        logger.log('----------- RENDERED PROMPT ---------------');
+        logger.log(systemPrompt);
+        logger.log('---------------------------------------');
+        let format = { type: 'text' };
+        if (schema) {
+            format = {
+                type: 'json_schema',
+                json_schema: {
+                    name: 'detector_response',
+                    schema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema),
+                },
+            };
+        }
+        const response = await client.chat.completions.create({
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: messages },
+            ],
+            model: 'gpt-4o',
+            response_format: format,
+            temperature: 0.1,
+        });
+        if (!response.choices[0].message.content) {
+            throw new Error('No response from OpenAI');
+        }
+        return response.choices[0].message.content;
+    }
+    function loadFile(path) {
+        // NOTE: there probably will be S3 loading stuff here
+        return {
+            content: async () => {
+                logger.debug('AI Core: loading prompt:', path);
+                return fs_1.default.promises.readFile((0, path_1.join)(basePath, path), 'utf-8');
+            },
+        };
+    }
+    return {
+        createWorkflow: createWorkflow,
+        createStep,
+        loadFile,
+        makeMessagesList,
+    };
+}

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

@@ -0,0 +1,10 @@
+export interface Action {
+    id: string;
+    type: string;
+    state: 'started' | 'completed' | 'failed';
+    message: string;
+}
+export type SendAction = (action: Action) => Promise<void>;
+export declare function makeActionWrapper(sendAction: SendAction): (message: string, type: string, action: () => Promise<unknown>) => Promise<void>;
+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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/action.ts"],"names":[],"mappings":"AAAA,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,aAEvC,MAAM,QACT,MAAM,UACJ,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"}

package/build/lib/bosun/action.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeActionWrapper = makeActionWrapper;
+exports.makeAction = makeAction;
+function makeActionWrapper(sendAction) {
+    return async function wrapAction(message, type, action) {
+        const id = Math.random().toString();
+        await sendAction({
+            id,
+            type,
+            state: 'started',
+            message,
+        });
+        await action();
+        await sendAction({
+            id,
+            type,
+            state: 'completed',
+            message,
+        });
+    };
+}
+function makeAction(sendAction, type, message) {
+    if (!sendAction) {
+        // noop
+        return async function action() { };
+    }
+    const id = Math.random().toString();
+    return function action(state = 'completed') {
+        return sendAction({
+            id,
+            type,
+            state,
+            message,
+        });
+    };
+}

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

@@ -0,0 +1,25 @@
+import { AiEngine } from '../ai';
+import { Logger, Message, Scheduler } from '../interfaces';
+import { SendAction } from './action';
+import { Context } from './context';
+type DefaultContext = Record<string, any>;
+export interface TesAgentFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    logger: Logger;
+    scheduler: Scheduler;
+    ai: AiEngine;
+    getMessages: () => 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 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

@@ -0,0 +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,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,oBAAoB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,EAAE,EAAE,QAAQ,CAAA;IACZ,WAAW,EAAE,MAAM,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,UAAU,EAAE,UAAU,CAAA;IACtB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACtB,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,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CACtE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAC7B,SAAS,CAAA;AAEd,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,uBAE5F"}

package/build/lib/bosun/agent.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestAgentFactory = createTestAgentFactory;
+function createTestAgentFactory(creator) {
+    return creator;
+}

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

@@ -0,0 +1,22 @@
+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;
+    /** silently swap the context */
+    swap(newContext: T): void;
+    subscribe: (listener: (context: T) => void) => () => boolean;
+}
+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/lib/bosun/context.d.ts.map

@@ -0,0 +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"}

package/build/lib/bosun/context.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContext = createContext;
+class Context {
+    #listeners = new Set();
+    #context;
+    constructor(context) {
+        this.#context = context;
+    }
+    set(pathOrContext, value) {
+        if (!this.#context) {
+            return;
+        }
+        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]];
+            }
+            // @ts-ignore
+            current[path[path.length - 1]] = value;
+        }
+        this.#listeners.forEach((listener) => listener(this.#context));
+    }
+    get() {
+        return this.#context;
+    }
+    /** silently swap the context */
+    swap(newContext) {
+        this.#context = newContext;
+    }
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    };
+}
+function createContext(context) {
+    return new Context(context);
+}

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

@@ -0,0 +1,5 @@
+export * from './action';
+export * from './context';
+export * from './agent';
+export * from './mock';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/build/lib/bosun/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./action"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./mock"), exports);

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

@@ -0,0 +1,6 @@
+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;
+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

@@ -0,0 +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"}

package/build/lib/bosun/mock.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMock = createMock;
+const node_util_1 = require("node:util");
+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') {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+                    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 (0, node_util_1.inspect)(obj, { depth: null }).split('\n').join('\n\t');
+}

package/build/lib/bosun/test-workflow.d.ts

@@ -0,0 +1,24 @@
+import { AiEngine } from '../ai';
+import { Logger, Message, Scheduler } from '../interfaces';
+type DefaultContext = Record<string, any>;
+export interface TestWorkflowFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    logger: Logger;
+    scheduler: Scheduler;
+    ai: AiEngine;
+    getMessages: (workflow: string) => Message[];
+    sendMessage: (workflow: string, message: string) => Promise<void>;
+    sendAction: ctx;
+}
+export interface TestWorkflow {
+    start: () => Promise<unknown>;
+    reactOnMessage: () => Promise<unknown>;
+    respondToMessage: () => Promise<unknown>;
+    isAssigned: () => Promise<boolean>;
+    onFatalError: (error: Error) => Promise<unknown>;
+    getContext: () => DefaultContext;
+    setContext: (context: DefaultContext) => void;
+}
+export type TestWorkflowFactory = (props: TestWorkflowFactoryProps) => Record<string, TestWorkflow>;
+export declare function createTestWorkflowFactory(creator: TestWorkflowFactory): TestWorkflowFactory;
+export {};
+//# sourceMappingURL=test-workflow.d.ts.map

package/build/lib/bosun/test-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/test-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1D,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,wBAAwB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IACjF,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,EAAE,EAAE,QAAQ,CAAA;IACZ,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAAE,CAAA;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,UAAU,EACV,GAAG,CAAA;CAAC;AAOR,MAAM,WAAW,YAAY;IAEzB,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;IAEhD,UAAU,EAAE,MAAM,cAAc,CAAA;IAChC,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CAChD;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAEnG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,uBAErE"}

package/build/lib/bosun/test-workflow.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestWorkflowFactory = createTestWorkflowFactory;
+{
+    get: () => CTX;
+    set: (ctx) => void subscribe;
+    (cb) => void ;
+}
+function createTestWorkflowFactory(creator) {
+    return creator;
+}

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

@@ -0,0 +1,25 @@
+import { AiEngine } from '../ai';
+import { Logger, Message, Scheduler } from '../interfaces';
+import { SendAction } from './action';
+import { Context } from './context';
+type DefaultContext = Record<string, any>;
+export interface TestWorkflowFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    logger: Logger;
+    scheduler: Scheduler;
+    ai: AiEngine;
+    getMessages: () => Message[];
+    sendMessage: (message: string) => Promise<void>;
+    sendAction: SendAction;
+    ctx: Context<CTX>;
+}
+export interface TestWorkflow {
+    start: () => Promise<unknown>;
+    reactOnMessage: () => Promise<unknown>;
+    respondToMessage: () => Promise<unknown>;
+    isAssigned: () => Promise<boolean>;
+    onFatalError: (error: Error) => Promise<unknown>;
+}
+export type TestWorkflowFactory<T extends DefaultContext = DefaultContext> = (props: TestWorkflowFactoryProps<T>) => TestWorkflow;
+export declare function createTestWorkflowFactory<T extends DefaultContext>(creator: TestWorkflowFactory<T>): TestWorkflowFactory<T>;
+export {};
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/bosun/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,wBAAwB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IACjF,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,EAAE,EAAE,QAAQ,CAAA;IACZ,WAAW,EAAE,MAAM,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,UAAU,EAAE,UAAU,CAAA;IACtB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,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,MAAM,mBAAmB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CACzE,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,KACjC,YAAY,CAAA;AAEjB,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,cAAc,EAC9D,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,0BAGlC"}

package/build/lib/bosun/workflow.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestWorkflowFactory = createTestWorkflowFactory;
+function createTestWorkflowFactory(creator) {
+    return creator;
+}

package/build/lib/interfaces.d.ts

@@ -0,0 +1,32 @@
+export interface Logger {
+    log: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+/**
+ * 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
+ */
+type ScheduleAction = (delay: Date, phone: string) => Promise<void>;
+export 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>;
+}
+export interface Message {
+    sender: 'user' | 'agent' | 'system';
+    text: string;
+    imageUrl?: string;
+}
+export {};
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +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;;;;;GAKG;AACH,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnE,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;AAED,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/build/lib/interfaces.js

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

package/build/lib/schedule.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @returns getNextTimePoint function that makes a date from a given {@link Delay}
+ * - note that Delay must not be negative
+ */
+export declare function delayFactory(schedule: Schedule): (delay: Delay) => Date;
+type Delay = [number, 'minutes' | 'hours' | 'days'] | [number, 'hours', number, 'minutes'] | [number, 'days', number, 'hours'] | [number, 'days', number, 'hours', number, 'minutes'];
+type singleInt = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+type hours = `${0 | 1}${singleInt}` | '20' | '21' | '22' | '23';
+type Time = `${hours}:${0 | 1 | 2 | 3 | 4 | 5}${singleInt}`;
+type WeekDays = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+type Year = 2024 | 2025 | 2026 | 2027 | 2028 | 2029 | 2030;
+type Month = '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12';
+type DateFmt = `${Year}-${Month}-${0 | 1 | 2 | 3}${singleInt}`;
+interface TimeRange {
+    days: WeekDays[];
+    from: Time;
+    to: Time;
+}
+export interface Schedule {
+    timeZone: string;
+    workingHours?: TimeRange[];
+    holidays?: DateFmt[];
+}
+export {};
+//# sourceMappingURL=schedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/lib/schedule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,WACH,KAAK,KAAG,IAAI,CAwCvD;AAkFD,KAAK,KAAK,GACJ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,GACtC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,GACpC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GACjC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;AAE1D,KAAK,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACtD,KAAK,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAC/D,KAAK,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,CAAA;AAC3D,KAAK,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAA;AAClG,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAC1D,KAAK,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE9F,KAAK,OAAO,GAAG,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,CAAA;AAE9D,UAAU,SAAS;IACf,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,EAAE,EAAE,IAAI,CAAA;CACX;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACvB"}

package/build/lib/schedule.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delayFactory = delayFactory;
+/**
+ * @returns getNextTimePoint function that makes a date from a given {@link Delay}
+ * - note that Delay must not be negative
+ */
+function delayFactory(schedule) {
+    return function getNextTimePoint(delay) {
+        const date = new Date();
+        const { holidays, timeZone, workingHours } = schedule;
+        const delayMs = getDelayTimeInMs(delay);
+        const [_, offsetDiffBefore] = convertToTimeZone(date, timeZone);
+        const localOffsetBefore = date.getTimezoneOffset() * 60 * 1000;
+        date.setTime(date.getTime() + delayMs);
+        let [targetTzDate, offsetDiff] = convertToTimeZone(date, timeZone);
+        const localOffsetAfterMs = targetTzDate.getTimezoneOffset() * 60 * 1000;
+        const localOffsetChange = localOffsetAfterMs - localOffsetBefore;
+        const targetTzOffsetChange = offsetDiff - offsetDiffBefore;
+        if (workingHours && workingHours?.length > 0) {
+            targetTzDate = getNextWorkingDate(targetTzDate, workingHours);
+        }
+        if (holidays && isHoliday(targetTzDate, holidays)) {
+            targetTzDate = skipHoliday(targetTzDate, holidays);
+        }
+        const targetDate = new Date(targetTzDate.getTime() + offsetDiff + targetTzOffsetChange + localOffsetChange);
+        const [, offsetDiffTz] = convertToTimeZone(targetDate, timeZone);
+        const targetOffsetTzChange = offsetDiffTz - offsetDiff;
+        return new Date(targetTzDate.getTime() +
+            offsetDiff +
+            targetTzOffsetChange +
+            localOffsetChange +
+            targetOffsetTzChange);
+    };
+}
+function getDelayTimeInMs(time) {
+    const minutesIndex = time.findIndex((el) => el === 'minutes');
+    const minutes = minutesIndex !== -1 ? time[minutesIndex - 1] : 0;
+    const hoursIndex = time.findIndex((el) => el === 'hours');
+    const hours = hoursIndex !== -1 ? time[hoursIndex - 1] : 0;
+    const daysIndex = time.findIndex((el) => el === 'days');
+    const days = daysIndex !== -1 ? time[daysIndex - 1] : 0;
+    if ([days, hours, minutes].some((v) => v < 0)) {
+        throw new Error('Negative delay');
+    }
+    return (minutes * 60 + hours * 60 * 60 + days * 24 * 60 * 60) * 1000;
+}
+function convertToTimeZone(date, timeZone) {
+    const convertedDate = new Date(date.toLocaleString('en-US', { timeZone }));
+    const offsetMS = date.getTime() - convertedDate.getTime();
+    return [convertedDate, offsetMS];
+}
+function getNextWorkingDate(date, workingHours) {
+    const currentDate = new Date(date);
+    while (true) {
+        const currentDay = getDayOfWeek(currentDate);
+        const daySchedule = workingHours.find((interval) => interval.days.includes(currentDay));
+        if (daySchedule) {
+            const [fromHours, fromMinutes] = daySchedule.from.split(':').map(Number);
+            const [toHours, toMinutes] = daySchedule.to.split(':').map(Number);
+            if (fromHours > toHours) {
+                throw new Error('"from" is later then "to"');
+            }
+            const startTime = new Date(currentDate);
+            startTime.setHours(fromHours, fromMinutes, 0, 0);
+            const endTime = new Date(currentDate);
+            endTime.setHours(toHours, toMinutes, 0, 0);
+            if (currentDate >= startTime && currentDate <= endTime) {
+                return currentDate;
+            }
+            else if (currentDate < startTime) {
+                return startTime;
+            }
+        }
+        currentDate.setDate(currentDate.getDate() + 1);
+        currentDate.setHours(0, 0, 0, 0);
+    }
+}
+function getDayOfWeek(date) {
+    const days = [
+        'sunday',
+        'monday',
+        'tuesday',
+        'wednesday',
+        'thursday',
+        'friday',
+        'saturday',
+    ];
+    return days[date.getDay()];
+}
+function isHoliday(date, holidays) {
+    const dateString = date.toISOString().split('T')[0];
+    return holidays.includes(dateString);
+}
+function skipHoliday(date, holidays) {
+    while (isHoliday(date, holidays)) {
+        date.setDate(date.getDate() + 1);
+    }
+    return date;
+}

package/build/lib/test-workflow.d.ts

@@ -0,0 +1,24 @@
+import { AiEngine } from './ai';
+import { Logger, Message, Scheduler } from './interfaces';
+type DefaultContext = Record<string, any>;
+export interface TestWorkflowFactoryProps<CTX extends DefaultContext = DefaultContext> {
+    logger: Logger;
+    scheduler: Scheduler;
+    ai: AiEngine;
+    getMessages: (workflow: string) => Message[];
+    sendMessage: (workflow: string, message: string) => Promise<void>;
+    sendAction: ctx;
+}
+export interface TestWorkflow {
+    start: () => Promise<unknown>;
+    reactOnMessage: () => Promise<unknown>;
+    respondToMessage: () => Promise<unknown>;
+    isAssigned: () => Promise<boolean>;
+    onFatalError: (error: Error) => Promise<unknown>;
+    getContext: () => DefaultContext;
+    setContext: (context: DefaultContext) => void;
+}
+export type TestWorkflowFactory = (props: TestWorkflowFactoryProps) => Record<string, TestWorkflow>;
+export declare function createTestWorkflowFactory(creator: TestWorkflowFactory): TestWorkflowFactory;
+export {};
+//# sourceMappingURL=test-workflow.d.ts.map

package/build/lib/test-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/test-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEzD,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzC,MAAM,WAAW,wBAAwB,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc;IACjF,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,EAAE,EAAE,QAAQ,CAAA;IACZ,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EAAE,CAAA;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,UAAU,EACV,GAAG,CAAA;CAAC;AAOR,MAAM,WAAW,YAAY;IAEzB,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;IAEhD,UAAU,EAAE,MAAM,cAAc,CAAA;IAChC,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CAChD;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAEnG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,uBAErE"}

package/build/lib/test-workflow.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestWorkflowFactory = createTestWorkflowFactory;
+{
+    get: () => CTX;
+    set: (ctx) => void subscribe;
+    (cb) => void ;
+}
+function createTestWorkflowFactory(creator) {
+    return creator;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "@recombine-ai/engine",
+    "version": "0.1.1",
+    "description": "Recombine AI engine for creating conversational AI agents",
+    "main": "build/index.js",
+    "types": "build/index.d.ts",
+    "author": "Recombine AI limited",
+    "license": "MIT",
+    "private": false,
+    "scripts": {
+        "dev": "tsc -w",
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
+        "test": "vitest"
+    },
+    "devDependencies": {
+        "@types/node": "^22.8.1",
+        "@types/nunjucks": "^3.2.6",
+        "prettier": "^3.3.3",
+        "typescript": "^5.7.3",
+        "vitest": "^3.0.6"
+    },
+    "dependencies": {
+        "nunjucks": "^3.2.4",
+        "openai": "^4.68.4",
+        "zod": "^3.23.8",
+        "zod-to-json-schema": "^3.23.5"
+    }
+}

package/readme.md

@@ -0,0 +1,103 @@
+<!-- cspell:words agentic -->
+
+# Recombine AI Engine
+
+A TypeScript library for building agentic workflows for conversational AI.
+
+## Features
+
+-   🔄 Multi-step agentic workflows
+-   🎯 Conditional execution and reviewers
+-   📝 Structured responses using Zod schemas
+-   🗂️ File-based prompts
+-   ⚡ Message history management
+-   🌍 Context injection using Nunjucks templates
+-   👩‍💻 Ready to be integrated with Recombine Bosun prompt-engineering IDE.
+
+## Installation
+
+```sh
+npm install @recombine/ai-engine
+```
+
+## Basic Usage
+
+```ts
+import { createAIEngine } from '@recombine-ai/engine'
+
+const engine = createAIEngine({
+    basePath: './path/to/prompts',
+})
+```
+
+### Creating a Workflow
+
+```ts
+// Create message list
+const messages = engine.makeMessagesList()
+messages.addMessage('User', 'Hello!')
+
+// Define steps
+const mainStep = engine.createStep({
+    name: 'mainStep',
+    prompt: engine.loadFile('conversation/main.txt'),
+    context: { userName: 'John Doe' },
+    execute: async (response) => {
+        messages.setProposedReply(response)
+    },
+    onError: async (error) => {
+        console.error('Error:', error)
+    },
+})
+
+const myReviewer = engine.createStep({
+    /* ... */
+})
+
+const myCoordinator = engine.createStep({
+    /* ... */
+})
+
+// Create and run workflow
+const workflow = await engine.createWorkflow(mainStep, myReviewer, myCoordinator)
+const response = await workflow.run(messages)
+```
+
+## Main concepts
+
+### Workflow & Steps
+
+AI agentic workflow is a chain of prompts where one prompt handles results of another and either
+does some side-effects or changes those results.
+
+In Recombine Engine we define these prompts as _steps_. Each step consists of a prompt and a bunch
+of related configurations and supporting functions, that e.g. determine whether a side-effect should
+happen and what should happen int those side-effects.
+
+#### Step Configuration
+
+```ts
+const myStep = engine.createStep({
+    name: 'myStep', // Step identifier used for observability
+    prompt: 'Here goes your prompt', // Prompt text or file, loaded with engine.loadFile('path')
+    schema: zod.object({/* ... */}), // Structured response schema
+    context: {userName: 'John Doe'}, // Variables to be used in prompts
+    ignoreDirectives: false, // Do not add directives into messages log
+    runIf: (messages: Messages) => true, // Run this step or skip it completely
+    shouldExecute: (reply: string) => true, // Execute side-effects, if needed
+    execute: async (reply: string) => {/* ... */}, // Side effect definition
+    onError: (error: string) => {/* ... */}, // Handle error during step execution
+    maxAttempts: 3 // Max rewind attempts (for reviewers)
+}
+```
+
+#### Workflow methods
+
+```ts
+const workflow = await engine.createWorkflow(/* workflow steps */)
+
+const reply = await workflow.run(messages) // run the workflow to get the proposed reply at the end
+workflow.terminate() // usually used in kill-switch or error handlers: terminates workflow, so no further steps will be executed
+workflow.rewind(step) // restart workflow from a particular step
+workflow.beforeEach(callback) // a callback to run before each step, e.g. to terminate workflow due to some external reasons
+```