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

package/build/telescope/interfaces/telescope.d.ts

@@ -0,0 +1,22 @@
+import type { ApiCallTracer } from './api-call-tracer';
+import type { TelescopeConversation } from './conversation';
+import type { ConversationalTracer } from './conversational-tracer';
+import type { EventTracer, MonitoringProvider } from './event-tracer';
+import type { LatencyTracer } from './latency-tracer';
+import type { StepTracer } from './step-tracer';
+export interface TelescopeContext {
+    scopeId: string;
+    conversationId?: string;
+    agentId?: string;
+    messagingProvider?: MonitoringProvider;
+}
+export interface ITelescope {
+    saveConversation(conversation: TelescopeConversation): Promise<void>;
+    getStepTracer(): StepTracer;
+    getApiCallTracer(): ApiCallTracer;
+    getConversationalTracer(): ConversationalTracer;
+    getLatencyTracer(): LatencyTracer;
+    getEventTracer(): EventTracer;
+    runObservation<T>(fn: () => Promise<T>, context?: Partial<TelescopeContext>): Promise<T>;
+}
+//# sourceMappingURL=telescope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telescope.d.ts","sourceRoot":"","sources":["../../../src/telescope/interfaces/telescope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAW/C,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;CACzC;AASD,MAAM,WAAW,UAAU;IACvB,gBAAgB,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,aAAa,IAAI,UAAU,CAAA;IAC3B,gBAAgB,IAAI,aAAa,CAAA;IACjC,uBAAuB,IAAI,oBAAoB,CAAA;IAC/C,gBAAgB,IAAI,aAAa,CAAA;IACjC,cAAc,IAAI,WAAW,CAAA;IAC7B,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC3F"}

package/build/telescope/interfaces/telescope.js

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

package/build/telescope/interfaces/traces.d.ts

@@ -0,0 +1,88 @@
+import type { LlmUsage } from './step-tracer';
+export type TelescopeStepTrace = {
+    traceId: string;
+    conversationId: string;
+    traceType: 'STEP';
+    scopeId?: string;
+    workflowId: string;
+    workflowRunId: string;
+    name: string;
+    renderedPrompt?: string;
+    receivedContext?: unknown;
+    receivedPrompt?: unknown;
+    stringifiedConversation?: string;
+    schema?: unknown;
+    model?: string;
+    llmUsage?: LlmUsage;
+    response?: string;
+    error?: unknown;
+    createdAt: number;
+};
+export type TelescopeApiCallTrace = {
+    traceId: string;
+    conversationId: string;
+    traceType: 'API_CALL';
+    scopeId?: string;
+    operationName: string;
+    method: string;
+    path: string;
+    baseUrl?: string;
+    request?: unknown;
+    response?: unknown;
+    status?: number;
+    ok?: boolean;
+    durationMs?: number;
+    error?: unknown;
+    createdAt: number;
+};
+export type TelescopeLatencyTrace = {
+    traceId: string;
+    conversationId: string;
+    traceType: 'LATENCY';
+    seq: number;
+    atMs: number;
+    eventType: string;
+    payload?: unknown;
+    createdAt: number;
+};
+export type TelescopeConversationalTrace = {
+    traceId: string;
+    conversationId: string;
+    traceType: 'CONVERSATIONAL';
+    scopeId?: string;
+    eventName: string;
+    role: string;
+    medium: string;
+    content: string;
+    contentTruncated?: boolean;
+    contentOriginalBytes?: number;
+    error?: unknown;
+    createdAt: number;
+};
+export type TelescopeTrace = TelescopeStepTrace | TelescopeApiCallTrace | TelescopeConversationalTrace;
+export type TelescopeStepTracesResult = {
+    limit: number;
+    items: TelescopeStepTrace[];
+    lastTraceId?: string;
+};
+export type TelescopeApiCallTracesResult = {
+    limit: number;
+    items: TelescopeApiCallTrace[];
+    lastTraceId?: string;
+};
+export type TelescopeLatencyTracesResult = {
+    limit: number;
+    items: TelescopeLatencyTrace[];
+    lastTraceId?: string;
+};
+export type TelescopeConversationalTracesResult = {
+    limit: number;
+    items: TelescopeConversationalTrace[];
+    lastTraceId?: string;
+};
+export type TelescopeTracesResult = {
+    limit: number;
+    items: TelescopeTrace[];
+    lastTraceId?: string;
+};
+//# sourceMappingURL=traces.d.ts.map

