agents 0.22.0 → 0.23.0

package/dist/diagnostics-C4jcz3VK.js

@@ -0,0 +1,360 @@
+import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-DZBYAB34.js";
+import { t as _classPrivateMethodInitSpec } from "./classPrivateMethodInitSpec-qMjJ6sHQ.js";
+import { VoiceProviderError } from "./voice/errors.js";
+//#region src/voice/diagnostics.ts
+const MAX_STRING_LENGTH = 160;
+const PRIVATE_KEY = /(^|_)(audio|body|contents?|exceptions?|messages?|prompts?|query|results?|stack|text|tokens?|tools?|transcripts?|arguments?)(_|$)/i;
+function boundedString(value, maxLength = MAX_STRING_LENGTH) {
+	const normalized = value.replace(/\s+/g, " ").trim();
+	return normalized.length <= maxLength ? normalized : `${normalized.slice(0, maxLength - 1)}…`;
+}
+function diagnosticErrorData(error) {
+	const summary = {
+		name: boundedString(error.name || "Error"),
+		message: boundedString(error.message || "Unknown error")
+	};
+	if (error instanceof VoiceProviderError) {
+		if (error.code !== void 0) summary.code = error.code;
+		if (error.status !== void 0) summary.status = error.status;
+		if (error.closeCode !== void 0) summary.closeCode = error.closeCode;
+		if (error.closeReason !== void 0) summary.closeReason = boundedString(error.closeReason);
+		if (error.wasClean !== void 0) summary.wasClean = error.wasClean;
+	}
+	return summary;
+}
+/**
+* Keep diagnostic metadata bounded and reject fields that could carry user or
+* provider content. Instrumentation should still pass only known-safe values.
+*/
+function sanitizeDiagnosticData(data) {
+	if (!data) return void 0;
+	const sanitized = {};
+	for (const [key, value] of Object.entries(data)) {
+		if (PRIVATE_KEY.test(key)) continue;
+		sanitized[key] = value instanceof Error ? diagnosticErrorData(value) : typeof value === "string" ? boundedString(value) : value;
+	}
+	return Object.keys(sanitized).length > 0 ? sanitized : void 0;
+}
+function createDiagnosticEvent(event, data, timestamp = Date.now()) {
+	const safeData = sanitizeDiagnosticData(data);
+	return {
+		event,
+		timestamp,
+		...safeData ? { data: safeData } : {}
+	};
+}
+/** Server-only diagnostics. The sink is the reserved voice protocol message. */
+var ServerDiagnostics = class {
+	constructor(browserConsole) {
+		this.browserConsole = browserConsole;
+	}
+	emit(connection, event, data) {
+		if (!this.browserConsole) return;
+		try {
+			connection.send(JSON.stringify({
+				type: "diagnostic",
+				...createDiagnosticEvent(event, data)
+			}));
+		} catch {}
+	}
+	turn(connection, turnId, source = "speech", now = Date.now) {
+		return new TurnDiagnostics(this, connection, turnId, source, now);
+	}
+};
+function safeDuration(value) {
+	return Math.max(0, value);
+}
+var _turn = /* @__PURE__ */ new WeakMap();
+var _startedAt = /* @__PURE__ */ new WeakMap();
+/** One sentence attempt measured by its parent turn clock. */
+var TtsSentenceTracker = class {
+	constructor(turn, startedAt) {
+		_classPrivateFieldInitSpec(this, _turn, void 0);
+		_classPrivateFieldInitSpec(this, _startedAt, void 0);
+		_classPrivateFieldSet2(_turn, this, turn);
+		_classPrivateFieldSet2(_startedAt, this, startedAt);
+	}
+	providerStarted() {
+		_classPrivateFieldGet2(_turn, this).recordTtsProviderStarted();
+	}
+	settle(outcome) {
+		return _classPrivateFieldGet2(_turn, this).recordTtsSentence(_classPrivateFieldGet2(_startedAt, this), outcome);
+	}
+};
+var _diagnostics = /* @__PURE__ */ new WeakMap();
+var _connection = /* @__PURE__ */ new WeakMap();
+var _now = /* @__PURE__ */ new WeakMap();
+var _startedAt2 = /* @__PURE__ */ new WeakMap();
+var _speechStartedAt = /* @__PURE__ */ new WeakMap();
+var _firstInterimObserved = /* @__PURE__ */ new WeakMap();
+var _finalInputAt = /* @__PURE__ */ new WeakMap();
+var _firstTtsProviderAt = /* @__PURE__ */ new WeakMap();
+var _firstAudioAt = /* @__PURE__ */ new WeakMap();
+var _ttsFinished = /* @__PURE__ */ new WeakMap();
+var _hasTtsFailures = /* @__PURE__ */ new WeakMap();
+var _metrics = /* @__PURE__ */ new WeakMap();
+/**
+* One content-free turn lifecycle. Diagnostics and stable metrics are emitted
+* from the same recorded landmarks; application metrics never parse event
+* names or diagnostic metadata.
+*/
+var TurnDiagnostics = class {
+	constructor(diagnostics, connection, turnId, source, now) {
+		_classPrivateFieldInitSpec(this, _diagnostics, void 0);
+		_classPrivateFieldInitSpec(this, _connection, void 0);
+		_classPrivateFieldInitSpec(this, _now, void 0);
+		_classPrivateFieldInitSpec(this, _startedAt2, void 0);
+		_classPrivateFieldInitSpec(this, _speechStartedAt, void 0);
+		_classPrivateFieldInitSpec(this, _firstInterimObserved, false);
+		_classPrivateFieldInitSpec(this, _finalInputAt, void 0);
+		_classPrivateFieldInitSpec(this, _firstTtsProviderAt, void 0);
+		_classPrivateFieldInitSpec(this, _firstAudioAt, void 0);
+		_classPrivateFieldInitSpec(this, _ttsFinished, false);
+		_classPrivateFieldInitSpec(this, _hasTtsFailures, false);
+		_classPrivateFieldInitSpec(this, _metrics, {});
+		_classPrivateFieldSet2(_diagnostics, this, diagnostics);
+		_classPrivateFieldSet2(_connection, this, connection);
+		_classPrivateFieldSet2(_now, this, now);
+		_classPrivateFieldSet2(_startedAt2, this, now());
+		this.turnId = turnId;
+		this.source = source;
+	}
+	get hasTtsFailures() {
+		return _classPrivateFieldGet2(_hasTtsFailures, this);
+	}
+	get ttsWorkMs() {
+		return _classPrivateFieldGet2(_metrics, this).ttsWorkMs ?? 0;
+	}
+	emit(event, data) {
+		const scopedData = {
+			...data,
+			turn_id: this.turnId
+		};
+		_classPrivateFieldGet2(_diagnostics, this).emit(_classPrivateFieldGet2(_connection, this), event, scopedData);
+	}
+	startModel() {
+		return new ModelDiagnosticTracker(this, _classPrivateFieldGet2(_now, this));
+	}
+	markTextInput() {
+		_classPrivateFieldGet2(_finalInputAt, this) ?? _classPrivateFieldSet2(_finalInputAt, this, _classPrivateFieldGet2(_startedAt2, this));
+	}
+	speechStarted() {
+		_classPrivateFieldGet2(_speechStartedAt, this) ?? _classPrivateFieldSet2(_speechStartedAt, this, _classPrivateFieldGet2(_now, this).call(this));
+		this.emit("speech.started");
+	}
+	firstInterim(characters) {
+		if (_classPrivateFieldGet2(_firstInterimObserved, this)) return;
+		_classPrivateFieldSet2(_firstInterimObserved, this, true);
+		const elapsed = _classPrivateFieldGet2(_speechStartedAt, this) === void 0 ? void 0 : safeDuration(_classPrivateFieldGet2(_now, this).call(this) - _classPrivateFieldGet2(_speechStartedAt, this));
+		if (elapsed !== void 0) _classPrivateFieldGet2(_metrics, this).speechStartToFirstInterimMs = elapsed;
+		this.emit("stt.interim", {
+			...characters === void 0 ? {} : { characters },
+			...elapsed === void 0 ? {} : { speech_to_interim_ms: elapsed }
+		});
+	}
+	finalInput(characters) {
+		_classPrivateFieldSet2(_finalInputAt, this, _classPrivateFieldGet2(_now, this).call(this));
+		const elapsed = _classPrivateFieldGet2(_speechStartedAt, this) === void 0 ? void 0 : safeDuration(_classPrivateFieldGet2(_finalInputAt, this) - _classPrivateFieldGet2(_speechStartedAt, this));
+		if (elapsed !== void 0) _classPrivateFieldGet2(_metrics, this).speechStartToFinalMs = elapsed;
+		this.emit("stt.utterance", {
+			...characters === void 0 ? {} : { characters },
+			...elapsed === void 0 ? {} : { speech_to_final_ms: elapsed }
+		});
+	}
+	recordAfterTranscribe(durationMs, outcome, characters) {
+		_classPrivateFieldGet2(_metrics, this).afterTranscribeMs = safeDuration(durationMs);
+		this.emit("after_transcribe.completed", {
+			duration_ms: safeDuration(durationMs),
+			outcome,
+			characters
+		});
+	}
+	beginTtsSentence() {
+		_classPrivateFieldGet2(_metrics, this).ttsWorkMs ??= 0;
+		return new TtsSentenceTracker(this, _classPrivateFieldGet2(_now, this).call(this));
+	}
+	recordTtsProviderStarted() {
+		_classPrivateFieldGet2(_firstTtsProviderAt, this) ?? _classPrivateFieldSet2(_firstTtsProviderAt, this, _classPrivateFieldGet2(_now, this).call(this));
+	}
+	recordTtsSentence(startedAt, outcome) {
+		const duration = safeDuration(_classPrivateFieldGet2(_now, this).call(this) - startedAt);
+		_classPrivateFieldGet2(_metrics, this).ttsWorkMs = (_classPrivateFieldGet2(_metrics, this).ttsWorkMs ?? 0) + duration;
+		if (outcome === "failed") _classPrivateFieldSet2(_hasTtsFailures, this, true);
+		return duration;
+	}
+	finishTts() {
+		if (_classPrivateFieldGet2(_ttsFinished, this)) return;
+		_classPrivateFieldSet2(_ttsFinished, this, true);
+		if (_classPrivateFieldGet2(_firstTtsProviderAt, this) !== void 0) _classPrivateFieldGet2(_metrics, this).ttsWallMs = safeDuration(_classPrivateFieldGet2(_now, this).call(this) - _classPrivateFieldGet2(_firstTtsProviderAt, this));
+	}
+	audioSent() {
+		const now = _classPrivateFieldGet2(_now, this).call(this);
+		if (_classPrivateFieldGet2(_firstAudioAt, this) !== void 0) return;
+		_classPrivateFieldSet2(_firstAudioAt, this, now);
+		if (_classPrivateFieldGet2(_finalInputAt, this) !== void 0) _classPrivateFieldGet2(_metrics, this).finalInputToFirstAudioMs = safeDuration(now - _classPrivateFieldGet2(_finalInputAt, this));
+		if (_classPrivateFieldGet2(_firstTtsProviderAt, this) !== void 0) _classPrivateFieldGet2(_metrics, this).ttsToFirstAudioMs = safeDuration(now - _classPrivateFieldGet2(_firstTtsProviderAt, this));
+	}
+	recordModelFirstText(durationMs) {
+		_classPrivateFieldGet2(_metrics, this).modelToFirstTextMs = safeDuration(durationMs);
+	}
+	recordReasoning(durationMs) {
+		_classPrivateFieldGet2(_metrics, this).exposedReasoningMs = (_classPrivateFieldGet2(_metrics, this).exposedReasoningMs ?? 0) + safeDuration(durationMs);
+	}
+	recordModelTerminal(durationMs) {
+		_classPrivateFieldGet2(_metrics, this).modelStreamConsumptionMs = safeDuration(durationMs);
+	}
+	finish(outcome) {
+		this.finishTts();
+		const summary = {
+			turnId: this.turnId,
+			source: this.source,
+			outcome,
+			turnTotalMs: safeDuration(_classPrivateFieldGet2(_now, this).call(this) - _classPrivateFieldGet2(_startedAt2, this)),
+			..._classPrivateFieldGet2(_metrics, this)
+		};
+		this.emit("turn.ended", {
+			outcome,
+			duration_ms: summary.turnTotalMs
+		});
+		try {
+			_classPrivateFieldGet2(_connection, this).send(JSON.stringify({
+				type: "turn_metrics",
+				...summary
+			}));
+		} catch {}
+		return summary;
+	}
+};
+var _turn2 = /* @__PURE__ */ new WeakMap();
+var _now2 = /* @__PURE__ */ new WeakMap();
+var _startedAt3 = /* @__PURE__ */ new WeakMap();
+var _firstTextObserved = /* @__PURE__ */ new WeakMap();
+var _reasoningActive = /* @__PURE__ */ new WeakMap();
+var _reasoningStartedAt = /* @__PURE__ */ new WeakMap();
+var _characters = /* @__PURE__ */ new WeakMap();
+var _terminal = /* @__PURE__ */ new WeakMap();
+var _ModelDiagnosticTracker_brand = /* @__PURE__ */ new WeakSet();
+/**
+* Tracks one model stream without retaining model or reasoning content.
+* Lifecycle methods are idempotent so stale turn cleanup cannot affect a
+* successor tracker.
+*/
+var ModelDiagnosticTracker = class {
+	constructor(turn, now) {
+		_classPrivateMethodInitSpec(this, _ModelDiagnosticTracker_brand);
+		_classPrivateFieldInitSpec(this, _turn2, void 0);
+		_classPrivateFieldInitSpec(this, _now2, void 0);
+		_classPrivateFieldInitSpec(this, _startedAt3, void 0);
+		_classPrivateFieldInitSpec(this, _firstTextObserved, false);
+		_classPrivateFieldInitSpec(this, _reasoningActive, false);
+		_classPrivateFieldInitSpec(this, _reasoningStartedAt, 0);
+		_classPrivateFieldInitSpec(this, _characters, 0);
+		_classPrivateFieldInitSpec(this, _terminal, false);
+		_classPrivateFieldSet2(_turn2, this, turn);
+		_classPrivateFieldSet2(_now2, this, now);
+		_classPrivateFieldSet2(_startedAt3, this, now());
+		_classPrivateFieldGet2(_turn2, this).emit("model.started");
+	}
+	observe(event) {
+		if (_classPrivateFieldGet2(_terminal, this)) return;
+		switch (event.type) {
+			case "text":
+				_classPrivateFieldSet2(_characters, this, _classPrivateFieldGet2(_characters, this) + event.text.length);
+				if (!_classPrivateFieldGet2(_firstTextObserved, this) && event.text.trim().length > 0) {
+					_classPrivateFieldSet2(_firstTextObserved, this, true);
+					const elapsed = safeDuration(_classPrivateFieldGet2(_now2, this).call(this) - _classPrivateFieldGet2(_startedAt3, this));
+					_classPrivateFieldGet2(_turn2, this).recordModelFirstText(elapsed);
+					_classPrivateFieldGet2(_turn2, this).emit("model.first_text", { elapsed_ms: elapsed });
+				}
+				break;
+			case "reasoning-start":
+				_assertClassBrand(_ModelDiagnosticTracker_brand, this, _startReasoning).call(this);
+				break;
+			case "reasoning-end":
+				_assertClassBrand(_ModelDiagnosticTracker_brand, this, _completeReasoning).call(this, "completed");
+				break;
+			case "finish":
+				_assertClassBrand(_ModelDiagnosticTracker_brand, this, _completeReasoning).call(this, "stream_finished");
+				break;
+			case "error": break;
+			case "boundary": break;
+		}
+	}
+	complete(outcome, finishReason) {
+		if (_classPrivateFieldGet2(_terminal, this)) return;
+		_assertClassBrand(_ModelDiagnosticTracker_brand, this, _completeReasoning).call(this, "stream_completed");
+		_classPrivateFieldSet2(_terminal, this, true);
+		const duration = this.elapsedMs();
+		_classPrivateFieldGet2(_turn2, this).recordModelTerminal(duration);
+		_classPrivateFieldGet2(_turn2, this).emit("model.completed", {
+			duration_ms: duration,
+			outcome,
+			characters: _classPrivateFieldGet2(_characters, this),
+			...finishReason === void 0 ? {} : { finish_reason: finishReason }
+		});
+	}
+	fail(error) {
+		if (_classPrivateFieldGet2(_terminal, this)) return;
+		_assertClassBrand(_ModelDiagnosticTracker_brand, this, _completeReasoning).call(this, "error");
+		_classPrivateFieldSet2(_terminal, this, true);
+		_classPrivateFieldGet2(_turn2, this).recordModelTerminal(this.elapsedMs());
+		_classPrivateFieldGet2(_turn2, this).emit("model.failed", { error });
+	}
+	abort() {
+		if (_classPrivateFieldGet2(_terminal, this)) return;
+		_assertClassBrand(_ModelDiagnosticTracker_brand, this, _completeReasoning).call(this, "aborted");
+		_classPrivateFieldSet2(_terminal, this, true);
+		_classPrivateFieldGet2(_turn2, this).recordModelTerminal(this.elapsedMs());
+	}
+	elapsedMs() {
+		return safeDuration(_classPrivateFieldGet2(_now2, this).call(this) - _classPrivateFieldGet2(_startedAt3, this));
+	}
+};
+function _startReasoning() {
+	if (_classPrivateFieldGet2(_reasoningActive, this)) return;
+	_classPrivateFieldSet2(_reasoningActive, this, true);
+	_classPrivateFieldSet2(_reasoningStartedAt, this, _classPrivateFieldGet2(_now2, this).call(this));
+	_classPrivateFieldGet2(_turn2, this).emit("model.reasoning_started");
+}
+function _completeReasoning(outcome) {
+	if (!_classPrivateFieldGet2(_reasoningActive, this)) return;
+	_classPrivateFieldSet2(_reasoningActive, this, false);
+	const duration = safeDuration(_classPrivateFieldGet2(_now2, this).call(this) - _classPrivateFieldGet2(_reasoningStartedAt, this));
+	_classPrivateFieldGet2(_turn2, this).recordReasoning(duration);
+	_classPrivateFieldGet2(_turn2, this).emit("model.reasoning_completed", {
+		duration_ms: duration,
+		outcome
+	});
+}
+var _enabled = /* @__PURE__ */ new WeakMap();
+var _ClientDiagnostics_brand = /* @__PURE__ */ new WeakSet();
+/** Browser-only diagnostics. Activation always comes from the server welcome. */
+var ClientDiagnostics = class {
+	constructor() {
+		_classPrivateMethodInitSpec(this, _ClientDiagnostics_brand);
+		_classPrivateFieldInitSpec(this, _enabled, false);
+	}
+	setEnabled(enabled) {
+		_classPrivateFieldSet2(_enabled, this, enabled);
+	}
+	emit(event, data) {
+		if (!_classPrivateFieldGet2(_enabled, this)) return;
+		_assertClassBrand(_ClientDiagnostics_brand, this, _log).call(this, "client", createDiagnosticEvent(event, data));
+	}
+	receive(event) {
+		if (!_classPrivateFieldGet2(_enabled, this)) return;
+		_assertClassBrand(_ClientDiagnostics_brand, this, _log).call(this, "server", event);
+	}
+};
+function _log(origin, event) {
+	try {
+		console.info(`[voice:${origin}] ${event.event}`, {
+			timestamp: event.timestamp,
+			...event.data ?? {}
+		});
+	} catch {}
+}
+//#endregion
+export { ServerDiagnostics as n, ClientDiagnostics as t };
+
+//# sourceMappingURL=diagnostics-C4jcz3VK.js.map

