@agent-native/core 0.93.0 → 0.94.1

package/dist/server/realtime-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice.js","sourceRoot":"","sources":["../../src/server/realtime-voice.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineEventHandler,\n  getHeader,\n  getMethod,\n  readRawBody,\n  setResponseHeader,\n  setResponseStatus,\n  type H3Event,\n} from \"h3\";\n\nimport {\n  actionsToEngineTools,\n  type ActionEntry,\n} from \"../agent/production-agent.js\";\nimport {\n  redactSensitiveFields,\n  sanitizeToolErrorText,\n  sanitizeToolErrorValue,\n} from \"../agent/tool-error-redaction.js\";\nimport { getSession } from \"./auth.js\";\nimport { resolveSecret } from \"./credential-provider.js\";\nimport { getH3App } from \"./framework-request-handler.js\";\nimport { runWithRequestContext } from \"./request-context.js\";\n\nexport const REALTIME_VOICE_SESSION_PATH =\n  \"/_agent-native/realtime-voice/session\";\nexport const REALTIME_VOICE_TOOL_PATH = \"/_agent-native/realtime-voice/tool\";\nexport const REALTIME_VOICE_MAX_SDP_BYTES = 64 * 1024;\nexport const REALTIME_VOICE_MAX_TOOL_BODY_BYTES = 64 * 1024;\nexport const REALTIME_VOICE_MAX_TOOL_OUTPUT_CHARS = 16_000;\n\nconst OPENAI_REALTIME_CALLS_URL = \"https://api.openai.com/v1/realtime/calls\";\nconst DEFAULT_MODEL = \"gpt-realtime-2.1\";\nconst DEFAULT_VOICE = \"marin\";\nconst DEFAULT_INSTRUCTIONS =\n  \"You are the live voice interface for this Agent Native app. Speak naturally, briefly, and conversationally. Use the available function tools when the user asks you to navigate or take an action. Never claim an action succeeded until its tool result confirms success. If a tool requires approval, explain that the user must approve it in chat.\";\nconst MAX_INSTRUCTIONS_CHARS = 16_000;\nconst MAX_TOOL_DESCRIPTION_CHARS = 2_000;\nconst MAX_TOOL_SCHEMA_CHARS = 64 * 1024;\nconst MAX_APPROVAL_KEY_CHARS = 1_024;\nconst REALTIME_TOOL_NAME = /^[A-Za-z0-9_-]{1,64}$/;\nconst CALL_ID = /^[A-Za-z0-9_-]{1,256}$/;\nconst SESSION_ID = /^[A-Za-z0-9_.:-]{1,256}$/;\nconst BROWSER_TAB_ID = /^[A-Za-z0-9_-]{1,96}$/;\n\nexport interface RealtimeVoiceRequestContext {\n  event: H3Event;\n  userEmail: string;\n  orgId?: string;\n  browserTabId?: string;\n}\n\nexport interface RealtimeVoiceToolExecutionRequest extends RealtimeVoiceRequestContext {\n  name: string;\n  args: Record<string, unknown>;\n  callId: string;\n  sessionId?: string;\n}\n\nexport interface RealtimeVoiceToolExecutionResult {\n  status: \"completed\" | \"failed\" | \"approval_required\";\n  output: string;\n  approvalKey?: string;\n}\n\nexport interface MountRealtimeVoiceRoutesOptions {\n  /** Server-controlled model. Defaults to gpt-realtime-2.1. */\n  model?: string;\n  /** Server-controlled output voice. Defaults to marin. */\n  voice?: string;\n  /** Static app guidance appended to the safe default voice instructions. */\n  instructions?: string;\n  /** Per-request app/navigation guidance. It is sent only to OpenAI. */\n  getInstructions?: (\n    context: RealtimeVoiceRequestContext,\n  ) => string | null | undefined | Promise<string | null | undefined>;\n  /** Optional app-specific active-organization resolver. */\n  resolveOrgId?: (\n    event: H3Event,\n  ) => string | null | undefined | Promise<string | null | undefined>;\n  /**\n   * Central agent tool executor supplied by the agent-chat plugin. The executor\n   * owns validation, approval, journaling, timeout, mutation notification, and\n   * action-result normalization; this transport must not call ActionEntry.run.\n   */\n  executeTool: (\n    request: RealtimeVoiceToolExecutionRequest,\n  ) =>\n    | RealtimeVoiceToolExecutionResult\n    | Promise<RealtimeVoiceToolExecutionResult>;\n}\n\ninterface RealtimeFunctionTool {\n  type: \"function\";\n  name: string;\n  description: string;\n  parameters: Record<string, unknown>;\n}\n\ninterface AuthenticatedVoiceContext extends RealtimeVoiceRequestContext {\n  timezone?: string;\n}\n\nfunction readSafeHeader(event: H3Event, name: string): string | undefined {\n  const value = getHeader(event, name);\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed || undefined;\n}\n\nfunction configuredIdentifier(\n  value: string | undefined,\n  fallback: string,\n): string {\n  const trimmed = value?.trim();\n  return trimmed && /^[A-Za-z0-9_.:-]{1,128}$/.test(trimmed)\n    ? trimmed\n    : fallback;\n}\n\nfunction truncate(value: string, maxChars: number): string {\n  if (value.length <= maxChars) return value;\n  return `${value.slice(0, maxChars)}\\n\\n...[truncated]`;\n}\n\nfunction sanitizeOutput(value: unknown, maxChars: number): string {\n  let serialized: string;\n  try {\n    const redacted = redactSensitiveFields(value);\n    serialized =\n      typeof redacted === \"string\"\n        ? redacted\n        : (JSON.stringify(redacted, (_key, entry) =>\n            typeof entry === \"bigint\" ? entry.toString() : entry,\n          ) ?? \"null\");\n  } catch {\n    serialized = \"[Unserializable tool result]\";\n  }\n  return truncate(sanitizeToolErrorText(serialized), maxChars);\n}\n\nasync function safeOpenAiErrorDetail(\n  response: Response,\n  apiKey: string,\n): Promise<string | null> {\n  const raw = await response.text().catch(() => \"\");\n  if (!raw) return null;\n  let detail = raw;\n  try {\n    const parsed = JSON.parse(raw) as {\n      error?: { message?: unknown; code?: unknown; type?: unknown } | unknown;\n    };\n    if (parsed.error && typeof parsed.error === \"object\") {\n      const error = parsed.error as {\n        message?: unknown;\n        code?: unknown;\n        type?: unknown;\n      };\n      detail = [error.message, error.code, error.type]\n        .filter((value) => typeof value === \"string\" && value.trim())\n        .join(\" · \");\n    }\n  } catch {\n    // Plain-text upstream errors are sanitized below.\n  }\n  const redacted = sanitizeToolErrorText(detail).replaceAll(\n    apiKey,\n    \"[REDACTED]\",\n  );\n  return truncate(redacted, 500) || null;\n}\n\nfunction normalizeToolSchema(\n  inputSchema: unknown,\n): Record<string, unknown> | null {\n  try {\n    const serialized = JSON.stringify(inputSchema);\n    if (!serialized || serialized.length > MAX_TOOL_SCHEMA_CHARS) return null;\n    const parsed = JSON.parse(serialized) as unknown;\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return null;\n    }\n    return parsed as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nfunction buildRealtimeTools(\n  actions: Record<string, ActionEntry>,\n): RealtimeFunctionTool[] {\n  const tools: RealtimeFunctionTool[] = [];\n  for (const tool of actionsToEngineTools(actions)) {\n    if (!REALTIME_TOOL_NAME.test(tool.name)) continue;\n    const parameters = normalizeToolSchema(tool.inputSchema);\n    if (!parameters) continue;\n    tools.push({\n      type: \"function\",\n      name: tool.name,\n      description: truncate(\n        sanitizeToolErrorText(tool.description || \"\"),\n        MAX_TOOL_DESCRIPTION_CHARS,\n      ),\n      parameters,\n    });\n  }\n  return tools;\n}\n\nfunction declaredBodyBytes(event: H3Event): number | undefined {\n  const raw = readSafeHeader(event, \"content-length\");\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nasync function readLimitedRawBody(\n  event: H3Event,\n  maxBytes: number,\n): Promise<string | null | \"oversize\"> {\n  const declared = declaredBodyBytes(event);\n  if (declared !== undefined && declared > maxBytes) return \"oversize\";\n\n  const raw = await readRawBody(event, \"utf8\").catch(() => undefined);\n  if (raw == null) return null;\n  const text =\n    typeof raw === \"string\" ? raw : new TextDecoder().decode(raw as Uint8Array);\n  return new TextEncoder().encode(text).byteLength > maxBytes\n    ? \"oversize\"\n    : text;\n}\n\nasync function authenticateVoiceRequest(\n  event: H3Event,\n  options: MountRealtimeVoiceRoutesOptions,\n): Promise<AuthenticatedVoiceContext | null> {\n  const session = await getSession(event).catch(() => null);\n  if (!session?.email) return null;\n  const resolvedOrgId = options.resolveOrgId\n    ? await options.resolveOrgId(event)\n    : session.orgId;\n  const timezone = readSafeHeader(event, \"x-user-timezone\");\n  const rawBrowserTabId = readSafeHeader(event, \"x-agent-native-browser-tab\");\n  const browserTabId =\n    rawBrowserTabId && BROWSER_TAB_ID.test(rawBrowserTabId)\n      ? rawBrowserTabId\n      : undefined;\n  return {\n    event,\n    userEmail: session.email,\n    ...(resolvedOrgId ? { orgId: resolvedOrgId } : {}),\n    ...(timezone && timezone.length < 64 ? { timezone } : {}),\n    ...(browserTabId ? { browserTabId } : {}),\n  };\n}\n\nasync function buildInstructions(\n  context: RealtimeVoiceRequestContext,\n  options: MountRealtimeVoiceRoutesOptions,\n): Promise<string> {\n  const dynamic = await options.getInstructions?.(context);\n  const appInstructions = dynamic ?? options.instructions;\n  if (!appInstructions?.trim()) return DEFAULT_INSTRUCTIONS;\n  return truncate(\n    sanitizeToolErrorText(\n      `${DEFAULT_INSTRUCTIONS}\\n\\n${appInstructions.trim()}`,\n    ),\n    MAX_INSTRUCTIONS_CHARS,\n  );\n}\n\n/**\n * Hash the authenticated identity before sending it to OpenAI. The stable\n * digest is useful for abuse detection without disclosing the user's email.\n */\nexport async function realtimeVoiceSafetyIdentifier(\n  userEmail: string,\n): Promise<string> {\n  const input = new TextEncoder().encode(\n    `agent-native:${userEmail.trim().toLowerCase()}`,\n  );\n  const digest = await globalThis.crypto.subtle.digest(\"SHA-256\", input);\n  return Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, \"0\"),\n  ).join(\"\");\n}\n\nfunction invalidMethod(event: H3Event): { error: string } {\n  setResponseStatus(event, 405);\n  return { error: \"Method not allowed\" };\n}\n\nfunction createSessionHandler(\n  tools: RealtimeFunctionTool[],\n  options: MountRealtimeVoiceRoutesOptions,\n) {\n  return defineEventHandler(async (event: H3Event) => {\n    if (getMethod(event) !== \"POST\") return invalidMethod(event);\n    setResponseHeader(event, \"Cache-Control\", \"no-store\");\n\n    const auth = await authenticateVoiceRequest(event, options);\n    if (!auth) {\n      setResponseStatus(event, 401);\n      return { error: \"Authentication required\" };\n    }\n\n    const contentType = readSafeHeader(event, \"content-type\")?.toLowerCase();\n    if (!contentType?.includes(\"application/sdp\")) {\n      setResponseStatus(event, 415);\n      return { error: \"Expected Content-Type: application/sdp\" };\n    }\n\n    const rawSdp = await readLimitedRawBody(\n      event,\n      REALTIME_VOICE_MAX_SDP_BYTES,\n    );\n    if (rawSdp === \"oversize\") {\n      setResponseStatus(event, 413);\n      return {\n        error: `SDP offer is too large (max ${REALTIME_VOICE_MAX_SDP_BYTES} bytes)`,\n      };\n    }\n    const sdp = rawSdp ?? \"\";\n    if (!sdp.trim()) {\n      setResponseStatus(event, 400);\n      return { error: \"SDP offer is required\" };\n    }\n\n    return runWithRequestContext(\n      {\n        userEmail: auth.userEmail,\n        orgId: auth.orgId,\n        timezone: auth.timezone,\n        run: auth.browserTabId\n          ? { browserTabId: auth.browserTabId }\n          : undefined,\n      },\n      async () => {\n        const apiKey = (await resolveSecret(\"OPENAI_API_KEY\"))?.trim();\n        if (!apiKey) {\n          setResponseStatus(event, 400);\n          return {\n            error:\n              \"Configure OPENAI_API_KEY in Settings to use realtime voice.\",\n          };\n        }\n\n        const instructions = await buildInstructions(auth, options);\n        const session = {\n          type: \"realtime\",\n          model: configuredIdentifier(options.model, DEFAULT_MODEL),\n          instructions,\n          output_modalities: [\"audio\"],\n          audio: {\n            input: {\n              transcription: { model: \"gpt-4o-mini-transcribe\" },\n              turn_detection: {\n                type: \"semantic_vad\",\n                create_response: true,\n                interrupt_response: true,\n                eagerness: \"auto\",\n              },\n            },\n            output: {\n              voice: configuredIdentifier(options.voice, DEFAULT_VOICE),\n            },\n          },\n          tools,\n          tool_choice: \"auto\",\n        };\n\n        const form = new FormData();\n        form.set(\"sdp\", sdp);\n        form.set(\"session\", JSON.stringify(session));\n\n        let upstream: Response;\n        try {\n          upstream = await fetch(OPENAI_REALTIME_CALLS_URL, {\n            method: \"POST\",\n            headers: {\n              Authorization: `Bearer ${apiKey}`,\n              \"OpenAI-Safety-Identifier\": await realtimeVoiceSafetyIdentifier(\n                auth.userEmail,\n              ),\n            },\n            body: form,\n          });\n        } catch {\n          setResponseStatus(event, 502);\n          return { error: \"Could not reach the OpenAI Realtime API\" };\n        }\n\n        if (!upstream.ok) {\n          const detail = await safeOpenAiErrorDetail(upstream, apiKey);\n          setResponseStatus(event, 502);\n          return {\n            error: `OpenAI rejected the realtime session (${upstream.status})${detail ? `: ${detail}` : \"\"}`,\n          };\n        }\n\n        const answerSdp = await upstream.text().catch(() => \"\");\n        if (!answerSdp.trim()) {\n          setResponseStatus(event, 502);\n          return { error: \"OpenAI returned an empty realtime session answer\" };\n        }\n\n        setResponseStatus(event, upstream.status);\n        setResponseHeader(event, \"Content-Type\", \"application/sdp\");\n        return answerSdp;\n      },\n    );\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction parseToolRequest(value: unknown): {\n  name: string;\n  args: Record<string, unknown>;\n  callId: string;\n  sessionId?: string;\n  browserTabId?: string;\n} | null {\n  if (!isRecord(value)) return null;\n  const { name, args, callId, sessionId, browserTabId } = value;\n  if (typeof name !== \"string\" || !REALTIME_TOOL_NAME.test(name)) return null;\n  if (typeof callId !== \"string\" || !CALL_ID.test(callId)) return null;\n  if (!isRecord(args)) return null;\n  if (\n    sessionId !== undefined &&\n    (typeof sessionId !== \"string\" || !SESSION_ID.test(sessionId))\n  ) {\n    return null;\n  }\n  if (\n    browserTabId !== undefined &&\n    (typeof browserTabId !== \"string\" || !BROWSER_TAB_ID.test(browserTabId))\n  ) {\n    return null;\n  }\n  return {\n    name,\n    args,\n    callId,\n    ...(sessionId ? { sessionId } : {}),\n    ...(browserTabId ? { browserTabId } : {}),\n  };\n}\n\nfunction normalizeExecutionResult(\n  result: RealtimeVoiceToolExecutionResult,\n): RealtimeVoiceToolExecutionResult {\n  const status = result?.status;\n  if (\n    status !== \"completed\" &&\n    status !== \"failed\" &&\n    status !== \"approval_required\"\n  ) {\n    throw new Error(\"Invalid realtime tool execution status\");\n  }\n  const output = sanitizeOutput(\n    result.output,\n    REALTIME_VOICE_MAX_TOOL_OUTPUT_CHARS,\n  );\n  return {\n    status,\n    output,\n    ...(status === \"approval_required\" &&\n    typeof result.approvalKey === \"string\" &&\n    result.approvalKey.length > 0 &&\n    result.approvalKey.length <= MAX_APPROVAL_KEY_CHARS\n      ? { approvalKey: result.approvalKey }\n      : {}),\n  };\n}\n\nfunction createToolHandler(\n  allowedToolNames: ReadonlySet<string>,\n  options: MountRealtimeVoiceRoutesOptions,\n) {\n  return defineEventHandler(async (event: H3Event) => {\n    if (getMethod(event) !== \"POST\") return invalidMethod(event);\n    setResponseHeader(event, \"Cache-Control\", \"no-store\");\n\n    const auth = await authenticateVoiceRequest(event, options);\n    if (!auth) {\n      setResponseStatus(event, 401);\n      return { error: \"Authentication required\" };\n    }\n\n    const contentType = readSafeHeader(event, \"content-type\")?.toLowerCase();\n    if (!contentType?.includes(\"application/json\")) {\n      setResponseStatus(event, 415);\n      return { error: \"Expected Content-Type: application/json\" };\n    }\n\n    const raw = await readLimitedRawBody(\n      event,\n      REALTIME_VOICE_MAX_TOOL_BODY_BYTES,\n    );\n    if (raw === \"oversize\") {\n      setResponseStatus(event, 413);\n      return {\n        error: `Tool request is too large (max ${REALTIME_VOICE_MAX_TOOL_BODY_BYTES} bytes)`,\n      };\n    }\n\n    let parsedBody: unknown;\n    try {\n      parsedBody = JSON.parse(raw ?? \"\");\n    } catch {\n      setResponseStatus(event, 400);\n      return { error: \"Invalid realtime tool request\" };\n    }\n    const request = parseToolRequest(parsedBody);\n    if (!request) {\n      setResponseStatus(event, 400);\n      return { error: \"Invalid realtime tool request\" };\n    }\n    if (!allowedToolNames.has(request.name)) {\n      setResponseStatus(event, 404);\n      return { error: \"Unknown realtime voice tool\" };\n    }\n\n    const browserTabId = request.browserTabId ?? auth.browserTabId;\n    const threadId = request.sessionId\n      ? `realtime:${request.sessionId}`\n      : `realtime:${request.callId}`;\n    return runWithRequestContext(\n      {\n        userEmail: auth.userEmail,\n        orgId: auth.orgId,\n        timezone: auth.timezone,\n        run: {\n          threadId,\n          ...(browserTabId ? { browserTabId } : {}),\n        },\n      },\n      async () => {\n        try {\n          const result = normalizeExecutionResult(\n            await options.executeTool({\n              event,\n              userEmail: auth.userEmail,\n              orgId: auth.orgId,\n              ...request,\n            }),\n          );\n          return { callId: request.callId, ...result };\n        } catch (error) {\n          setResponseStatus(event, 500);\n          return {\n            callId: request.callId,\n            status: \"failed\" as const,\n            output: truncate(\n              sanitizeToolErrorValue(error) || \"Tool execution failed\",\n              REALTIME_VOICE_MAX_TOOL_OUTPUT_CHARS,\n            ),\n          };\n        }\n      },\n    );\n  });\n}\n\n/** Mount the authenticated OpenAI Realtime WebRTC and tool bridge routes. */\nexport function mountRealtimeVoiceRoutes(\n  nitroApp: any,\n  actions: Record<string, ActionEntry>,\n  options: MountRealtimeVoiceRoutesOptions,\n): { sessionPath: string; toolPath: string } {\n  if (typeof options?.executeTool !== \"function\") {\n    throw new Error(\"mountRealtimeVoiceRoutes requires executeTool\");\n  }\n\n  const tools = buildRealtimeTools(actions);\n  const allowedToolNames = new Set(tools.map((tool) => tool.name));\n  const app = getH3App(nitroApp);\n  app.use(REALTIME_VOICE_SESSION_PATH, createSessionHandler(tools, options));\n  app.use(\n    REALTIME_VOICE_TOOL_PATH,\n    createToolHandler(allowedToolNames, options),\n  );\n  return {\n    sessionPath: REALTIME_VOICE_SESSION_PATH,\n    toolPath: REALTIME_VOICE_TOOL_PATH,\n  };\n}\n"]}