package/build/telescope/interfaces/traces.d.ts.map

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

package/build/telescope/interfaces/traces.js

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

package/build/telescope/latency-events.d.ts

@@ -0,0 +1,15 @@
+export declare const LATENCY_EVENT_SCHEMA: "latency.event.v1";
+export declare const LATENCY_EVENT_TYPES: readonly ["call.started", "call.ended", "vad.activated", "vad.deactivated", "stt.started", "stt.interim", "stt.final", "speech.created", "reply.pending.started", "reply.pending.completed", "llm.wait.started", "llm.wait.completed", "llm.stream.started", "llm.stream.completed", "llm.requested", "llm.connect_tcp.started", "llm.connect_tcp.completed", "llm.connect_tcp.failed", "llm.start_tls.started", "llm.start_tls.completed", "llm.start_tls.failed", "llm.first_token", "llm.completed", "tts.text.first_sent", "tts.text.completed", "tts.provider.started", "tts.provider.completed", "tts.audio.first_received", "tts.audio.last_received", "tts.decode.started", "tts.decode.completed", "audio.output.wait.started", "audio.output.wait.completed", "interruption.detected", "audio.playback.started", "audio.playback.stopped", "audio.playback.ended", "audio.playback.interrupted"];
+export type LatencyEventType = (typeof LATENCY_EVENT_TYPES)[number];
+export type LatencyEventPayload = Record<string, unknown>;
+export type LatencyEvent = {
+    schema: typeof LATENCY_EVENT_SCHEMA;
+    seq: number;
+    atMs: number;
+    eventType: LatencyEventType;
+    payload?: LatencyEventPayload;
+};
+export type LatencyEventRequest = LatencyEvent & {
+    conversationId?: string;
+};
+//# sourceMappingURL=latency-events.d.ts.map

package/build/telescope/latency-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-events.d.ts","sourceRoot":"","sources":["../../src/telescope/latency-events.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,EAAG,kBAA2B,CAAA;AAE/D,eAAO,MAAM,mBAAmB,42BAuCtB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,OAAO,oBAAoB,CAAA;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,gBAAgB,CAAA;IAC3B,OAAO,CAAC,EAAE,mBAAmB,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA"}

package/build/telescope/latency-events.js

@@ -0,0 +1,41 @@
+export const LATENCY_EVENT_SCHEMA = 'latency.event.v1';
+export const LATENCY_EVENT_TYPES = [
+    'call.started',
+    'call.ended',
+    'vad.activated',
+    'vad.deactivated',
+    'stt.started',
+    'stt.interim',
+    'stt.final',
+    'speech.created',
+    'reply.pending.started',
+    'reply.pending.completed',
+    'llm.wait.started',
+    'llm.wait.completed',
+    'llm.stream.started',
+    'llm.stream.completed',
+    'llm.requested',
+    'llm.connect_tcp.started',
+    'llm.connect_tcp.completed',
+    'llm.connect_tcp.failed',
+    'llm.start_tls.started',
+    'llm.start_tls.completed',
+    'llm.start_tls.failed',
+    'llm.first_token',
+    'llm.completed',
+    'tts.text.first_sent',
+    'tts.text.completed',
+    'tts.provider.started',
+    'tts.provider.completed',
+    'tts.audio.first_received',
+    'tts.audio.last_received',
+    'tts.decode.started',
+    'tts.decode.completed',
+    'audio.output.wait.started',
+    'audio.output.wait.completed',
+    'interruption.detected',
+    'audio.playback.started',
+    'audio.playback.stopped',
+    'audio.playback.ended',
+    'audio.playback.interrupted',
+];