package/dist/diagnostics-C4jcz3VK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-C4jcz3VK.js","names":[],"sources":["../src/voice/diagnostics.ts"],"sourcesContent":["import { VoiceProviderError } from \"./errors\";\nimport type { TextStreamEvent } from \"./text-stream\";\nimport type {\n  VoiceDiagnosticEvent,\n  VoiceModelFinishReason,\n  VoiceTurnMetrics,\n  VoiceTurnOutcome,\n  VoiceTurnSource\n} from \"./types\";\n\nconst MAX_STRING_LENGTH = 160;\n\nconst PRIVATE_KEY =\n  /(^|_)(audio|body|contents?|exceptions?|messages?|prompts?|query|results?|stack|text|tokens?|tools?|transcripts?|arguments?)(_|$)/i;\n\ntype DiagnosticValue = string | number | boolean | null | Error;\nexport type DiagnosticData = Record<string, DiagnosticValue>;\n\ntype DiagnosticConnection = {\n  send(data: string | ArrayBuffer): void;\n};\n\nfunction boundedString(value: string, maxLength = MAX_STRING_LENGTH): string {\n  const normalized = value.replace(/\\s+/g, \" \").trim();\n  return normalized.length <= maxLength\n    ? normalized\n    : `${normalized.slice(0, maxLength - 1)}…`;\n}\n\nfunction diagnosticErrorData(error: Error): Record<string, unknown> {\n  const summary: Record<string, unknown> = {\n    name: boundedString(error.name || \"Error\"),\n    message: boundedString(error.message || \"Unknown error\")\n  };\n\n  if (error instanceof VoiceProviderError) {\n    if (error.code !== undefined) summary.code = error.code;\n    if (error.status !== undefined) summary.status = error.status;\n    if (error.closeCode !== undefined) summary.closeCode = error.closeCode;\n    if (error.closeReason !== undefined) {\n      summary.closeReason = boundedString(error.closeReason);\n    }\n    if (error.wasClean !== undefined) summary.wasClean = error.wasClean;\n  }\n\n  return summary;\n}\n\n/**\n * Keep diagnostic metadata bounded and reject fields that could carry user or\n * provider content. Instrumentation should still pass only known-safe values.\n */\nexport function sanitizeDiagnosticData(\n  data?: DiagnosticData\n): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n\n  const sanitized: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (PRIVATE_KEY.test(key)) continue;\n    sanitized[key] =\n      value instanceof Error\n        ? diagnosticErrorData(value)\n        : typeof value === \"string\"\n          ? boundedString(value)\n          : value;\n  }\n\n  return Object.keys(sanitized).length > 0 ? sanitized : undefined;\n}\n\nfunction createDiagnosticEvent(\n  event: string,\n  data?: DiagnosticData,\n  timestamp = Date.now()\n): VoiceDiagnosticEvent {\n  const safeData = sanitizeDiagnosticData(data);\n  return {\n    event,\n    timestamp,\n    ...(safeData ? { data: safeData } : {})\n  };\n}\n\n/** Server-only diagnostics. The sink is the reserved voice protocol message. */\nexport class ServerDiagnostics {\n  readonly browserConsole: boolean;\n\n  constructor(browserConsole: boolean) {\n    this.browserConsole = browserConsole;\n  }\n\n  emit(\n    connection: DiagnosticConnection,\n    event: string,\n    data?: DiagnosticData\n  ): void {\n    if (!this.browserConsole) return;\n\n    try {\n      connection.send(\n        JSON.stringify({\n          type: \"diagnostic\",\n          ...createDiagnosticEvent(event, data)\n        })\n      );\n    } catch {\n      // Diagnostics must never alter call behavior.\n    }\n  }\n\n  turn(\n    connection: DiagnosticConnection,\n    turnId: string,\n    source: VoiceTurnSource = \"speech\",\n    now: () => number = Date.now\n  ): TurnDiagnostics {\n    return new TurnDiagnostics(this, connection, turnId, source, now);\n  }\n}\n\nfunction safeDuration(value: number): number {\n  return Math.max(0, value);\n}\n\nexport type TtsSentenceOutcome = \"completed\" | \"skipped\" | \"failed\";\n\n/** One sentence attempt measured by its parent turn clock. */\nexport class TtsSentenceTracker {\n  #turn: TurnDiagnostics;\n  #startedAt: number;\n\n  constructor(turn: TurnDiagnostics, startedAt: number) {\n    this.#turn = turn;\n    this.#startedAt = startedAt;\n  }\n\n  providerStarted(): void {\n    this.#turn.recordTtsProviderStarted();\n  }\n\n  settle(outcome: TtsSentenceOutcome): number {\n    return this.#turn.recordTtsSentence(this.#startedAt, outcome);\n  }\n}\n\n/**\n * One content-free turn lifecycle. Diagnostics and stable metrics are emitted\n * from the same recorded landmarks; application metrics never parse event\n * names or diagnostic metadata.\n */\nexport class TurnDiagnostics {\n  readonly turnId: string;\n  readonly source: VoiceTurnSource;\n  #diagnostics: ServerDiagnostics;\n  #connection: DiagnosticConnection;\n  #now: () => number;\n  #startedAt: number;\n  #speechStartedAt: number | undefined;\n  #firstInterimObserved = false;\n  #finalInputAt: number | undefined;\n  #firstTtsProviderAt: number | undefined;\n  #firstAudioAt: number | undefined;\n  #ttsFinished = false;\n  #hasTtsFailures = false;\n  #metrics: Partial<VoiceTurnMetrics> = {};\n\n  constructor(\n    diagnostics: ServerDiagnostics,\n    connection: DiagnosticConnection,\n    turnId: string,\n    source: VoiceTurnSource,\n    now: () => number\n  ) {\n    this.#diagnostics = diagnostics;\n    this.#connection = connection;\n    this.#now = now;\n    this.#startedAt = now();\n    this.turnId = turnId;\n    this.source = source;\n  }\n\n  get hasTtsFailures(): boolean {\n    return this.#hasTtsFailures;\n  }\n\n  get ttsWorkMs(): number {\n    return this.#metrics.ttsWorkMs ?? 0;\n  }\n\n  emit(event: string, data?: DiagnosticData): void {\n    const scopedData: DiagnosticData = {\n      ...data,\n      turn_id: this.turnId\n    };\n    this.#diagnostics.emit(this.#connection, event, scopedData);\n  }\n\n  startModel(): ModelDiagnosticTracker {\n    return new ModelDiagnosticTracker(this, this.#now);\n  }\n\n  markTextInput(): void {\n    this.#finalInputAt ??= this.#startedAt;\n  }\n\n  speechStarted(): void {\n    this.#speechStartedAt ??= this.#now();\n    this.emit(\"speech.started\");\n  }\n\n  firstInterim(characters?: number): void {\n    if (this.#firstInterimObserved) return;\n    this.#firstInterimObserved = true;\n    const elapsed =\n      this.#speechStartedAt === undefined\n        ? undefined\n        : safeDuration(this.#now() - this.#speechStartedAt);\n    if (elapsed !== undefined) {\n      this.#metrics.speechStartToFirstInterimMs = elapsed;\n    }\n    this.emit(\"stt.interim\", {\n      ...(characters === undefined ? {} : { characters }),\n      ...(elapsed === undefined ? {} : { speech_to_interim_ms: elapsed })\n    });\n  }\n\n  finalInput(characters?: number): void {\n    this.#finalInputAt = this.#now();\n    const elapsed =\n      this.#speechStartedAt === undefined\n        ? undefined\n        : safeDuration(this.#finalInputAt - this.#speechStartedAt);\n    if (elapsed !== undefined) this.#metrics.speechStartToFinalMs = elapsed;\n    this.emit(\"stt.utterance\", {\n      ...(characters === undefined ? {} : { characters }),\n      ...(elapsed === undefined ? {} : { speech_to_final_ms: elapsed })\n    });\n  }\n\n  recordAfterTranscribe(\n    durationMs: number,\n    outcome: \"accepted\" | \"skipped\",\n    characters: number\n  ): void {\n    this.#metrics.afterTranscribeMs = safeDuration(durationMs);\n    this.emit(\"after_transcribe.completed\", {\n      duration_ms: safeDuration(durationMs),\n      outcome,\n      characters\n    });\n  }\n\n  beginTtsSentence(): TtsSentenceTracker {\n    this.#metrics.ttsWorkMs ??= 0;\n    return new TtsSentenceTracker(this, this.#now());\n  }\n\n  recordTtsProviderStarted(): void {\n    this.#firstTtsProviderAt ??= this.#now();\n  }\n\n  recordTtsSentence(startedAt: number, outcome: TtsSentenceOutcome): number {\n    const duration = safeDuration(this.#now() - startedAt);\n    this.#metrics.ttsWorkMs = (this.#metrics.ttsWorkMs ?? 0) + duration;\n    if (outcome === \"failed\") this.#hasTtsFailures = true;\n    return duration;\n  }\n\n  finishTts(): void {\n    if (this.#ttsFinished) return;\n    this.#ttsFinished = true;\n    if (this.#firstTtsProviderAt !== undefined) {\n      this.#metrics.ttsWallMs = safeDuration(\n        this.#now() - this.#firstTtsProviderAt\n      );\n    }\n  }\n\n  audioSent(): void {\n    const now = this.#now();\n    if (this.#firstAudioAt !== undefined) return;\n    this.#firstAudioAt = now;\n    if (this.#finalInputAt !== undefined) {\n      this.#metrics.finalInputToFirstAudioMs = safeDuration(\n        now - this.#finalInputAt\n      );\n    }\n    if (this.#firstTtsProviderAt !== undefined) {\n      this.#metrics.ttsToFirstAudioMs = safeDuration(\n        now - this.#firstTtsProviderAt\n      );\n    }\n  }\n\n  recordModelFirstText(durationMs: number): void {\n    this.#metrics.modelToFirstTextMs = safeDuration(durationMs);\n  }\n\n  recordReasoning(durationMs: number): void {\n    this.#metrics.exposedReasoningMs =\n      (this.#metrics.exposedReasoningMs ?? 0) + safeDuration(durationMs);\n  }\n\n  recordModelTerminal(durationMs: number): void {\n    this.#metrics.modelStreamConsumptionMs = safeDuration(durationMs);\n  }\n\n  finish(outcome: VoiceTurnOutcome): VoiceTurnMetrics {\n    this.finishTts();\n\n    const summary: VoiceTurnMetrics = {\n      turnId: this.turnId,\n      source: this.source,\n      outcome,\n      turnTotalMs: safeDuration(this.#now() - this.#startedAt),\n      ...this.#metrics\n    };\n\n    this.emit(\"turn.ended\", {\n      outcome,\n      duration_ms: summary.turnTotalMs\n    });\n    try {\n      this.#connection.send(\n        JSON.stringify({ type: \"turn_metrics\", ...summary })\n      );\n    } catch {\n      // A closing connection can make the terminal summary undeliverable.\n    }\n    return summary;\n  }\n}\n\n/**\n * Tracks one model stream without retaining model or reasoning content.\n * Lifecycle methods are idempotent so stale turn cleanup cannot affect a\n * successor tracker.\n */\nexport class ModelDiagnosticTracker {\n  #turn: TurnDiagnostics;\n  #now: () => number;\n  #startedAt: number;\n  #firstTextObserved = false;\n  #reasoningActive = false;\n  #reasoningStartedAt = 0;\n  #characters = 0;\n  #terminal = false;\n\n  constructor(turn: TurnDiagnostics, now: () => number) {\n    this.#turn = turn;\n    this.#now = now;\n    this.#startedAt = now();\n    this.#turn.emit(\"model.started\");\n  }\n\n  observe(event: TextStreamEvent): void {\n    if (this.#terminal) return;\n\n    switch (event.type) {\n      case \"text\":\n        this.#characters += event.text.length;\n        if (!this.#firstTextObserved && event.text.trim().length > 0) {\n          this.#firstTextObserved = true;\n          const elapsed = safeDuration(this.#now() - this.#startedAt);\n          this.#turn.recordModelFirstText(elapsed);\n          this.#turn.emit(\"model.first_text\", { elapsed_ms: elapsed });\n        }\n        break;\n      case \"reasoning-start\":\n        this.#startReasoning();\n        break;\n      case \"reasoning-end\":\n        this.#completeReasoning(\"completed\");\n        break;\n      case \"finish\":\n        this.#completeReasoning(\"stream_finished\");\n        break;\n      case \"error\":\n        break;\n      case \"boundary\":\n        break;\n    }\n  }\n\n  complete(\n    outcome: \"output\" | \"no_output\",\n    finishReason?: VoiceModelFinishReason\n  ): void {\n    if (this.#terminal) return;\n    this.#completeReasoning(\"stream_completed\");\n    this.#terminal = true;\n    const duration = this.elapsedMs();\n    this.#turn.recordModelTerminal(duration);\n    this.#turn.emit(\"model.completed\", {\n      duration_ms: duration,\n      outcome,\n      characters: this.#characters,\n      ...(finishReason === undefined ? {} : { finish_reason: finishReason })\n    });\n  }\n\n  fail(error: Error): void {\n    if (this.#terminal) return;\n    this.#completeReasoning(\"error\");\n    this.#terminal = true;\n    this.#turn.recordModelTerminal(this.elapsedMs());\n    this.#turn.emit(\"model.failed\", { error });\n  }\n\n  abort(): void {\n    if (this.#terminal) return;\n    this.#completeReasoning(\"aborted\");\n    this.#terminal = true;\n    this.#turn.recordModelTerminal(this.elapsedMs());\n  }\n\n  elapsedMs(): number {\n    return safeDuration(this.#now() - this.#startedAt);\n  }\n\n  #startReasoning(): void {\n    if (this.#reasoningActive) return;\n    this.#reasoningActive = true;\n    this.#reasoningStartedAt = this.#now();\n    this.#turn.emit(\"model.reasoning_started\");\n  }\n\n  #completeReasoning(outcome: string): void {\n    if (!this.#reasoningActive) return;\n    this.#reasoningActive = false;\n    const duration = safeDuration(this.#now() - this.#reasoningStartedAt);\n    this.#turn.recordReasoning(duration);\n    this.#turn.emit(\"model.reasoning_completed\", {\n      duration_ms: duration,\n      outcome\n    });\n  }\n}\n\n/** Browser-only diagnostics. Activation always comes from the server welcome. */\nexport class ClientDiagnostics {\n  #enabled = false;\n\n  setEnabled(enabled: boolean): void {\n    this.#enabled = enabled;\n  }\n\n  emit(event: string, data?: DiagnosticData): void {\n    if (!this.#enabled) return;\n    this.#log(\"client\", createDiagnosticEvent(event, data));\n  }\n\n  receive(event: VoiceDiagnosticEvent): void {\n    if (!this.#enabled) return;\n    this.#log(\"server\", event);\n  }\n\n  #log(origin: \"client\" | \"server\", event: VoiceDiagnosticEvent): void {\n    try {\n      console.info(`[voice:${origin}] ${event.event}`, {\n        timestamp: event.timestamp,\n        ...(event.data ?? {})\n      });\n    } catch {\n      // Console replacements and test spies are allowed to throw.\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/index-BB0kqhIz.d.ts

