@opengeni/sdk 1.3.0 → 1.4.2

package/dist/{chunk-VYCTL62C.js → chunk-GZQSWAKD.js}

@@ -227,4 +227,4 @@ export {
   authorizeTranscriptionAdapter,
   createTranscriptionSessionRequest
 };
-//# sourceMappingURL=chunk-VYCTL62C.js.map
+//# sourceMappingURL=chunk-GZQSWAKD.js.map

package/dist/chunk-GZQSWAKD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transcription.ts"],"sourcesContent":["/**\n * Framework- and transport-agnostic speech-to-text capability contract.\n *\n * Audio transport, microphone access, credentials, and provider SDKs belong to\n * host-supplied adapters. This module deliberately contains no browser globals\n * and no provider implementation.\n */\n\nimport type { WorkspaceVoiceInputSettings } from \"./types\";\n\nexport type TranscriptionCredentialMode = \"managed\" | \"byok\";\n\nexport type WorkspaceTranscriptionTarget = {\n  provider: string;\n  model: string | null;\n  credentialMode: TranscriptionCredentialMode;\n  /** Workspace-scoped connection reference. This is never a secret. */\n  credentialConnectionId: string | null;\n  region: string | null;\n};\n\nexport type WorkspaceTranscriptionPolicy = {\n  enabled: boolean;\n  /** Exact admin-accepted policy identity; required whenever enabled. */\n  acceptanceId: string | null;\n  primary: WorkspaceTranscriptionTarget | null;\n  /** Explicit language preference. Required when automatic detection is not accepted. */\n  language: string | null;\n  /** Whether the accepted adapter may automatically detect the spoken language. */\n  autoDetectLanguage: boolean;\n  /** Whether the accepted adapter may identify distinct speakers. */\n  diarization: {\n    enabled: boolean;\n    maxSpeakers: number | null;\n  };\n  retention: {\n    mode: \"none\" | \"provider-policy\";\n    maxDays: number | null;\n  };\n  privacy: {\n    allowProviderLogging: boolean;\n    allowProviderTraining: boolean;\n  };\n  fallback: {\n    mode: \"disabled\" | \"explicit\";\n    targets: WorkspaceTranscriptionTarget[];\n  };\n  cost: {\n    currency: \"USD\";\n    maxPerHour: number | null;\n    maxPerMonth: number | null;\n  };\n};\n\nexport const DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY: WorkspaceTranscriptionPolicy = {\n  enabled: false,\n  acceptanceId: null,\n  primary: null,\n  language: null,\n  autoDetectLanguage: false,\n  diarization: { enabled: false, maxSpeakers: null },\n  retention: { mode: \"none\", maxDays: null },\n  privacy: { allowProviderLogging: false, allowProviderTraining: false },\n  fallback: { mode: \"disabled\", targets: [] },\n  cost: { currency: \"USD\", maxPerHour: null, maxPerMonth: null },\n};\n\nexport type TranscriptionAdapterDescriptor = {\n  provider: string;\n  model: string | null;\n  credentialMode: TranscriptionCredentialMode;\n  region: string | null;\n};\n\nexport type TranscriptionTargetSelection =\n  | { kind: \"primary\" }\n  | { kind: \"fallback\"; index: number };\n\nexport type TranscriptionPolicyBlockReason =\n  | \"disabled\"\n  | \"unaccepted\"\n  | \"target_missing\"\n  | \"fallback_disabled\"\n  | \"fallback_unaccepted\"\n  | \"provider_mismatch\"\n  | \"model_mismatch\"\n  | \"credential_mode_mismatch\"\n  | \"region_mismatch\";\n\nexport type TranscriptionAuthorization =\n  | {\n      authorized: true;\n      acceptanceId: string;\n      target: WorkspaceTranscriptionTarget;\n      selection: TranscriptionTargetSelection;\n    }\n  | { authorized: false; reason: TranscriptionPolicyBlockReason };\n\nexport type TranscriptionLifecycleStatus =\n  | \"idle\"\n  | \"requesting-permission\"\n  | \"listening\"\n  | \"reconnecting\"\n  | \"cancelling\"\n  | \"closed\"\n  | \"error\";\n\nexport type TranscriptionErrorCode =\n  | \"insufficient_credits\"\n  | \"allowance_exhausted\"\n  | \"monthly_model_cost_limit\"\n  | \"permission_denied\"\n  | \"not_supported\"\n  | \"network\"\n  | \"provider\"\n  | \"policy_blocked\"\n  | \"timeout\"\n  | \"cancelled\"\n  | \"unavailable\"\n  | \"too_large\"\n  | \"invalid_audio\"\n  | \"unknown\";\n\n/** Native browser voice input defaults to the configured deployment capability. */\nexport function resolveWorkspaceVoiceInputEnabled(settings: unknown): boolean | null {\n  if (!isRecord(settings)) return null;\n  const voiceInput = settings.voiceInput;\n  if (isRecord(voiceInput) && typeof voiceInput.enabled === \"boolean\") {\n    return (voiceInput as WorkspaceVoiceInputSettings).enabled;\n  }\n  const legacy = settings.transcription;\n  return isRecord(legacy) && typeof legacy.enabled === \"boolean\" ? legacy.enabled : null;\n}\n\nexport type TranscriptionTimeSpan = {\n  startMilliseconds: number;\n  endMilliseconds: number;\n};\n\nexport type TranscriptionSpeaker = {\n  /** Provider-neutral identity stable within the local transcription session. */\n  id: string;\n  label?: string | undefined;\n};\n\nexport type TranscriptionWord = {\n  text: string;\n  span: TranscriptionTimeSpan;\n  confidence?: number | undefined;\n  speaker?: TranscriptionSpeaker | undefined;\n};\n\n/** Optional result detail; adapters omit fields their provider cannot supply. */\nexport type TranscriptionResultMetadata = {\n  detectedLanguage?: string | undefined;\n  span?: TranscriptionTimeSpan | undefined;\n  confidence?: number | undefined;\n  speaker?: TranscriptionSpeaker | undefined;\n  words?: TranscriptionWord[] | undefined;\n};\n\nexport type TranscriptionDiagnostic = {\n  operation: \"start\" | \"session\" | \"cancel\" | \"close\";\n  code: TranscriptionErrorCode;\n  /** Exact diagnostic detail forwarded by React without content rewriting. */\n  detail: string;\n};\n\ntype TranscriptionEventBase = {\n  /** Stable across reconnects and explicitly accepted fallback attempts. */\n  localSessionId: string;\n  /** Adapter-monotonic across the entire local session, including replay. */\n  sequence: number;\n  occurredAt: string;\n};\n\nexport type TranscriptionEvent =\n  | (TranscriptionEventBase & { type: \"permission.requested\" })\n  | (TranscriptionEventBase & {\n      type: \"session.opened\";\n      providerSessionId: string;\n    })\n  | (TranscriptionEventBase & {\n      type: \"transcript.partial\";\n      segmentId: string;\n      text: string;\n      metadata?: TranscriptionResultMetadata | undefined;\n    })\n  | (TranscriptionEventBase & {\n      type: \"transcript.final\";\n      segmentId: string;\n      text: string;\n      /** Stable provider/coordinator acceptance identity used for dedupe. */\n      providerAcceptanceId: string;\n      metadata?: TranscriptionResultMetadata | undefined;\n    })\n  | (TranscriptionEventBase & {\n      type: \"usage\";\n      audioMilliseconds: number;\n      costUsd: number | null;\n    })\n  | (TranscriptionEventBase & {\n      type: \"session.reconnecting\";\n      attempt: number;\n      reason: string;\n    })\n  | (TranscriptionEventBase & {\n      type: \"session.error\";\n      code: TranscriptionErrorCode;\n      recoverable: boolean;\n    })\n  | (TranscriptionEventBase & {\n      type: \"session.closed\";\n      reason: \"completed\" | \"cancelled\" | \"error\" | \"replaced\";\n    });\n\nexport type TranscriptionSessionRequest = {\n  localSessionId: string;\n  policyAcceptanceId: string;\n  selection: TranscriptionTargetSelection;\n  target: WorkspaceTranscriptionTarget;\n  language: string | null;\n  autoDetectLanguage: boolean;\n  diarization: WorkspaceTranscriptionPolicy[\"diarization\"];\n  retention: WorkspaceTranscriptionPolicy[\"retention\"];\n  privacy: WorkspaceTranscriptionPolicy[\"privacy\"];\n  cost: WorkspaceTranscriptionPolicy[\"cost\"];\n  /** A replacement/reconnect adapter must emit events above this floor. */\n  sequenceFloor: number;\n};\n\nexport type TranscriptionEventListener = (event: TranscriptionEvent) => void;\n\nexport type TranscriptionAdapterStartContext = {\n  /** Aborted on local cancellation, policy replacement, timeout, or unmount. */\n  signal: AbortSignal;\n  /** Non-UI observability seam; callers receive the exact provider detail. */\n  reportDiagnostic: (diagnostic: TranscriptionDiagnostic) => void;\n};\n\nexport type TranscriptionSession = {\n  readonly localSessionId: string;\n  cancel(reason?: string): Promise<void>;\n  close(): Promise<void>;\n};\n\nexport type TranscriptionAdapter = {\n  readonly descriptor: TranscriptionAdapterDescriptor;\n  start(\n    request: TranscriptionSessionRequest,\n    listener: TranscriptionEventListener,\n    context: TranscriptionAdapterStartContext,\n  ): Promise<TranscriptionSession>;\n};\n\n/** Invalid or absent settings always resolve to the fail-closed default. */\nexport function resolveWorkspaceTranscriptionPolicy(\n  settings: unknown,\n): WorkspaceTranscriptionPolicy {\n  if (!isRecord(settings)) return cloneDefaultPolicy();\n  const candidate = settings.transcription;\n  if (!isWorkspaceTranscriptionPolicy(candidate)) return cloneDefaultPolicy();\n  return {\n    ...candidate,\n    primary: candidate.primary ? normalizeTarget(candidate.primary) : null,\n    language: candidate.language?.trim() ?? null,\n    diarization: { ...candidate.diarization },\n    retention: { ...candidate.retention },\n    privacy: { ...candidate.privacy },\n    fallback: {\n      mode: candidate.fallback.mode,\n      targets: candidate.fallback.targets.map(normalizeTarget),\n    },\n    cost: { ...candidate.cost },\n  };\n}\n\n/**\n * Speech authorization is intentionally independent from turn model policy.\n * Every selected adapter must match one exact admin-accepted target.\n */\nexport function authorizeTranscriptionAdapter(\n  policy: WorkspaceTranscriptionPolicy,\n  descriptor: TranscriptionAdapterDescriptor,\n  selection: TranscriptionTargetSelection = { kind: \"primary\" },\n): TranscriptionAuthorization {\n  if (!isWorkspaceTranscriptionPolicy(policy)) {\n    return { authorized: false, reason: \"unaccepted\" };\n  }\n  if (!policy.enabled) return { authorized: false, reason: \"disabled\" };\n  if (!policy.acceptanceId) return { authorized: false, reason: \"unaccepted\" };\n  let target: WorkspaceTranscriptionTarget | null | undefined;\n  if (selection.kind === \"primary\") {\n    target = policy.primary;\n  } else {\n    if (policy.fallback.mode !== \"explicit\") {\n      return { authorized: false, reason: \"fallback_disabled\" };\n    }\n    target = policy.fallback.targets[selection.index];\n    if (!target) return { authorized: false, reason: \"fallback_unaccepted\" };\n  }\n  if (!target) return { authorized: false, reason: \"target_missing\" };\n  const acceptedTarget = normalizeTarget(target);\n  if (acceptedTarget.provider !== descriptor.provider) {\n    return { authorized: false, reason: \"provider_mismatch\" };\n  }\n  if (acceptedTarget.model !== descriptor.model) {\n    return { authorized: false, reason: \"model_mismatch\" };\n  }\n  if (acceptedTarget.credentialMode !== descriptor.credentialMode) {\n    return { authorized: false, reason: \"credential_mode_mismatch\" };\n  }\n  if (acceptedTarget.region !== descriptor.region) {\n    return { authorized: false, reason: \"region_mismatch\" };\n  }\n  return {\n    authorized: true,\n    acceptanceId: policy.acceptanceId,\n    target: acceptedTarget,\n    selection,\n  };\n}\n\nexport function createTranscriptionSessionRequest(input: {\n  policy: WorkspaceTranscriptionPolicy;\n  adapter: TranscriptionAdapter;\n  localSessionId: string;\n  selection?: TranscriptionTargetSelection | undefined;\n  sequenceFloor?: number | undefined;\n}): TranscriptionSessionRequest | null {\n  const sequenceFloor = input.sequenceFloor ?? 0;\n  if (!Number.isSafeInteger(sequenceFloor) || sequenceFloor < 0) return null;\n  const authorization = authorizeTranscriptionAdapter(\n    input.policy,\n    input.adapter.descriptor,\n    input.selection,\n  );\n  if (!authorization.authorized) return null;\n  return {\n    localSessionId: input.localSessionId,\n    policyAcceptanceId: authorization.acceptanceId,\n    selection: authorization.selection,\n    target: { ...authorization.target },\n    language: input.policy.language?.trim() ?? null,\n    autoDetectLanguage: input.policy.autoDetectLanguage,\n    diarization: { ...input.policy.diarization },\n    retention: { ...input.policy.retention },\n    privacy: { ...input.policy.privacy },\n    cost: { ...input.policy.cost },\n    sequenceFloor,\n  };\n}\n\nfunction cloneDefaultPolicy(): WorkspaceTranscriptionPolicy {\n  return {\n    ...DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY,\n    diarization: { ...DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY.diarization },\n    retention: { ...DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY.retention },\n    privacy: { ...DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY.privacy },\n    fallback: { mode: \"disabled\", targets: [] },\n    cost: { ...DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY.cost },\n  };\n}\n\nfunction isWorkspaceTranscriptionPolicy(value: unknown): value is WorkspaceTranscriptionPolicy {\n  if (!isRecord(value) || typeof value.enabled !== \"boolean\") return false;\n  if (\n    !hasOnlyKeys(value, [\n      \"enabled\",\n      \"acceptanceId\",\n      \"primary\",\n      \"language\",\n      \"autoDetectLanguage\",\n      \"diarization\",\n      \"retention\",\n      \"privacy\",\n      \"fallback\",\n      \"cost\",\n    ])\n  ) {\n    return false;\n  }\n  if (!(value.acceptanceId === null || isUuid(value.acceptanceId))) return false;\n  if (!(value.primary === null || isTarget(value.primary))) return false;\n  if (!(value.language === null || isBoundedString(value.language, 64))) return false;\n  if (typeof value.autoDetectLanguage !== \"boolean\") return false;\n  if (\n    !isRecord(value.diarization) ||\n    !hasOnlyKeys(value.diarization, [\"enabled\", \"maxSpeakers\"]) ||\n    typeof value.diarization.enabled !== \"boolean\" ||\n    !(\n      value.diarization.maxSpeakers === null ||\n      (isBoundedInteger(value.diarization.maxSpeakers, 100) && value.diarization.maxSpeakers >= 2)\n    )\n  ) {\n    return false;\n  }\n  if (!value.diarization.enabled && value.diarization.maxSpeakers !== null) return false;\n  if (!isRecord(value.retention) || !hasOnlyKeys(value.retention, [\"mode\", \"maxDays\"])) {\n    return false;\n  }\n  if (value.retention.mode !== \"none\" && value.retention.mode !== \"provider-policy\") return false;\n  if (!(value.retention.maxDays === null || isBoundedInteger(value.retention.maxDays, 3650))) {\n    return false;\n  }\n  if (\n    !isRecord(value.privacy) ||\n    !hasOnlyKeys(value.privacy, [\"allowProviderLogging\", \"allowProviderTraining\"]) ||\n    typeof value.privacy.allowProviderLogging !== \"boolean\" ||\n    typeof value.privacy.allowProviderTraining !== \"boolean\"\n  ) {\n    return false;\n  }\n  if (!isRecord(value.fallback) || !hasOnlyKeys(value.fallback, [\"mode\", \"targets\"])) {\n    return false;\n  }\n  if (value.fallback.mode !== \"disabled\" && value.fallback.mode !== \"explicit\") return false;\n  if (\n    !Array.isArray(value.fallback.targets) ||\n    value.fallback.targets.length > 8 ||\n    !value.fallback.targets.every(isTarget)\n  ) {\n    return false;\n  }\n  if (value.fallback.mode === \"disabled\" && value.fallback.targets.length !== 0) return false;\n  if (value.fallback.mode === \"explicit\" && value.fallback.targets.length === 0) return false;\n  if (\n    !isRecord(value.cost) ||\n    !hasOnlyKeys(value.cost, [\"currency\", \"maxPerHour\", \"maxPerMonth\"]) ||\n    value.cost.currency !== \"USD\"\n  ) {\n    return false;\n  }\n  if (!isNullableBoundedNumber(value.cost.maxPerHour, 10_000)) return false;\n  if (!isNullableBoundedNumber(value.cost.maxPerMonth, 1_000_000)) return false;\n  if (value.enabled && (!value.acceptanceId || !value.primary)) return false;\n  if (value.enabled && !value.autoDetectLanguage && value.language === null) return false;\n  if (value.autoDetectLanguage && value.language !== null) return false;\n  const targets = [value.primary, ...value.fallback.targets].filter(\n    (target): target is WorkspaceTranscriptionTarget => target !== null,\n  );\n  if (new Set(targets.map(targetKey)).size !== targets.length) return false;\n  return true;\n}\n\nfunction targetKey(target: WorkspaceTranscriptionTarget): string {\n  return [\n    target.provider.trim(),\n    target.model?.trim() ?? \"\",\n    target.credentialMode,\n    target.credentialConnectionId ?? \"\",\n    target.region?.trim() ?? \"\",\n  ].join(\"\\u0000\");\n}\n\nfunction isTarget(value: unknown): value is WorkspaceTranscriptionTarget {\n  if (!isRecord(value)) return false;\n  if (\n    !hasOnlyKeys(value, [\"provider\", \"model\", \"credentialMode\", \"credentialConnectionId\", \"region\"])\n  ) {\n    return false;\n  }\n  if (!isBoundedString(value.provider, 128)) return false;\n  if (!(value.model === null || isBoundedString(value.model, 256))) return false;\n  if (value.credentialMode !== \"managed\" && value.credentialMode !== \"byok\") return false;\n  if (value.provider.trim() === \"azure-speech\" && value.credentialMode !== \"byok\") return false;\n  if (!(value.credentialConnectionId === null || isUuid(value.credentialConnectionId))) {\n    return false;\n  }\n  if (!(value.region === null || isBoundedString(value.region, 128))) return false;\n  if (value.credentialMode === \"byok\" && value.credentialConnectionId === null) return false;\n  if (value.credentialMode === \"managed\" && value.credentialConnectionId !== null) return false;\n  return true;\n}\n\nfunction normalizeTarget(target: WorkspaceTranscriptionTarget): WorkspaceTranscriptionTarget {\n  return {\n    provider: target.provider.trim(),\n    model: target.model?.trim() ?? null,\n    credentialMode: target.credentialMode,\n    credentialConnectionId: target.credentialConnectionId,\n    region: target.region?.trim() ?? null,\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n  const accepted = new Set(keys);\n  return Object.keys(value).every((key) => accepted.has(key));\n}\n\nfunction isBoundedString(value: unknown, maximum: number): value is string {\n  return typeof value === \"string\" && value.trim().length > 0 && value.length <= maximum;\n}\n\nfunction isUuid(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)\n  );\n}\n\nfunction isBoundedInteger(value: unknown, maximum: number): value is number {\n  return Number.isInteger(value) && (value as number) >= 0 && (value as number) <= maximum;\n}\n\nfunction isNullableBoundedNumber(value: unknown, maximum: number): boolean {\n  return (\n    value === null ||\n    (typeof value === \"number\" && Number.isFinite(value) && value >= 0 && value <= maximum)\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2UXZUCEZ.js → chunk-JOI7XCG6.js}