package/build/telescope/stub-storage.d.ts

@@ -0,0 +1,21 @@
+import { type Logger } from '../dockyard';
+import type { ConversationSearchResult, TelescopeConversation } from './interfaces/conversation';
+import type { TelescopeStorage } from './interfaces/storage';
+import type { TelescopeApiCallTrace, TelescopeApiCallTracesResult, TelescopeConversationalTrace, TelescopeConversationalTracesResult, TelescopeLatencyTrace, TelescopeLatencyTracesResult, TelescopeStepTrace, TelescopeStepTracesResult, TelescopeTracesResult } from './interfaces/traces';
+export declare class StubStorage implements TelescopeStorage {
+    private logger;
+    constructor(logger?: Logger);
+    saveConversation(conversation: TelescopeConversation): Promise<void>;
+    searchConversations(phoneNumber?: string, limit?: number, lastConversationId?: string, agentId?: string): Promise<ConversationSearchResult>;
+    getConversation(conversationId: string): Promise<TelescopeConversation | null>;
+    saveTelescopeStepTraces(traces: TelescopeStepTrace[]): Promise<void>;
+    getTelescopeStepTraces(conversationId: string, limit?: number, lastTraceId?: string): Promise<TelescopeStepTracesResult>;
+    saveTelescopeApiCallTraces(traces: TelescopeApiCallTrace[]): Promise<void>;
+    saveTelescopeLatencyTraces(traces: TelescopeLatencyTrace[]): Promise<void>;
+    getTelescopeApiCallTraces(conversationId: string, limit?: number, lastTraceId?: string): Promise<TelescopeApiCallTracesResult>;
+    getTelescopeLatencyTraces(conversationId: string, limit?: number, lastTraceId?: string): Promise<TelescopeLatencyTracesResult>;
+    saveTelescopeConversationalTraces(traces: TelescopeConversationalTrace[]): Promise<void>;
+    getTelescopeConversationalTraces(conversationId: string, limit?: number, lastTraceId?: string): Promise<TelescopeConversationalTracesResult>;
+    getTelescopeTraces(conversationId: string, limit?: number, lastTraceId?: string): Promise<TelescopeTracesResult>;
+}
+//# sourceMappingURL=stub-storage.d.ts.map

package/build/telescope/stub-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-storage.d.ts","sourceRoot":"","sources":["../../src/telescope/stub-storage.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,MAAM,EAAqB,MAAM,aAAa,CAAA;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EACR,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,mCAAmC,EACnC,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,yBAAyB,EAEzB,qBAAqB,EACxB,MAAM,qBAAqB,CAAA;AAM5B,qBAAa,WAAY,YAAW,gBAAgB;IAChD,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,CAAC,EAAE,MAAM;IAIrB,gBAAgB,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,mBAAmB,CACrB,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,CAAC;IAU9B,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAK9E,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,sBAAsB,CACxB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,yBAAyB,CAAC;IAK/B,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,yBAAyB,CAC3B,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,4BAA4B,CAAC;IAKlC,yBAAyB,CAC3B,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,4BAA4B,CAAC;IAKlC,iCAAiC,CAAC,MAAM,EAAE,4BAA4B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF,gCAAgC,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mCAAmC,CAAC;IAKzC,kBAAkB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAW,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC;CAIpC"}

package/build/telescope/stub-storage.js