package/dist/server/transcribe-voice.d.ts

@@ -20,7 +20,7 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;
 //# sourceMappingURL=transcribe-voice.d.ts.map

package/dist/shared/reasoning-effort.d.ts

@@ -1,9 +1,29 @@
 export declare const REASONING_EFFORTS: readonly ["auto", "none", "minimal", "low", "medium", "high", "xhigh", "max"];
 export type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+/**
+ * Shared chat always chooses an explicit reasoning tier. Keep `auto` in the
+ * accepted type only so older persisted selections and external callers can
+ * migrate cleanly; new UI and engine defaults resolve it to Medium.
+ */
+export declare const DEFAULT_REASONING_EFFORT: ReasoningEffort;
 export declare const REASONING_EFFORT_LABELS: Record<ReasoningEffort, string>;
 export declare function isReasoningEffort(value: unknown): value is ReasoningEffort;
 export declare function getReasoningEffortOptionsForModel(model: string | undefined): ReasoningEffort[];
 export declare function normalizeReasoningEffortForModel(model: string | undefined, effort: ReasoningEffort | undefined): ReasoningEffort | undefined;
+/**
+ * Normalize a chat request before it reaches an engine. Explicit off/minimal
+ * sentinels must survive this layer so the engine can distinguish them from a
+ * missing selection, which now means the Medium default.
+ */
+export declare function normalizeReasoningEffortForRequest(model: string | undefined, effort: ReasoningEffort | undefined): ReasoningEffort | undefined;
 export declare function reasoningEffortLabel(effort: ReasoningEffort | undefined): string;
