@agent-native/core 0.79.26 → 0.80.0

package/dist/voice/index.d.ts

@@ -0,0 +1,5 @@
+export type { VoiceContextMode, VoiceContextPack, VoiceContextSnippet, VoiceTerm, } from "./voice-context.js";
+export { formatVoiceContextPackForPrompt, parseVoiceContextPack, sanitizeVoiceContextPack, voiceContextHasContent, voiceContextTermsOnly, } from "./voice-context.js";
+export { buildVoiceGuidanceBlock } from "./voice-cleanup-prompt.js";
+export { applyVoiceContextReplacements, applyVoiceTermReplacements, } from "./voice-replacements.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

package/dist/voice/index.js

@@ -0,0 +1,4 @@
+export { formatVoiceContextPackForPrompt, parseVoiceContextPack, sanitizeVoiceContextPack, voiceContextHasContent, voiceContextTermsOnly, } from "./voice-context.js";
+export { buildVoiceGuidanceBlock } from "./voice-cleanup-prompt.js";
+export { applyVoiceContextReplacements, applyVoiceTermReplacements, } from "./voice-replacements.js";
+//# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC","sourcesContent":["export type {\n  VoiceContextMode,\n  VoiceContextPack,\n  VoiceContextSnippet,\n  VoiceTerm,\n} from \"./voice-context.js\";\nexport {\n  formatVoiceContextPackForPrompt,\n  parseVoiceContextPack,\n  sanitizeVoiceContextPack,\n  voiceContextHasContent,\n  voiceContextTermsOnly,\n} from \"./voice-context.js\";\nexport { buildVoiceGuidanceBlock } from \"./voice-cleanup-prompt.js\";\nexport {\n  applyVoiceContextReplacements,\n  applyVoiceTermReplacements,\n} from \"./voice-replacements.js\";\n"]}

package/dist/voice/voice-cleanup-prompt.d.ts

@@ -0,0 +1,6 @@
+import { type VoiceContextPack } from "./voice-context.js";
+export declare function buildVoiceGuidanceBlock({ instructions, contextPack, }: {
+    instructions?: string;
+    contextPack?: VoiceContextPack | null;
+}): string | undefined;
+//# sourceMappingURL=voice-cleanup-prompt.d.ts.map

package/dist/voice/voice-cleanup-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cleanup-prompt.d.ts","sourceRoot":"","sources":["../../src/voice/voice-cleanup-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAU5B,wBAAgB,uBAAuB,CAAC,EACtC,YAAY,EACZ,WAAW,GACZ,EAAE;IACD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACvC,GAAG,MAAM,GAAG,SAAS,CAkBrB"}

package/dist/voice/voice-cleanup-prompt.js

@@ -0,0 +1,26 @@
+import { formatVoiceContextPackForPrompt, } from "./voice-context.js";
+const MAX_CUSTOM_INSTRUCTIONS_CHARS = 4_000;
+function cleanInstructions(value) {
+    const trimmed = value?.replace(/\0/g, "").trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.slice(0, MAX_CUSTOM_INSTRUCTIONS_CHARS);
+}
+export function buildVoiceGuidanceBlock({ instructions, contextPack, }) {
+    const customInstructions = cleanInstructions(instructions);
+    const formattedContext = formatVoiceContextPackForPrompt(contextPack);
+    if (!customInstructions && !formattedContext)
+        return undefined;
+    const sections = [
+        "Use the following voice guidance only to improve transcription, cleanup, terminology, casing, punctuation, and formatting.",
+        "Never add facts or content that are not present in the audio or transcript.",
+    ];
+    if (customInstructions) {
+        sections.push(`User instructions:\n${customInstructions}`);
+    }
+    if (formattedContext) {
+        sections.push(`Voice context:\n${formattedContext}`);
+    }
+    return sections.join("\n\n");
+}
+//# sourceMappingURL=voice-cleanup-prompt.js.map

