@recombine-ai/platform 0.2.6-test.8 → 0.3.0

package/build/engine/bosun/index.js

@@ -0,0 +1,7 @@
+export * from './action';
+export * from './context';
+export * from './agent';
+export * from './mock';
+export * from './step-tracer';
+export * from './api-call-tracer';
+export * from './conversational-tracer';

package/build/engine/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/engine/bosun/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/engine/bosun/mock.ts"],"names":[],"mappings":"AAEA,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;AAKX,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/engine/bosun/mock.js

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

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

@@ -0,0 +1,8 @@
+import type { StepTrace } from '../../telescope';
+import { Logger } from '../interfaces';
+export type { LlmUsage, StepTrace, StepTracer } from '../../telescope';
+export declare function createStubStepTracer(logger: Logger): {
+    addStepTrace(trace: StepTrace): void;
+    flush(): Promise<void>;
+};
+//# sourceMappingURL=step-tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-tracer.d.ts","sourceRoot":"","sources":["../../../src/engine/bosun/step-tracer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAQtC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKtE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM;wBAEvB,SAAS;;EA2BpC"}

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

@@ -0,0 +1,29 @@
+import { toJSONSchema } from 'zod';
+export function createStubStepTracer(logger) {
+    return {
+        addStepTrace(trace) {
+            logger.log(`StepTrace: ${trace.name}, in workflow (${trace.workflowId})`);
+            if (trace.model) {
+                logger.log(`StepTrace, model: ${trace.model}`);
+            }
+            if (trace.schema) {
+                logger.log('StepTrace, schema:', toJSONSchema(trace.schema));
+            }
+            if (trace.receivedContext) {
+                logger.log('StepTrace, context:', trace.receivedContext);
+            }
+            if (trace.stringifiedConversation) {
+                logger.log(`StepTrace, messages: \n${trace.stringifiedConversation}`);
+            }
+            if (trace.renderedPrompt) {
+                logger.log('------------ RENDERED PROMPT ----------\n' +
+                    trace.renderedPrompt +
+                    '\n---------------------------------------');
+            }
+            if (trace.response) {
+                logger.log(`StepTrace, LLM response:\n${trace.response}`);
+            }
+        },
+        async flush() { },
+    };
+}

package/build/engine/default-logger.d.ts

@@ -0,0 +1,3 @@
+import { type Logger } from '../dockyard';
+export declare function defaultLogger(): Logger;
+//# sourceMappingURL=default-logger.d.ts.map

package/build/engine/default-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-logger.d.ts","sourceRoot":"","sources":["../../src/engine/default-logger.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAKvD,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/build/engine/default-logger.js

@@ -0,0 +1,5 @@
+import createLogger from '../dockyard';
+let logger;
+export function defaultLogger() {
+    return (logger ??= createLogger());
+}

package/build/engine/engine.d.ts

@@ -0,0 +1,6 @@
+import { Conversation, Message, StepBuilder } from './interfaces';
+import { AIEngine, EngineConfig } from './interfaces/engine';
+export declare function createAIEngine<CTX extends object>(cfg?: EngineConfig): AIEngine<CTX>;
+export declare function createConversation(initialMessages?: Message[]): Conversation;
+export declare function getStepBuilder<CTX = unknown>(): StepBuilder<CTX>;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AAOA,OAAO,EAEH,YAAY,EAGZ,OAAO,EAEP,WAAW,EAKd,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA+B5D,wBAAgB,cAAc,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,GAAE,YAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAyQxF;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/engine/engine.js

