@agent-native/core 0.79.27 → 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/locales/ar-SA/template-design.mdx

@@ -350,6 +350,47 @@ pnpm dev
 
 نظرًا لأن التصميم هو مجرد ملفات HTML/JSX مستقلة، يقوم الوكيل بتحرير نفس المصدر الذي يعرضه iframe ويأتي منه كل تصدير - لا يوجد تنسيق "AI mockup" منفصل لترجمته. يوفر نظام التصميم المرتبط الرموز المميزة ويكرم الوكيل `custom_instructions` في كل تذكرة جيل. حدد نصًا أو منطقة في المعاينة واضغط على Cmd+I لتركيز الوكيل على هذا الجزء بالضبط.
 
+### نموذج المحرر
+
+يعتمد Design على النظرة العامة أولاً عند العمل على شاشات متعددة. بعد الإنشاء
+أو التحديثات الواسعة، يفتح المحرر النظرة العامة للشاشات: لوحة لا نهائية تكون
+فيها كل شاشة إطارًا ثابتًا يمكن تحديده أو نقله أو تغيير حجمه أو إسقاطه أو
+تكراره. انقر نقرًا مزدوجًا على إطار للتركيز على شاشة واحدة.
+
+وضع الشاشة الواحدة مخصص للتمرير، والتفاعل مع سلوك النموذج الأولي، وتحرير
+طبقات DOM/الكود داخل ملف واحد معروض. تعكس لوحة الطبقات هذا التقسيم: الشاشات
+إطارات من المستوى الأعلى، وتحت الشاشة النشطة تظهر طبقات DOM/الكود المتداخلة.
+
+لأسماء طبقات مستقرة، أضف `data-agent-native-layer-name` إلى العناصر المهمة.
+يستخدمه Design قبل البدائل الدلالية/النصية، ويمكنه حفظ إعادة تسمية الطبقات عبر
+تحرير هذا السمة. يدعم HTML المضمن تحرير طبقات الكود محليًا للنصوص والأصناف
+والأنماط والسمات وترتيب المصدر والتغييرات البنيوية الصغيرة؛ وتقتصر التعديلات
+المرئية لطبقات الكود حاليًا على HTML. يستطيع وضع مصدر localhost تسجيل لوحات
+عمل المسارات المحلية وحلها، لكن قراءة/كتابة الملفات المحلية تبقى عقد جسر إلى
+أن يتم تعزيز عناصر التحكم الصريحة في الأذونات.
+
+### ملحقات محرر Design
+
+يتضمن المحرر علامة تبويب المفتش **Extensions** بعد **Tweaks**. تعمل
+كمسار إضافات خاص بـ Design: يمكن للمستخدمين النقر على **+ Extension** ليطلبوا
+من الوكيل بناء ملحق، أو تثبيت ملحق يعلن فتحة `design.editor.inspector`.
+
+تُعرض ملحقات Design مضمّنة بجانب لوحة العمل عبر صندوق رمل الملحقات القياسي.
+يمرر المضيف تحديثات `window.slotContext` و`window.onSlotContext(...)` مع
+`designId` الحالي، والملف النشط، وقائمة الشاشات، ومعرفات الشاشات المحددة،
+وبيانات العنصر المحدد، ووضع العرض، والتكبير، والأداة النشطة، وقيم التعديلات.
+يسمح ذلك للملحق بعرض معلومات عن التحديد الحالي، أو تقديم عناصر تحكم في النمط،
+أو بناء تدفقات عمل صغيرة حول التصميم المفتوح.
+
+للعمل الحتمي، يمكن للملحقات استدعاء إجراءات التطبيق من خلال جسر الملحقات.
+وللتغييرات المدفوعة بالذكاء الاصطناعي، اجعل الملحق يستدعي
+`agentNative.chat.send(...)` مع محدد العنصر/معرف المصدر والتغيير المطلوب. يجب
+أن يستدعي الوكيل `view-screen` أولاً، ثم يستخدم `apply-visual-edit` لتغييرات
+نمط العنصر أو الصنف أو النص أو الحركة، أو يستخدم `update-design` /
+`generate-design` مع `canvasFrames` لتغييرات موضع لوحة العمل. راجع
+[Extensions](/docs/extensions#what-an-extension-can-do) لمعرفة صندوق الرمل
+والحالة المستمرة وواجهات جسر الملحقات.
+
 ### تخصيصه
 
 التصميم عبارة عن قالب كامل وقابل للاستنساخ. بعض الأفكار الإضافية العملية:

package/docs/content/locales/de-DE/template-design.mdx

@@ -348,6 +348,57 @@ Der Agent weiß immer, was Sie offen haben. Das aktuelle Design, die geöffnete
 
 Da es sich bei einem Design lediglich um eigenständige HTML/JSX-Dateien handelt, bearbeitet der Agent dieselbe Quelle, die der Iframe rendert, und jeder Export stammt aus – es gibt kein separates „AI-Mockup“-Format zum Übersetzen. Ein verknüpftes Designsystem liefert Token und `custom_instructions`, die der Agent bei jedem Generationsdurchlauf ehrt. Wählen Sie in der Vorschau Text oder einen Bereich aus und drücken Sie Befehl+I, um den Agenten genau auf diesen Teil zu konzentrieren.
 
+### Editor-Modell
+
+Design ist bei Arbeit mit mehreren Bildschirmen übersichtsorientiert. Nach der
+Generierung oder größeren Aktualisierungen öffnet der Editor die
+Bildschirmübersicht: eine unendliche Arbeitsfläche, auf der jeder Bildschirm ein
+statischer Rahmen ist, den Sie auswählen, verschieben, skalieren, ablegen oder
+duplizieren können. Verwenden Sie die Vollansicht-Schaltfläche des Rahmens, wenn ein Bildschirm
+fokussiertes Scrollen oder Prototypinteraktion benötigt.
+
+Der Einzelbildschirmmodus ist für Scrollen, Interaktion mit Prototypverhalten
+und Bearbeitung der DOM-/Code-Ebenen in einer gerenderten Datei gedacht. Das
+Ebenenfenster spiegelt diese Trennung wider: Bildschirme sind Rahmen der
+obersten Ebene, darunter liegen die DOM-/Code-Ebenen des aktiven Bildschirms.
+
+Für stabile Ebenennamen fügen Sie wichtigen Elementen
+`data-agent-native-layer-name` hinzu. Design verwendet dies vor
+semantischen/textbasierten Fallbacks und kann Umbenennungen durch Bearbeiten
+dieses Attributs speichern. Inline-HTML unterstützt lokale Code-Ebenen-Edits
+für Text, Klassen, Stile, Attribute, Quellreihenfolge und kleine strukturelle
+Änderungen; visuelle Code-Ebenen-Edits sind heute HTML-only. Der
+localhost-Quellmodus kann lokale Routen-Artboards registrieren und auflösen,
+aber lokale Datei-Lese-/Schreibvorgänge bleiben ein Bridge-Vertrag, bis
+explizite Berechtigungskontrollen gehärtet sind.
+
+### Erweiterungen im Design-Editor
+
+Der Editor enthält nach **Tweaks** eine **Extensions**-Inspektorregisterkarte.
+Sie funktioniert wie eine Design-spezifische Plugin-Spur: Benutzer können auf
+**+ Extension** klicken, um den Agenten eine Erweiterung erstellen zu lassen,
+oder eine Erweiterung installieren, die den Slot `design.editor.inspector`
+deklariert.
+
+Design-Erweiterungen werden über die Standard-Erweiterungssandbox inline neben
+der Arbeitsfläche gerendert. Der Host übergibt `window.slotContext` und
+`window.onSlotContext(...)`-Updates mit der aktuellen `designId`, der aktiven
+Datei, der Bildschirmliste, ausgewählten Bildschirm-IDs, Metadaten des
+ausgewählten Elements, Ansichtsmodus, Zoom, aktivem Werkzeug und Tweak-Werten.
+So kann eine Erweiterung Informationen zur aktuellen Auswahl anzeigen,
+Stilsteuerungen anbieten oder kompakte Workflows rund um das geöffnete Design
+erstellen.
+
+Für deterministische Arbeit können Erweiterungen App-Aktionen über die
+Erweiterungsbrücke aufrufen. Für KI-gesteuerte Änderungen sollte die Erweiterung
+`agentNative.chat.send(...)` mit dem Selektor/Quell-ID des ausgewählten Elements
+und der gewünschten Änderung aufrufen. Der Agent sollte zuerst `view-screen`
+aufrufen und dann `apply-visual-edit` für Stil-, Klassen-, Text- oder
+Verschiebungsänderungen an Elementen verwenden, oder `update-design` /
+`generate-design` mit `canvasFrames` für Änderungen an der Platzierung der
+Arbeitsfläche. Siehe [Extensions](/docs/extensions#what-an-extension-can-do)
+für Sandbox, persistente Daten und Bridge-APIs.
+
 ### Anpassen
 
 Design ist eine vollständige, klonbare Vorlage. Einige praktische Erweiterungsideen:

package/docs/content/locales/es-ES/template-design.mdx

@@ -348,6 +348,56 @@ El agente siempre sabe lo que tienes abierto. `view-screen` devuelve el diseño
 
 Debido a que un diseño son solo archivos HTML/JSX independientes, el agente edita la misma fuente que representa el iframe y de donde proviene cada exportación; no hay un formato de "maqueta de IA" independiente para traducir. Un sistema de diseño vinculado proporciona tokens y `custom_instructions` el agente honra en cada paso de generación. Seleccione texto o una región en la vista previa y presione Cmd+I para enfocar al agente exactamente en esa parte.
 
+### Modelo del editor
+
+Design prioriza la vista general para el trabajo con varias pantallas. Después
+de generar o aplicar actualizaciones amplias, el editor abre la vista general de
+pantallas: un lienzo infinito donde cada pantalla es un marco estático que se
+puede seleccionar, mover, redimensionar, soltar o duplicar. Usa el botón de vista completa del marco cuando una pantalla necesite
+desplazamiento enfocado o interacción de prototipo.
+
+El modo de una sola pantalla sirve para desplazarse, interactuar con el
+comportamiento del prototipo y editar las capas DOM/código dentro de un archivo
+renderizado. El panel de capas refleja esa división: las pantallas son marcos de
+nivel superior, con capas DOM/código anidadas para la pantalla activa.
+
+Para nombres de capa estables, agrega `data-agent-native-layer-name` a los
+elementos importantes. Design lo usa antes de los respaldos semánticos/de texto
+y puede persistir cambios de nombre editando ese atributo. HTML inline admite
+ediciones locales de capas de código para texto, clases, estilos, atributos,
+orden del código fuente y pequeños cambios estructurales; las ediciones visuales
+de capas de código solo admiten HTML por ahora. El modo de fuente localhost
+puede registrar y resolver artboards de rutas locales, pero las lecturas y
+escrituras de archivos locales siguen siendo un contrato de puente hasta que se
+endurezcan los controles explícitos de permisos.
+
+### Extensiones del editor de Design
+
+El editor incluye una pestaña de inspector **Extensions** después de
+**Tweaks**. Funciona como un carril de plugins específico de Design: los
+usuarios pueden hacer clic en **+ Extension** para pedirle al agente que cree
+una extensión, o instalar una extensión que declare el slot
+`design.editor.inspector`.
+
+Las extensiones de Design se renderizan en línea junto al artboard mediante el
+sandbox estándar de extensiones. El host pasa actualizaciones de
+`window.slotContext` y `window.onSlotContext(...)` con el `designId` actual, el
+archivo activo, la lista de pantallas, los ids de pantalla seleccionados, los
+metadatos del elemento seleccionado, el modo de vista, el zoom, la herramienta
+activa y los valores de tweaks. Eso permite que una extensión muestre
+información sobre la selección actual, ofrezca controles de estilo o construya
+flujos compactos alrededor del diseño abierto.
+
+Para trabajo determinista, las extensiones pueden llamar acciones de la app a
+través del puente de extensiones. Para cambios impulsados por IA, haz que la
+extensión llame `agentNative.chat.send(...)` con el selector/id de origen del
+elemento seleccionado y el cambio solicitado. El agente debe llamar primero
+`view-screen`, luego usar `apply-visual-edit` para cambios de estilo, clase,
+texto o movimiento de elementos, o `update-design` / `generate-design` con
+`canvasFrames` para cambios de colocación del artboard. Consulta
+[Extensions](/docs/extensions#what-an-extension-can-do) para el sandbox, el
+estado persistente y las APIs del puente.
+
 ### Personalizarlo
 
 El diseño es una plantilla completa y clonable. Algunas ideas prácticas de extensión:

package/docs/content/locales/fr-FR/template-design.mdx

@@ -348,6 +348,55 @@ L'agent sait toujours ce que vous avez ouvert. La conception actuelle, le fichie
 
 Étant donné qu'une conception n'est constituée que de fichiers HTML/JSX autonomes, l'agent édite la même source que celle du rendu iframe et celle d'où provient chaque exportation : il n'existe pas de format de « maquette IA » distinct à traduire. Un système de conception lié fournit des jetons et `custom_instructions` que l'agent honore à chaque passage de génération. Sélectionnez du texte ou une région dans l'aperçu et appuyez sur Cmd+I pour concentrer l'agent exactement sur cette partie.
 
+### Modèle d'éditeur
+
+Design privilégie la vue d'ensemble pour le travail multi-écran. Après une
+génération ou une mise à jour large, l'éditeur ouvre la vue d'ensemble des
+écrans : un canevas infini où chaque écran est un cadre statique que vous pouvez
+sélectionner, déplacer, redimensionner, déposer ou dupliquer. Utilisez le bouton de vue complète du cadre lorsqu’un écran nécessite un
+défilement ciblé ou une interaction de prototype.
+
+Le mode écran unique sert à faire défiler, interagir avec le comportement du
+prototype et modifier les couches DOM/code dans un fichier rendu. Le panneau des
+couches reflète cette séparation : les écrans sont des cadres de niveau
+supérieur, avec les couches DOM/code imbriquées pour l'écran actif.
+
+Pour des noms de couche stables, ajoutez `data-agent-native-layer-name` aux
+éléments importants. Design l'utilise avant les replis sémantiques/textuels et
+peut persister les renommages en modifiant cet attribut. Le HTML inline prend en
+charge les modifications locales de couches de code pour le texte, les classes,
+les styles, les attributs, l'ordre source et les petits changements structurels;
+les modifications visuelles de couches de code sont uniquement HTML aujourd'hui.
+Le mode source localhost peut enregistrer et résoudre des artboards de routes
+locales, mais les lectures/écritures de fichiers locaux restent un contrat de
+pont jusqu'au durcissement des contrôles d'autorisation explicites.
+
+### Extensions de l'éditeur Design
+
+L'éditeur inclut un onglet d'inspecteur **Extensions** après **Tweaks**. Il
+fonctionne comme une piste de plugins propre à Design : les utilisateurs peuvent
+cliquer sur **+ Extension** pour demander à l'agent de créer une extension, ou
+installer une extension qui déclare le slot `design.editor.inspector`.
+
+Les extensions Design s'affichent en ligne à côté de l'artboard via le bac à
+sable standard des extensions. L'hôte transmet les mises à jour
+`window.slotContext` et `window.onSlotContext(...)` avec le `designId` actuel,
+le fichier actif, la liste des écrans, les ids d'écran sélectionnés, les
+métadonnées de l'élément sélectionné, le mode d'affichage, le zoom, l'outil
+actif et les valeurs de tweaks. Cela permet à une extension d'afficher des
+informations sur la sélection actuelle, d'offrir des contrôles de style ou de
+créer des workflows compacts autour du design ouvert.
+
+Pour un travail déterministe, les extensions peuvent appeler les actions de
+l'app via le pont d'extension. Pour les changements pilotés par l'IA,
+l'extension doit appeler `agentNative.chat.send(...)` avec le sélecteur/id source
+de l'élément sélectionné et la modification demandée. L'agent doit d'abord
+appeler `view-screen`, puis utiliser `apply-visual-edit` pour les changements de
+style, classe, texte ou déplacement d'élément, ou `update-design` /
+`generate-design` avec `canvasFrames` pour les changements de placement de
+l'artboard. Consultez [Extensions](/docs/extensions#what-an-extension-can-do)
+pour le bac à sable, l'état persistant et les APIs du pont.
+
 ### Le personnaliser
 
 Design est un modèle complet et clonable. Quelques idées d'extension pratiques :