@recombine-ai/platform 0.2.6-test.9 → 0.4.0

package/build/telescope/tracers/conversational-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversational-tracer.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/conversational-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AACpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,qBAAa,6BAA8B,YAAW,oBAAoB;IAC/D,YAAY,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IAC/D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,MAAM,CAAQ;gBAGlB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAO7D,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAgClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/build/telescope/tracers/conversational-tracer.js

@@ -0,0 +1,45 @@
+export class TelescopeConversationalTracer {
+    scopeContext;
+    storage;
+    buffer = [];
+    logger;
+    constructor(storage, logger, scopeContext) {
+        this.storage = storage;
+        this.logger = logger;
+        this.scopeContext = scopeContext || null;
+    }
+    addConversationalTrace(trace) {
+        if (!trace.traceId) {
+            trace.traceId = crypto.randomUUID();
+        }
+        if (!trace.createdAt) {
+            trace.createdAt = Date.now();
+        }
+        const conversationId = trace.conversationId ?? this.scopeContext?.getStore()?.conversationId;
+        if (!conversationId) {
+            this.logger.error('ConversationalTrace missing conversationId, dropping trace', {
+                eventName: trace.eventName,
+                role: trace.role,
+                medium: trace.medium,
+            });
+            return;
+        }
+        this.buffer.push({
+            traceId: trace.traceId,
+            conversationId,
+            traceType: 'CONVERSATIONAL',
+            scopeId: trace.scopeId ?? this.scopeContext?.getStore()?.scopeId,
+            eventName: trace.eventName,
+            role: trace.role,
+            medium: trace.medium,
+            content: trace.content,
+            error: trace.error,
+            createdAt: trace.createdAt,
+        });
+    }
+    async flush() {
+        const traces = this.buffer;
+        this.buffer = [];
+        await this.storage.saveTelescopeConversationalTraces(traces);
+    }
+}

package/build/telescope/tracers/event-tracer.d.ts

@@ -0,0 +1,14 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { EventTracer, MonitoringEvent, MonitoringEventContext, MonitoringEventSchema } from '../interfaces/event-tracer';
+import type { TelescopeContext } from '../interfaces/telescope';
+export declare const MONITORING_EVENT_SCHEMA: MonitoringEventSchema;
+export type MonitoringSink = (line: string) => void;
+export declare class TelescopeEventTracer implements EventTracer {
+    private readonly context;
+    private readonly sink;
+    private readonly scopeContext;
+    constructor(context: MonitoringEventContext, sink?: MonitoringSink, scopeContext?: AsyncLocalStorage<TelescopeContext> | null);
+    emit(event: MonitoringEvent): void;
+    private withAmbientConversationId;
+}
+//# sourceMappingURL=event-tracer.d.ts.map

package/build/telescope/tracers/event-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tracer.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/event-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGpD,OAAO,KAAK,EACR,WAAW,EACX,eAAe,EACf,sBAAsB,EAGtB,qBAAqB,EACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAM/D,eAAO,MAAM,uBAAuB,EAAE,qBAA6C,CAAA;AAEnF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAwDnD,qBAAa,oBAAqB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;gBAGrE,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,cAA4B,EAClC,YAAY,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAO7D,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAsBlC,OAAO,CAAC,yBAAyB;CA2BpC"}

package/build/telescope/tracers/event-tracer.js