@@ -0,0 +1,306 @@
+import { randomUUID } from 'crypto';
+import nunjucks from 'nunjucks';
+import * as Zod from 'zod';
+import { createStubStepTracer } from './bosun/step-tracer';
+import { defaultLogger } from './default-logger';
+import { reportProviderError } from './monitoring';
+import { createStubRegistry, stdPrompt } from './step-registry';
+const STRUCTURED_RESPONSE_MAX_ATTEMPTS = 3;
+export function createAIEngine(cfg = {}) {
+    const logger = cfg.logger || defaultLogger();
+    const stepTracer = cfg.stepTracer || createStubStepTracer(logger);
+    const registry = cfg.stepRegistry || createStubRegistry(logger);
+    function createWorkflow({ onError, beforeExecute, afterExecute, steps = [], name = 'workflow', }) {
+        steps.forEach(addStepToTracer);
+        return {
+            run: async (messages, contextProvider, beforeEach) => {
+                const state = new WorkflowState(logger, steps);
+                let beforeHookExecuted = false;
+                let didExecute = false;
+                do {
+                    const ctx = await contextProvider();
+                    await beforeEach?.(messages, ctx, state);
+                    const step = state.getStep();
+                    if (state.isTerminated()) {
+                        logger.log('AI Engine, run terminated');
+                        break;
+                    }
+                    if (!step.runIf || (await step.runIf(messages, ctx))) {
+                        didExecute = true;
+                        if (beforeExecute && !beforeHookExecuted) {
+                            await beforeExecute(ctx);
+                            beforeHookExecuted = true;
+                        }
+                        if ('prompt' in step) {
+                            await runStep(step, messages, ctx, state);
+                        }
+                        else {
+                            await runProgrammaticStep(step, messages, ctx, state);
+                        }
+                    }
+                } while (state.next());
+                if (afterExecute && didExecute) {
+                    await afterExecute(await contextProvider());
+                }
+                await stepTracer.flush();
+                return state.isTerminated() ? null : messages.getProposedReply();
+            },
+        };
+        function addStepToTracer(step) {
+            if ('prompt' in step) {
+                registry.addStep({
+                    name: step.name,
+                    prompt: stdPrompt(step.prompt),
+                    type: 'text',
+                    schema: 'schema' in step ? step.schema : undefined,
+                });
+            }
+        }
+        async function runStep(step, conversation, ctx, state) {
+            const stepTrace = {
+                name: step.name,
+                workflowId: name,
+                workflowRunId: state.runId,
+                createdAt: Date.now(),
+                model: JSON.stringify(step.model.getOptions()),
+                schema: 'schema' in step
+                    ? step.schema instanceof Zod.ZodType
+                        ? step.schema
+                        : undefined
+                    : undefined,
+            };
+            try {
+                stepTrace.receivedContext = ctx;
+                let response = null;
+                let prompt = typeof step.prompt === 'string' ? step.prompt : await step.prompt.content();
+                stepTrace.receivedPrompt = prompt;
+                prompt = renderPrompt(prompt, ctx);
+                stepTrace.renderedPrompt = prompt;
+                const stringifiedMessages = conversation.toString({
+                    ignoreAddedMessages: step.ignoreAddedMessages,
+                });
+                stepTrace.stringifiedConversation = stringifiedMessages;
+                if ('schema' in step) {
+                    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);
+                    stepTrace.response = response;
+                }
+                if (!response) {
+                    throw new Error('No response from OpenAI');
+                }
+                logger.log(`AI Engine, executing ${step.name}`);
+                await step.execute(response, conversation, ctx, state);
+            }
+            catch (err) {
+                reportProviderError(err, {
+                    logger,
+                    eventTracer: cfg.eventTracer,
+                    providerInfo: step.model.getProviderInfo?.(),
+                });
+                const error = err instanceof Error ? err : new Error(String(err));
+                stepTrace.error = error;
+                try {
+                    await (step.onError
+                        ? step.onError(error.message, ctx)
+                        : onError(error.message, ctx));
+                }
+                catch (onErrorErr) {
+                    logger.error('AI Engine, onError handler failed', {
+                        err: onErrorErr,
+                        stepName: step.name,
+                    });
+                    if (onErrorErr instanceof Error) {
+                        throw onErrorErr;
+                    }
+                    else if (typeof onErrorErr === 'string') {
+                        throw new Error(onErrorErr);
+                    }
+                    else {
+                        throw new Error('Unknown error in onError handler');
+                    }
+                }
+                state.terminate();
+            }
+            finally {
+                stepTracer.addStepTrace(stepTrace);
+            }
+        }
+        async function runProgrammaticStep(step, messages, ctx, state) {
+            try {
+                if (!step.runIf || (await step.runIf(messages, ctx))) {
+                    await step.execute(messages, ctx, state);
+                }
+            }
+            catch (error) {
+                logger.error(`AI Engine, error in dumb step ${step.name}: ${error.message}`);
+                await (step.onError
+                    ? step.onError(error.message, ctx)
+                    : onError(error.message, ctx));
+                state.terminate();
+            }
+        }
+    }
+    async function runLlm(model, systemPrompt, messages, schema) {
+        return model.generateResponse(systemPrompt, messages, schema);
+    }
+    function renderPrompt(prompt, context) {
+        if (cfg.nunjucksEnv) {
+            return cfg.nunjucksEnv.renderString(prompt, context ?? {});
+        }
+        nunjucks.configure({
+            autoescape: false,
+            trimBlocks: true,
+            lstripBlocks: true,
+        });
+        return nunjucks.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,
+        renderPrompt,
+        getStepBuilder() {
+            return (step) => step;
+        },
+    };
+}
+class WorkflowState {
+    logger;
+    steps;
+    shouldRun = true;
+    currentStep = 0;
+    attempts = new Map();
+    rewinder = 0;
+    lastRewindTo = 0;
+    runId;
+    constructor(logger, steps) {
+        this.logger = logger;
+        this.steps = steps;
+        this.runId = randomUUID();
+    }
+    terminate() {
+        this.logger.debug('AI Engine: Terminating conversation...');
+        this.shouldRun = false;
+    }
+    isTerminated() {
+        return !this.shouldRun;
+    }
+    getStep() {
+        return this.steps[this.currentStep] || null;
+    }
+    next() {
+        this.currentStep++;
+        if (this.rewinder < this.currentStep) {
+            this.attempts.delete(this.lastRewindTo);
+        }
+        return this.currentStep < this.steps.length;
+    }
+    rewindTo(stepName) {
+        this.rewinder = this.currentStep;
+        const index = this.steps.findIndex((s) => s.name === stepName);
+        if (index < 0) {
+            const names = this.steps.map((s) => s.name).join(', ');
+            throw new Error(`Tried to rewind to ${stepName}, steps: [${names}]`);
+        }
+        this.currentStep = index - 1;
+        this.lastRewindTo = this.currentStep;
+        const step = this.steps[index];
+        const max = step.maxAttempts || 10;
+        const attempt = this.attempts.get(this.currentStep) ?? 1;
+        if (attempt >= max) {
+            throw new Error(`Max attempts reached for step ${step.name}`);
+        }
+        this.attempts.set(this.currentStep, attempt + 1);
+    }
+}
+export function createConversation(initialMessages = []) {
+    const messages = initialMessages.map((msg) => ({
+        ...msg,
+        isAddedMessage: false,
+        formatter: undefined,
+    }));
+    const names = {
+        agent: 'Agent',
+        user: 'User',
+        system: 'System',
+    };
+    let defaultFormatter = (message) => `${names[message.sender]}: ${message.text}`;
+    let proposedFormatter = (message) => `Proposed reply: ${message}`;
+    let proposedReply = null;
+    return {
+        toString: (options) => {
+            return (messages
+                .filter((msg) => !options?.ignoreAddedMessages || !msg.isAddedMessage)
+                .map((msg) => {
+                return msg.formatter ? msg.formatter(msg) : defaultFormatter(msg);
+            })
+                .filter((msg) => msg !== null)
+                .join('\n') + (proposedReply ? `\n${proposedFormatter(proposedReply)}` : ''));
+        },
+        addMessage: (message, opts) => {
+            messages.push({
+                ...message,
+                isAddedMessage: true,
+                formatter: opts?.formatter ?? defaultFormatter,
+            });
+        },
+        setDefaultFormatter: (formatter) => {
+            defaultFormatter = formatter;
+        },
+        setProposedMessageFormatter: (formatter) => {
+            proposedFormatter = formatter;
+        },
+        setProposedReply: (message) => (proposedReply = message),
+        getProposedReply: () => proposedReply,
+        getHistory: () => messages,
+    };
+}
+export function getStepBuilder() {
+    return (step) => step;
+}