package/dist/voice/voice-cleanup-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cleanup-prompt.js","sourceRoot":"","sources":["../../src/voice/voice-cleanup-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,GAEhC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAE5C,SAAS,iBAAiB,CAAC,KAAyB;IAClD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,EACtC,YAAY,EACZ,WAAW,GAIZ;IACC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC,kBAAkB,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAE/D,MAAM,QAAQ,GAAG;QACf,4HAA4H;QAC5H,6EAA6E;KAC9E,CAAC;IAEF,IAAI,kBAAkB,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,uBAAuB,kBAAkB,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,gBAAgB,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,gBAAgB,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["import {\n  formatVoiceContextPackForPrompt,\n  type VoiceContextPack,\n} from \"./voice-context.js\";\n\nconst MAX_CUSTOM_INSTRUCTIONS_CHARS = 4_000;\n\nfunction cleanInstructions(value: string | undefined): string | undefined {\n  const trimmed = value?.replace(/\\0/g, \"\").trim();\n  if (!trimmed) return undefined;\n  return trimmed.slice(0, MAX_CUSTOM_INSTRUCTIONS_CHARS);\n}\n\nexport function buildVoiceGuidanceBlock({\n  instructions,\n  contextPack,\n}: {\n  instructions?: string;\n  contextPack?: VoiceContextPack | null;\n}): string | undefined {\n  const customInstructions = cleanInstructions(instructions);\n  const formattedContext = formatVoiceContextPackForPrompt(contextPack);\n  if (!customInstructions && !formattedContext) return undefined;\n\n  const sections = [\n    \"Use the following voice guidance only to improve transcription, cleanup, terminology, casing, punctuation, and formatting.\",\n    \"Never add facts or content that are not present in the audio or transcript.\",\n  ];\n\n  if (customInstructions) {\n    sections.push(`User instructions:\\n${customInstructions}`);\n  }\n  if (formattedContext) {\n    sections.push(`Voice context:\\n${formattedContext}`);\n  }\n\n  return sections.join(\"\\n\\n\");\n}\n"]}

package/dist/voice/voice-context.d.ts

@@ -0,0 +1,25 @@
+export type VoiceContextMode = "dictation" | "cleanup" | "transcript" | "title" | "summary" | "meeting";
+export interface VoiceContextSnippet {
+    label: string;
+    value: string;
+}
+export interface VoiceTerm {
+    term: string;
+    replacement?: string;
+    confidence?: number;
+    source?: string;
+    scope?: string;
+}
+export interface VoiceContextPack {
+    surface?: string;
+    mode?: VoiceContextMode | string;
+    snippets?: VoiceContextSnippet[];
+    terms?: VoiceTerm[];
+    metadata?: Record<string, string | number | boolean | null | undefined>;
+}
+export declare function sanitizeVoiceContextPack(input: unknown): VoiceContextPack | undefined;
+export declare function parseVoiceContextPack(value: string): VoiceContextPack | undefined;
+export declare function voiceContextHasContent(pack: VoiceContextPack | undefined): boolean;
+export declare function voiceContextTermsOnly(input: unknown): VoiceContextPack | undefined;
+export declare function formatVoiceContextPackForPrompt(input: unknown): string;
+//# sourceMappingURL=voice-context.d.ts.map

package/dist/voice/voice-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-context.d.ts","sourceRoot":"","sources":["../../src/voice/voice-context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,SAAS,GACT,YAAY,GACZ,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzE;AAsBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,SAAS,CAoF9B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,gBAAgB,GAAG,SAAS,CAQ9B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,GAAG,SAAS,GACjC,OAAO,CAQT;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,SAAS,CAI9B;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA+CtE"}

package/dist/voice/voice-context.js