@@ -91,7 +91,7 @@ function parseCodexRealtimeV3Event(payload) {
       }
     };
   }
-  if (type === "turn.done") {
+  if (type === "turn.done" || type === "transcript.segment") {
     const turn = record(event.turn);
     const turnIdField = boundedStringField(turn, "id", CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES);
     const transcriptField = boundedStringField(
@@ -395,6 +395,10 @@ function createCodexRealtimeV3Bridge(options) {
           clientAckThroughSequence = Math.max(clientAckThroughSequence ?? 0, entry.sequence);
         }
       }
+      if (options.events.readyState !== "open") {
+        publish();
+        continue;
+      }
       for (let index = 0; index < result.outbound.length; ) {
         const entry = result.outbound[index];
         if (sentSequences.has(entry.sequence)) {
@@ -539,7 +543,7 @@ function createCodexRealtimeV3Bridge(options) {
       }
     } else if (event.type === "output_audio.delta") {
       speaking = true;
-    } else if (event.type === "turn.done") {
+    } else if (event.type === "turn.done" || event.type === "transcript.segment") {
       speaking = false;
       if (event.transcript.length > 0 && !finalizedTurnIds.has(event.turnId)) {
         const coveredByDelegationItemId = event.role === "user" && pendingDelegationUserTranscript !== null && normalizedTranscript(event.transcript) === normalizedTranscript(pendingDelegationUserTranscript.text) ? pendingDelegationUserTranscript.delegationItemId : null;
@@ -610,6 +614,7 @@ function finalTranscript(randomUUID, event, coveredByDelegationItemId, modelCont
     text: event.transcript,
     payload: {
       turnId: event.turnId,
+      ...event.type === "transcript.segment" ? { transcriptSource: "provider_fragments", grouping: "application_segment" } : {},
       ...coveredByDelegationItemId ? { coveredByDelegationItemId } : {}
     },
     ...modelContext ? { modelContext } : {}
@@ -872,7 +877,7 @@ async function startCodexRealtimeWebrtc(options) {
       { signal: options.signal }
     );
     throwIfAborted(options.signal);
-    if (answer.version !== "v3" || answer.model !== "gpt-live-1-boulder-alpha" || !answer.sdp) {
+    if (answer.version !== "v3" || answer.model !== (options.expectedModel ?? "gpt-live-1-boulder-alpha") || !answer.sdp) {
       throw new Error("Opengeni returned an incompatible Codex realtime answer");
     }
     await peerConnection.setRemoteDescription({
@@ -1093,7 +1098,23 @@ var SESSION_REALTIME_INBOUND_KINDS = /* @__PURE__ */ new Set([
   "error"
 ]);
 var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+var REALTIME_REFUSAL_CODES = /* @__PURE__ */ new Set([
+  "insufficient_credits",
+  "allowance_exhausted",
+  "monthly_model_cost_limit",
+  "realtime_voice_unavailable"
+]);
+function codexRealtimeRefusal(error) {
+  if (!(error instanceof OpenGeniApiError) || !error.code) return null;
+  if (!REALTIME_REFUSAL_CODES.has(error.code)) return null;
+  const message = apiErrorMessage(error);
+  return {
+    code: error.code,
+    message: message ?? (error.code === "insufficient_credits" ? "Live voice needs Opengeni credits. Add credits to continue." : "Live voice is unavailable right now.")
+  };
+}
 function sessionRealtimeOwnerStorageNamespace(model) {
+  if (model === "opengeni-azure/gpt-live-1") return "azure-live-owner";
   if (model === "gpt-live-1-boulder-alpha") return "codex-realtime-owner";
   if (model === "supergrok/grok-voice-think-fast-2.0") return "xai-realtime-owner";
   return "gateway-realtime-owner";
@@ -1151,7 +1172,8 @@ function createCodexRealtimeController(options) {
     connectionGeneration: 0,
     reconnectAttempt: 0,
     diagnostic: null,
-    error: null
+    error: null,
+    refusal: null
   };
   let active = null;
   let pendingAbort = null;
@@ -1168,6 +1190,7 @@ function createCodexRealtimeController(options) {
   let generation = 0;
   let reconnectAttempt = 0;
   let recoveryTerminal = false;
+  let connectedInMode = false;
   let mutationTail = Promise.resolve();
   let connectionTask = null;
   const acceptedDelegationItemIds = new Set(
@@ -1420,6 +1443,10 @@ function createCodexRealtimeController(options) {
     if (closed || stopping || isAbortError(error)) return;
     const message = safeError2(error);
     if (error instanceof CodexRealtimeMicrophoneError) {
+      if (error.code !== "track_ended" && !connectedInMode) {
+        await endAfterFailure(microphoneFailureMessage(error), null);
+        return;
+      }
       if (error.code === "track_ended" && state.mode?.state === "active") {
         reconnectAttempt += 1;
         publish({
@@ -1439,6 +1466,11 @@ function createCodexRealtimeController(options) {
       transitionEnded("Realtime owner no longer exists");
       return;
     }
+    const refusal = codexRealtimeRefusal(error);
+    if (refusal) {
+      await endForRefusal(refusal);
+      return;
+    }
     if (error instanceof OpenGeniApiError && error.status === 409 && error.retryable && owner) {
       try {
         const reconciled = await begin(owner, true, false);
@@ -1456,6 +1488,9 @@ function createCodexRealtimeController(options) {
           return;
         }
       }
+    } else if (error instanceof OpenGeniApiError && !error.retryable && !connectedInMode) {
+      await endAfterFailure(message, null);
+      return;
     } else if (error instanceof OpenGeniApiError && !error.retryable) {
       stopTimers();
       if (!active) releaseMicrophone();
@@ -1574,6 +1609,13 @@ function createCodexRealtimeController(options) {
     });
     let connected;
     try {
+      if (active?.transport.drain) {
+        await active.transport.drain();
+        await active.bridge.flush();
+      }
+      if (closed || stopping || abort.signal.aborted || pendingGeneration !== targetGeneration) {
+        throw abort.signal.reason ?? new DOMException("Aborted", "AbortError");
+      }
       const media = await ensureMicrophone(replaceMicrophone, abort.signal);
       const operationId = randomUUID();
       const commonTransportInput = {
@@ -1689,6 +1731,7 @@ function createCodexRealtimeController(options) {
         onFatal: (fatal) => onBridgeFatal(targetGeneration, bridge, fatal)
       });
       active = { generation: targetGeneration, transport: connected, bridge };
+      connectedInMode = true;
       connected.setOutputMuted(state.outputMuted);
       recoveryTerminal = false;
       pendingAbort = null;
@@ -1759,6 +1802,7 @@ function createCodexRealtimeController(options) {
     return response.mode;
   };
   const heartbeat = async () => {
+    let stopInstruction = null;
     await exclusive(async () => {
       const current = state.mode;
       if (!owner || !current || current.state !== "active") {
@@ -1779,6 +1823,30 @@ function createCodexRealtimeController(options) {
         return;
       }
       publish({ mode: result.mode, realtimeId: result.mode.id, error: null });
+      stopInstruction = result.stop ?? null;
+    });
+    const instruction = stopInstruction;
+    stopInstruction = null;
+    if (instruction && !stopping && !closed) await endForRefusal(instruction);
+  };
+  const endForRefusal = async (refusal) => await endAfterFailure(refusal.message, refusal);
+  const endAfterFailure = async (message, refusal) => {
+    try {
+      await controller.stop();
+    } catch {
+      stopping = false;
+      closeBrowserResources();
+      clearOwner();
+    }
+    recoveryTerminal = false;
+    publish({
+      status: "error",
+      realtimeId: null,
+      mode: null,
+      bridge: null,
+      diagnostic: diagnostic("terminal_stop", message, false),
+      error: message,
+      refusal
     });
   };
   const flush = async () => {
@@ -1828,6 +1896,7 @@ function createCodexRealtimeController(options) {
       closed = false;
       stopping = false;
       recoveryTerminal = false;
+      connectedInMode = false;
       const record2 = {
         version: OWNER_RECORD_VERSION,
         workspaceId: options.workspaceId,
@@ -1838,11 +1907,12 @@ function createCodexRealtimeController(options) {
       };
       owner = record2;
       storage?.setItem(storageKey, JSON.stringify(record2));
-      publish({ status: "starting", error: null, diagnostic: null });
+      publish({ status: "starting", error: null, diagnostic: null, refusal: null });
       try {
         await begin(record2, false);
       } catch (error) {
         closeBrowserResources(false);
+        const refusal = codexRealtimeRefusal(error);
         const failedMode = state.mode;
         if (failedMode?.state === "active") {
           await handleConnectionFailure(error, "reconnect", false);
@@ -1852,9 +1922,11 @@ function createCodexRealtimeController(options) {
             status: "error",
             realtimeId: null,
             mode: null,
-            error: safeError2(error)
+            error: refusal?.message ?? safeError2(error),
+            ...refusal ? { refusal, diagnostic: diagnostic("terminal_stop", refusal.message, false) } : {}
           });
         }
+        if (refusal) return;
         throw error;
       }
     },
@@ -1863,6 +1935,7 @@ function createCodexRealtimeController(options) {
         if (recoveryTerminal && state.mode?.state === "active") return;
         const record3 = readOwnerRecord(storage, storageKey, options);
         if (!record3) {
+          if (state.status === "error" && !state.mode) return;
           transitionEnded();
           return;
         }
@@ -1883,7 +1956,7 @@ function createCodexRealtimeController(options) {
       if (lifecycle.state === "ended") {
         const record3 = readOwnerRecord(storage, storageKey, options);
         if (record3 && record3.operationId !== lifecycle.operationId) {
-          if (connectionTask || state.status === "active") return;
+          if (connectionTask || state.status === "active" || state.status === "starting") return;
           closed = false;
           stopping = false;
           owner = record3;
@@ -1896,6 +1969,7 @@ function createCodexRealtimeController(options) {
           await connectionTask;
           return;
         }
+        if (state.status === "error" && !state.mode) return;
         if (state.realtimeId === null || lifecycle.realtimeId === state.realtimeId) {
           transitionEnded(`Realtime ended: ${lifecycle.reason}`);
         }
@@ -1979,6 +2053,7 @@ function createCodexRealtimeController(options) {
       connectionTask = null;
       void retiredTask?.catch(() => void 0);
       try {
+        await active?.transport.drain?.();
         await active?.bridge.sealAndFlush();
         closeBrowserResources();
         let current = state.mode;
@@ -2248,8 +2323,33 @@ function stringValue2(value) {
 function isAbortError(error) {
   return error instanceof Error && error.name === "AbortError";
 }
+function microphoneFailureMessage(error) {
+  switch (error.code) {
+    case "permission_denied":
+      return "Microphone access is blocked. Allow it in site settings, then try again.";
+    case "device_not_found":
+      return "No microphone was found. Connect one, then try again.";
+    case "device_unavailable":
+      return "Your microphone is busy or unavailable. Close other apps using it, then try again.";
+    default:
+      return /timed out/i.test(error.message) ? "Microphone access wasn't granted in time. Allow it when your browser asks, then try again." : "The microphone could not start. Try again.";
+  }
+}
+function apiErrorMessage(error) {
+  try {
+    const body = JSON.parse(error.body);
+    const nested = body.error && typeof body.error === "object" ? body.error : body;
+    return typeof nested.message === "string" && nested.message ? nested.message : null;
+  } catch {
+    return null;
+  }
+}
 function safeError2(error) {
-  return error instanceof Error ? error.message : "Codex realtime browser controller failed";
+  if (error instanceof OpenGeniApiError) {
+    const message = apiErrorMessage(error);
+    if (message) return /[.!?]$/.test(message) ? message : `${message}.`;
+  }
+  return error instanceof Error ? error.message : "Live voice failed in this browser.";
 }
 
 export {
@@ -2273,9 +2373,10 @@ export {
   createCodexRealtimeV3Bridge,
   projectSessionRealtimeLifecycle,
   CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,
+  codexRealtimeRefusal,
   sessionRealtimeOwnerStorageNamespace,
   sessionRealtimeOwnerStorageKey,
   hasStoredSessionRealtimeOwnerProof,
   createCodexRealtimeController
 };
-//# sourceMappingURL=chunk-2UXZUCEZ.js.map
+//# sourceMappingURL=chunk-JOI7XCG6.js.map