@@ -0,0 +1,72 @@
+import { writeSync } from 'node:fs';
+export const MONITORING_EVENT_SCHEMA = 'monitoring.event.v1';
+const defaultSink = (line) => {
+    writeSync(1, line);
+};
+const EVENTS_WITH_CONVERSATION_ID = new Set([
+    'text.chat.started',
+    'agent.killswitch.triggered',
+    'agent.runtime.fatal_error',
+    'api.third_party.unexpected_error',
+    'api.request.latency',
+    'workflow.analytical.latency',
+    'text.latency.full_response',
+]);
+const EVENTS_WITH_MESSAGING_PROVIDER = new Set([
+    'text.latency.full_response',
+]);
+const EVENTS_WITH_AGENT_ID = new Set([
+    'text.chat.started',
+    'voice.call.accepted',
+    'agent.killswitch.triggered',
+    'agent.runtime.fatal_error',
+    'workflow.analytical.latency',
+    'text.latency.full_response',
+    'agent.escalation.requested',
+    'workflow.freeze.outlier',
+]);
+export class TelescopeEventTracer {
+    context;
+    sink;
+    scopeContext;
+    constructor(context, sink = defaultSink, scopeContext) {
+        this.context = context;
+        this.sink = sink;
+        this.scopeContext = scopeContext ?? null;
+    }
+    emit(event) {
+        const envelope = {
+            schema: MONITORING_EVENT_SCHEMA,
+            monitoringEvent: event.event,
+            service: this.context.service,
+            environment: this.context.environment,
+            attributes: this.withAmbientConversationId(event),
+            ts: Date.now(),
+        };
+        try {
+            this.sink(`${JSON.stringify(envelope)}\n`);
+        }
+        catch {
+        }
+    }
+    withAmbientConversationId(event) {
+        let attributes = event.attributes;
+        const store = this.scopeContext?.getStore();
+        if (EVENTS_WITH_CONVERSATION_ID.has(event.event) &&
+            attributes.conversationId === undefined &&
+            store?.conversationId !== undefined) {
+            attributes = { ...attributes, conversationId: store.conversationId };
+        }
+        if (EVENTS_WITH_AGENT_ID.has(event.event) &&
+            attributes.agentId === undefined &&
+            store?.agentId !== undefined) {
+            attributes = { ...attributes, agentId: store.agentId };
+        }
+        if (EVENTS_WITH_MESSAGING_PROVIDER.has(event.event) &&
+            attributes.provider === undefined &&
+            store?.messagingProvider !== undefined) {
+            attributes = { ...attributes, provider: store.messagingProvider };
+        }
+        return attributes;
+    }
+}

package/build/telescope/tracers/index.d.ts

@@ -0,0 +1,7 @@
+export { TelescopeApiCallTracer } from './api-call-tracer';
+export { TelescopeConversationalTracer } from './conversational-tracer';
+export { TelescopeLatencyTracer } from './latency-tracer';
+export { TelescopeStepTracer } from './step-tracer';
+export { MONITORING_EVENT_SCHEMA, TelescopeEventTracer } from './event-tracer';
+export type { MonitoringSink } from './event-tracer';
+//# sourceMappingURL=index.d.ts.map

package/build/telescope/tracers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/build/telescope/tracers/index.js

@@ -0,0 +1,5 @@
+export { TelescopeApiCallTracer } from './api-call-tracer';
+export { TelescopeConversationalTracer } from './conversational-tracer';
+export { TelescopeLatencyTracer } from './latency-tracer';
+export { TelescopeStepTracer } from './step-tracer';
+export { MONITORING_EVENT_SCHEMA, TelescopeEventTracer } from './event-tracer';

package/build/telescope/tracers/latency-tracer.d.ts