@@ -0,0 +1,55 @@
+import createLogger, { childLoggerFabric } from '../dockyard';
+export class StubStorage {
+    logger;
+    constructor(logger) {
+        this.logger = logger || childLoggerFabric(createLogger())('StubStorage');
+    }
+    async saveConversation(conversation) {
+        this.logger.debug('saveConversation', { conversation });
+    }
+    async searchConversations(phoneNumber, limit, lastConversationId, agentId) {
+        this.logger.debug('searchConversations', {
+            phoneNumber,
+            limit,
+            lastConversationId,
+            agentId,
+        });
+        return { items: [], limit: limit || 10 };
+    }
+    async getConversation(conversationId) {
+        this.logger.debug('getConversation', { conversationId });
+        return null;
+    }
+    async saveTelescopeStepTraces(traces) {
+        this.logger.debug('saveStepTraces', { traces });
+    }
+    async getTelescopeStepTraces(conversationId, limit = 10, lastTraceId) {
+        this.logger.debug('getStepTraces', { conversationId });
+        return { limit, lastTraceId, items: [] };
+    }
+    async saveTelescopeApiCallTraces(traces) {
+        this.logger.debug('saveApiCallTraces', { traces });
+    }
+    async saveTelescopeLatencyTraces(traces) {
+        this.logger.debug('saveLatencyTraces', { traces });
+    }
+    async getTelescopeApiCallTraces(conversationId, limit = 10, lastTraceId) {
+        this.logger.debug('getApiCallTraces', { conversationId });
+        return { limit, lastTraceId, items: [] };
+    }
+    async getTelescopeLatencyTraces(conversationId, limit = 10, lastTraceId) {
+        this.logger.debug('getLatencyTraces', { conversationId });
+        return { limit, lastTraceId, items: [] };
+    }
+    async saveTelescopeConversationalTraces(traces) {
+        this.logger.debug('saveConversationalTraces', { traces });
+    }
+    async getTelescopeConversationalTraces(conversationId, limit = 10, lastTraceId) {
+        this.logger.debug('getConversationalTraces', { conversationId });
+        return { limit, lastTraceId, items: [] };
+    }
+    async getTelescopeTraces(conversationId, limit = 10, lastTraceId) {
+        this.logger.debug('getTraces', { conversationId });
+        return { limit, lastTraceId, items: [] };
+    }
+}

package/build/telescope/stub-telescope.d.ts

@@ -0,0 +1,5 @@
+import { type Logger } from '../dockyard';
+import type { ITelescope } from './interfaces/telescope';
+export declare function createStubTelescope(logger?: Logger): ITelescope;
+export declare const stubTelescope: ITelescope;
+//# sourceMappingURL=stub-telescope.d.ts.map

package/build/telescope/stub-telescope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-telescope.d.ts","sourceRoot":"","sources":["../../src/telescope/stub-telescope.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,MAAM,EAAqB,MAAM,aAAa,CAAA;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAMxD,wBAAgB,mBAAmB,CAC/B,MAAM,GAAE,MAA2D,GACpE,UAAU,CA8CZ;AAMD,eAAO,MAAM,aAAa,EAAE,UAAkC,CAAA"}

package/build/telescope/stub-telescope.js

@@ -0,0 +1,47 @@
+import createLogger, { childLoggerFabric } from '../dockyard';
+export function createStubTelescope(logger = childLoggerFabric(createLogger())('StubTelescope')) {
+    return {
+        getApiCallTracer() {
+            return {
+                addApiCallTrace: (trace) => logger.log('Telescope: [API] trace added:', { trace }),
+                flush: async () => logger.log('Tracer: flushed'),
+            };
+        },
+        getConversationalTracer() {
+            return {
+                addConversationalTrace: (trace) => logger.log('Telescope: [Con.] trace added:', { trace }),
+                flush: async () => logger.log('Tracer: flushed'),
+            };
+        },
+        getStepTracer() {
+            return {
+                addStepTrace: (trace) => logger.log('Telescope: [Step] trace added:', { trace }),
+                flush: async () => logger.log('Tracer: flushed'),
+            };
+        },
+        getLatencyTracer() {
+            return {
+                addLatencyTrace(trace) {
+                    logger.log('Telescope: [Latency] trace added:', { trace });
+                },
+                async flush() {
+                    logger.log('Tracer: flushed');
+                },
+            };
+        },
+        getEventTracer() {
+            return {
+                emit(event) {
+                    logger.log('Telescope: [Event] emitted:', { event });
+                },
+            };
+        },
+        async runObservation(fn) {
+            return fn();
+        },
+        async saveConversation(conversation) {
+            logger.log('Telescope: save conversation.', { conversation });
+        },
+    };
+}
+export const stubTelescope = createStubTelescope();