@@ -0,0 +1,156 @@
+const MAX_CONTEXT_PACK_CHARS = 64_000;
+const MAX_SNIPPETS = 8;
+const MAX_SNIPPET_VALUE_CHARS = 1_800;
+const MAX_TERMS = 80;
+const MAX_TERM_CHARS = 120;
+const MAX_METADATA_KEYS = 12;
+const MAX_METADATA_VALUE_CHARS = 160;
+function cleanString(value, maxChars) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.replace(/\0/g, "").trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.slice(0, maxChars);
+}
+function cleanNumber(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    return Math.min(1, Math.max(0, value));
+}
+export function sanitizeVoiceContextPack(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return undefined;
+    }
+    const raw = input;
+    const surface = cleanString(raw.surface, 80);
+    const mode = cleanString(raw.mode, 40);
+    const snippets = Array.isArray(raw.snippets)
+        ? raw.snippets
+            .slice(0, MAX_SNIPPETS)
+            .map((snippet) => {
+            if (!snippet || typeof snippet !== "object")
+                return null;
+            const candidate = snippet;
+            const label = cleanString(candidate.label, 80);
+            const value = cleanString(candidate.value, MAX_SNIPPET_VALUE_CHARS);
+            return label && value ? { label, value } : null;
+        })
+            .filter((snippet) => snippet !== null)
+        : undefined;
+    const terms = Array.isArray(raw.terms)
+        ? raw.terms
+            .slice(0, MAX_TERMS)
+            .map((term) => {
+            if (!term || typeof term !== "object")
+                return null;
+            const candidate = term;
+            const rawTerm = cleanString(candidate.term, MAX_TERM_CHARS);
+            if (!rawTerm || rawTerm.length < 2)
+                return null;
+            const replacement = cleanString(candidate.replacement, MAX_TERM_CHARS);
+            const source = cleanString(candidate.source, 40);
+            const scope = cleanString(candidate.scope, 40);
+            const confidence = cleanNumber(candidate.confidence);
+            return {
+                term: rawTerm,
+                ...(replacement ? { replacement } : {}),
+                ...(confidence !== undefined ? { confidence } : {}),
+                ...(source ? { source } : {}),
+                ...(scope ? { scope } : {}),
+            };
+        })
+            .filter((term) => term !== null)
+        : undefined;
+    const metadata = raw.metadata &&
+        typeof raw.metadata === "object" &&
+        !Array.isArray(raw.metadata)
+        ? Object.fromEntries(Object.entries(raw.metadata)
+            .slice(0, MAX_METADATA_KEYS)
+            .flatMap(([key, value]) => {
+            const cleanKey = cleanString(key, 60);
+            if (!cleanKey)
+                return [];
+            if (typeof value === "string" ||
+                typeof value === "number" ||
+                typeof value === "boolean" ||
+                value === null) {
+                const cleanValue = typeof value === "string"
+                    ? cleanString(value, MAX_METADATA_VALUE_CHARS)
+                    : value;
+                return cleanValue === undefined ? [] : [[cleanKey, cleanValue]];
+            }
+            return [];
+        }))
+        : undefined;
+    const pack = {
+        ...(surface ? { surface } : {}),
+        ...(mode ? { mode } : {}),
+        ...(snippets?.length ? { snippets } : {}),
+        ...(terms?.length ? { terms } : {}),
+        ...(metadata && Object.keys(metadata).length > 0 ? { metadata } : {}),
+    };
+    return voiceContextHasContent(pack) ? pack : undefined;
+}
+export function parseVoiceContextPack(value) {
+    const trimmed = value.replace(/\0/g, "").trim();
+    if (!trimmed || trimmed.length > MAX_CONTEXT_PACK_CHARS)
+        return undefined;
+    try {
+        return sanitizeVoiceContextPack(JSON.parse(trimmed));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function voiceContextHasContent(pack) {
+    return Boolean(pack?.surface ||
+        pack?.mode ||
+        pack?.snippets?.length ||
+        pack?.terms?.length ||
+        (pack?.metadata && Object.keys(pack.metadata).length > 0));
+}
+export function voiceContextTermsOnly(input) {
+    const pack = sanitizeVoiceContextPack(input);
+    if (!pack?.terms?.length)
+        return undefined;
+    return { terms: pack.terms };
+}
+export function formatVoiceContextPackForPrompt(input) {
+    const pack = sanitizeVoiceContextPack(input);
+    if (!pack)
+        return "";
+    const sections = [];
+    if (pack.surface)
+        sections.push(`Surface: ${pack.surface}`);
+    if (pack.mode)
+        sections.push(`Mode: ${pack.mode}`);
+    if (pack.snippets?.length) {
+        sections.push([
+            "Context snippets:",
+            ...pack.snippets.map((snippet) => `- ${snippet.label}: ${snippet.value}`),
+        ].join("\n"));
+    }
+    if (pack.terms?.length) {
+        sections.push([
+            "Preferred vocabulary and casing:",
+            ...pack.terms.map((term) => {
+                const replacement = term.replacement && term.replacement !== term.term
+                    ? ` -> ${term.replacement}`
+                    : "";
+                const source = term.source ? ` (${term.source})` : "";
+                return `- ${term.term}${replacement}${source}`;
+            }),
+        ].join("\n"));
+    }
+    if (pack.metadata && Object.keys(pack.metadata).length > 0) {
+        sections.push([
+            "Metadata:",
+            ...Object.entries(pack.metadata).map(([key, value]) => {
+                return `- ${key}: ${String(value)}`;
+            }),
+        ].join("\n"));
+    }
+    return sections.join("\n\n");
+}
+//# sourceMappingURL=voice-context.js.map

package/dist/voice/voice-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-context.js","sourceRoot":"","sources":["../../src/voice/voice-context.ts"],"names":[],"mappings":"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","sourcesContent":["export type VoiceContextMode =\n  | \"dictation\"\n  | \"cleanup\"\n  | \"transcript\"\n  | \"title\"\n  | \"summary\"\n  | \"meeting\";\n\nexport interface VoiceContextSnippet {\n  label: string;\n  value: string;\n}\n\nexport interface VoiceTerm {\n  term: string;\n  replacement?: string;\n  confidence?: number;\n  source?: string;\n  scope?: string;\n}\n\nexport interface VoiceContextPack {\n  surface?: string;\n  mode?: VoiceContextMode | string;\n  snippets?: VoiceContextSnippet[];\n  terms?: VoiceTerm[];\n  metadata?: Record<string, string | number | boolean | null | undefined>;\n}\n\nconst MAX_CONTEXT_PACK_CHARS = 64_000;\nconst MAX_SNIPPETS = 8;\nconst MAX_SNIPPET_VALUE_CHARS = 1_800;\nconst MAX_TERMS = 80;\nconst MAX_TERM_CHARS = 120;\nconst MAX_METADATA_KEYS = 12;\nconst MAX_METADATA_VALUE_CHARS = 160;\n\nfunction cleanString(value: unknown, maxChars: number): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.replace(/\\0/g, \"\").trim();\n  if (!trimmed) return undefined;\n  return trimmed.slice(0, maxChars);\n}\n\nfunction cleanNumber(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.min(1, Math.max(0, value));\n}\n\nexport function sanitizeVoiceContextPack(\n  input: unknown,\n): VoiceContextPack | undefined {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    return undefined;\n  }\n\n  const raw = input as VoiceContextPack;\n  const surface = cleanString(raw.surface, 80);\n  const mode = cleanString(raw.mode, 40);\n\n  const snippets = Array.isArray(raw.snippets)\n    ? raw.snippets\n        .slice(0, MAX_SNIPPETS)\n        .map((snippet) => {\n          if (!snippet || typeof snippet !== \"object\") return null;\n          const candidate = snippet as Partial<VoiceContextSnippet>;\n          const label = cleanString(candidate.label, 80);\n          const value = cleanString(candidate.value, MAX_SNIPPET_VALUE_CHARS);\n          return label && value ? { label, value } : null;\n        })\n        .filter((snippet): snippet is VoiceContextSnippet => snippet !== null)\n    : undefined;\n\n  const terms = Array.isArray(raw.terms)\n    ? raw.terms\n        .slice(0, MAX_TERMS)\n        .map((term) => {\n          if (!term || typeof term !== \"object\") return null;\n          const candidate = term as Partial<VoiceTerm>;\n          const rawTerm = cleanString(candidate.term, MAX_TERM_CHARS);\n          if (!rawTerm || rawTerm.length < 2) return null;\n          const replacement = cleanString(\n            candidate.replacement,\n            MAX_TERM_CHARS,\n          );\n          const source = cleanString(candidate.source, 40);\n          const scope = cleanString(candidate.scope, 40);\n          const confidence = cleanNumber(candidate.confidence);\n          return {\n            term: rawTerm,\n            ...(replacement ? { replacement } : {}),\n            ...(confidence !== undefined ? { confidence } : {}),\n            ...(source ? { source } : {}),\n            ...(scope ? { scope } : {}),\n          };\n        })\n        .filter((term): term is VoiceTerm => term !== null)\n    : undefined;\n\n  const metadata =\n    raw.metadata &&\n    typeof raw.metadata === \"object\" &&\n    !Array.isArray(raw.metadata)\n      ? Object.fromEntries(\n          Object.entries(raw.metadata)\n            .slice(0, MAX_METADATA_KEYS)\n            .flatMap(([key, value]) => {\n              const cleanKey = cleanString(key, 60);\n              if (!cleanKey) return [];\n              if (\n                typeof value === \"string\" ||\n                typeof value === \"number\" ||\n                typeof value === \"boolean\" ||\n                value === null\n              ) {\n                const cleanValue =\n                  typeof value === \"string\"\n                    ? cleanString(value, MAX_METADATA_VALUE_CHARS)\n                    : value;\n                return cleanValue === undefined ? [] : [[cleanKey, cleanValue]];\n              }\n              return [];\n            }),\n        )\n      : undefined;\n\n  const pack: VoiceContextPack = {\n    ...(surface ? { surface } : {}),\n    ...(mode ? { mode } : {}),\n    ...(snippets?.length ? { snippets } : {}),\n    ...(terms?.length ? { terms } : {}),\n    ...(metadata && Object.keys(metadata).length > 0 ? { metadata } : {}),\n  };\n\n  return voiceContextHasContent(pack) ? pack : undefined;\n}\n\nexport function parseVoiceContextPack(\n  value: string,\n): VoiceContextPack | undefined {\n  const trimmed = value.replace(/\\0/g, \"\").trim();\n  if (!trimmed || trimmed.length > MAX_CONTEXT_PACK_CHARS) return undefined;\n  try {\n    return sanitizeVoiceContextPack(JSON.parse(trimmed));\n  } catch {\n    return undefined;\n  }\n}\n\nexport function voiceContextHasContent(\n  pack: VoiceContextPack | undefined,\n): boolean {\n  return Boolean(\n    pack?.surface ||\n    pack?.mode ||\n    pack?.snippets?.length ||\n    pack?.terms?.length ||\n    (pack?.metadata && Object.keys(pack.metadata).length > 0),\n  );\n}\n\nexport function voiceContextTermsOnly(\n  input: unknown,\n): VoiceContextPack | undefined {\n  const pack = sanitizeVoiceContextPack(input);\n  if (!pack?.terms?.length) return undefined;\n  return { terms: pack.terms };\n}\n\nexport function formatVoiceContextPackForPrompt(input: unknown): string {\n  const pack = sanitizeVoiceContextPack(input);\n  if (!pack) return \"\";\n\n  const sections: string[] = [];\n  if (pack.surface) sections.push(`Surface: ${pack.surface}`);\n  if (pack.mode) sections.push(`Mode: ${pack.mode}`);\n\n  if (pack.snippets?.length) {\n    sections.push(\n      [\n        \"Context snippets:\",\n        ...pack.snippets.map(\n          (snippet) => `- ${snippet.label}: ${snippet.value}`,\n        ),\n      ].join(\"\\n\"),\n    );\n  }\n\n  if (pack.terms?.length) {\n    sections.push(\n      [\n        \"Preferred vocabulary and casing:\",\n        ...pack.terms.map((term) => {\n          const replacement =\n            term.replacement && term.replacement !== term.term\n              ? ` -> ${term.replacement}`\n              : \"\";\n          const source = term.source ? ` (${term.source})` : \"\";\n          return `- ${term.term}${replacement}${source}`;\n        }),\n      ].join(\"\\n\"),\n    );\n  }\n\n  if (pack.metadata && Object.keys(pack.metadata).length > 0) {\n    sections.push(\n      [\n        \"Metadata:\",\n        ...Object.entries(pack.metadata).map(([key, value]) => {\n          return `- ${key}: ${String(value)}`;\n        }),\n      ].join(\"\\n\"),\n    );\n  }\n\n  return sections.join(\"\\n\\n\");\n}\n"]}