@@ -0,0 +1,15 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { Logger } from '../../dockyard';
+import type { LatencyTrace, LatencyTracer } from '../interfaces/latency-tracer';
+import type { TelescopeStorage } from '../interfaces/storage';
+import type { TelescopeContext } from '../interfaces/telescope';
+export declare class TelescopeLatencyTracer implements LatencyTracer {
+    private scopeContext;
+    private storage;
+    private buffer;
+    private logger;
+    constructor(storage: TelescopeStorage, logger: Logger, scopeContext?: AsyncLocalStorage<TelescopeContext> | null);
+    addLatencyTrace(trace: LatencyTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=latency-tracer.d.ts.map

package/build/telescope/tracers/latency-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-tracer.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/latency-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,qBAAa,sBAAuB,YAAW,aAAa;IACxD,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAQ;gBAGlB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAO7D,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IA2BpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/build/telescope/tracers/latency-tracer.js

@@ -0,0 +1,40 @@
+export class TelescopeLatencyTracer {
+    scopeContext;
+    storage;
+    buffer = [];
+    logger;
+    constructor(storage, logger, scopeContext) {
+        this.storage = storage;
+        this.logger = logger;
+        this.scopeContext = scopeContext || null;
+    }
+    addLatencyTrace(trace) {
+        if (!trace.traceId) {
+            trace.traceId = crypto.randomUUID();
+        }
+        const conversationId = trace.conversationId ?? this.scopeContext?.getStore()?.conversationId;
+        if (!conversationId) {
+            this.logger.error('LatencyTrace missing conversationId, dropping trace', {
+                traceId: trace.traceId,
+                eventType: trace.eventType,
+                seq: trace.seq,
+            });
+            return;
+        }
+        this.buffer.push({
+            traceId: trace.traceId,
+            conversationId,
+            traceType: 'LATENCY',
+            seq: trace.seq,
+            atMs: trace.atMs,
+            eventType: trace.eventType,
+            payload: trace.payload,
+            createdAt: trace.createdAt,
+        });
+    }
+    async flush() {
+        const traces = this.buffer;
+        this.buffer = [];
+        await this.storage.saveTelescopeLatencyTraces(traces);
+    }
+}

package/build/telescope/tracers/step-tracer.d.ts

@@ -0,0 +1,15 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { Logger } from '../../dockyard';
+import type { StepTrace, StepTracer } from '../interfaces/step-tracer';
+import type { TelescopeStorage } from '../interfaces/storage';
+import type { TelescopeContext } from '../interfaces/telescope';
+export declare class TelescopeStepTracer implements StepTracer {
+    scopeContext: AsyncLocalStorage<TelescopeContext> | null;
+    private storage;
+    private buffer;
+    private logger;
+    constructor(storage: TelescopeStorage, logger: Logger, scopeContext?: AsyncLocalStorage<TelescopeContext> | null);
+    addStepTrace(trace: StepTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=step-tracer.d.ts.map

package/build/telescope/tracers/step-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tracer.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/step-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,qBAAa,mBAAoB,YAAW,UAAU;IAC3C,YAAY,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IAC/D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAQ;gBAGlB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAW7D,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAwC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/build/telescope/tracers/step-tracer.js

@@ -0,0 +1,50 @@
+export class TelescopeStepTracer {
+    scopeContext;
+    storage;
+    buffer = [];
+    logger;
+    constructor(storage, logger, scopeContext) {
+        this.logger = logger;
+        this.storage = storage;
+        this.scopeContext = scopeContext || null;
+    }
+    addStepTrace(trace) {
+        this.logger.log('Adding step trace');
+        const traceId = trace.traceId || crypto.randomUUID();
+        const createdAt = trace.createdAt || Date.now();
+        const conversationId = trace.conversationId || this.scopeContext?.getStore()?.conversationId;
+        if (!conversationId) {
+            this.logger.error('StepTrace missing conversationId, dropping trace', {
+                name: trace.name,
+                workflowId: trace.workflowId,
+                workflowRunId: trace.workflowRunId,
+            });
+            return;
+        }
+        this.buffer.push({
+            traceId,
+            conversationId,
+            traceType: 'STEP',
+            scopeId: trace.scopeId ?? this.scopeContext?.getStore()?.scopeId,
+            workflowId: trace.workflowId,
+            workflowRunId: trace.workflowRunId,
+            name: trace.name,
+            renderedPrompt: trace.renderedPrompt,
+            receivedContext: trace.receivedContext,
+            receivedPrompt: trace.receivedPrompt,
+            stringifiedConversation: trace.stringifiedConversation,
+            schema: trace.schema,
+            model: trace.model,
+            llmUsage: trace.llmUsage,
+            response: trace.response,
+            error: trace.error,
+            createdAt,
+        });
+        this.logger.log('Logged trace to buffer', trace.name);
+    }
+    async flush() {
+        const traces = this.buffer;
+        this.buffer = [];
+        await this.storage.saveTelescopeStepTraces(traces);
+    }
+}

package/build/text-agent-handlers/event.d.ts

@@ -0,0 +1,11 @@
+export type ChannelType = 'whatsapp' | 'sms' | 'mms' | 'webchat' | 'email' | 'other';
+export declare const CHANNEL_TYPES: ChannelType[];
+export interface Event<TMeta = Record<string, unknown>> {
+    kind: string;
+    conversationId: string;
+    sender: string;
+    body: string | null;
+    channel: ChannelType;
+    metadata: TMeta;
+}
+//# sourceMappingURL=event.d.ts.map

package/build/text-agent-handlers/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/event.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AACpF,eAAO,MAAM,aAAa,EAAE,WAAW,EAA4D,CAAA;AAEnG,MAAM,WAAW,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIlD,IAAI,EAAE,MAAM,CAAA;IAKZ,cAAc,EAAE,MAAM,CAAA;IAOtB,MAAM,EAAE,MAAM,CAAA;IAMd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAKnB,OAAO,EAAE,WAAW,CAAA;IAKpB,QAAQ,EAAE,KAAK,CAAA;CAClB"}

package/build/text-agent-handlers/event.js

@@ -0,0 +1 @@
+export const CHANNEL_TYPES = ['whatsapp', 'sms', 'mms', 'webchat', 'email', 'other'];

package/build/text-agent-handlers/incoming-message.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from '../dockyard';
+import type { Event } from './event';
+import type { AgentCreator, AgentRegistry, ChatLockStore } from './ports';
+export interface IncomingMessageOptions<TMeta> {
+    registry: AgentRegistry;
+    chatLocks: ChatLockStore;
+    getAgentCreator: (agentId: string) => AgentCreator<TMeta> | null;
+    parseMetadata: (event: Event) => Event<TMeta>;
+    logger: Logger;
+    delays?: {
+        messageSeconds?: number;
+        webchatSeconds?: number;
+        timeLimitSeconds?: number;
+    };
+}
+export declare function createIncomingMessageHandler<TMeta>(options: IncomingMessageOptions<TMeta>): (event: Event) => Promise<void>;
+//# sourceMappingURL=incoming-message.d.ts.map

package/build/text-agent-handlers/incoming-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incoming-message.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/incoming-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAY,aAAa,EAAE,MAAM,SAAS,CAAA;AAYnF,MAAM,WAAW,sBAAsB,CAAC,KAAK;IACzC,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,EAAE,aAAa,CAAA;IACxB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAChE,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3F;AAOD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAuI1C,OAAO,KAAK,KAAG,OAAO,CAAC,IAAI,CAAC,CAW3E"}

package/build/text-agent-handlers/incoming-message.js

@@ -0,0 +1,131 @@
+const DEFAULT_MESSAGE_DELAY_SECONDS = 60;
+const DEFAULT_WEBCHAT_DELAY_SECONDS = 30;
+const DEFAULT_TIME_LIMIT_SECONDS = 14 * 60;
+const addSeconds = (date, seconds) => new Date(date.getTime() + seconds * 1000);
+const isAfter = (date, dateToCompare) => date.getTime() > dateToCompare.getTime();
+const differenceInMilliseconds = (later, earlier) => later.getTime() - earlier.getTime();
+const differenceInSeconds = (later, earlier) => Math.trunc(differenceInMilliseconds(later, earlier) / 1000);
+export function createIncomingMessageHandler(options) {
+    const { registry, chatLocks, getAgentCreator, parseMetadata, logger, delays = {} } = options;
+    const messageDelaySeconds = delays.messageSeconds ?? DEFAULT_MESSAGE_DELAY_SECONDS;
+    const webchatDelaySeconds = delays.webchatSeconds ?? DEFAULT_WEBCHAT_DELAY_SECONDS;
+    const timeLimitSeconds = delays.timeLimitSeconds ?? DEFAULT_TIME_LIMIT_SECONDS;
+    async function createAgent(conversationId) {
+        const agentRecord = await registry.getAgent(conversationId);
+        if (!agentRecord) {
+            throw new Error(`incoming-message, agent not found for ${conversationId}`);
+        }
+        const agentCreator = getAgentCreator(agentRecord.agentId);
+        if (!agentCreator) {
+            throw new Error(`incoming-message, agent creator not found for ${agentRecord.agentId}`);
+        }
+        const { agent, scheduler } = await agentCreator(conversationId, agentRecord.agentId);
+        return { agent, scheduler, agentRecord };
+    }
+    async function handleChatMessage(event) {
+        logger.debug('incoming-message.handleChatMessage, handling message', {
+            conversationId: event.conversationId,
+        });
+        const { agent, scheduler, agentRecord } = await createAgent(event.conversationId);
+        let shouldContinue = true;
+        try {
+            if (!(await agent.isAssigned(event.conversationId))) {
+                logger.debug('incoming-message (reactOnMessage), workflow is unassigned from bot');
+                await registry.deleteAgent(event.conversationId, agentRecord.agentId);
+                await scheduler.clearAllPendingActions(event.conversationId);
+                return;
+            }
+            shouldContinue = await agent.reactOnMessage(event);
+        }
+        catch (err) {
+            logger.error('incoming-message, could not react to message', { err });
+            await agent.onFatalError(err instanceof Error ? err.message : String(err), event.conversationId);
+            await scheduler.clearAllPendingActions(event.conversationId);
+            await registry.deleteAgent(event.conversationId, agentRecord.agentId);
+        }
+        if (!shouldContinue) {
+            return;
+        }
+        const currentDate = new Date();
+        const delaySeconds = event.channel === 'webchat' ? webchatDelaySeconds : messageDelaySeconds;
+        const newLock = {
+            conversationId: event.conversationId,
+            expiresAt: addSeconds(currentDate, delaySeconds),
+            createdAt: currentDate,
+        };
+        const successfullyLocked = await chatLocks.lockChat(newLock);
+        logger.debug('incoming-message, chat lock status', {
+            successfullyLocked,
+            conversationId: event.conversationId,
+        });
+        if (!successfullyLocked) {
+            const newExpiration = addSeconds(currentDate, delaySeconds);
+            await chatLocks.updateLockExpiration(event.conversationId, newExpiration);
+            return;
+        }
+        await handleMessageOnLockRelease(event, newLock);
+    }
+    async function handleMessageOnLockRelease(event, chatLock) {
+        logger.debug('incoming-message.handleMessageOnLockRelease, handling message', {
+            conversationId: event.conversationId,
+        });
+        const currentLock = chatLock ?? (await chatLocks.getChatLock(event.conversationId));
+        const { agent, scheduler, agentRecord } = await createAgent(event.conversationId);
+        if (currentLock)
+            logger.debug('incoming-message.handleMessageOnLockRelease, is chat lock expired', {
+                isExpired: isAfter(new Date(), currentLock.expiresAt),
+            });
+        if (!currentLock || isAfter(new Date(), currentLock.expiresAt)) {
+            logger.debug('incoming-message, chat lock expired, invoking workflow', {
+                conversationId: event.conversationId,
+            });
+            await chatLocks.releaseLock(event.conversationId);
+            try {
+                if (!(await agent.isAssigned(event.conversationId))) {
+                    logger.debug('incoming-message (respondToMessage), workflow is unassigned from bot');
+                    await registry.deleteAgent(event.conversationId, agentRecord.agentId);
+                    await scheduler.clearAllPendingActions(event.conversationId);
+                    return;
+                }
+                await agent.onChatReady(event.conversationId, event.metadata);
+                await agent.respondToMessage(event);
+            }
+            catch (err) {
+                logger.error('incoming-message, could not respond to message', { err });
+                await agent.onFatalError(String(err), event.conversationId);
+                await scheduler.clearAllPendingActions(event.conversationId);
+                await registry.deleteAgent(event.conversationId, agentRecord.agentId);
+            }
+            return;
+        }
+        if (differenceInSeconds(currentLock.expiresAt, currentLock.createdAt) > timeLimitSeconds) {
+            logger.debug('incoming-message, lock has exceeded time limit, rejecting workflow and releasing lock', {
+                conversationId: event.conversationId,
+                timeLimitSeconds,
+            });
+            await agent.onFatalError(`Could not process new messages, there are too many consecutive responses.`, event.conversationId);
+            await registry.deleteAgent(event.conversationId, agentRecord.agentId);
+            await scheduler.clearAllPendingActions(event.conversationId);
+            await chatLocks.releaseLock(event.conversationId);
+        }
+        const waitingPeriod = differenceInMilliseconds(currentLock.expiresAt, new Date());
+        logger.debug('incoming-message, waiting for chat lock to be released', {
+            conversationId: event.conversationId,
+            waitingPeriodMs: waitingPeriod,
+        });
+        await new Promise((resolve) => setTimeout(resolve, waitingPeriod));
+        await handleMessageOnLockRelease(event);
+    }
+    return async function handleIncomingMessage(event) {
+        if (!event.conversationId) {
+            logger.error('incoming-message, missing conversationId in event', { event });
+            return;
+        }
+        try {
+            await handleChatMessage(parseMetadata(event));
+        }
+        catch (err) {
+            logger.error('incoming-message, could not handle incoming message', { err });
+        }
+    };
+}

package/build/text-agent-handlers/index.d.ts

@@ -0,0 +1,15 @@
+export { CHANNEL_TYPES } from './event';
+export type { ChannelType, Event } from './event';
+export type { Job, JobInput, JobsPersistence } from './jobs';
+export type { AgentCreator, AgentRecord, AgentRegistry, ChatLock, ChatLockStore, HandlerResponse, JobRunner, } from './ports';
+export { createIncomingMessageHandler } from './incoming-message';
+export type { IncomingMessageOptions } from './incoming-message';
+export { createJobsHandler } from './jobs-handler';
+export type { JobsHandlerOptions } from './jobs-handler';
+export { createMessageAcceptor } from './message-acceptor';
+export type { MessageAcceptorOptions } from './message-acceptor';
+export { createNotificationHookHandler } from './notification-hook';
+export type { NotificationHookOptions, NotificationHookRequest } from './notification-hook';
+export { instrumentTextAgent } from './instrument';
+export type { InstrumentTextAgentOptions } from './instrument';
+//# sourceMappingURL=index.d.ts.map

package/build/text-agent-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACjD,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAC5D,YAAY,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,eAAe,EACf,SAAS,GACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAA;AACnE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA"}

package/build/text-agent-handlers/index.js

@@ -0,0 +1,6 @@
+export { CHANNEL_TYPES } from './event';
+export { createIncomingMessageHandler } from './incoming-message';
+export { createJobsHandler } from './jobs-handler';
+export { createMessageAcceptor } from './message-acceptor';
+export { createNotificationHookHandler } from './notification-hook';
+export { instrumentTextAgent } from './instrument';

package/build/text-agent-handlers/instrument.d.ts

@@ -0,0 +1,12 @@
+import type { TextAgent } from '../agent';
+import type { ITelescope, MonitoringProvider } from '../telescope';
+import type { Event } from './event';
+export interface InstrumentTextAgentOptions<TMeta> {
+    telescope: ITelescope;
+    agent: TextAgent<TMeta>;
+    fallbackConversationId: string;
+    messagingProvider?: MonitoringProvider;
+    onEvent?: (event: Event<TMeta>) => Promise<void>;
+}
+export declare function instrumentTextAgent<TMeta>(options: InstrumentTextAgentOptions<TMeta>): TextAgent<TMeta>;
+//# sourceMappingURL=instrument.d.ts.map

package/build/text-agent-handlers/instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAElE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC7C,SAAS,EAAE,UAAU,CAAA;IACrB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;IAEvB,sBAAsB,EAAE,MAAM,CAAA;IAE9B,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;IAEtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAaD,wBAAgB,mBAAmB,CAAC,KAAK,EACrC,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAC3C,SAAS,CAAC,KAAK,CAAC,CAiDlB"}

package/build/text-agent-handlers/instrument.js

@@ -0,0 +1,27 @@
+import { emitConversationalTrace, textEventTrace } from '../telescope';
+export function instrumentTextAgent(options) {
+    const { telescope, agent, fallbackConversationId, messagingProvider, onEvent } = options;
+    const observation = (conversationId) => ({ conversationId, messagingProvider });
+    async function traceReceivedMessage(event) {
+        if (event.kind !== 'message')
+            return;
+        await emitConversationalTrace(telescope.getConversationalTracer(), textEventTrace(event.conversationId || fallbackConversationId, 'received-message', event.body ?? ''));
+    }
+    return {
+        name: agent.name,
+        sender: agent.sender,
+        startWorkflow: async (id) => telescope.runObservation(() => agent.startWorkflow(id), observation(id)),
+        reactOnMessage: async (event) => telescope.runObservation(async () => {
+            await onEvent?.(event);
+            await traceReceivedMessage(event);
+            return agent.reactOnMessage(event);
+        }, observation(event.conversationId || fallbackConversationId)),
+        onChatReady: async (id, meta) => telescope.runObservation(() => agent.onChatReady(id, meta), observation(id)),
+        respondToMessage: async (event) => telescope.runObservation(async () => {
+            await onEvent?.(event);
+            return agent.respondToMessage(event);
+        }, observation(event.conversationId || fallbackConversationId)),
+        isAssigned: async (id) => telescope.runObservation(() => agent.isAssigned(id), observation(id)),
+        onFatalError: async (error, id) => telescope.runObservation(() => agent.onFatalError(error, id), observation(id || fallbackConversationId)),
+    };
+}

package/build/text-agent-handlers/jobs-handler.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from '../dockyard';
+import type { JobInput } from './jobs';
+import type { AgentCreator, AgentRegistry, HandlerResponse } from './ports';
+export interface JobsHandlerOptions<TMeta> {
+    registry: AgentRegistry;
+    getAgentCreator: (agentId: string) => AgentCreator<TMeta> | null;
+    logger: Logger;
+}
+export declare function createJobsHandler<TMeta>(options: JobsHandlerOptions<TMeta>): (input: JobInput) => Promise<HandlerResponse>;
+//# sourceMappingURL=jobs-handler.d.ts.map

package/build/text-agent-handlers/jobs-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-handler.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/jobs-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG3E,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACrC,QAAQ,EAAE,aAAa,CAAA;IACvB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAChE,MAAM,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAGvC,OAAO,QAAQ,KAAG,OAAO,CAAC,eAAe,CAAC,CAuB7E"}

package/build/text-agent-handlers/jobs-handler.js

@@ -0,0 +1,27 @@
+import { handlerResponse } from './ports';
+export function createJobsHandler(options) {
+    const { registry, getAgentCreator, logger } = options;
+    return async function handleJob(input) {
+        const agentCreator = getAgentCreator(input.workflowId);
+        if (!agentCreator) {
+            logger.error('jobs, unknown workflowId', { workflowId: input.workflowId });
+            return handlerResponse(400, { message: `Unknown workflowId: ${input.workflowId}` });
+        }
+        const { scheduler, agent } = await agentCreator(input.conversationId, input.workflowId);
+        if (await agent.isAssigned(input.conversationId)) {
+            try {
+                await scheduler.runJob(input);
+            }
+            catch (err) {
+                await agent.onFatalError(String(err), input.conversationId);
+                await scheduler.clearAllPendingActions(input.conversationId);
+                await registry.deleteAgent(input.conversationId, input.workflowId);
+            }
+        }
+        else {
+            await registry.deleteAgent(input.conversationId, input.workflowId);
+            await scheduler.clearAllPendingActions(input.conversationId);
+        }
+        return handlerResponse(200, { message: 'OK' });
+    };
+}

package/build/text-agent-handlers/jobs.d.ts

@@ -0,0 +1,19 @@
+export interface Job {
+    jobId: string;
+    conversationId: string;
+    pointInTime: number;
+}
+export interface JobInput {
+    jobId: string;
+    workflowId: string;
+    conversationId: string;
+    handlerId: string;
+}
+export interface JobsPersistence {
+    getAllJobs(): Promise<Job[]>;
+    getJobById(jobId: string): Promise<Job>;
+    dropJob(jobId: string): Promise<void>;
+    saveJob: (job: Job) => Promise<void>;
+    getJobsByConversationId: (conversationId: string) => Promise<Job[]>;
+}
+//# sourceMappingURL=jobs.d.ts.map

package/build/text-agent-handlers/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/jobs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACtB;AAKD,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,uBAAuB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;CACtE"}

package/build/text-agent-handlers/jobs.js

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

package/build/text-agent-handlers/message-acceptor.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from '../dockyard';
+import type { EventTracer } from '../telescope';
+import type { Event } from './event';
+import type { AgentRegistry, HandlerResponse } from './ports';
+export interface MessageAcceptorOptions {
+    registry: AgentRegistry;
+    resolveAgentId: (event: Event) => string;
+    eventTracer: EventTracer;
+    invokeIncomingMessage: (event: Event) => Promise<void>;
+    logger: Logger;
+}
+export declare function createMessageAcceptor(options: MessageAcceptorOptions): (event: Event) => Promise<HandlerResponse>;
+//# sourceMappingURL=message-acceptor.d.ts.map

package/build/text-agent-handlers/message-acceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-acceptor.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/message-acceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG7D,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,aAAa,CAAA;IAEvB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IAExB,qBAAqB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,IAG7B,OAAO,KAAK,KAAG,OAAO,CAAC,eAAe,CAAC,CAqC9E"}