@recombine-ai/telescope 0.1.0 → 0.2.0

package/build/index.d.ts

@@ -0,0 +1,6 @@
+export declare function helloTelescope(): string;
+export type * from './interfaces/api-call-tracer';
+export type * from './interfaces/conversational-tracer';
+export type * from './interfaces/latency-tracer';
+export type * from './interfaces/step-tracer';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,mBAAmB,8BAA8B,CAAA;AACjD,mBAAmB,oCAAoC,CAAA;AACvD,mBAAmB,6BAA6B,CAAA;AAChD,mBAAmB,0BAA0B,CAAA"}

package/build/index.js

@@ -0,0 +1,3 @@
+export function helloTelescope() {
+    return 'Hello from telescope!';
+}

package/build/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/build/index.test.js

@@ -0,0 +1,7 @@
+import { describe, expect, it } from 'vitest';
+import { helloTelescope } from './index';
+describe('Telescope', () => {
+    it('returns the correct greeting', () => {
+        expect(helloTelescope()).toBe('Hello from telescope!');
+    });
+});

package/build/interfaces/api-call-tracer.d.ts

@@ -0,0 +1,21 @@
+export type ApiCallTrace = {
+    traceId?: string;
+    conversationId?: string;
+    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 interface ApiCallTracer {
+    addApiCallTrace(trace: ApiCallTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=api-call-tracer.d.ts.map

package/build/interfaces/api-call-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-call-tracer.d.ts","sourceRoot":"","sources":["../../src/interfaces/api-call-tracer.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG;IAEvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IAEZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,OAAO,CAAC,EAAE,OAAO,CAAA;IAGjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,KAAK,CAAC,EAAE,OAAO,CAAA;IAGf,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,WAAW,aAAa;IAC1B,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

package/build/interfaces/api-call-tracer.js

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

package/build/interfaces/conversational-tracer.d.ts

@@ -0,0 +1,16 @@
+export type ConversationalTrace = {
+    traceId?: string;
+    conversationId?: string;
+    scopeId?: string;
+    eventName: 'finished-main-streaming-step' | 'llm-handler-stream-requested' | 'received-message' | 'sent-message' | 'transfer-requested' | 'hangup-requested';
+    role: 'agent' | 'user' | 'system' | (string & {});
+    medium: 'phone' | 'whatsapp' | (string & {});
+    content: string;
+    createdAt: number;
+    error?: unknown;
+};
+export interface ConversationalTracer {
+    addConversationalTrace(trace: ConversationalTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=conversational-tracer.d.ts.map

package/build/interfaces/conversational-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversational-tracer.d.ts","sourceRoot":"","sources":["../../src/interfaces/conversational-tracer.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG;IAE9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,SAAS,EACH,8BAA8B,GAC9B,8BAA8B,GAC9B,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,CAAA;IAGxB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAGjD,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAG5C,OAAO,EAAE,MAAM,CAAA;IAGf,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,oBAAoB;IACjC,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

package/build/interfaces/conversational-tracer.js

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

package/build/interfaces/dockyard.d.ts

@@ -0,0 +1,6 @@
+export interface Logger {
+    log: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+//# sourceMappingURL=dockyard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dockyard.d.ts","sourceRoot":"","sources":["../../src/interfaces/dockyard.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACnB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAClC"}

package/build/interfaces/dockyard.js

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

package/build/interfaces/latency-tracer.d.ts

@@ -0,0 +1,14 @@
+export type LatencyTrace = {
+    traceId?: string;
+    conversationId?: string;
+    seq: number;
+    atMs: number;
+    eventType: string;
+    payload?: unknown;
+    createdAt: number;
+};
+export interface LatencyTracer {
+    addLatencyTrace(trace: LatencyTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=latency-tracer.d.ts.map

package/build/interfaces/latency-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-tracer.d.ts","sourceRoot":"","sources":["../../src/interfaces/latency-tracer.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG;IAEvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,GAAG,EAAE,MAAM,CAAA;IAGX,IAAI,EAAE,MAAM,CAAA;IAGZ,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,CAAC,EAAE,OAAO,CAAA;IAGjB,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,WAAW,aAAa;IAC1B,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

package/build/interfaces/latency-tracer.js

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

package/build/interfaces/step-tracer.d.ts

@@ -0,0 +1,30 @@
+import type { ZodType } from 'zod';
+export type LlmUsage = {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cachedPromptTokens?: number;
+};
+export type StepTrace = {
+    traceId?: string;
+    conversationId?: string;
+    scopeId?: string;
+    workflowId: string;
+    workflowRunId: string;
+    name: string;
+    renderedPrompt?: string;
+    receivedContext?: Record<string, unknown> | unknown;
+    receivedPrompt?: string;
+    stringifiedConversation?: string;
+    schema?: ZodType;
+    model?: string;
+    llmUsage?: LlmUsage;
+    response?: string;
+    createdAt: number;
+    error?: Error;
+};
+export interface StepTracer {
+    addStepTrace(trace: StepTrace): void;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=step-tracer.d.ts.map

package/build/interfaces/step-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tracer.d.ts","sourceRoot":"","sources":["../../src/interfaces/step-tracer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAElC,MAAM,MAAM,QAAQ,GAAG;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IAEpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,UAAU,EAAE,MAAM,CAAA;IAElB,aAAa,EAAE,MAAM,CAAA;IAErB,IAAI,EAAE,MAAM,CAAA;IAEZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAA;IACnD,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAGjB,SAAS,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAED,MAAM,WAAW,UAAU;IAKvB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAKpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

package/build/interfaces/step-tracer.js

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

package/build/stubs.d.ts

@@ -0,0 +1,22 @@
+import { ApiCallTrace } from './interfaces/api-call-tracer';
+import { ConversationalTrace } from './interfaces/conversational-tracer';
+import { Logger } from './interfaces/dockyard';
+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/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../src/stubs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAiB,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAwB,MAAM,oCAAoC,CAAA;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,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/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/package.json

@@ -1,25 +1,30 @@
 {
-    "name": "@recombine-ai/telescope",
-    "version": "0.1.0",
-    "description": "Observability suite for Recombine platform and Bosun IDE",
-    "license": "EULA",
-    "author": "recombine.ai",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/recombine-ai/platform.git",
-        "directory": "packages/telescope"
-    },
-    "files": [
-        "build"
-    ],
-    "type": "module",
-    "exports": {
-        ".": "./src/index.ts"
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org"
-    },
-    "dependencies": {
-        "zod": "^4.4.3"
+  "name": "@recombine-ai/telescope",
+  "version": "0.2.0",
+  "description": "Observability suite for Recombine platform and Bosun IDE",
+  "license": "EULA",
+  "author": "recombine.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/recombine-ai/platform.git",
+    "directory": "packages/telescope"
+  },
+  "files": [
+    "build"
+  ],
+  "type": "module",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.js",
+      "default": "./build/index.js"
     }
-}
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  }
+}