agents 0.21.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/{do-oauth-client-provider-VTZj2VtM.d.ts → do-oauth-client-provider-Tmf1vgKz.d.ts}

@@ -7,7 +7,7 @@ import {
   StoredOAuthTokens
 } from "@modelcontextprotocol/client";
 
-//#region src/mcp/do-oauth-client-provider.d.ts
+//#region src/mcp/client/do-oauth-client-provider.d.ts
 interface AgentMcpOAuthProvider extends OAuthClientProvider {
   authUrl: string | undefined;
   clientId: string | undefined;
@@ -107,4 +107,4 @@ export {
   DurableObjectOAuthClientProvider as r,
   AgentMcpOAuthProvider as t
 };
-//# sourceMappingURL=do-oauth-client-provider-VTZj2VtM.d.ts.map
+//# sourceMappingURL=do-oauth-client-provider-Tmf1vgKz.d.ts.map

package/dist/{email-CL27preh.d.ts → email-7TatiTnl.d.ts}

@@ -1,4 +1,31 @@
 //#region src/email.d.ts
+/** Cloudflare Email Service binding. */
+type EmailSendBinding = SendEmail;
+/** Options for sending an outbound email from an Agent. */
+type SendEmailOptions = {
+  binding: EmailSendBinding;
+  to: string | string[];
+  from:
+    | string
+    | {
+        email: string;
+        name?: string;
+      };
+  subject: string;
+  text?: string;
+  html?: string;
+  replyTo?:
+    | string
+    | {
+        email: string;
+        name?: string;
+      };
+  cc?: string | string[];
+  bcc?: string | string[];
+  inReplyTo?: string;
+  headers?: Record<string, string>;
+  secret?: string;
+};
 /**
  * Header object as returned by postal-mime and similar email parsing libraries.
  * Each header has a lowercase key and a string value.
@@ -141,17 +168,19 @@ declare function createCatchAllEmailResolver<Env>(
 ): EmailResolver<Env>;
 //#endregion
 export {
-  SecureReplyResolverOptions as a,
-  createCatchAllEmailResolver as c,
-  isAutoReplyEmail as d,
-  signAgentHeaders as f,
+  EmailSendBinding as a,
+  SignatureFailureReason as c,
+  createHeaderBasedEmailResolver as d,
+  createSecureReplyEmailResolver as f,
   EmailResolverResult as i,
-  createHeaderBasedEmailResolver as l,
+  createAddressBasedEmailResolver as l,
+  signAgentHeaders as m,
   EmailHeader as n,
-  SignatureFailureReason as o,
+  SecureReplyResolverOptions as o,
+  isAutoReplyEmail as p,
   EmailResolver as r,
-  createAddressBasedEmailResolver as s,
+  SendEmailOptions as s,
   DEFAULT_MAX_AGE_SECONDS as t,
-  createSecureReplyEmailResolver as u
+  createCatchAllEmailResolver as u
 };
-//# sourceMappingURL=email-CL27preh.d.ts.map
+//# sourceMappingURL=email-7TatiTnl.d.ts.map

package/dist/email-send.d.ts

@@ -0,0 +1,15 @@
+import { s as SendEmailOptions } from "./email-7TatiTnl.js";
+
+//#region src/email-send.d.ts
+type AgentEmailIdentity = {
+  agentName: string;
+  agentId: string;
+};
+/** Send with the routing and signing behavior used by `Agent.sendEmail()`. */
+declare function sendAgentEmail(
+  options: SendEmailOptions,
+  identity: AgentEmailIdentity
+): Promise<EmailSendResult>;
+//#endregion
+export { sendAgentEmail };
+//# sourceMappingURL=email-send.d.ts.map

package/dist/email-send.js

@@ -0,0 +1,32 @@
+import { signAgentHeaders } from "./email.js";
+//#region src/email-send.ts
+/** Send with the routing and signing behavior used by `Agent.sendEmail()`. */
+async function sendAgentEmail(options, identity) {
+	if (!options.binding) throw new Error("binding is required. Pass your send_email binding, e.g. this.sendEmail({ binding: this.env.EMAIL, ... }).");
+	const headers = {
+		...options.headers,
+		"X-Agent-Name": identity.agentName,
+		"X-Agent-ID": identity.agentId
+	};
+	if (options.inReplyTo) headers["In-Reply-To"] = options.inReplyTo;
+	if (typeof options.secret === "string") {
+		const signedHeaders = await signAgentHeaders(options.secret, identity.agentName, identity.agentId);
+		headers["X-Agent-Sig"] = signedHeaders["X-Agent-Sig"];
+		headers["X-Agent-Sig-Ts"] = signedHeaders["X-Agent-Sig-Ts"];
+	}
+	return options.binding.send({
+		from: options.from,
+		to: options.to,
+		subject: options.subject,
+		text: options.text,
+		html: options.html,
+		replyTo: options.replyTo,
+		cc: options.cc,
+		bcc: options.bcc,
+		headers
+	});
+}
+//#endregion
+export { sendAgentEmail };
+
+//# sourceMappingURL=email-send.js.map

package/dist/email-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-send.js","names":[],"sources":["../src/email-send.ts"],"sourcesContent":["import { signAgentHeaders, type SendEmailOptions } from \"./email\";\n\ntype AgentEmailIdentity = {\n  agentName: string;\n  agentId: string;\n};\n\n/** Send with the routing and signing behavior used by `Agent.sendEmail()`. */\nexport async function sendAgentEmail(\n  options: SendEmailOptions,\n  identity: AgentEmailIdentity\n): Promise<EmailSendResult> {\n  if (!options.binding) {\n    throw new Error(\n      \"binding is required. Pass your send_email binding, \" +\n        \"e.g. this.sendEmail({ binding: this.env.EMAIL, ... }).\"\n    );\n  }\n\n  const headers: Record<string, string> = {\n    ...options.headers,\n    \"X-Agent-Name\": identity.agentName,\n    \"X-Agent-ID\": identity.agentId\n  };\n\n  if (options.inReplyTo) {\n    headers[\"In-Reply-To\"] = options.inReplyTo;\n  }\n\n  if (typeof options.secret === \"string\") {\n    const signedHeaders = await signAgentHeaders(\n      options.secret,\n      identity.agentName,\n      identity.agentId\n    );\n    headers[\"X-Agent-Sig\"] = signedHeaders[\"X-Agent-Sig\"];\n    headers[\"X-Agent-Sig-Ts\"] = signedHeaders[\"X-Agent-Sig-Ts\"];\n  }\n\n  // Preserve Agent.sendEmail()'s existing optional display-name input while\n  // delegating to the platform binding type, whose EmailAddress requires one.\n  return options.binding.send({\n    from: options.from,\n    to: options.to,\n    subject: options.subject,\n    text: options.text,\n    html: options.html,\n    replyTo: options.replyTo,\n    cc: options.cc,\n    bcc: options.bcc,\n    headers\n  } as EmailMessageBuilder);\n}\n"],"mappings":";;;AAQA,eAAsB,eACpB,SACA,UAC0B;CAC1B,IAAI,CAAC,QAAQ,SACX,MAAM,IAAI,MACR,2GAEF;CAGF,MAAM,UAAkC;EACtC,GAAG,QAAQ;EACX,gBAAgB,SAAS;EACzB,cAAc,SAAS;CACzB;CAEA,IAAI,QAAQ,WACV,QAAQ,iBAAiB,QAAQ;CAGnC,IAAI,OAAO,QAAQ,WAAW,UAAU;EACtC,MAAM,gBAAgB,MAAM,iBAC1B,QAAQ,QACR,SAAS,WACT,SAAS,OACX;EACA,QAAQ,iBAAiB,cAAc;EACvC,QAAQ,oBAAoB,cAAc;CAC5C;CAIA,OAAO,QAAQ,QAAQ,KAAK;EAC1B,MAAM,QAAQ;EACd,IAAI,QAAQ;EACZ,SAAS,QAAQ;EACjB,MAAM,QAAQ;EACd,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,IAAI,QAAQ;EACZ,KAAK,QAAQ;EACb;CACF,CAAwB;AAC1B"}