package/build/telescope/stubs.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from '../dockyard';
+import { ApiCallTrace } from './interfaces/api-call-tracer';
+import { ConversationalTrace } from './interfaces/conversational-tracer';
+import { LatencyTrace } from './interfaces/latency-tracer';
+import { StepTrace } from './interfaces/step-tracer';
+export declare function createStubStepTracer(logger: Logger): {
+    addStepTrace(trace: StepTrace): void;
+    flush(): Promise<void>;
+};
+export declare function createStubApiCallTracer(logger: Logger): {
+    addApiCallTrace(trace: ApiCallTrace): void;
+    flush(): Promise<void>;
+};
+export declare function createStubConversationalTracer(logger: Logger): {
+    addConversationalTrace(trace: ConversationalTrace): void;
+    flush(): Promise<void>;
+};
+export declare function createStubLatencyTracer(logger: Logger): {
+    addLatencyTrace(trace: LatencyTrace): void;
+    flush(): Promise<void>;
+};
+//# sourceMappingURL=stubs.d.ts.map

package/build/telescope/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../src/telescope/stubs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAiB,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAwB,MAAM,oCAAoC,CAAA;AAC9F,OAAO,EAAE,YAAY,EAAiB,MAAM,6BAA6B,CAAA;AACzE,OAAO,EAAE,SAAS,EAAc,MAAM,0BAA0B,CAAA;AAEhE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM;wBAEvB,SAAS;;EAuBpC;AAKD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;2BAEvB,YAAY;;EAQ1C;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM;kCAEvB,mBAAmB;;EAKxD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;2BAEvB,YAAY;;EAK1C"}

package/build/telescope/stubs.js

@@ -0,0 +1,51 @@
+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', { prompt: trace.renderedPrompt });
+            }
+            if (trace.response) {
+                logger.log(`StepTrace, LLM response:\n${trace.response}`);
+            }
+        },
+        async flush() { },
+    };
+}
+export function createStubApiCallTracer(logger) {
+    return {
+        addApiCallTrace(trace) {
+            logger.log(`ApiCallTrace: ${trace.operationName} (${trace.method} ${trace.path})`, trace);
+        },
+        async flush() { },
+    };
+}
+export function createStubConversationalTracer(logger) {
+    return {
+        addConversationalTrace(trace) {
+            logger.log(`ConversationalTrace: ${trace.eventName}`, trace);
+        },
+        async flush() { },
+    };
+}
+export function createStubLatencyTracer(logger) {
+    return {
+        addLatencyTrace(trace) {
+            logger.log(`LatencyTrace: ${trace.eventType} (seq ${trace.seq})`, trace);
+        },
+        async flush() { },
+    };
+}

package/build/telescope/telescope.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from '../dockyard';
+import type { TelescopeConversation } from './interfaces/conversation';
+import type { MonitoringEventContext } from './interfaces/event-tracer';
+import type { TelescopeStorage } from './interfaces/storage';
+import type { ITelescope, TelescopeContext } from './interfaces/telescope';
+import { TelescopeApiCallTracer, TelescopeConversationalTracer, TelescopeEventTracer, TelescopeLatencyTracer, TelescopeStepTracer } from './tracers';
+export declare class Telescope implements ITelescope {
+    storage: TelescopeStorage;
+    private context;
+    private logger;
+    private eventContext?;
+    constructor(storage: TelescopeStorage, logger: Logger, eventContext?: Partial<MonitoringEventContext>);
+    saveConversation(conversation: TelescopeConversation): Promise<void>;
+    getStepTracer(): TelescopeStepTracer;
+    getApiCallTracer(): TelescopeApiCallTracer;
+    getConversationalTracer(): TelescopeConversationalTracer;
+    getLatencyTracer(): TelescopeLatencyTracer;
+    getEventTracer(): TelescopeEventTracer;
+    runObservation<T>(fn: () => Promise<T>, context?: Partial<TelescopeContext>): Promise<T>;
+}
+//# sourceMappingURL=telescope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telescope.d.ts","sourceRoot":"","sources":["../../src/telescope/telescope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,EACH,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACtB,MAAM,WAAW,CAAA;AAElB,qBAAa,SAAU,YAAW,UAAU;IACjC,OAAO,EAAE,gBAAgB,CAAA;IAChC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAGlD,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAW5C,gBAAgB,CAAC,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E,aAAa,IAAI,mBAAmB;IAIpC,gBAAgB,IAAI,sBAAsB;IAI1C,uBAAuB,IAAI,6BAA6B;IAIxD,gBAAgB,IAAI,sBAAsB;IAI1C,cAAc,IAAI,oBAAoB;IAiBtC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAS3F"}