package/dist/voice/voice-replacements.d.ts

@@ -0,0 +1,4 @@
+import { type VoiceContextPack, type VoiceTerm } from "./voice-context.js";
+export declare function applyVoiceTermReplacements(text: string, terms: readonly VoiceTerm[] | undefined): string;
+export declare function applyVoiceContextReplacements(text: string, contextPack: VoiceContextPack | undefined): string;
+//# sourceMappingURL=voice-replacements.d.ts.map

package/dist/voice/voice-replacements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-replacements.d.ts","sourceRoot":"","sources":["../../src/voice/voice-replacements.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AA4B5B,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GACtC,MAAM,CA+BR;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,gBAAgB,GAAG,SAAS,GACxC,MAAM,CAGR"}

package/dist/voice/voice-replacements.js

@@ -0,0 +1,52 @@
+import { sanitizeVoiceContextPack, } from "./voice-context.js";
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function isAlphaNumeric(value) {
+    return value != null && /[\p{L}\p{N}_]/u.test(value);
+}
+function isSafeVoiceReplacementBoundary(text, index, direction) {
+    const char = text[index];
+    if (char == null)
+        return true;
+    if (isAlphaNumeric(char))
+        return false;
+    if (char === "@" || char === "/" || char === "\\" || char === ":") {
+        return false;
+    }
+    if (char === "." || char === "-" || char === "+") {
+        const neighbor = direction === "before" ? text[index - 1] : text[index + 1];
+        return !isAlphaNumeric(neighbor);
+    }
+    return true;
+}
+export function applyVoiceTermReplacements(text, terms) {
+    if (!text || !terms?.length)
+        return text;
+    let next = text;
+    const replacements = terms
+        .filter((term) => term.term.trim().length >= 2 &&
+        term.replacement?.trim() &&
+        term.replacement.trim() !== term.term.trim())
+        .sort((a, b) => b.term.length - a.term.length);
+    for (const term of replacements) {
+        const source = escapeRegExp(term.term.trim());
+        const replacement = term.replacement?.trim() ?? "";
+        const pattern = new RegExp(source, "giu");
+        next = next.replace(pattern, (match, offset) => {
+            const start = offset;
+            const end = offset + match.length;
+            if (!isSafeVoiceReplacementBoundary(next, start - 1, "before") ||
+                !isSafeVoiceReplacementBoundary(next, end, "after")) {
+                return match;
+            }
+            return replacement;
+        });
+    }
+    return next;
+}
+export function applyVoiceContextReplacements(text, contextPack) {
+    const pack = sanitizeVoiceContextPack(contextPack);
+    return applyVoiceTermReplacements(text, pack?.terms);
+}
+//# sourceMappingURL=voice-replacements.js.map

