Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

extensions/voice/src/debug.ts

Raw
import { defineDebug } from "./pi-ext-debug.ts";

const schema = {
	events: [
		"session.start",
		"session.shutdown",
		"voice.open",
		"voice.close",
		"voice.reply",
		"voice.response",
		"voice.child.retire",
		"asr.bridge",
		"tts.bridge",
		"speech.runtime",
		"test-audio.core.failure",
		"test-audio.io.failure",
		"test-audio.facade.failure",
		"native-audio.main.failure",
	],
	spans: ["voice.child", "asr.command", "tts.command"],
	fields: {
		backend: ["native"],
		runtimeVersion: ["1.13.8"],
		outcome: [
			"opened",
			"closed",
			"ready",
			"error",
			"aborted",
			"start",
			"end",
			"cancel",
			"timeout",
			"rejected",
			"accepted",
			"dropped",
			"recovering",
			"paused",
			"resumed",
			"muted",
			"unmuted",
			"speech",
			"partial",
			"final",
			"playing",
			"ended",
			"failed",
			"scored",
		],
		kind: [
			"call",
			"capture",
			"asr",
			"tts",
			"playback",
			"lifecycle",
			"ui",
			"http",
			"command",
			"route",
			"turn",
		],
		status: [
			"running",
			"suspended",
			"closed",
			"interrupted",
			"live",
			"ended",
			"enabled",
			"disabled",
			"granted",
			"denied",
			"prompt",
			"unavailable",
			"ok",
			"client",
			"server",
			"timeout",
			"network",
			"invalid",
			"overflow",
			"muted",
		],
		voice: ["piper", "kokoro-af_nicole", "none"],
		route: ["direct", "webrtc"],
		reason: [
			"initial",
			"permission",
			"devicechange",
			"resume",
			"sinkchange",
			"route-change",
			"startup-error",
			"state-stream-error",
			"asr-stream-error",
			"tts-stream-error",
			"end-button",
			"pagehide",
			"new-input",
			"stop",
			"controller-close",
			"first-response",
			"response-stall",
			"backpressure",
			"queue-overflow",
			"stall",
			"stream-error",
			"initialization-failed",
			"response-failed",
			"empty-output",
			"invalid-json",
			"invalid-schema",
			"empty-heard",
			"empty-reply",
		],
		outputClassification: ["headphones", "speakers", "unknown"],
		outputEvidence: ["selected-label", "unavailable", "default"],
		model: ["configured", "claude", "current", "fallback", "none"],
		stream: ["state", "asr", "tts", "other"],
		streamEvent: ["state", "voice", "other"],
		errorClass: [
			"Error",
			"TypeError",
			"ReferenceError",
			"SyntaxError",
			"RangeError",
			"AbortError",
			"NetworkError",
			"InvalidStateError",
			"other",
		],
		timingPhase: [
			"startup",
			"flushwait",
			"poll",
			"apm",
			"resample",
			"asr-vad",
			"tts-callback",
			"tts-resample",
			"idle",
		],
		stage: [
			"request",
			"open",
			"read",
			"closed",
			"decode",
			"parse",
			"handler",
			"overflow",
			"start",
			"audio",
			"finish",
			"reset",
			"close",
			"speak",
			"cancel",
			"worker",
			"visibility",
			"freeze",
			"resume",
			"pagehide",
			"pageshow",
			"context",
			"track",
			"discard",
		],
		epoch: "number",
		generation: "number",
		requestId: "number",
		speakerId: "number",
		count: "number",
		durationMs: "number",
		sampleRate: "number",
		queueDepth: "number",
		level: "number",
		bytes: "number",
		active: "boolean",
		workAccepted: "boolean",
		muted: "boolean",
		aec: "boolean",
		noiseSuppression: "boolean",
		autoGainControl: "boolean",
		hidden: "boolean",
		ready: "boolean",
		audioWorklet: "boolean",
		audioFrames: "boolean",
		workerTransform: "boolean",
		scriptTransform: "boolean",
		lifecycle: "boolean",
		enumerateDevices: "boolean",
		devicechange: "boolean",
		contextSink: "boolean",
		peerSink: "boolean",
		inputCount: "number",
		outputCount: "number",
		selectedInput: "number",
		selectedOutput: "number",
		inputChanged: "boolean",
		outputChanged: "boolean",
		deviceListChanged: "boolean",
		paused: "boolean",
		readyState: "number",
		currentTimeMs: "number",
		volumeMilli: "number",
		trackLive: "boolean",
		inboundBytes: "number",
		inboundEnergyMicro: "number",
		waitMs: "number",
		probabilityMilli: "number",
		frame: "number",
		nextMic: "number",
		queuedCapture: "number",
		queuedRender: "number",
		captureHeld: "number",
		renderHeld: "number",
		externalCaptureHeld: "number",
		externalRenderHeld: "number",
		tickGapMs: "number",
		threadCpuMs: "number",
		eluActiveMs: "number",
		eluIdleMs: "number",
		maxGapMs: "number",
		maxThreadCpuMs: "number",
		maxEluActiveMs: "number",
		maxEluIdleMs: "number",
		creditPendingId: "number",
		creditAckAgeMs: "number",
		pollAgeMs: "number",
		releaseAgeMs: "number",
		unsentCapture: "number",
		unsentRender: "number",
		exportedCapture: "number",
		exportedRender: "number",
		appliedCapture: "number",
		appliedRender: "number",
		heldCapture: "number",
		heldRender: "number",
		pollGapMs: "number",
		pollMaxGapMs: "number",
		currentThreadCpuMs: "number",
		currentEluActiveMs: "number",
		currentEluIdleMs: "number",
		maxPollThreadCpuMs: "number",
		maxPollEluActiveMs: "number",
		maxPollEluIdleMs: "number",
		vadInitMs: "number",
		apmRenderMaxMs: "number",
		apmCaptureMaxMs: "number",
		ticking: "boolean",
	},
} as const;

export type VoiceDebugEvent = (typeof schema.events)[number];
export type VoiceDebugDetails = Partial<
	Record<keyof typeof schema.fields, string | number | boolean>
>;
const debug: ReturnType<typeof defineDebug<typeof schema>> =
	defineDebug(schema);
export const dbg: typeof debug.dbg = debug.dbg;
export const span: typeof debug.span = debug.span;
export const closeDebug: typeof debug.closeDebug = debug.closeDebug;