package/build/telescope/telescope.js

@@ -0,0 +1,41 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { TelescopeApiCallTracer, TelescopeConversationalTracer, TelescopeEventTracer, TelescopeLatencyTracer, TelescopeStepTracer, } from './tracers';
+export class Telescope {
+    storage;
+    context;
+    logger;
+    eventContext;
+    constructor(storage, logger, eventContext) {
+        this.storage = storage;
+        this.context = new AsyncLocalStorage();
+        this.logger = logger;
+        this.eventContext = eventContext;
+    }
+    async saveConversation(conversation) {
+        await this.storage.saveConversation(conversation);
+    }
+    getStepTracer() {
+        return new TelescopeStepTracer(this.storage, this.logger, this.context);
+    }
+    getApiCallTracer() {
+        return new TelescopeApiCallTracer(this.storage, this.logger, this.context);
+    }
+    getConversationalTracer() {
+        return new TelescopeConversationalTracer(this.storage, this.logger, this.context);
+    }
+    getLatencyTracer() {
+        return new TelescopeLatencyTracer(this.storage, this.logger, this.context);
+    }
+    getEventTracer() {
+        return new TelescopeEventTracer({
+            service: this.eventContext?.service ?? 'agent-service',
+            environment: this.eventContext?.environment ?? process.env.STAGE ?? 'development',
+        }, undefined, this.context);
+    }
+    runObservation(fn, context) {
+        return this.context.run({
+            ...context,
+            scopeId: context?.scopeId || crypto.randomUUID(),
+        }, fn);
+    }
+}

package/build/telescope/trace-helpers.d.ts

@@ -0,0 +1,12 @@
+import type { Message } from './interfaces/conversation';
+import type { ConversationalTrace, ConversationalTracer } from './interfaces/conversational-tracer';
+import type { ITelescope } from './interfaces/telescope';
+export type TextTraceEventName = 'received-message' | 'sent-message' | 'transfer-requested';
+export declare function textEventTrace(conversationId: string, eventName: TextTraceEventName, content: string): ConversationalTrace;
+export declare function userTurnTrace(conversationId: string, lastMessage: Message | undefined): ConversationalTrace;
+export declare function agentReplyTrace(conversationId: string, reply: string): ConversationalTrace;
+export declare function emitConversationalTrace(tracer: ConversationalTracer | undefined, trace: ConversationalTrace, logger?: {
+    error: (...args: unknown[]) => void;
+}): Promise<void>;
+export declare function emitAgentFatalError(telescope: ITelescope, name: string, err: string | Error, conversationId?: string): void;
+//# sourceMappingURL=trace-helpers.d.ts.map

package/build/telescope/trace-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-helpers.d.ts","sourceRoot":"","sources":["../../src/telescope/trace-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAMxD,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,CAAA;AAG3F,wBAAgB,cAAc,CAC1B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,MAAM,GAChB,mBAAmB,CASrB;AAGD,wBAAgB,aAAa,CACzB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,OAAO,GAAG,SAAS,GACjC,mBAAmB,CASrB;AAGD,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAS1F;AAOD,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,GAAE;IAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAY,GAC1D,OAAO,CAAC,IAAI,CAAC,CAQf;AAOD,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,UAAU,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GAAG,KAAK,EACnB,cAAc,CAAC,EAAE,MAAM,GACxB,IAAI,CAaN"}

