@kognitivedev/voice-tracing 0.2.29

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+
+$ tsc

package/.turbo/turbo-test.log

@@ -0,0 +1,288 @@
+$ vitest run
+
+ RUN  v3.2.4 /Users/vserifsaglam/work/memory-experiment/packages/voice-tracing
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > bootstraps the session run before starting traces and carries backend ids forward
+[VoiceTracing:reporter] initialized {
+  sessionId: 'rtc_bootstrap_1',
+  agentName: 'voice-demo',
+  modelId: 'gpt-realtime-1.5',
+  transcriptionModelId: 'gpt-4o-transcribe'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > bootstraps the session run before starting traces and carries backend ids forward
+[VoiceTracing:reporter] session state updated {
+  sessionId: 'rtc_bootstrap_1',
+  messageCount: 1,
+  toolInvocationCount: 0,
+  connectionStatus: 'connected',
+  agentState: 'listening',
+  speechState: 'idle',
+  transcriptionStatus: 'completed',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] turn recovered from state {
+  sessionId: 'rtc_bootstrap_1',
+  messageId: 'user-msg-1',
+  transcriptPreview: 'hello'
+}
+[VoiceTracing:reporter] turn started {
+  sessionId: 'rtc_bootstrap_1',
+  runId: 'session:voice-demo:rtc_bootstrap_1',
+  turnId: '5ef9303b-b12c-495b-bf68-9092008e95cd',
+  traceId: 'agent:voice-demo:5ef9303b-b12c-495b-bf68-9092008e95cd',
+  turnIndex: 0,
+  transcriptPreview: 'hello',
+  startMessageId: 'user-msg-1',
+  hasUsage: false,
+  transcriptionCostCentsOverride: null
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > normalizes voice messages for persistence and avoids placeholder trace logs
+[VoiceTracing:reporter] initialized {
+  sessionId: 'rtc_test_1',
+  agentName: 'voice-demo',
+  modelId: 'gpt-realtime-1.5',
+  transcriptionModelId: 'gpt-4o-transcribe'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > normalizes voice messages for persistence and avoids placeholder trace logs
+[VoiceTracing:reporter] session state updated {
+  sessionId: 'rtc_test_1',
+  messageCount: 2,
+  toolInvocationCount: 0,
+  connectionStatus: 'connected',
+  agentState: 'listening',
+  speechState: 'idle',
+  transcriptionStatus: 'completed',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] turn recovered from state {
+  sessionId: 'rtc_test_1',
+  messageId: 'user-msg-1',
+  transcriptPreview: 'What is the weather in Paris?'
+}
+[VoiceTracing:reporter] turn started {
+  sessionId: 'rtc_test_1',
+  runId: 'session:voice-demo:rtc_test_1',
+  turnId: '7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  traceId: 'agent:voice-demo:7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  turnIndex: 0,
+  transcriptPreview: 'What is the weather in Paris?',
+  startMessageId: 'user-msg-1',
+  hasUsage: false,
+  transcriptionCostCentsOverride: null
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > normalizes voice messages for persistence and avoids placeholder trace logs
+[VoiceTracing:reporter] telemetry received {
+  sessionId: 'rtc_test_1',
+  type: 'voice.response.done',
+  responseId: 'resp_1',
+  itemId: null,
+  toolCallId: null,
+  hasActiveTurn: true
+}
+[VoiceTracing:reporter] no active turn found from state {
+  sessionId: 'rtc_test_1',
+  latestMessageCount: 2,
+  seenUserMessageCount: 1
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > normalizes voice messages for persistence and avoids placeholder trace logs
+[VoiceTracing:reporter] response done rawEvent check {
+  sessionId: 'rtc_test_1',
+  traceId: 'agent:voice-demo:7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  hasRawResponse: false,
+  rawOutputCount: 0,
+  functionCallCount: 0,
+  pendingCount: 0
+}
+[VoiceTracing:reporter] response completed {
+  sessionId: 'rtc_test_1',
+  traceId: 'agent:voice-demo:7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  runId: 'session:voice-demo:rtc_test_1',
+  status: 'completed',
+  outputPreview: 'It is 22 degrees.'
+}
+[VoiceTracing:reporter] turn finalized {
+  sessionId: 'rtc_test_1',
+  traceId: 'agent:voice-demo:7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  runId: 'session:voice-demo:rtc_test_1',
+  status: 'completed',
+  nextUserMessageId: null,
+  messageCount: 2,
+  outputPreview: 'It is 22 degrees.'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > normalizes voice messages for persistence and avoids placeholder trace logs
+[VoiceTracing:reporter] conversation flushed {
+  sessionId: 'rtc_test_1',
+  traceId: 'agent:voice-demo:7b3f137b-36ff-406f-9d60-a436fc8e1f8c',
+  agentRunId: 'session:voice-demo:rtc_test_1',
+  messageCount: 2,
+  replaySkipped: false
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > recovers completed turns from conversation history on disconnect
+[VoiceTracing:reporter] initialized {
+  sessionId: 'rtc_test_fallback',
+  agentName: 'voice-demo',
+  modelId: 'gpt-realtime-1.5',
+  transcriptionModelId: 'gpt-4o-transcribe'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > recovers completed turns from conversation history on disconnect
+[VoiceTracing:reporter] session state updated {
+  sessionId: 'rtc_test_fallback',
+  messageCount: 2,
+  toolInvocationCount: 0,
+  connectionStatus: 'connected',
+  agentState: 'listening',
+  speechState: 'idle',
+  transcriptionStatus: 'completed',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] no active turn found from state {
+  sessionId: 'rtc_test_fallback',
+  latestMessageCount: 2,
+  seenUserMessageCount: 0
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > recovers completed turns from conversation history on disconnect
+[VoiceTracing:reporter] flush call end {
+  sessionId: 'rtc_test_fallback',
+  reason: 'disconnect',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] synthetic turns recovered {
+  sessionId: 'rtc_test_fallback',
+  reason: 'disconnect',
+  turnCount: 1,
+  messageCount: 2,
+  responseStatus: null
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > recovers completed turns from conversation history on disconnect
+[VoiceTracing:reporter] conversation flushed {
+  sessionId: 'rtc_test_fallback',
+  traceId: 'agent:voice-demo:voice-session-flush',
+  agentRunId: 'session:voice-demo:rtc_test_fallback',
+  messageCount: 2,
+  replaySkipped: false
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] initialized {
+  sessionId: 'rtc_test_flush_dedupe',
+  agentName: 'voice-demo',
+  modelId: 'gpt-realtime-1.5',
+  transcriptionModelId: 'gpt-4o-transcribe'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] session state updated {
+  sessionId: 'rtc_test_flush_dedupe',
+  messageCount: 2,
+  toolInvocationCount: 0,
+  connectionStatus: 'connected',
+  agentState: 'listening',
+  speechState: 'idle',
+  transcriptionStatus: 'completed',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] turn recovered from state {
+  sessionId: 'rtc_test_flush_dedupe',
+  messageId: 'user-msg-1',
+  transcriptPreview: 'hello'
+}
+[VoiceTracing:reporter] turn started {
+  sessionId: 'rtc_test_flush_dedupe',
+  runId: 'session:voice-demo:rtc_test_flush_dedupe',
+  turnId: 'ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  traceId: 'agent:voice-demo:ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  turnIndex: 0,
+  transcriptPreview: 'hello',
+  startMessageId: 'user-msg-1',
+  hasUsage: false,
+  transcriptionCostCentsOverride: null
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] telemetry received {
+  sessionId: 'rtc_test_flush_dedupe',
+  type: 'voice.response.done',
+  responseId: 'resp_1',
+  itemId: null,
+  toolCallId: null,
+  hasActiveTurn: true
+}
+[VoiceTracing:reporter] no active turn found from state {
+  sessionId: 'rtc_test_flush_dedupe',
+  latestMessageCount: 2,
+  seenUserMessageCount: 1
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] response done rawEvent check {
+  sessionId: 'rtc_test_flush_dedupe',
+  traceId: 'agent:voice-demo:ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  hasRawResponse: false,
+  rawOutputCount: 0,
+  functionCallCount: 0,
+  pendingCount: 0
+}
+[VoiceTracing:reporter] response completed {
+  sessionId: 'rtc_test_flush_dedupe',
+  traceId: 'agent:voice-demo:ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  runId: 'session:voice-demo:rtc_test_flush_dedupe',
+  status: 'completed',
+  outputPreview: 'hi there'
+}
+[VoiceTracing:reporter] turn finalized {
+  sessionId: 'rtc_test_flush_dedupe',
+  traceId: 'agent:voice-demo:ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  runId: 'session:voice-demo:rtc_test_flush_dedupe',
+  status: 'completed',
+  nextUserMessageId: null,
+  messageCount: 2,
+  outputPreview: 'hi there'
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] conversation flushed {
+  sessionId: 'rtc_test_flush_dedupe',
+  traceId: 'agent:voice-demo:ba4ad99f-3dfc-4521-9d1c-829bead7998b',
+  agentRunId: 'session:voice-demo:rtc_test_flush_dedupe',
+  messageCount: 2,
+  replaySkipped: false
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] flush call end {
+  sessionId: 'rtc_test_flush_dedupe',
+  reason: 'disconnect',
+  hasActiveTurn: false
+}
+[VoiceTracing:reporter] synthetic turn recovery skipped {
+  sessionId: 'rtc_test_flush_dedupe',
+  reason: 'disconnect',
+  hasReportedRuns: true
+}
+
+stdout | src/__tests__/voice-tracing.test.ts > @kognitivedev/voice-tracing reporter > does not replay the full transcript again on disconnect flush when nothing changed
+[VoiceTracing:reporter] conversation flushed {
+  sessionId: 'rtc_test_flush_dedupe',
+  traceId: 'agent:voice-demo:voice-session-flush',
+  agentRunId: 'session:voice-demo:rtc_test_flush_dedupe',
+  messageCount: 0,
+  replaySkipped: true
+}
+
+ ✓ src/__tests__/voice-tracing.test.ts (6 tests) 74ms
+
+ Test Files  1 passed (1)
+      Tests  6 passed (6)
+   Start at  12:40:06
+   Duration  4.42s (transform 467ms, setup 0ms, collect 681ms, tests 74ms, environment 0ms, prepare 672ms)
+

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @kognitivedev/voice-tracing
+
+## 0.2.29
+
+### Patch Changes
+
+- release
+
+- Updated dependencies []:
+  - @kognitivedev/shared@0.2.29

package/dist/backend-adapter.d.ts

@@ -0,0 +1,16 @@
+import type { VoiceTracingAdapter } from "./types";
+type Logger = Pick<Console, "log" | "error" | "warn">;
+export interface KognitiveBackendVoiceTracingAdapterConfig {
+    baseUrl: string;
+    apiKey?: string;
+    getBearerToken?: () => Promise<string | null | undefined> | string | null | undefined;
+    fetch?: typeof globalThis.fetch;
+    logger?: Logger;
+    endpoints?: {
+        agentRun?: string;
+        log?: string;
+        traceEvents?: string;
+    };
+}
+export declare function createKognitiveBackendVoiceTracingAdapter(config: KognitiveBackendVoiceTracingAdapterConfig): VoiceTracingAdapter;
+export {};

package/dist/backend-adapter.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKognitiveBackendVoiceTracingAdapter = createKognitiveBackendVoiceTracingAdapter;
+function trimTrailingSlash(value) {
+    return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function createKognitiveBackendVoiceTracingAdapter(config) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const fetchImpl = (_a = config.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch;
+    const logger = config.logger;
+    const baseUrl = trimTrailingSlash(config.baseUrl);
+    const endpoints = {
+        agentRun: (_c = (_b = config.endpoints) === null || _b === void 0 ? void 0 : _b.agentRun) !== null && _c !== void 0 ? _c : "/api/kognitive/cognitive/agent-run",
+        log: (_e = (_d = config.endpoints) === null || _d === void 0 ? void 0 : _d.log) !== null && _e !== void 0 ? _e : "/api/kognitive/cognitive/log",
+        traceEvents: (_g = (_f = config.endpoints) === null || _f === void 0 ? void 0 : _f.traceEvents) !== null && _g !== void 0 ? _g : "/api/kognitive/cognitive/trace-events",
+    };
+    const post = async (endpoint, payload) => {
+        var _a, _b, _c;
+        try {
+            const bearerToken = await ((_a = config.getBearerToken) === null || _a === void 0 ? void 0 : _a.call(config));
+            const response = await fetchImpl(`${baseUrl}${endpoint}`, {
+                method: "POST",
+                headers: Object.assign({ "Content-Type": "application/json" }, (bearerToken || config.apiKey
+                    ? { Authorization: `Bearer ${bearerToken !== null && bearerToken !== void 0 ? bearerToken : config.apiKey}` }
+                    : {})),
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => "");
+                (_b = logger === null || logger === void 0 ? void 0 : logger.warn) === null || _b === void 0 ? void 0 : _b.call(logger, "[VoiceTracing:backend-adapter] request failed", {
+                    endpoint,
+                    status: response.status,
+                    body: errorText.slice(0, 400),
+                });
+                return null;
+            }
+            return await response.json().catch(() => null);
+        }
+        catch (error) {
+            (_c = logger === null || logger === void 0 ? void 0 : logger.error) === null || _c === void 0 ? void 0 : _c.call(logger, "[VoiceTracing:backend-adapter] request error", {
+                endpoint,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    };
+    return {
+        async reportAgentRun(data) {
+            return await post(endpoints.agentRun, data);
+        },
+        async reportConversationLog(data) {
+            return await post(endpoints.log, Object.assign({ type: "voice" }, data));
+        },
+        async reportTraceEvents(data) {
+            return await post(endpoints.traceEvents, data);
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { VoiceTracingAdapter, VoiceTracingReporterConfig, VoiceTracingSessionEvent, VoiceTracingTelemetryEvent, VoiceTracingUsageSnapshot, PersistedConversationMessage, } from "./types";
+export { createVoiceTracingReporter, createVoiceTelemetryReporter } from "./reporter";
+export { createKognitiveBackendVoiceTracingAdapter } from "./backend-adapter";
+export { createKognitiveVoiceTracingAdapter } from "./kognitive-adapter";

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKognitiveVoiceTracingAdapter = exports.createKognitiveBackendVoiceTracingAdapter = exports.createVoiceTelemetryReporter = exports.createVoiceTracingReporter = void 0;
+var reporter_1 = require("./reporter");
+Object.defineProperty(exports, "createVoiceTracingReporter", { enumerable: true, get: function () { return reporter_1.createVoiceTracingReporter; } });
+Object.defineProperty(exports, "createVoiceTelemetryReporter", { enumerable: true, get: function () { return reporter_1.createVoiceTelemetryReporter; } });
+var backend_adapter_1 = require("./backend-adapter");
+Object.defineProperty(exports, "createKognitiveBackendVoiceTracingAdapter", { enumerable: true, get: function () { return backend_adapter_1.createKognitiveBackendVoiceTracingAdapter; } });
+var kognitive_adapter_1 = require("./kognitive-adapter");
+Object.defineProperty(exports, "createKognitiveVoiceTracingAdapter", { enumerable: true, get: function () { return kognitive_adapter_1.createKognitiveVoiceTracingAdapter; } });

package/dist/kognitive-adapter.d.ts

@@ -0,0 +1,8 @@
+import type { VoiceTracingAdapter } from "./types";
+type KognitiveLike = {
+    reportAgentRun(data: Record<string, unknown>): Promise<unknown> | unknown;
+    reportConversationLog(data: Record<string, unknown>): Promise<unknown> | unknown;
+    reportTraceEvents(data: Record<string, unknown>): Promise<unknown> | unknown;
+};
+export declare function createKognitiveVoiceTracingAdapter(kognitive: KognitiveLike): VoiceTracingAdapter;
+export {};

package/dist/kognitive-adapter.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKognitiveVoiceTracingAdapter = createKognitiveVoiceTracingAdapter;
+function createKognitiveVoiceTracingAdapter(kognitive) {
+    return {
+        async reportAgentRun(data) {
+            return await kognitive.reportAgentRun(data);
+        },
+        async reportConversationLog(data) {
+            return await kognitive.reportConversationLog(data);
+        },
+        async reportTraceEvents(data) {
+            const result = await kognitive.reportTraceEvents(data);
+            return (result !== null && result !== void 0 ? result : null);
+        },
+    };
+}

package/dist/reporter.d.ts

@@ -0,0 +1,12 @@
+import type { VoiceTracingAdapter, VoiceTracingReporterConfig, VoiceTracingSessionEvent, VoiceTracingTelemetryEvent, VoiceTracingUsageSnapshot } from "./types";
+export declare function createVoiceTracingReporter(config: VoiceTracingReporterConfig): {
+    handleSessionEvent(event: VoiceTracingSessionEvent): void;
+    handleTelemetry(event: VoiceTracingTelemetryEvent): Promise<void>;
+    flushCallEnd(reason?: string): void;
+};
+export declare const createVoiceTelemetryReporter: typeof createVoiceTracingReporter;
+export type VoiceReportingSink = VoiceTracingAdapter;
+export type VoiceTelemetryReporterConfig = VoiceTracingReporterConfig;
+export type VoiceSessionEvent = VoiceTracingSessionEvent;
+export type VoiceTelemetryEvent = VoiceTracingTelemetryEvent;
+export type VoiceUsageSnapshot = VoiceTracingUsageSnapshot;