@agent-native/core 0.79.27 → 0.80.0

package/dist/client/use-agent-engine-configured.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-engine-configured.js","sourceRoot":"","sources":["../../src/client/use-agent-engine-configured.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { PROVIDER_ENV_VARS } from \"../agent/engine/provider-env-vars.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nconst PROVIDER_ENV_VAR_SET = new Set(PROVIDER_ENV_VARS);\n\n/** `unknown` until the first check resolves, so callers don't flash the gate. */\nexport type AgentEngineConfiguredState = \"unknown\" | \"configured\" | \"missing\";\n\nexport interface UseAgentEngineConfiguredResult {\n  /** True once we know nothing can run the agent (no key / Builder / BYOK). */\n  missing: boolean;\n  state: AgentEngineConfiguredState;\n}\n\n/**\n * Shared \"can the agent run?\" gate — the single source of truth for the sidebar\n * composer and app prompt boxes. Checks the env-key / Builder / BYOK status\n * endpoints on mount, re-checks on `agent-engine:configured-changed`, and folds\n * in the adapter's `agent-chat:missing-api-key` signal. Pass `enabled = false`\n * to short-circuit to configured; flaky requests stay `unknown`.\n */\nexport function useAgentEngineConfigured(\n  enabled = true,\n): UseAgentEngineConfiguredResult {\n  const [state, setState] = useState<AgentEngineConfiguredState>(\"unknown\");\n\n  useEffect(() => {\n    let cancelled = false;\n    const check = async (options?: { missingFallback?: boolean }) => {\n      if (!enabled) {\n        setState(\"configured\");\n        return;\n      }\n      const [envKeys, builderStatus, engineStatus] = await Promise.all([\n        fetch(agentNativePath(\"/_agent-native/env-status\"))\n          .then((r) => (r.ok ? r.json() : null))\n          .catch(() => null),\n        fetch(agentNativePath(\"/_agent-native/builder/status\"))\n          .then((r) => (r.ok ? r.json() : null))\n          .catch(() => null),\n        fetch(agentNativePath(\"/_agent-native/agent-engine/status\"))\n          .then((r) => (r.ok ? r.json() : null))\n          .catch(() => null),\n      ]);\n      if (cancelled) return;\n      // All three failed — likely a flaky network; keep the current state.\n      if (envKeys == null && builderStatus == null && engineStatus == null) {\n        if (options?.missingFallback) setState(\"missing\");\n        return;\n      }\n      const keys = (envKeys ?? []) as Array<{\n        key: string;\n        configured: boolean;\n      }>;\n      const llmKeys = keys.filter((k) => PROVIDER_ENV_VAR_SET.has(k.key));\n      const anyConfigured =\n        llmKeys.some((k) => k.configured) ||\n        builderStatus?.configured === true ||\n        engineStatus?.configured === true;\n      setState(anyConfigured ? \"configured\" : \"missing\");\n    };\n    const onConfiguredChanged = () => {\n      void check();\n    };\n    const onMissing = () => {\n      if (!enabled) {\n        setState(\"configured\");\n        return;\n      }\n      void check({ missingFallback: true });\n    };\n\n    void check();\n    window.addEventListener(\n      \"agent-engine:configured-changed\",\n      onConfiguredChanged,\n    );\n    // A stale failed stream can arrive after a reconnect succeeds. Re-check the\n    // current status before pinning the composer in setup.\n    window.addEventListener(\"agent-chat:missing-api-key\", onMissing);\n    return () => {\n      cancelled = true;\n      window.removeEventListener(\n        \"agent-engine:configured-changed\",\n        onConfiguredChanged,\n      );\n      window.removeEventListener(\"agent-chat:missing-api-key\", onMissing);\n    };\n  }, [enabled]);\n\n  return { missing: state === \"missing\", state };\n}\n"]}
+{"version":3,"file":"use-agent-engine-configured.js","sourceRoot":"","sources":["../../src/client/use-agent-engine-configured.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { PROVIDER_ENV_VARS } from \"../agent/engine/provider-env-vars.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nconst PROVIDER_ENV_VAR_SET = new Set(PROVIDER_ENV_VARS);\n\n/** `unknown` until the first check resolves, so callers don't flash the gate. */\nexport type AgentEngineConfiguredState = \"unknown\" | \"configured\" | \"missing\";\n\nexport interface UseAgentEngineConfiguredResult {\n  /** True once we know nothing can run the agent (no key / Builder / BYOK). */\n  missing: boolean;\n  state: AgentEngineConfiguredState;\n}\n\nexport interface FetchAgentEngineConfiguredStateOptions {\n  missingFallback?: boolean;\n  timeoutMs?: number;\n}\n\nconst DEFAULT_STATUS_CHECK_TIMEOUT_MS = 2500;\n\nasync function fetchStatusJson(\n  path: string,\n  timeoutMs: number,\n): Promise<unknown | null> {\n  const controller =\n    typeof AbortController !== \"undefined\" ? new AbortController() : null;\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<null>((resolve) => {\n    timeoutId = setTimeout(() => {\n      controller?.abort();\n      resolve(null);\n    }, timeoutMs);\n  });\n\n  const request = fetch(\n    agentNativePath(path),\n    controller ? { signal: controller.signal } : undefined,\n  )\n    .then((r) => (r.ok ? r.json() : null))\n    .catch(() => null)\n    .finally(() => {\n      if (timeoutId !== undefined) clearTimeout(timeoutId);\n    });\n\n  return Promise.race([request, timeout]);\n}\n\nfunction hasConfiguredFlag(value: unknown): value is { configured: boolean } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"configured\" in value &&\n    typeof (value as { configured?: unknown }).configured === \"boolean\"\n  );\n}\n\nexport async function fetchAgentEngineConfiguredState(\n  enabled = true,\n  options?: FetchAgentEngineConfiguredStateOptions,\n): Promise<AgentEngineConfiguredState> {\n  if (!enabled) return \"configured\";\n\n  const timeoutMs =\n    typeof options?.timeoutMs === \"number\" && options.timeoutMs > 0\n      ? options.timeoutMs\n      : DEFAULT_STATUS_CHECK_TIMEOUT_MS;\n  const [envKeys, builderStatus, engineStatus] = await Promise.all([\n    fetchStatusJson(\"/_agent-native/env-status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/builder/status\", timeoutMs),\n    fetchStatusJson(\"/_agent-native/agent-engine/status\", timeoutMs),\n  ]);\n\n  // All three failed — likely a flaky network; keep the caller in unknown\n  // unless this check is reacting to an explicit missing-key stream event.\n  if (envKeys == null && builderStatus == null && engineStatus == null) {\n    return options?.missingFallback ? \"missing\" : \"unknown\";\n  }\n\n  const keys = (envKeys ?? []) as Array<{\n    key: string;\n    configured: boolean;\n  }>;\n  const llmKeys = keys.filter((k) => PROVIDER_ENV_VAR_SET.has(k.key));\n  const anyConfigured =\n    llmKeys.some((k) => k.configured) ||\n    (hasConfiguredFlag(builderStatus) && builderStatus.configured) ||\n    (hasConfiguredFlag(engineStatus) && engineStatus.configured);\n  return anyConfigured ? \"configured\" : \"missing\";\n}\n\n/**\n * Shared \"can the agent run?\" gate — the single source of truth for the sidebar\n * composer and app prompt boxes. Checks the env-key / Builder / BYOK status\n * endpoints on mount, re-checks on `agent-engine:configured-changed`, and folds\n * in the adapter's `agent-chat:missing-api-key` signal. Pass `enabled = false`\n * to short-circuit to configured; flaky requests stay `unknown`.\n */\nexport function useAgentEngineConfigured(\n  enabled = true,\n): UseAgentEngineConfiguredResult {\n  const [state, setState] = useState<AgentEngineConfiguredState>(\"unknown\");\n\n  useEffect(() => {\n    let cancelled = false;\n    const check = async (options?: { missingFallback?: boolean }) => {\n      const nextState = await fetchAgentEngineConfiguredState(enabled, options);\n      if (cancelled) return;\n      if (nextState === \"unknown\") {\n        return;\n      }\n      setState(nextState);\n    };\n    const onConfiguredChanged = () => {\n      void check();\n    };\n    const onMissing = () => {\n      if (!enabled) {\n        setState(\"configured\");\n        return;\n      }\n      void check({ missingFallback: true });\n    };\n\n    void check();\n    window.addEventListener(\n      \"agent-engine:configured-changed\",\n      onConfiguredChanged,\n    );\n    // A stale failed stream can arrive after a reconnect succeeds. Re-check the\n    // current status before pinning the composer in setup.\n    window.addEventListener(\"agent-chat:missing-api-key\", onMissing);\n    return () => {\n      cancelled = true;\n      window.removeEventListener(\n        \"agent-engine:configured-changed\",\n        onConfiguredChanged,\n      );\n      window.removeEventListener(\"agent-chat:missing-api-key\", onMissing);\n    };\n  }, [enabled]);\n\n  return { missing: state === \"missing\", state };\n}\n"]}