package/build/telescope/trace-helpers.js

@@ -0,0 +1,54 @@
+export function textEventTrace(conversationId, eventName, content) {
+    return {
+        conversationId,
+        eventName,
+        role: eventName === 'received-message' ? 'user' : 'agent',
+        medium: 'whatsapp',
+        content,
+        createdAt: Date.now(),
+    };
+}
+export function userTurnTrace(conversationId, lastMessage) {
+    return {
+        conversationId,
+        eventName: 'llm-handler-stream-requested',
+        role: lastMessage?.sender ?? 'user',
+        medium: 'phone',
+        content: lastMessage?.text ?? '',
+        createdAt: Date.now(),
+    };
+}
+export function agentReplyTrace(conversationId, reply) {
+    return {
+        conversationId,
+        eventName: 'finished-main-streaming-step',
+        role: 'agent',
+        medium: 'phone',
+        content: reply,
+        createdAt: Date.now(),
+    };
+}
+export async function emitConversationalTrace(tracer, trace, logger = console) {
+    if (!tracer)
+        return;
+    try {
+        tracer.addConversationalTrace(trace);
+        await tracer.flush();
+    }
+    catch (err) {
+        logger.error('Failed to write conversational trace', { err });
+    }
+}
+export function emitAgentFatalError(telescope, name, err, conversationId) {
+    const isError = err instanceof Error;
+    telescope.getEventTracer().emit({
+        event: 'agent.runtime.fatal_error',
+        attributes: {
+            agentId: name,
+            conversationId,
+            errorType: isError ? err.name : 'Error',
+            errorMessage: isError ? err.message : String(err),
+            stack: isError ? err.stack : undefined,
+        },
+    });
+}

package/build/telescope/tracers/api-call-tracer.d.ts

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

package/build/telescope/tracers/api-call-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-call-tracer.d.ts","sourceRoot":"","sources":["../../../src/telescope/tracers/api-call-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,+BAA+B,CAAA;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,qBAAa,sBAAuB,YAAW,aAAa;IACjD,YAAY,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IAC/D,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;IAoDpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/build/telescope/tracers/api-call-tracer.js

@@ -0,0 +1,53 @@
+export class TelescopeApiCallTracer {
+    scopeContext;
+    storage;
+    buffer = [];
+    logger;
+    constructor(storage, logger, scopeContext) {
+        this.logger = logger;
+        this.storage = storage;
+        this.scopeContext = scopeContext || null;
+    }
+    addApiCallTrace(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('ApiCallTrace missing conversationId, dropping trace', {
+                operationName: trace.operationName,
+                method: trace.method,
+                path: trace.path,
+            });
+            return;
+        }
+        const isFailed = trace.ok === false || (typeof trace.status === 'number' && trace.status >= 400);
+        const derivedError = trace.error ??
+            (isFailed ? (trace.response ?? { status: trace.status, ok: trace.ok }) : undefined);
+        this.buffer.push({
+            traceId: trace.traceId,
+            conversationId,
+            traceType: 'API_CALL',
+            scopeId: trace.scopeId ?? this.scopeContext?.getStore()?.scopeId,
+            operationName: trace.operationName,
+            method: trace.method,
+            path: trace.path,
+            baseUrl: trace.baseUrl,
+            request: trace.request,
+            response: trace.response,
+            status: trace.status,
+            ok: trace.ok,
+            durationMs: trace.durationMs,
+            error: derivedError,
+            createdAt: trace.createdAt,
+        });
+    }
+    async flush() {
+        const traces = this.buffer;
+        this.buffer = [];
+        await this.storage.saveTelescopeApiCallTraces(traces);
+    }
+}

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

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