package/build/engine/index.d.ts

@@ -0,0 +1,15 @@
+export type { AIEngine, AIStreamEngine, BasicStep, BeforeEachStep, Conversation, EngineConfig, JsonLlmStep, LlmStep, LlmAdapter, LlmProviderInfo, LlmStreamAdapter, Logger, Message, ProgrammaticStep, ResponseChunk, ScheduleAction, Scheduler, StepBuilder, StreamWorkflowConfig, StreamingEngineConfig, StringLlmStep, Transcript, Workflow, WorkflowConfig, WorkflowControls, WorkflowStep, } from './interfaces';
+export { createAIEngine, createConversation, getStepBuilder } from './engine';
+export { createAIStreamEngine, getAzureClient, getOpenAiClient } from './stream';
+export type { StreamingWorkflowConfig } from './stream';
+export { ScheduleQuery, createScheduleQuery, delayFactory } from './schedule';
+export type { Schedule } from './schedule';
+export { createContext, createMock, createStubApiCallTracer, createStubConversationalTracer, createStubStepTracer, createTestAgentFactory, makeAction, makeActionWrapper, } from './bosun';
+export type { Action, ApiCallTrace, ApiCallTracer, Context, ConversationalTrace, ConversationalTracer, LlmUsage, PromptString, SendAction, StepDef, StepRegistry, StepTrace, StepTracer, TestAgent, TestAgentFactory, TestAgentFactoryProps, TestTextAgent, TestVoiceAgent, } from './bosun';
+export { createLocalFS } from './prompt-fs';
+export type { FsConfig, PromptFS, PromptFile } from './prompt-fs';
+export { createMockAdapter, createOpenAIAdapter, createOpenAIStreamAdapter, detectProvider, } from './llm-adapters';
+export type { OpenAIChatOptions } from './llm-adapters';
+export { classifyProviderError, reportProviderError } from './monitoring';
+export type { ProviderErrorReport } from './monitoring';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,YAAY,GACf,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC7E,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAChF,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC7E,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EACH,aAAa,EACb,UAAU,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,EACtB,UAAU,EACV,iBAAiB,GACpB,MAAM,SAAS,CAAA;AAChB,YAAY,EACR,MAAM,EACN,YAAY,EACZ,aAAa,EACb,OAAO,EACP,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,OAAO,EACP,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,GACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,GACjB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACzE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}