@@ -0,0 +1,101 @@
+import {
+  D as ChannelInboundMessage,
+  F as ChannelMessageSurface,
+  U as UserIdentity,
+  V as ChannelIdentity,
+  a as ChannelApprovalRequestOptions,
+  d as ChannelRoute,
+  h as DeliveryResult,
+  j as ChannelIngressEvent,
+  l as ChannelDeliveryOptions,
+  n as Channel,
+  p as ChannelStreamOptions,
+  s as ChannelChunkSource,
+  u as ChannelMessage,
+  w as ChannelEmailInput,
+  y as ChannelApprovalResponse
+} from "./channel-Bnm4S7T2.js";
+
+//#region src/channels/host/index.d.ts
+type ChannelMessageEvent = {
+  channelKey: string;
+  route: string /** Stable identity derived only from the configured Channel and eventId. */;
+  dispatchId: string;
+  message: ChannelInboundMessage;
+};
+type ChannelApprovalResponseEvent = {
+  channelKey: string;
+  route: string /** Stable identity derived only from the configured Channel and eventId. */;
+  dispatchId: string;
+  response: ChannelApprovalResponse;
+};
+type ChannelRouteEvent = {
+  channelKey: string;
+  event: ChannelIngressEvent;
+  route:
+    | string
+    | null /** Stable identity derived only from the configured Channel and eventId. */;
+  dispatchId: string;
+};
+type ChannelHostOptions = {
+  channels: Record<
+    string,
+    Channel
+  > /** Used when a Channel does not provide a route. Default: event thread id. */;
+  defaultRoute?: ChannelRoute /** Resolve an existing, explicitly linked application user. */;
+  findUser?(
+    identity: ChannelIdentity
+  ): Promise<UserIdentity | null> /** Observes every valid route outcome before application dispatch. */;
+  onRoute?(event: ChannelRouteEvent): void | Promise<void>;
+  onMessage?(event: ChannelMessageEvent): void | Promise<void>;
+  onApprovalResponse?(
+    event: ChannelApprovalResponseEvent
+  ): void | Promise<void>;
+};
+/**
+ * Authenticates and normalizes ingress through configured Channel adapters,
+ * resolves outbound surfaces, and awaits the application's durable handoff.
+ */
+declare class ChannelHost {
+  #private;
+  constructor(options: ChannelHostOptions);
+  handleRequest(request: Request): Promise<Response | undefined>;
+  handleEmail(email: ChannelEmailInput): Promise<boolean>;
+  /** Deliver through the configured Channel or composite named by the surface. */
+  deliver(
+    surface: ChannelMessageSurface,
+    message: ChannelMessage,
+    options?: ChannelDeliveryOptions
+  ): Promise<DeliveryResult>;
+  /**
+   * Deliver a progressively generated answer to the Channel or composite
+   * named by the surface.
+   *
+   * A Channel that can stream consumes the stream itself. A Channel that
+   * cannot never learns it was a stream, because the Host collects the answer
+   * and calls `deliver` once.
+   */
+  stream(
+    surface: ChannelMessageSurface,
+    chunks: ChannelChunkSource,
+    options?: ChannelStreamOptions
+  ): Promise<DeliveryResult>;
+  /** Request approval through the Channel or composite named by the surface. */
+  requestApproval(
+    surface: ChannelMessageSurface,
+    options: ChannelApprovalRequestOptions
+  ): Promise<DeliveryResult>;
+  /** Return the identity's configured Channel destination, when supported. */
+  contactSurface(identity: ChannelIdentity): ChannelMessageSurface | null;
+  /** Resolve whether a surface can currently be selected without delivery. */
+  isAvailable(surface: ChannelMessageSurface): Promise<boolean>;
+}
+//#endregion
+export {
+  ChannelRouteEvent as a,
+  ChannelMessageEvent as i,
+  ChannelHost as n,
+  ChannelHostOptions as r,
+  ChannelApprovalResponseEvent as t
+};
+//# sourceMappingURL=index-BB0kqhIz.d.ts.map