package/dist/collab/awareness.d.ts

@@ -49,11 +49,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -64,10 +64,10 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;
 //# sourceMappingURL=awareness.d.ts.map

package/dist/collab/awareness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAuCa,MAAM;eAAS,MAAM;;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAWM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;kBAuCa,MAAM;eAAS,MAAM;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;kBAWM,MAAM;kBAAY,MAAM;;GAMvD,CAAC"}

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/file-upload/actions/upload-image.d.ts

@@ -3,18 +3,18 @@ declare const _default: import("../../action.js").ActionDefinition<{
     url?: string;
     filename?: string;
 }, {
-    id?: undefined;
     error: string;
     configured?: undefined;
     connectPath?: undefined;
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
 } | {
-    id?: undefined;
     error: string;
     configured: boolean;
     connectPath: string;
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
 } | {
     error?: undefined;

package/dist/notifications/routes.d.ts

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -28,7 +28,7 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/observability/routes.d.ts

@@ -41,28 +41,28 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
-    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
+    ok?: undefined;
+    error?: undefined;
     id?: undefined;
 } | {
-    error?: undefined;
-    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-} | {
     ok?: undefined;
+    error?: undefined;
+} | {
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
     error: any;
+    ok?: undefined;
+    id?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
     ok: boolean;
+    error?: undefined;
+    id?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transcribe-voice.d.ts","sourceRoot":"","sources":["../../src/server/transcribe-voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA+FH,wBAAgB,4BAA4B;;;;;;IAsW3C"}
+{"version":3,"file":"transcribe-voice.d.ts","sourceRoot":"","sources":["../../src/server/transcribe-voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsGH,wBAAgB,4BAA4B;;;;;;IAuX3C"}

package/dist/server/transcribe-voice.js

@@ -21,6 +21,7 @@ import { createBuilderEngine } from "../agent/engine/builder-engine.js";
 import { appStateGet } from "../application-state/store.js";
 import { getOrgContext } from "../org/context.js";
 import { transcribeWithBuilder } from "../transcription/builder-transcription.js";
+import { applyVoiceContextReplacements, buildVoiceGuidanceBlock, parseVoiceContextPack, voiceContextTermsOnly, } from "../voice/index.js";
 import { getSession } from "./auth.js";
 import { resolveHasBuilderPrivateKey, resolveSecret, } from "./credential-provider.js";
 import { runWithRequestContext } from "./request-context.js";
@@ -125,6 +126,15 @@ export function createTranscribeVoiceHandler() {
         const instructions = instructionsPart?.data
             ? sanitizeInstructions(Buffer.from(instructionsPart.data).toString("utf8"))
             : undefined;
+        const voiceContextPart = parts?.find((p) => p.name === "voiceContext" || p.name === "contextPack");
+        const voiceContext = voiceContextPart?.data
+            ? parseVoiceContextPack(Buffer.from(voiceContextPart.data).toString("utf8"))
+            : undefined;
+        const voiceGuidance = buildVoiceGuidanceBlock({
+            instructions,
+            contextPack: voiceContextTermsOnly(voiceContext),
+        });
+        const applyVoiceContext = (value) => applyVoiceContextReplacements(value, voiceContext).trim();
         // Resolve provider preference. Per-request "provider" form field takes
         // precedence (the desktop client sends it on every dictation press),
         // falling back to the user's stored `voice-transcription-prefs` app
@@ -190,7 +200,7 @@ export function createTranscribeVoiceHandler() {
         // does not want audio uploaded to any external provider. The client
         // shouldn't hit this endpoint when "browser" is selected; this is a
         // defense-in-depth refusal.
-        if (providerPref === "browser") {
+        if (providerPref === "browser" && !transcriptText) {
             setResponseStatus(event, 400);
             return {
                 error: 'Voice provider is set to "browser" (Web Speech API only). Change the preference in Settings → Voice Transcription to use a server-side provider.',
@@ -205,7 +215,8 @@ export function createTranscribeVoiceHandler() {
             return await cleanupTranscriptText({
                 event,
                 text: transcriptText,
-                instructions,
+                instructions: voiceGuidance,
+                contextPack: voiceContext,
                 providerPref,
                 hasBuilderPrivateKey,
                 withRequestContext,
@@ -239,9 +250,9 @@ export function createTranscribeVoiceHandler() {
                     mimeType: mime,
                     apiKey: geminiKey,
                     language: language || undefined,
-                    instructions,
+                    instructions: voiceGuidance,
                 });
-                const trimmed = text.trim();
+                const trimmed = applyVoiceContext(text);
                 if (!trimmed) {
                     setResponseStatus(event, 502);
                     return { error: "Gemini returned an empty transcript." };
@@ -273,9 +284,9 @@ export function createTranscribeVoiceHandler() {
                         ? BUILDER_GEMINI_TRANSCRIPTION_MODEL
                         : undefined,
                     language: language || undefined,
-                    instructions,
+                    instructions: voiceGuidance,
                 });
-                return { text: (result.text ?? "").trim() };
+                return { text: applyVoiceContext(result.text ?? "") };
             }
             catch (err) {
                 const message = err?.message ?? String(err);
@@ -306,7 +317,8 @@ export function createTranscribeVoiceHandler() {
                 audioBytes,
                 mime,
                 language,
-                instructions,
+                instructions: voiceGuidance,
+                contextPack: voiceContext,
             });
         }
         // ── Auto / undefined / openai fallback chain ────────────────────────
@@ -320,9 +332,9 @@ export function createTranscribeVoiceHandler() {
                     mimeType: mime,
                     model: BUILDER_GEMINI_TRANSCRIPTION_MODEL,
                     language: language || undefined,
-                    instructions,
+                    instructions: voiceGuidance,
                 });
-                return { text: (result.text ?? "").trim() };
+                return { text: applyVoiceContext(result.text ?? "") };
             }
             catch (err) {
                 const message = err?.message ?? String(err);
@@ -347,9 +359,9 @@ export function createTranscribeVoiceHandler() {
                         mimeType: mime,
                         apiKey: geminiKey,
                         language: language || undefined,
-                        instructions,
+                        instructions: voiceGuidance,
                     });
-                    const trimmed = text.trim();
+                    const trimmed = applyVoiceContext(text);
                     if (trimmed) {
                         console.log(`[transcribe-voice] Gemini → ${trimmed.length} chars`);
                         return { text: trimmed };
@@ -402,7 +414,8 @@ export function createTranscribeVoiceHandler() {
             audioBytes,
             mime,
             language,
-            instructions,
+            instructions: voiceGuidance,
+            contextPack: voiceContext,
         });
     });
 }
@@ -413,7 +426,7 @@ export function createTranscribeVoiceHandler() {
  * strict-Groq preference path and the auto fallback chain share one
  * implementation.
  */
-async function callWhisperCompat({ event, provider, audioBytes, mime, language, instructions, }) {
+async function callWhisperCompat({ event, provider, audioBytes, mime, language, instructions, contextPack, }) {
     const ext = pickExtension(mime);
     const filename = `composer-voice.${ext}`;
     const form = new FormData();
@@ -443,7 +456,9 @@ async function callWhisperCompat({ event, provider, audioBytes, mime, language,
             };
         }
         const data = (await res.json());
-        return { text: (data.text ?? "").trim() };
+        return {
+            text: applyVoiceContextReplacements((data.text ?? "").trim(), contextPack).trim(),
+        };
     }
     catch (err) {
         setResponseStatus(event, 502);
@@ -457,12 +472,13 @@ async function callWhisperCompat({ event, provider, audioBytes, mime, language,
         clearTimeout(timeout);
     }
 }
-async function cleanupTranscriptText({ event, text, instructions, providerPref, hasBuilderPrivateKey, withRequestContext, resolveApiKey, }) {
+async function cleanupTranscriptText({ event, text, instructions, contextPack, providerPref, hasBuilderPrivateKey, withRequestContext, resolveApiKey, }) {
     const original = text.trim();
     if (!original)
         return { text: "" };
+    const finalizeText = (value) => applyVoiceContextReplacements(value || original, contextPack).trim();
     if (providerPref === "browser") {
-        return { text: original };
+        return { text: finalizeText(original) };
     }
     if (providerPref === "builder" || providerPref === "builder-gemini") {
         if (!(await hasBuilderPrivateKey())) {
@@ -473,7 +489,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
         }
         try {
             const cleaned = await withRequestContext(() => cleanupWithBuilder({ text: original, instructions }));
-            return { text: cleaned || original };
+            return { text: finalizeText(cleaned || original) };
         }
         catch (err) {
             setResponseStatus(event, 502);
@@ -496,7 +512,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
                 apiKey: geminiKey,
                 instructions,
             });
-            return { text: cleaned || original };
+            return { text: finalizeText(cleaned || original) };
         }
         catch (err) {
             setResponseStatus(event, 502);
@@ -521,7 +537,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
                 apiKey,
                 instructions,
             });
-            return { text: cleaned || original };
+            return { text: finalizeText(cleaned || original) };
         }
         catch (err) {
             setResponseStatus(event, 502);
@@ -534,7 +550,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
         try {
             const cleaned = await withRequestContext(() => cleanupWithBuilder({ text: original, instructions }));
             if (cleaned)
-                return { text: cleaned };
+                return { text: finalizeText(cleaned) };
         }
         catch {
             // Fall through to BYOK providers, then raw text.
@@ -549,7 +565,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
                 instructions,
             });
             if (cleaned)
-                return { text: cleaned };
+                return { text: finalizeText(cleaned) };
         }
         catch {
             // Fall through.
@@ -565,7 +581,7 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
                 instructions,
             });
             if (cleaned)
-                return { text: cleaned };
+                return { text: finalizeText(cleaned) };
         }
         catch {
             // Fall through.
@@ -581,13 +597,13 @@ async function cleanupTranscriptText({ event, text, instructions, providerPref,
                 instructions,
             });
             if (cleaned)
-                return { text: cleaned };
+                return { text: finalizeText(cleaned) };
         }
         catch {
             // Fall through.
         }
     }
-    return { text: original };
+    return { text: finalizeText(original) };
 }
 async function cleanupWithBuilder({ text, instructions, }) {
     const engine = createBuilderEngine();