package/dist/email.d.ts

@@ -1,25 +1,29 @@
-import { n as AgentEmail } from "./internal_context-Dg4Cgjcu.js";
+import { t as AgentEmail } from "./internal_context-BlxFEWfn.js";
 import {
-  a as SecureReplyResolverOptions,
-  c as createCatchAllEmailResolver,
-  d as isAutoReplyEmail,
-  f as signAgentHeaders,
+  a as EmailSendBinding,
+  c as SignatureFailureReason,
+  d as createHeaderBasedEmailResolver,
+  f as createSecureReplyEmailResolver,
   i as EmailResolverResult,
-  l as createHeaderBasedEmailResolver,
+  l as createAddressBasedEmailResolver,
+  m as signAgentHeaders,
   n as EmailHeader,
-  o as SignatureFailureReason,
+  o as SecureReplyResolverOptions,
+  p as isAutoReplyEmail,
   r as EmailResolver,
-  s as createAddressBasedEmailResolver,
+  s as SendEmailOptions,
   t as DEFAULT_MAX_AGE_SECONDS,
-  u as createSecureReplyEmailResolver
-} from "./email-CL27preh.js";
+  u as createCatchAllEmailResolver
+} from "./email-7TatiTnl.js";
 export {
   type AgentEmail,
   DEFAULT_MAX_AGE_SECONDS,
   EmailHeader,
   EmailResolver,
   EmailResolverResult,
+  EmailSendBinding,
   SecureReplyResolverOptions,
+  SendEmailOptions,
   SignatureFailureReason,
   createAddressBasedEmailResolver,
   createCatchAllEmailResolver,