package/build/engine/index.js

@@ -0,0 +1,7 @@
+export { createAIEngine, createConversation, getStepBuilder } from './engine';
+export { createAIStreamEngine, getAzureClient, getOpenAiClient } from './stream';
+export { ScheduleQuery, createScheduleQuery, delayFactory } from './schedule';
+export { createContext, createMock, createStubApiCallTracer, createStubConversationalTracer, createStubStepTracer, createTestAgentFactory, makeAction, makeActionWrapper, } from './bosun';
+export { createLocalFS } from './prompt-fs';
+export { createMockAdapter, createOpenAIAdapter, createOpenAIStreamAdapter, detectProvider, } from './llm-adapters';
+export { classifyProviderError, reportProviderError } from './monitoring';

package/build/engine/interfaces/adapter.d.ts

@@ -0,0 +1,12 @@
+import * as Zod from 'zod';
+import type { MonitoringProvider } from '../../telescope';
+export interface LlmProviderInfo {
+    provider: MonitoringProvider;
+    model?: string;
+}
+export interface LlmAdapter {
+    generateResponse: (systemPrompt: string, messages: string, schema?: Zod.ZodType) => Promise<string>;
+    getOptions: () => unknown;
+    getProviderInfo?: () => LlmProviderInfo;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/build/engine/interfaces/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAA;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAOzD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,kBAAkB,CAAA;IAK5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IAOvB,gBAAgB,EAAE,CACd,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,KACnB,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpB,UAAU,EAAE,MAAM,OAAO,CAAA;IAKzB,eAAe,CAAC,EAAE,MAAM,eAAe,CAAA;CAC1C"}

package/build/engine/interfaces/adapter.js

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

package/build/engine/interfaces/conversation.d.ts

@@ -0,0 +1,19 @@
+export interface Conversation {
+    setDefaultFormatter: (formatter: (message: Message) => string) => void;
+    toString: (options?: {
+        ignoreAddedMessages?: boolean;
+    }) => string;
+    addMessage: (message: Message, opts?: {
+        formatter?: (message: Message) => string;
+    }) => void;
+    setProposedMessageFormatter: (formatter: (message: string) => string) => void;
+    setProposedReply: (message: string) => void;
+    getProposedReply: () => string | null;
+    getHistory: () => Message[];
+}
+export interface Message {
+    sender: 'user' | 'agent' | 'system';
+    text: string;
+    imageUrl?: string;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/build/engine/interfaces/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/conversation.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAKzB,mBAAmB,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,KAAK,IAAI,CAAA;IAQtE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAA;IAMjE,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAM3F,2BAA2B,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,KAAK,IAAI,CAAA;IAM7E,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAM3C,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAQrC,UAAU,EAAE,MAAM,OAAO,EAAE,CAAA;CAC9B;AAMD,MAAM,WAAW,OAAO;IAEpB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAEnC,IAAI,EAAE,MAAM,CAAA;IAEZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/build/engine/interfaces/conversation.js

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

package/build/engine/interfaces/engine.d.ts

@@ -0,0 +1,21 @@
+import { Environment } from 'nunjucks';
+import type { EventTracer } from '../../telescope';
+import { StepRegistry, StepTracer } from '../bosun';
+import { Conversation, Message } from './conversation';
+import { Logger } from './other';
+import { StepBuilder } from './steps';
+import { Workflow, WorkflowConfig } from './workflow';
+export interface AIEngine<CTX extends object> {
+    createWorkflow: (config: WorkflowConfig<CTX>) => Workflow<CTX>;
+    createConversation: (messages?: Message[]) => Conversation;
+    getStepBuilder(): StepBuilder<CTX>;
+    renderPrompt: (prompt: string, context?: object) => string;
+}
+export interface EngineConfig {
+    logger?: Logger;
+    stepTracer?: StepTracer;
+    eventTracer?: EventTracer;
+    stepRegistry?: StepRegistry;
+    nunjucksEnv?: Environment;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAqBrD,MAAM,WAAW,QAAQ,CAAC,GAAG,SAAS,MAAM;IAMxC,cAAc,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,CAAA;IAO9D,kBAAkB,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,YAAY,CAAA;IAM1D,cAAc,IAAI,WAAW,CAAC,GAAG,CAAC,CAAA;IAQlC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAC7D;AAKD,MAAM,WAAW,YAAY;IAEzB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,UAAU,CAAC,EAAE,UAAU,CAAA;IAMvB,WAAW,CAAC,EAAE,WAAW,CAAA;IAGzB,YAAY,CAAC,EAAE,YAAY,CAAA;IAG3B,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B"}

package/build/engine/interfaces/engine.js

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

package/build/engine/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+export * from './other';
+export * from './conversation';
+export * from './steps';
+export * from './stream';
+export * from './workflow';
+export * from './adapter';
+export * from './engine';
+//# sourceMappingURL=index.d.ts.map

package/build/engine/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA"}

package/build/engine/interfaces/index.js

@@ -0,0 +1,7 @@
+export * from './other';
+export * from './conversation';
+export * from './steps';
+export * from './stream';
+export * from './workflow';
+export * from './adapter';
+export * from './engine';

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

@@ -0,0 +1,7 @@
+export type { Logger } from '../../dockyard';
+export type ScheduleAction = (delay: Date, phone: string) => Promise<void>;
+export interface Scheduler {
+    registerAction: (actionName: string, action: (phone: string) => Promise<unknown>) => ScheduleAction;
+    clearAllPendingActions: (phone: string) => Promise<unknown>;
+}
+//# sourceMappingURL=other.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/other.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAQ5C,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1E,MAAM,WAAW,SAAS;IAOtB,cAAc,EAAE,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC1C,cAAc,CAAA;IAKnB,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9D"}

package/build/engine/interfaces/other.js

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

package/build/engine/interfaces/steps.d.ts

@@ -0,0 +1,33 @@
+import * as Zod from 'zod';
+import { PromptFile } from '../prompt-fs';
+import { LlmAdapter } from './adapter';
+import { Conversation } from './conversation';
+import { WorkflowControls } from './workflow';
+export interface BasicStep<CTX> {
+    name: string;
+    runIf?: (messages: Conversation, ctx: CTX) => boolean | Promise<boolean>;
+    maxAttempts?: number;
+    onError?: (error: string, ctx: CTX) => Promise<unknown>;
+}
+export interface ProgrammaticStep<CTX> extends BasicStep<CTX> {
+    execute: (messages: Conversation, ctx: CTX, workflow: WorkflowControls) => Promise<unknown>;
+}
+export interface LlmStep<CTX> extends BasicStep<CTX> {
+    model: LlmAdapter;
+    prompt: string | PromptFile;
+    ignoreAddedMessages?: boolean;
+}
+export interface JsonLlmStep<CTX, Schema extends Zod.ZodType> extends LlmStep<CTX> {
+    schema: Schema;
+    execute: (reply: Zod.infer<Schema>, conversation: Conversation, ctx: CTX, workflowControls: WorkflowControls) => Promise<unknown>;
+}
+export interface StringLlmStep<CTX> extends LlmStep<CTX> {
+    execute: (reply: string, conversation: Conversation, ctx: CTX, workflowControls?: WorkflowControls) => Promise<unknown>;
+}
+export type WorkflowStep<CTX> = StringLlmStep<CTX> | JsonLlmStep<CTX, any> | ProgrammaticStep<CTX>;
+export interface StepBuilder<CTX> {
+    <Schema extends Zod.ZodType>(step: JsonLlmStep<CTX, Schema>): JsonLlmStep<CTX, Schema>;
+    (step: StringLlmStep<CTX>): StringLlmStep<CTX>;
+    (step: ProgrammaticStep<CTX>): ProgrammaticStep<CTX>;
+}
+//# sourceMappingURL=steps.d.ts.map

package/build/engine/interfaces/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/engine/interfaces/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAA;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,SAAS,CAAC,GAAG;IAE1B,IAAI,EAAE,MAAM,CAAA;IAGZ,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAMxE,WAAW,CAAC,EAAE,MAAM,CAAA;IAGpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,gBAAgB,CAAC,GAAG,CAAE,SAAQ,SAAS,CAAC,GAAG,CAAC;IAEzD,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9F;AAED,MAAM,WAAW,OAAO,CAAC,GAAG,CAAE,SAAQ,SAAS,CAAC,GAAG,CAAC;IAEhD,KAAK,EAAE,UAAU,CAAA;IAMjB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAK3B,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,WAAW,CAAC,GAAG,EAAE,MAAM,SAAS,GAAG,CAAC,OAAO,CAAE,SAAQ,OAAO,CAAC,GAAG,CAAC;IAM9E,MAAM,EAAE,MAAM,CAAA;IAgBd,OAAO,EAAE,CACL,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EACxB,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG,EACR,gBAAgB,EAAE,gBAAgB,KACjC,OAAO,CAAC,OAAO,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,GAAG,CAAE,SAAQ,OAAO,CAAC,GAAG,CAAC;IAgBpD,OAAO,EAAE,CACL,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG,EACR,gBAAgB,CAAC,EAAE,gBAAgB,KAClC,OAAO,CAAC,OAAO,CAAC,CAAA;CACxB;AAED,MAAM,MAAM,YAAY,CAAC,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;AAElG,MAAM,WAAW,WAAW,CAAC,GAAG;IAC5B,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACtF,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAC9C,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;CACvD"}

package/build/engine/interfaces/steps.js

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