+/**
+ * Resolve a user-facing selection for a model. Legacy `auto`, missing values,
+ * and tiers unsupported by the newly selected model all become Medium.
+ * Non-reasoning models still retain Medium in persisted chat state so moving
+ * back to a reasoning model has a predictable default; their engines omit the
+ * effort through `normalizeReasoningEffortForModel`.
+ */
+export declare function resolveReasoningEffortSelection(model: string | undefined, effort: ReasoningEffort | undefined): ReasoningEffort;
 export declare function stepDownReasoningEffort(effort: ReasoningEffort | undefined): ReasoningEffort | undefined;
 //# sourceMappingURL=reasoning-effort.d.ts.map

package/dist/shared/reasoning-effort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning-effort.d.ts","sourceRoot":"","sources":["../../src/shared/reasoning-effort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAC5B,MAAM,EACN,MAAM,EACN,SAAS,EACT,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,CACG,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CASnE,CAAC;AA2BF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,eAAe,EAAE,CAcnB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,GAAG,SAAS,CAoB7B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,UAEvE;AAkBD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,GAAG,SAAS,CAG7B"}
+{"version":3,"file":"reasoning-effort.d.ts","sourceRoot":"","sources":["../../src/shared/reasoning-effort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAC5B,MAAM,EACN,MAAM,EACN,SAAS,EACT,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,CACG,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA0B,CAAC;AAElE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CASnE,CAAC;AAsBF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,eAAe,EAAE,CAcnB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,GAAG,SAAS,CAmB7B;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,GAAG,SAAS,CAG7B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,UAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,CAOjB;AAkBD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,eAAe,GAAG,SAAS,CAG7B"}

package/dist/shared/reasoning-effort.js

@@ -8,6 +8,12 @@ export const REASONING_EFFORTS = [
     "xhigh",
     "max",
 ];
+/**
+ * Shared chat always chooses an explicit reasoning tier. Keep `auto` in the
+ * accepted type only so older persisted selections and external callers can
+ * migrate cleanly; new UI and engine defaults resolve it to Medium.
+ */
+export const DEFAULT_REASONING_EFFORT = "medium";
 export const REASONING_EFFORT_LABELS = {
     auto: "Auto",
     none: "None",
@@ -18,12 +24,7 @@ export const REASONING_EFFORT_LABELS = {
     xhigh: "Extra High",
     max: "Max",
 };
-const VISIBLE_STANDARD_EFFORTS = [
-    "auto",
-    "low",
-    "medium",
-    "high",
-];
+const VISIBLE_STANDARD_EFFORTS = ["low", "medium", "high"];
 const VISIBLE_GPT_EFFORTS = [
     ...VISIBLE_STANDARD_EFFORTS,
     "xhigh",
@@ -58,10 +59,9 @@ export function getReasoningEffortOptionsForModel(model) {
     return [];
 }
 export function normalizeReasoningEffortForModel(model, effort) {
-    if (!model || !effort || effort === "auto") {
+    if (!model)
         return undefined;
-    }
-    let normalized = effort;
+    let normalized = !effort || effort === "auto" ? DEFAULT_REASONING_EFFORT : effort;
     if (normalized === "xhigh" &&
         isClaudeReasoningModel(model) &&
         !supportsClaudeXHigh(model)) {
@@ -76,12 +76,36 @@ export function normalizeReasoningEffortForModel(model, effort) {
     }
     return normalized;
 }
+/**
+ * Normalize a chat request before it reaches an engine. Explicit off/minimal
+ * sentinels must survive this layer so the engine can distinguish them from a
+ * missing selection, which now means the Medium default.
+ */
+export function normalizeReasoningEffortForRequest(model, effort) {
+    if (effort === "none" || effort === "minimal")
+        return effort;
+    return normalizeReasoningEffortForModel(model, effort);
+}
 export function reasoningEffortLabel(effort) {
-    return REASONING_EFFORT_LABELS[effort ?? "auto"];
+    return REASONING_EFFORT_LABELS[!effort || effort === "auto" ? DEFAULT_REASONING_EFFORT : effort];
+}
+/**
+ * Resolve a user-facing selection for a model. Legacy `auto`, missing values,
+ * and tiers unsupported by the newly selected model all become Medium.
+ * Non-reasoning models still retain Medium in persisted chat state so moving
+ * back to a reasoning model has a predictable default; their engines omit the
+ * effort through `normalizeReasoningEffortForModel`.
+ */
+export function resolveReasoningEffortSelection(model, effort) {
+    const requested = !effort || effort === "auto" ? DEFAULT_REASONING_EFFORT : effort;
+    const options = getReasoningEffortOptionsForModel(model);
+    return options.length === 0 || options.includes(requested)
+        ? requested
+        : DEFAULT_REASONING_EFFORT;
 }
 /**
- * One tier down from each effort, stopping at "minimal" — "none"/"auto"
- * (not really "tiers") and "minimal" itself are left unchanged. Used by the
+ * One tier down from each effort, stopping at "minimal" — legacy `auto`,
+ * "none", and "minimal" itself are left unchanged. Used by the
  * empty-final-response retry so a retried turn asks for meaningfully less
  * reasoning instead of repeating the exact request that came back empty.
  */
@@ -98,30 +122,40 @@ export function stepDownReasoningEffort(effort) {
     return REASONING_EFFORT_STEP_DOWN[effort] ?? effort;
 }
 function isGPTReasoningModel(model) {
-    return /^gpt-5/.test(model) || /^o\d/.test(model);
+    const id = model.toLowerCase().replace(/^openai\//, "");
+    return /^gpt-5/.test(id) || /^o\d/.test(id);
 }
 function isClaudeReasoningModel(model) {
-    return /^claude-/.test(model);
+    const id = model.toLowerCase().replace(/^anthropic\//, "");
+    if (id.includes("fable-5") || id.includes("mythos-5"))
+        return true;
+    if (id.includes("sonnet-5") || id.includes("sonnet-4-6"))
+        return true;
+    if (id.includes("haiku-4-5"))
+        return true;
+    const opusMatch = id.match(/opus-4[-.](\d+)/);
+    return opusMatch ? parseInt(opusMatch[1], 10) >= 6 : false;
 }
 function supportsClaudeXHigh(model) {
+    const id = model.toLowerCase().replace(/^anthropic\//, "");
     // Models that support the xhigh effort tier (built-in extended thinking via
     // output_config.effort). Keep this version-aware so any future Claude model
     // with a higher patch/minor number is automatically included rather than
     // silently falling back to the lower "high" tier.
     // claude-fable-5 is a Mythos-class model and also supports xhigh.
-    if (model.includes("fable-5"))
+    if (id.includes("fable-5"))
         return true;
     // Sonnet 5 supports the expanded effort ladder through Builder/Anthropic.
-    if (model.includes("sonnet-5"))
+    if (id.includes("sonnet-5"))
         return true;
     // opus-4-7 introduced xhigh; all opus-4.x successors (4-8, 4-9…) should too.
-    const opusMatch = model.match(/opus-4-(\d+)/);
+    const opusMatch = id.match(/opus-4[-.](\d+)/);
     if (opusMatch) {
         return parseInt(opusMatch[1], 10) >= 7;
     }
     return false;
 }
 function isGeminiReasoningModel(model) {
-    return /^gemini-/.test(model);
+    return /^gemini-/.test(model.toLowerCase().replace(/^google\//, ""));
 }
 //# sourceMappingURL=reasoning-effort.js.map

package/dist/shared/reasoning-effort.js.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning-effort.js","sourceRoot":"","sources":["../../src/shared/reasoning-effort.ts"],"names":[],"mappings":"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","sourcesContent":["export const REASONING_EFFORTS = [\n  \"auto\",\n  \"none\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] as const;\n\nexport type ReasoningEffort = (typeof REASONING_EFFORTS)[number];\n\nexport const REASONING_EFFORT_LABELS: Record<ReasoningEffort, string> = {\n  auto: \"Auto\",\n  none: \"None\",\n  minimal: \"Minimal\",\n  low: \"Low\",\n  medium: \"Medium\",\n  high: \"High\",\n  xhigh: \"Extra High\",\n  max: \"Max\",\n};\n\nconst VISIBLE_STANDARD_EFFORTS: ReasoningEffort[] = [\n  \"auto\",\n  \"low\",\n  \"medium\",\n  \"high\",\n];\n\nconst VISIBLE_GPT_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"xhigh\",\n];\n\nconst VISIBLE_CLAUDE_BUILT_IN_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"xhigh\",\n  \"max\",\n];\n\nconst VISIBLE_CLAUDE_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"max\",\n];\n\nconst effortSet = new Set<string>(REASONING_EFFORTS);\n\nexport function isReasoningEffort(value: unknown): value is ReasoningEffort {\n  return typeof value === \"string\" && effortSet.has(value);\n}\n\nexport function getReasoningEffortOptionsForModel(\n  model: string | undefined,\n): ReasoningEffort[] {\n  if (!model) return [];\n  if (isGPTReasoningModel(model)) {\n    return VISIBLE_GPT_EFFORTS;\n  }\n  if (isClaudeReasoningModel(model)) {\n    return supportsClaudeXHigh(model)\n      ? VISIBLE_CLAUDE_BUILT_IN_EFFORTS\n      : VISIBLE_CLAUDE_EFFORTS;\n  }\n  if (isGeminiReasoningModel(model)) {\n    return VISIBLE_STANDARD_EFFORTS;\n  }\n  return [];\n}\n\nexport function normalizeReasoningEffortForModel(\n  model: string | undefined,\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort | undefined {\n  if (!model || !effort || effort === \"auto\") {\n    return undefined;\n  }\n  let normalized = effort;\n  if (\n    normalized === \"xhigh\" &&\n    isClaudeReasoningModel(model) &&\n    !supportsClaudeXHigh(model)\n  ) {\n    normalized = \"high\";\n  }\n  if (normalized === \"max\" && isGPTReasoningModel(model)) {\n    normalized = \"xhigh\";\n  }\n  const options = getReasoningEffortOptionsForModel(model);\n  if (!options.length || !options.includes(normalized)) {\n    return undefined;\n  }\n  return normalized;\n}\n\nexport function reasoningEffortLabel(effort: ReasoningEffort | undefined) {\n  return REASONING_EFFORT_LABELS[effort ?? \"auto\"];\n}\n\n/**\n * One tier down from each effort, stopping at \"minimal\" — \"none\"/\"auto\"\n * (not really \"tiers\") and \"minimal\" itself are left unchanged. Used by the\n * empty-final-response retry so a retried turn asks for meaningfully less\n * reasoning instead of repeating the exact request that came back empty.\n */\nconst REASONING_EFFORT_STEP_DOWN: Partial<\n  Record<ReasoningEffort, ReasoningEffort>\n> = {\n  max: \"xhigh\",\n  xhigh: \"high\",\n  high: \"medium\",\n  medium: \"low\",\n  low: \"minimal\",\n};\n\nexport function stepDownReasoningEffort(\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort | undefined {\n  if (!effort) return effort;\n  return REASONING_EFFORT_STEP_DOWN[effort] ?? effort;\n}\n\nfunction isGPTReasoningModel(model: string) {\n  return /^gpt-5/.test(model) || /^o\\d/.test(model);\n}\n\nfunction isClaudeReasoningModel(model: string) {\n  return /^claude-/.test(model);\n}\n\nfunction supportsClaudeXHigh(model: string) {\n  // Models that support the xhigh effort tier (built-in extended thinking via\n  // output_config.effort). Keep this version-aware so any future Claude model\n  // with a higher patch/minor number is automatically included rather than\n  // silently falling back to the lower \"high\" tier.\n  // claude-fable-5 is a Mythos-class model and also supports xhigh.\n  if (model.includes(\"fable-5\")) return true;\n  // Sonnet 5 supports the expanded effort ladder through Builder/Anthropic.\n  if (model.includes(\"sonnet-5\")) return true;\n  // opus-4-7 introduced xhigh; all opus-4.x successors (4-8, 4-9…) should too.\n  const opusMatch = model.match(/opus-4-(\\d+)/);\n  if (opusMatch) {\n    return parseInt(opusMatch[1], 10) >= 7;\n  }\n  return false;\n}\n\nfunction isGeminiReasoningModel(model: string) {\n  return /^gemini-/.test(model);\n}\n"]}
+{"version":3,"file":"reasoning-effort.js","sourceRoot":"","sources":["../../src/shared/reasoning-effort.ts"],"names":[],"mappings":"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","sourcesContent":["export const REASONING_EFFORTS = [\n  \"auto\",\n  \"none\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] as const;\n\nexport type ReasoningEffort = (typeof REASONING_EFFORTS)[number];\n\n/**\n * Shared chat always chooses an explicit reasoning tier. Keep `auto` in the\n * accepted type only so older persisted selections and external callers can\n * migrate cleanly; new UI and engine defaults resolve it to Medium.\n */\nexport const DEFAULT_REASONING_EFFORT: ReasoningEffort = \"medium\";\n\nexport const REASONING_EFFORT_LABELS: Record<ReasoningEffort, string> = {\n  auto: \"Auto\",\n  none: \"None\",\n  minimal: \"Minimal\",\n  low: \"Low\",\n  medium: \"Medium\",\n  high: \"High\",\n  xhigh: \"Extra High\",\n  max: \"Max\",\n};\n\nconst VISIBLE_STANDARD_EFFORTS: ReasoningEffort[] = [\"low\", \"medium\", \"high\"];\n\nconst VISIBLE_GPT_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"xhigh\",\n];\n\nconst VISIBLE_CLAUDE_BUILT_IN_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"xhigh\",\n  \"max\",\n];\n\nconst VISIBLE_CLAUDE_EFFORTS: ReasoningEffort[] = [\n  ...VISIBLE_STANDARD_EFFORTS,\n  \"max\",\n];\n\nconst effortSet = new Set<string>(REASONING_EFFORTS);\n\nexport function isReasoningEffort(value: unknown): value is ReasoningEffort {\n  return typeof value === \"string\" && effortSet.has(value);\n}\n\nexport function getReasoningEffortOptionsForModel(\n  model: string | undefined,\n): ReasoningEffort[] {\n  if (!model) return [];\n  if (isGPTReasoningModel(model)) {\n    return VISIBLE_GPT_EFFORTS;\n  }\n  if (isClaudeReasoningModel(model)) {\n    return supportsClaudeXHigh(model)\n      ? VISIBLE_CLAUDE_BUILT_IN_EFFORTS\n      : VISIBLE_CLAUDE_EFFORTS;\n  }\n  if (isGeminiReasoningModel(model)) {\n    return VISIBLE_STANDARD_EFFORTS;\n  }\n  return [];\n}\n\nexport function normalizeReasoningEffortForModel(\n  model: string | undefined,\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort | undefined {\n  if (!model) return undefined;\n  let normalized =\n    !effort || effort === \"auto\" ? DEFAULT_REASONING_EFFORT : effort;\n  if (\n    normalized === \"xhigh\" &&\n    isClaudeReasoningModel(model) &&\n    !supportsClaudeXHigh(model)\n  ) {\n    normalized = \"high\";\n  }\n  if (normalized === \"max\" && isGPTReasoningModel(model)) {\n    normalized = \"xhigh\";\n  }\n  const options = getReasoningEffortOptionsForModel(model);\n  if (!options.length || !options.includes(normalized)) {\n    return undefined;\n  }\n  return normalized;\n}\n\n/**\n * Normalize a chat request before it reaches an engine. Explicit off/minimal\n * sentinels must survive this layer so the engine can distinguish them from a\n * missing selection, which now means the Medium default.\n */\nexport function normalizeReasoningEffortForRequest(\n  model: string | undefined,\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort | undefined {\n  if (effort === \"none\" || effort === \"minimal\") return effort;\n  return normalizeReasoningEffortForModel(model, effort);\n}\n\nexport function reasoningEffortLabel(effort: ReasoningEffort | undefined) {\n  return REASONING_EFFORT_LABELS[\n    !effort || effort === \"auto\" ? DEFAULT_REASONING_EFFORT : effort\n  ];\n}\n\n/**\n * Resolve a user-facing selection for a model. Legacy `auto`, missing values,\n * and tiers unsupported by the newly selected model all become Medium.\n * Non-reasoning models still retain Medium in persisted chat state so moving\n * back to a reasoning model has a predictable default; their engines omit the\n * effort through `normalizeReasoningEffortForModel`.\n */\nexport function resolveReasoningEffortSelection(\n  model: string | undefined,\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort {\n  const requested =\n    !effort || effort === \"auto\" ? DEFAULT_REASONING_EFFORT : effort;\n  const options = getReasoningEffortOptionsForModel(model);\n  return options.length === 0 || options.includes(requested)\n    ? requested\n    : DEFAULT_REASONING_EFFORT;\n}\n\n/**\n * One tier down from each effort, stopping at \"minimal\" — legacy `auto`,\n * \"none\", and \"minimal\" itself are left unchanged. Used by the\n * empty-final-response retry so a retried turn asks for meaningfully less\n * reasoning instead of repeating the exact request that came back empty.\n */\nconst REASONING_EFFORT_STEP_DOWN: Partial<\n  Record<ReasoningEffort, ReasoningEffort>\n> = {\n  max: \"xhigh\",\n  xhigh: \"high\",\n  high: \"medium\",\n  medium: \"low\",\n  low: \"minimal\",\n};\n\nexport function stepDownReasoningEffort(\n  effort: ReasoningEffort | undefined,\n): ReasoningEffort | undefined {\n  if (!effort) return effort;\n  return REASONING_EFFORT_STEP_DOWN[effort] ?? effort;\n}\n\nfunction isGPTReasoningModel(model: string) {\n  const id = model.toLowerCase().replace(/^openai\\//, \"\");\n  return /^gpt-5/.test(id) || /^o\\d/.test(id);\n}\n\nfunction isClaudeReasoningModel(model: string) {\n  const id = model.toLowerCase().replace(/^anthropic\\//, \"\");\n  if (id.includes(\"fable-5\") || id.includes(\"mythos-5\")) return true;\n  if (id.includes(\"sonnet-5\") || id.includes(\"sonnet-4-6\")) return true;\n  if (id.includes(\"haiku-4-5\")) return true;\n  const opusMatch = id.match(/opus-4[-.](\\d+)/);\n  return opusMatch ? parseInt(opusMatch[1], 10) >= 6 : false;\n}\n\nfunction supportsClaudeXHigh(model: string) {\n  const id = model.toLowerCase().replace(/^anthropic\\//, \"\");\n  // Models that support the xhigh effort tier (built-in extended thinking via\n  // output_config.effort). Keep this version-aware so any future Claude model\n  // with a higher patch/minor number is automatically included rather than\n  // silently falling back to the lower \"high\" tier.\n  // claude-fable-5 is a Mythos-class model and also supports xhigh.\n  if (id.includes(\"fable-5\")) return true;\n  // Sonnet 5 supports the expanded effort ladder through Builder/Anthropic.\n  if (id.includes(\"sonnet-5\")) return true;\n  // opus-4-7 introduced xhigh; all opus-4.x successors (4-8, 4-9…) should too.\n  const opusMatch = id.match(/opus-4[-.](\\d+)/);\n  if (opusMatch) {\n    return parseInt(opusMatch[1], 10) >= 7;\n  }\n  return false;\n}\n\nfunction isGeminiReasoningModel(model: string) {\n  return /^gemini-/.test(model.toLowerCase().replace(/^google\\//, \"\"));\n}\n"]}

package/dist/styles/agent-conversation.css

@@ -476,6 +476,23 @@
   }
 }
 
+/* ─── ReasoningCell streaming tail clamp ────────────────────────────────────── */
+/* While a reasoning cell is actively streaming and open, clamp the body to
+   roughly the last ~6 lines instead of letting it grow and push the rest of
+   the transcript around (the Claude Code "tail view" behavior). The reversed
+   column anchors the box to its bottom edge, so overflow is clipped off the
+   top while the newest lines stay pinned in view — pure CSS, no scroll/rAF
+   tracking needed. A soft fade masks the clipped edge in both themes since
+   it only touches alpha, not color. */
+.reasoning-cell-tail {
+  display: flex;
+  flex-direction: column-reverse;
+  overflow: hidden;
+  max-height: 8rem;
+  mask-image: linear-gradient(to bottom, transparent, black 1.5rem);
+  -webkit-mask-image: linear-gradient(to bottom, transparent, black 1.5rem);
+}
+
 /* ─── Agent-Markdown (AssistantChat react-markdown render surface) ─────────── */
 /* These classes are applied by the SmoothMarkdownText/MarkdownText components  */
 /* in the AssistantChat/AssistantChatInner tree. The shiki dual-theme rules      */

package/dist/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md

@@ -13,17 +13,21 @@ metadata:
 
 # Voice Transcription
 
-Click-to-toggle microphone inside the sidebar composer turns speech into
-text. Users configure live transcription separately from AI cleanup in
-Settings → Voice Transcription. The feature is available in every template
-that renders `TiptapComposer`.
+The microphone inside the sidebar composer offers two distinct paths:
+editable dictation and an opt-in realtime speech-to-speech agent session.
+Users configure dictation separately from AI cleanup in Settings → Voice
+Transcription. Both paths are available in every template that renders the
+shared agent sidebar.
 
 ## UX rules
 
 - **Always show the mic alongside the send button.** Cursor replaces send
   with mic when the composer is empty; their users complain. We keep both
   visible — Lovable does the same.
-- **Click-to-toggle, not push-to-talk.** More forgiving in a sidebar, avoids
+- **Ask before switching modes.** The mic opens a shadcn popover offering
+  **Start voice mode** and **Keep dictating**; never silently replace the
+  established dictation behavior.
+- **Dictation is click-to-toggle, not push-to-talk.** More forgiving in a sidebar, avoids
   host-app hotkey clashes. Keyboard shortcut is `Cmd/Ctrl+Shift+M` and
   `Escape` cancels mid-recording.
 - **Transcript lands in the composer, editable, never auto-sent.** Insert at
@@ -34,6 +38,31 @@ that renders `TiptapComposer`.
   Never use a sparkle or robot icon.
 - **Errors via inline alert or toast, never `window.alert`.**
 
+## Realtime speech mode
+
+Realtime speech mode is a full-duplex OpenAI Realtime WebRTC session, separate
+from the dictation providers below. It requires the authenticated user's
+`OPENAI_API_KEY`, uses the server-owned `gpt-realtime-2.1` session
+configuration, and keeps the key out of browser code.
+
+- Starting voice mode collapses the chat into a persistent bottom-end speech
+  orb. Clicking the orb shows or hides chat without ending the session; ending
+  the session is a separate, explicit control.
+- Semantic VAD keeps listening, starts responses automatically, and supports
+  barge-in while the agent is speaking.
+- Function calls must cross the authenticated realtime tool bridge and enter
+  `executeAgentToolCall`. Never call `ActionEntry.run` directly: that bypasses
+  schema validation, approvals, audit/journal behavior, timeouts, redaction,
+  and mutation refreshes.
+- Preserve the active browser-tab id in request context so `set-url`,
+  `set-search-params`, `view-screen`, and tab-scoped application state affect
+  the app the user is actually speaking to.
+- Do not persist audio. Store only compact lifecycle and latest-transcript
+  context at `application_state["realtime-voice-session"]`; delete it when the
+  session ends.
+- Missing-key failures should open Settings focused on the user-scoped
+  `OPENAI_API_KEY` field. Never send, log, or echo the key to the browser.
+
 ## Source And Cleanup
 
 Settings must keep these as separate choices:
@@ -80,11 +109,14 @@ Default behavior:
 | --------------------------------------------------------------------- | --------------------------------------------------- |
 | `packages/core/src/client/composer/useVoiceDictation.ts`              | Provider-routing hook (MediaRecorder / Web Speech)  |
 | `packages/core/src/client/composer/VoiceButton.tsx`                   | Mic button + live amplitude + cancel overlay        |
+| `packages/core/src/client/composer/RealtimeVoiceMode.tsx`            | Opt-in popover + persistent speech orb              |
+| `packages/core/src/client/composer/useRealtimeVoiceMode.tsx`         | WebRTC lifecycle, provider events, and tool bridge  |
 | `packages/core/src/client/composer/TiptapComposer.tsx`                | Wires the hook, insertion, and keyboard shortcut    |
 | `packages/core/src/client/settings/VoiceTranscriptionSection.tsx`     | Live source + cleanup controls in sidebar settings  |
 | `packages/core/src/client/transcription/BuilderTranscriptionCta.tsx`  | CTA shown when Builder account isn't connected      |
 | `packages/core/src/client/transcription/use-live-transcription.ts`    | Web Speech live-transcription hook for recordings   |
 | `packages/core/src/server/transcribe-voice.ts`                        | Route handler (routes to Builder/Gemini/Groq/Whisper) |
+| `packages/core/src/server/realtime-voice.ts`                          | Authenticated OpenAI SDP and action-tool routes     |
 | `packages/core/src/transcription/builder-transcription.ts`            | Builder proxy transcription client                  |
 | `packages/core/src/voice/`                                            | Shared voice context pack, prompt, and replacement helpers |
 | `packages/core/src/secrets/register-framework-secrets.ts`             | Framework-level provider key registration           |
@@ -139,4 +171,6 @@ Templates can:
 - Don't call transcription providers from the client — go through `/_agent-native/transcribe-voice` so the user's secret stays server-side.
 - Don't remove the cancel affordance — mic permission abuse paranoia is real.
 - Don't auto-submit the transcript — users always edit before sending.
+- Don't route realtime tool calls around the central guarded agent executor.
+- Don't persist realtime audio or put provider keys in SDP/session payloads.
 - Don't copy Cursor's "hide send when empty" pattern — it confuses users.

package/docs/content/a2a-protocol.mdx

@@ -5,7 +5,13 @@ description: "Agent-to-agent communication via JSON-RPC: discovery, messaging, s
 
 # A2A Protocol
 
-Agent-to-agent communication over HTTP. Agents discover each other, send messages, and receive structured results.
+A2A lets agents talk to each other directly over HTTP: they discover each other's capabilities, send messages, and get back structured results — no shared database or hand-wired API needed.
+
+<Callout tone="info">
+
+**A2A vs MCP.** A2A is for **agent-to-agent** delegation — one agent-native app's agent handing work to another app's agent, which reasons over it with its own LLM loop. [MCP](/docs/mcp-protocol) is for **tool-to-agent** access — an external host like Claude or Cursor calling your app's actions directly as tools, with no extra agent reasoning in between. Use A2A when the receiving side should think; use MCP when it should just execute. See [MCP Server — MCP vs A2A](/docs/mcp-protocol#mcp-vs-a2a) for the full comparison table.
+
+</Callout>
 
 ## Overview {#overview}
 
@@ -159,7 +165,7 @@ All methods are called via `POST /_agent-native/a2a` with JSON-RPC 2.0 format:
 | `tasks/get`      | Fetch a task by ID — used to poll an async task to completion                                                         | `id`                          |
 | `tasks/cancel`   | Cancel a running task                                                                                                 | `id`                          |
 
-<Endpoint id="doc-block-a6g596" title="Primary A2A endpoint" summary="All JSON-RPC methods are POSTed here. message/send shown." method="POST" path="/_agent-native/a2a" summary="Send a message and wait for the completed task" auth="JWT bearer signed with A2A_SECRET (or legacy apiKeyEnv static token)" params={[
+<Endpoint id="doc-block-a6g596" title="Primary A2A endpoint" summary="All JSON-RPC methods are POSTed here. message/send shown." method="POST" path="/_agent-native/a2a" auth="JWT bearer signed with A2A_SECRET (or legacy apiKeyEnv static token)" params={[
   {
     "name": "Authorization",
     "in": "header",
@@ -272,9 +278,11 @@ When `message/send` is called with `async: true`, the JSON-RPC handler enqueues
 
 </Diagram>
 
-> [!IMPORTANT]
-> **Serverless Webhook & Gateway Timeouts:**
-> Hosted environment gateways (such as Netlify, Vercel, or Cloudflare Pages) impose strict execution limits (often 10 to 30 seconds) on public-facing HTTP routes. Because agent loops can take significant time to run queries, fetch context, and execute tools, you **must use `async: true`** when calling A2A endpoints or handling external webhooks. This immediately returns a `working` status to the API gateway, keeping the connection open only for a few milliseconds, while the self-fired `/process-task` POST executes the agent loop in the background. Do not block the primary HTTP request waiting for the agent loop to finish.
+<Callout tone="warning">
+
+**Serverless webhook and gateway timeouts.** Hosted environment gateways (such as Netlify, Vercel, or Cloudflare Pages) impose strict execution limits (often 10 to 30 seconds) on public-facing HTTP routes. Because agent loops can take significant time to run queries, fetch context, and execute tools, you **must use `async: true`** when calling A2A endpoints or handling external webhooks. This immediately returns a `working` status to the API gateway, keeping the connection open only for a few milliseconds, while the self-fired `/process-task` POST executes the agent loop in the background. Do not block the primary HTTP request waiting for the agent loop to finish.
+
+</Callout>
 
 Messages contain typed parts — text, structured data, and files can all travel in one message:
 
@@ -534,3 +542,11 @@ export default defineAction({
 ```
 
 The analytics agent receives the message, runs the query via its handler, and returns the result. The mail action gets the text response back. No shared database, no direct API calls — just agent-to-agent communication.
+
+## What's next {#whats-next}
+
+- [**MCP Server**](/docs/mcp-protocol#mcp-vs-a2a) — the sibling protocol for external tools calling your app directly
+- [**Dispatch**](/docs/dispatch) — the app that routes inbound messages to the right A2A peer
+- [**Messaging**](/docs/messaging) — reaching agents from Slack, email, Telegram, and WhatsApp
+- [**Agent Mentions**](/docs/agent-mentions) — `@`-mentioning a connected agent in chat, which calls A2A under the hood
+- [**Multi-App Workspaces**](/docs/multi-app-workspace) — same-origin workspace A2A with auto-signed credentials

package/docs/content/actions.mdx

@@ -11,7 +11,7 @@ Actions are the single source of truth for anything your app does. Define an act
 - **Typesafe React hooks** — `useActionQuery("name")` and `useActionMutation("name")` on the frontend, types inferred from the schema.
 - **Imperative client calls** — `callAction("name", params)` when a hook does not fit.
 - **Framework transport** — auto-mounted by the framework behind those hooks and available to external HTTP clients.
-- **An MCP tool** — exposed to Claude, ChatGPT custom MCP apps, Claude Desktop/Code, Cursor, Codex, and any other MCP client.
+- **An MCP tool** — exposed to Claude, ChatGPT custom MCP apps, Claude Desktop/Code, Cursor, Codex, and any other MCP host.
 - **An A2A tool** — called by other agent-native apps over A2A.
 - **A CLI command** — `pnpm action <name>` for scripting and dev loops.
 
@@ -146,23 +146,23 @@ around actions, not a required prerequisite for the action itself.
   filename="actions/reply-to-email.ts"
   language="ts"
   code={
-    'import { defineAction } from "@agent-native/core/action";\nimport { z } from "zod";\n\nexport default defineAction({\n  description: "Reply to an email thread in the user\'s voice.",\n  schema: z.object({\n    emailId: z.string().describe("The id of the email to reply to."),\n    body: z.string().describe("The reply body, in markdown."),\n  }),\n  run: async ({ emailId, body }) => {\n    await db.insert(replies).values({ emailId, body });\n    return { ok: true, emailId };\n  },\n});'
+    'import { defineAction } from "@agent-native/core/action";\nimport { z } from "zod";\n\nimport { getDb, schema } from "../server/db/index.js";\n\nexport default defineAction({\n  description: "Reply to an email thread in the user\'s voice.",\n  schema: z.object({\n    emailId: z.string().describe("The id of the email to reply to."),\n    body: z.string().describe("The reply body, in markdown."),\n  }),\n  run: async ({ emailId, body }) => {\n    const db = getDb();\n    await db.insert(schema.replies).values({ emailId, body });\n    return { ok: true, emailId };\n  },\n});'
   }
   annotations={[
     {
-      lines: "5",
+      lines: "7",
       label: "Tool surface",
       note: "`description` is what the agent reads to decide when to call this. The per-field `.describe()` calls flow into the JSON Schema too.",
     },
     {
-      lines: "6-9",
+      lines: "8-11",
       label: "Typed contract",
       note: "One schema validates input from **every** surface and is converted to JSON Schema for the model. Invalid inputs never reach `run`.",
     },
     {
-      lines: "10-13",
+      lines: "12-16",
       label: "One implementation",
-      note: "The `run` body is the single source of truth — the UI button and the agent tool both execute exactly this.",
+      note: "The `run` body is the single source of truth — the UI button and the agent tool both execute exactly this. `getDb()` and `schema` come from your app's `server/db/index.ts` — see [Database](/docs/database).",
     },
   ]}
 />
@@ -392,23 +392,9 @@ For list and read actions, use `accessFilter` to scope the query to the current
 
 ### Human-in-the-loop approval {#needs-approval}
 
-A handful of actions are too consequential to let the agent run autonomously — sending an email, charging a card, deleting an account. For those, set `needsApproval` to pause the loop and require a human to approve the specific call before `run()` executes:
+A handful of actions are too consequential to let the agent run autonomously — sending an email, charging a card, deleting an account. Set `needsApproval: true` (or a predicate `(args, ctx) => boolean | Promise<boolean>`) on `defineAction` and the loop pauses before `run()`, requiring a human to approve that specific call. The default is **off**, and almost every action should stay that way.
 
-```ts
-export default defineAction({
-  description: "Send an email via Gmail.",
-  schema: z.object({ to: z.string(), subject: z.string(), body: z.string() }),
-  needsApproval: true, // pause; a human must approve this specific send
-  run: async (args) => {
-    /* ...actually send... */
-  },
-});
-```
-
-`needsApproval` also accepts a predicate `(args, ctx) => boolean | Promise<boolean>` to gate conditionally (e.g. only external recipients, only above a threshold); it **fails closed**, so a throw counts as "approval required". When the gate is truthy and unapproved, the loop stops the turn and the side effect never fires until a human approves in the chat UI.
-
-> [!WARNING]
-> Keep approvals rare. Each gated action is a hard stop in the agent loop. The default is **off**, and almost every action should leave it off. See [Human-in-the-Loop Approvals](/docs/human-approval) for the predicate API, the `approval_required` event, and the full flow.
+See [Human-in-the-Loop Approvals](/docs/human-approval) for the predicate API, the `approval_required` event, and the full end-to-end flow.
 
 ### Audit logging {#audit}
 
@@ -554,7 +540,7 @@ export default defineAction({
 });
 ```
 
-Keep `link` as the fallback for CLI and non-UI MCP clients; it is also the embed's launch target. The embed bridge — the signed embed-start session, transplant vs. controlled-frame rendering, the `ui/*` host bridge, CSP, and height clamping — is owned by [External Agents](/docs/external-agents#mcp-app-bridge).
+Keep `link` as the fallback for CLI and non-UI MCP hosts; it is also the embed's launch target. The embed bridge — the signed embed-start session, transplant vs. controlled-frame rendering, the `ui/*` host bridge, CSP, and height clamping — is owned by [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## Standard actions {#standard-actions}