package/dist/index-BVVgDSdq.d.ts

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

package/dist/index-XDkuQ7zm.d.ts

@@ -0,0 +1,89 @@
+//#region src/tasks/errors.d.ts
+/**
+ * Error classes for the Tasks capability. Each carries a stable `name` so
+ * hosts and tests can classify failures without depending on message text.
+ */
+/**
+ * Thrown by a step callback to fail its run immediately, skipping any
+ * remaining retry attempts.
+ *
+ * Errors named `"NonRetryableError"` from other sources (for example
+ * `cloudflare:workflows`) are honored the same way.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class NonRetryableError extends Error {
+  constructor(
+    message: string,
+    options?: {
+      cause?: unknown;
+    }
+  );
+}
+/**
+ * Thrown before executing user code when one replay uses the same step name
+ * twice. Step names are durable journal keys and must be unique within a run.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class DuplicateTaskStepError extends Error {
+  /** The step name used more than once. */
+  readonly stepName: string;
+  constructor(stepName: string);
+}
+/**
+ * Thrown when a replay observes a journal that this handler code cannot have
+ * written — a known step under a different kind, for example. The run fails
+ * rather than guessing; changing a definition's step layout for in-flight
+ * runs requires versioning the definition name.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class TaskReplayDivergedError extends Error {
+  /** The step name where replay diverged from the journal. */
+  readonly stepName: string;
+  constructor(stepName: string, detail: string);
+}
+/**
+ * Recorded against a run whose persisted definition name is no longer
+ * registered after a deployment. The run fails visibly; it is never silently
+ * deleted and never replayed against a different handler.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class MissingTaskDefinitionError extends Error {
+  /** The persisted definition name that no longer resolves. */
+  readonly definition: string;
+  constructor(definition: string);
+}
+/**
+ * Thrown when a Task input, step result, metadata value, or final result is
+ * not JSON-serializable or exceeds the serialized size limit.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class TaskSerializationError extends Error {
+  constructor(context: string, detail: string);
+}
+//#endregion
+//#region src/tasks/serialization.d.ts
+/**
+ * Value serialization for the Tasks capability.
+ *
+ * Task inputs, step results, metadata, and final results persist as JSON
+ * text in SQLite. `undefined` (and a `void` handler result) is represented
+ * as SQL `NULL` rather than a JSON envelope, so the JSON column space stays
+ * plain: `"null"` is JSON `null`, column `NULL` is `undefined`.
+ */
+/** Default ceiling for one serialized value (1 MiB). */
+declare const MAX_SERIALIZED_BYTES = 1048576;
+//#endregion
+export {
+  TaskReplayDivergedError as a,
+  NonRetryableError as i,
+  DuplicateTaskStepError as n,
+  TaskSerializationError as o,
+  MissingTaskDefinitionError as r,
+  MAX_SERIALIZED_BYTES as t
+};
+//# sourceMappingURL=index-XDkuQ7zm.d.ts.map

package/dist/{index-DcSAZKsB.d.ts → index-YSKgfgg9.d.ts}

@@ -785,6 +785,8 @@ declare const channels: {
   readonly chat: Channel<any, any>;
   readonly transcript: Channel<any, any>;
   readonly fiber: Channel<any, any>;
+  readonly task: Channel<any, any>;
+  readonly stream: Channel<any, any>;
   readonly agentTool: Channel<any, any>;
   readonly schedule: Channel<any, any>;
   readonly lifecycle: Channel<any, any>;
@@ -932,4 +934,4 @@ export {
   MCPObservabilityEvent as s,
   ChannelEventMap as t
 };
-//# sourceMappingURL=index-DcSAZKsB.d.ts.map
+//# sourceMappingURL=index-YSKgfgg9.d.ts.map