package/dist/voice/voice-replacements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-replacements.js","sourceRoot":"","sources":["../../src/voice/voice-replacements.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  sanitizeVoiceContextPack,\n  type VoiceContextPack,\n  type VoiceTerm,\n} from \"./voice-context.js\";\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction isAlphaNumeric(value: string | undefined): boolean {\n  return value != null && /[\\p{L}\\p{N}_]/u.test(value);\n}\n\nfunction isSafeVoiceReplacementBoundary(\n  text: string,\n  index: number,\n  direction: \"before\" | \"after\",\n): boolean {\n  const char = text[index];\n  if (char == null) return true;\n  if (isAlphaNumeric(char)) return false;\n  if (char === \"@\" || char === \"/\" || char === \"\\\\\" || char === \":\") {\n    return false;\n  }\n  if (char === \".\" || char === \"-\" || char === \"+\") {\n    const neighbor = direction === \"before\" ? text[index - 1] : text[index + 1];\n    return !isAlphaNumeric(neighbor);\n  }\n  return true;\n}\n\nexport function applyVoiceTermReplacements(\n  text: string,\n  terms: readonly VoiceTerm[] | undefined,\n): string {\n  if (!text || !terms?.length) return text;\n\n  let next = text;\n  const replacements = terms\n    .filter(\n      (term) =>\n        term.term.trim().length >= 2 &&\n        term.replacement?.trim() &&\n        term.replacement.trim() !== term.term.trim(),\n    )\n    .sort((a, b) => b.term.length - a.term.length);\n\n  for (const term of replacements) {\n    const source = escapeRegExp(term.term.trim());\n    const replacement = term.replacement?.trim() ?? \"\";\n    const pattern = new RegExp(source, \"giu\");\n    next = next.replace(pattern, (match, offset: number) => {\n      const start = offset;\n      const end = offset + match.length;\n      if (\n        !isSafeVoiceReplacementBoundary(next, start - 1, \"before\") ||\n        !isSafeVoiceReplacementBoundary(next, end, \"after\")\n      ) {\n        return match;\n      }\n      return replacement;\n    });\n  }\n\n  return next;\n}\n\nexport function applyVoiceContextReplacements(\n  text: string,\n  contextPack: VoiceContextPack | undefined,\n): string {\n  const pack = sanitizeVoiceContextPack(contextPack);\n  return applyVoiceTermReplacements(text, pack?.terms);\n}\n"]}

