@kognitivedev/voice-tracing 0.2.29

package/src/types.ts

@@ -0,0 +1,76 @@
+import type { KognitiveUIMessage, Metadata, ResourceId } from "@kognitivedev/shared";
+
+export interface VoiceTracingUsageSnapshot {
+    type: "tokens" | "seconds";
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+    inputAudioTokens?: number;
+    inputTextTokens?: number;
+    outputAudioTokens?: number;
+    outputTextTokens?: number;
+    cachedAudioTokens?: number;
+    cachedTextTokens?: number;
+    seconds?: number;
+}
+
+export type VoiceTracingTelemetryEvent =
+    | { type: "voice.call.started"; at: string; callId: string; modelId: string; voice: string }
+    | { type: "voice.call.ended"; at: string; callId?: string; reason?: string }
+    | { type: "voice.session.updated"; at: string; callId?: string; session: Record<string, unknown> }
+    | { type: "voice.response.created"; at: string; callId?: string; responseId: string }
+    | { type: "voice.response.output.completed"; at: string; callId?: string; responseId?: string; itemId?: string; outputText?: string; status?: string; rawEvent: Record<string, unknown> }
+    | { type: "voice.response.done"; at: string; callId?: string; responseId: string; status: string; outputText?: string; usage?: VoiceTracingUsageSnapshot; rawEvent: Record<string, unknown> }
+    | { type: "voice.user.transcribed"; at: string; callId?: string; itemId?: string; transcript: string; usage?: VoiceTracingUsageSnapshot; rawEvent: Record<string, unknown> }
+    | { type: "voice.assistant.started"; at: string; callId?: string; responseId?: string; rawEvent: Record<string, unknown> }
+    | { type: "voice.assistant.stopped"; at: string; callId?: string; responseId?: string; rawEvent: Record<string, unknown> }
+    | { type: "voice.tool.started"; at: string; callId?: string; responseId?: string; toolCallId: string; toolName: string; input?: unknown; rawEvent: Record<string, unknown> }
+    | { type: "voice.tool.completed"; at: string; callId?: string; responseId?: string; toolCallId: string; toolName: string; output?: unknown }
+    | { type: "voice.tool.failed"; at: string; callId?: string; responseId?: string; toolCallId: string; toolName: string; error: string }
+    | { type: "voice.interrupted"; at: string; callId?: string; responseId?: string; reason?: string; rawEvent?: Record<string, unknown> }
+    | { type: "voice.error"; at: string; callId?: string; error: string; rawEvent?: Record<string, unknown> }
+    | { type: "voice.raw"; at: string; callId?: string; rawEvent: Record<string, unknown> };
+
+type VoiceTracingSessionStateShape = {
+    callId?: string;
+    messages: KognitiveUIMessage[];
+    toolInvocations: unknown[];
+    connectionStatus?: string;
+    agentState?: string;
+    speechState?: string;
+    transcriptionStatus?: string;
+};
+
+export type VoiceTracingSessionEvent =
+    | { type: "state.updated"; state: VoiceTracingSessionStateShape }
+    | { type: "tool-call"; toolCall: { toolName: string }; state: VoiceTracingSessionStateShape }
+    | { type: "tool-result"; toolResult: { toolName: string; isError?: boolean }; state: VoiceTracingSessionStateShape }
+    | { type: "raw"; event: Record<string, unknown>; state: VoiceTracingSessionStateShape }
+    | { type: "error"; error: unknown; state: VoiceTracingSessionStateShape };
+
+export type PersistedConversationPart = Record<string, unknown>;
+
+export type PersistedConversationMessage = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | PersistedConversationPart[];
+    metadata?: Metadata;
+};
+
+export interface VoiceTracingAdapter {
+    reportAgentRun(data: Record<string, unknown>): Promise<unknown> | unknown;
+    reportConversationLog(data: Record<string, unknown>): Promise<unknown> | unknown;
+    reportTraceEvents(data: Record<string, unknown>): Promise<{ traceDbId?: string | null } | null>;
+}
+
+export interface VoiceTracingReporterConfig {
+    adapter: VoiceTracingAdapter;
+    agentName: string;
+    callId: string;
+    modelId: string;
+    transcriptionModelId?: string;
+    voice: string;
+    resourceId: ResourceId;
+    metadata?: Metadata;
+    transport?: string;
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "noEmit": false,
+    "incremental": false
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "src/__tests__"
+  ]
+}