package/docs/content/a2a-protocol.mdx

@@ -20,13 +20,53 @@ Key concepts:
 - **Tasks** — each message creates a task with a lifecycle (submitted, working, completed, failed, canceled)
 - **JWT bearer auth** — production A2A requires `A2A_SECRET` or an explicit legacy `apiKeyEnv`
 
-```an-diagram title="One agent hands work to another" summary="A mail agent discovers the analytics agent's card, sends a JSON-RPC message, and gets a completed task back."
-{
-  "html": "<div class=\"diagram-handoff\"><div class=\"diagram-card\"><strong>Mail agent</strong><small class=\"diagram-muted\">needs analytics</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">GET /.well-known/agent-card.json</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill accent\">POST /_agent-native/a2a<br><small class=\"diagram-muted\">message/send</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-pill ok\">task · completed</div></div><div class=\"diagram-card\" data-rough><strong>Analytics agent</strong><small class=\"diagram-muted\">runs run-query, returns result</small></div></div>",
-  "css": ".diagram-handoff{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-handoff .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-handoff .diagram-arrow{font-size:20px;line-height:1}"
+<Diagram id="doc-block-3a1ebt" title="One agent hands work to another" summary={"A mail agent discovers the analytics agent's card, sends a JSON-RPC message, and gets a completed task back."}>
+
+```html
+<div class="diagram-handoff">
+  <div class="diagram-card">
+    <strong>Mail agent</strong
+    ><small class="diagram-muted">needs analytics</small>
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill">GET /.well-known/agent-card.json</div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+    <div class="diagram-pill accent">
+      POST /_agent-native/a2a<br /><small class="diagram-muted"
+        >message/send</small
+      >
+    </div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&larr;</div>
+    <div class="diagram-pill ok">task · completed</div>
+  </div>
+  <div class="diagram-card" data-rough>
+    <strong>Analytics agent</strong
+    ><small class="diagram-muted">runs run-query, returns result</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-handoff {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+.diagram-handoff .diagram-col {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-handoff .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## Server setup {#server-setup}
 
 Most templates get A2A through the framework agent chat plugin. If you are mounting it yourself, call `mountA2A()` in a server plugin:
@@ -176,14 +216,62 @@ JSON-RPC 2.0 endpoint for `message/send`, `message/stream`, `tasks/get`, and `ta
 
 When `message/send` is called with `async: true`, the JSON-RPC handler enqueues the task and self-fires a POST to an internal `/_agent-native/a2a/_process-task` route so the handler runs in a fresh function execution with its own full timeout. This route is authenticated with an HMAC token bound to the task ID (5-minute lifetime, signed with `A2A_SECRET`). It is mounted before the `/_agent-native/a2a` JSON-RPC route so h3's prefix matching does not swallow it.
 
-```an-diagram title="Async task lifecycle on serverless" summary="async:true returns working in milliseconds, then a fresh execution runs the agent loop while the caller polls."
-{
-  "html": "<div class=\"diagram-async\"><div class=\"diagram-box\" data-rough>message/send<br><small class=\"diagram-muted\">async: true</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\"><span class=\"diagram-pill\">enqueue task</span><span class=\"diagram-pill warn\">return working</span><small class=\"diagram-muted\">~milliseconds</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>self-fire POST /_agent-native/a2a/_process-task<br><small class=\"diagram-muted\">HMAC token · fresh execution · full timeout</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill\">tasks/get (poll)</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">completed</div></div></div>",
-  "css": ".diagram-async{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-async .diagram-panel{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-col{display:flex;flex-direction:column;align-items:center;gap:6px}.diagram-async .diagram-arrow{font-size:20px;line-height:1}",
-  "caption": "A recurring sweeper re-claims any task left in flight if the function execution dies mid-run."
+<Diagram id="doc-block-1nl4ck7" title="Async task lifecycle on serverless" summary="async:true returns working in milliseconds, then a fresh execution runs the agent loop while the caller polls." caption="A recurring sweeper re-claims any task left in flight if the function execution dies mid-run.">
+
+```html
+<div class="diagram-async">
+  <div class="diagram-box" data-rough>
+    message/send<br /><small class="diagram-muted">async: true</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel">
+    <span class="diagram-pill">enqueue task</span
+    ><span class="diagram-pill warn">return working</span
+    ><small class="diagram-muted">~milliseconds</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-box" data-rough>
+    self-fire POST /_agent-native/a2a/_process-task<br /><small
+      class="diagram-muted"
+      >HMAC token · fresh execution · full timeout</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col">
+    <div class="diagram-pill">tasks/get (poll)</div>
+    <div class="diagram-arrow diagram-muted" aria-hidden="true">&#8635;</div>
+    <div class="diagram-pill ok">completed</div>
+  </div>
+</div>
+```
+
+```css
+.diagram-async {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-async .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-async .diagram-col {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+}
+.diagram-async .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</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.

package/docs/content/actions.mdx

@@ -19,13 +19,74 @@ One definition, seven consumers. This is rung 3 of the [ladder](/docs/what-is-ag
 If you are deciding whether to expose an operation headlessly, in chat, in an
 embedded sidecar, or as a full app screen, see [Agent Surfaces](/docs/agent-surfaces).
 
-```an-diagram title="One definition, seven consumers" summary="A single defineAction() fans out to every surface — agent, UI, HTTP, MCP, A2A, and CLI — with one validated schema and one run() body."
-{
-  "html": "<div class=\"diagram-fanout\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">defineAction()</span><small class=\"diagram-muted\">schema + run(), defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><div class=\"diagram-node\">Agent tool<br><small class=\"diagram-muted\">JSON Schema in context</small></div><div class=\"diagram-node\">React hooks<br><small class=\"diagram-muted\">useActionQuery/Mutation</small></div><div class=\"diagram-node\">callAction()<br><small class=\"diagram-muted\">imperative client</small></div><div class=\"diagram-node\">HTTP<br><small class=\"diagram-muted\">/_agent-native/actions/:name</small></div><div class=\"diagram-node\">MCP tool<br><small class=\"diagram-muted\">external hosts</small></div><div class=\"diagram-node\">A2A tool<br><small class=\"diagram-muted\">other agent-native apps</small></div><div class=\"diagram-node\">CLI<br><small class=\"diagram-muted\">pnpm action &lt;name&gt;</small></div></div></div>",
-  "css": ".diagram-fanout{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-fanout .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-fanout .diagram-arrow{font-size:22px;line-height:1}.diagram-fanout .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}"
+<Diagram id="doc-block-xcp5x6" title="One definition, seven consumers" summary={"A single defineAction() fans out to every surface — agent, UI, HTTP, MCP, A2A, and CLI — with one validated schema and one run() body."}>
+
+```html
+<div class="diagram-fanout">
+  <div class="diagram-panel center" data-rough>
+    <span class="diagram-pill accent">defineAction()</span
+    ><small class="diagram-muted">schema + run(), defined once</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-grid">
+    <div class="diagram-node">
+      Agent tool<br /><small class="diagram-muted"
+        >JSON Schema in context</small
+      >
+    </div>
+    <div class="diagram-node">
+      React hooks<br /><small class="diagram-muted"
+        >useActionQuery/Mutation</small
+      >
+    </div>
+    <div class="diagram-node">
+      callAction()<br /><small class="diagram-muted">imperative client</small>
+    </div>
+    <div class="diagram-node">
+      HTTP<br /><small class="diagram-muted"
+        >/_agent-native/actions/:name</small
+      >
+    </div>
+    <div class="diagram-node">
+      MCP tool<br /><small class="diagram-muted">external hosts</small>
+    </div>
+    <div class="diagram-node">
+      A2A tool<br /><small class="diagram-muted">other agent-native apps</small>
+    </div>
+    <div class="diagram-node">
+      CLI<br /><small class="diagram-muted">pnpm action &lt;name&gt;</small>
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-fanout {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-fanout .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  padding: 14px 16px;
+}
+.diagram-fanout .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-fanout .diagram-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px;
 }
 ```
 
+</Diagram>
+
 If the UI and agent both need to do something, reach for an action — not a custom
 route. For when a route-shaped protocol _is_ the right call, see [Prefer Actions
 For App Operations](/docs/server#actions-first).