@agent-native/core 0.79.27 → 0.80.1

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/skills-guide.mdx

@@ -118,6 +118,10 @@ Skills موجود في `.agents/skills/<name>/SKILL.md` ويحتوي على إر
 
 ## skills المدعوم بالتطبيق {#app-backed-skills}
 
+تشمل skills المدعومة بالتطبيق حاليا `visual-plan` و`visual-recap` من Plan،
+و`visual-edit` من Design، و`assets` من Assets، و`content` لتحرير docs/blog/MDX
+من المستودع.
+
 تحزم skills المدعومة بالتطبيق تطبيقًا أصليًا للوكيل باعتباره قطعة أثرية في سوق المهارات. يمكن أن تتضمن الحزمة تعليمات الوكيل، وبيانات تعريف موصل skills المصدرة، وتعليمات التشغيل المستضافة/المحلية، وأسطح UI مثل تطبيقات MCP.
 
 > **التفاصيل الكاملة أدناه:** يتم تغطية آليات skills المدعومة بالتطبيق (تنسيق البيان، وأوامر CLI، ومحولات السوق، وتجزئة التحديث التلقائي) في [App-backed skills — full details](#app-backed-skills-full).
@@ -328,6 +332,7 @@ scope: dev
 ```bash
 # المسار السعيد: التعليمات المصدرة بالإضافة إلى موصل MCP المستضاف.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 
 # تحرير Content docs/blog/MDX مع اعتبار الريبو مصدر الحقيقة.

package/docs/content/locales/ar-SA/template-design.mdx

@@ -340,7 +340,7 @@ pnpm dev
 - **التصميمات** — `create-design` (صدفة فارغة)، `generate-design` (كتابة محتوى HTML/JSX)، `update-design`، `get-design`، `list-designs`، `duplicate-design`، `delete-design`، و`apply-tweaks` لاستمرار مقبض القرص المباشر القيم (لون التمييز، والكثافة، وما إلى ذلك).
 - **الملفات** — `create-file`، `update-file`، `list-files`، `delete-file` للملفات الموجودة داخل مشروع التصميم.
 - **أنظمة التصميم** — `create-design-system`، و`update-design-system`، و`get-design-system`، و`list-design-systems`، و`delete-design-system`، و`set-default-design-system`، و`analyze-brand-assets` لجمع بيانات العلامة التجارية قبل التحليل.
-- **استيراد** — `import-code`، و`import-figma`، و`import-github`، و`import-from-url`، و`import-document` (DOCX/PPTX/PDF/XLSX)، و`import-design-project` لرفع نظام التصميم من مشروع حالي.
+- **استيراد** — `index-design-system-with-builder` for Builder-backed code/GitHub design-system indexing, plus `import-figma`, `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **التصدير والتسليم** — `export-html`، و`export-pdf`، و`export-svg`، و`export-zip`، و`export-coding-handoff` لتحويل التصميم إلى تسليم لأداة البرمجة.
 - **السياق والتنقل** — `view-screen` (التصميم الحالي، ملف مفتوح، عرض، سؤال معلق أو شبكة متغيرة)، `get-design-snapshot` (الحالة الحالية للوكيل الخارجي للمتابعة منها)، و`navigate`.
 
@@ -350,6 +350,60 @@ pnpm dev
 
 نظرًا لأن التصميم هو مجرد ملفات HTML/JSX مستقلة، يقوم الوكيل بتحرير نفس المصدر الذي يعرضه iframe ويأتي منه كل تصدير - لا يوجد تنسيق "AI mockup" منفصل لترجمته. يوفر نظام التصميم المرتبط الرموز المميزة ويكرم الوكيل `custom_instructions` في كل تذكرة جيل. حدد نصًا أو منطقة في المعاينة واضغط على Cmd+I لتركيز الوكيل على هذا الجزء بالضبط.
 
+### نموذج المحرر
+
+يعتمد Design على النظرة العامة أولاً عند العمل على شاشات متعددة. بعد الإنشاء
+أو التحديثات الواسعة، يفتح المحرر النظرة العامة للشاشات: لوحة لا نهائية تكون
+فيها كل شاشة إطارًا ثابتًا يمكن تحديده أو نقله أو تغيير حجمه أو إسقاطه أو
+تكراره. انقر نقرًا مزدوجًا على إطار للتركيز على شاشة واحدة.
+
+وضع الشاشة الواحدة مخصص للتمرير، والتفاعل مع سلوك النموذج الأولي، وتحرير
+طبقات DOM/الكود داخل ملف واحد معروض. تعكس لوحة الطبقات هذا التقسيم: الشاشات
+إطارات من المستوى الأعلى، وتحت الشاشة النشطة تظهر طبقات DOM/الكود المتداخلة.
+
+ثبّت `/visual-edit` عندما يحتاج وكيل البرمجة إلى فتح تطبيق محلي يعمل في
+Design بدل إنشاء HTML نموذج أولي مستقل:
+
+```bash
+npx @agent-native/core@latest skills add visual-edit
+```
+
+بعد تشغيل خادم التطوير للتطبيق الهدف، يستخدم `/visual-edit`
+`npx @agent-native/core@latest design connect` مع `add-localhost-screens` لوضع
+كل مسار أو URL مطلوب كشاشة iframe منفصلة مدعومة بعنوان URL. تبقى التدفقات
+المرقمة مثل `localhost:1234/onboarding/1` و`/onboarding/2` و`/onboarding/3`
+كشاشات منفصلة ومرتبة في وضع النظرة العامة.
+
+لأسماء طبقات مستقرة، أضف `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/skills-guide.mdx

@@ -118,6 +118,10 @@ Domäne skills folgt demselben Format wie das Framework skills. Sie kodieren Mus
 
 ## App-gestütztes skills {#app-backed-skills}
 
+Aktuelle appgestützte Skills sind `visual-plan` und `visual-recap` aus Plan,
+`visual-edit` aus Design, `assets` aus Assets und `content` für repo-basiertes
+Bearbeiten von docs/blog/MDX.
+
 App-gestütztes skills-Paket einer agentennativen App als Skill-Marktplatz-Artefakt. Das Paket kann Agentenanweisungen, exportierte skills-, MCP-Connector-Metadaten, gehostete/lokale Startanweisungen und UI-Oberflächen wie MCP-Apps enthalten.
 
 > **Vollständige Details unten:** Die Mechanismen des App-gestützten skills (Manifestformat, CLI-Befehle, Marktplatzadapter, automatisches Update-Hashing) werden in [App-backed skills — full details](#app-backed-skills-full) behandelt.
@@ -328,6 +332,7 @@ Offline-Arbeit oder datenschutzrelevante Nutzung.
 ```bash
 # Glücklicher Weg: exportierte Anweisungen plus gehosteter MCP-Connector.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 
 # Repo-first Content docs/blog/MDX Bearbeitung.

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

@@ -338,7 +338,7 @@ Jeder vom Agenten aufrufbare Vorgang ist eine TypeScript-Datei in `templates/des
 - **Designs** – `create-design` (leere Shell), `generate-design` (generierten HTML/JSX-Inhalt schreiben), `update-design`, `get-design`, `list-designs`, `duplicate-design`, `delete-design` und `apply-tweaks` zum Beibehalten von Live-Tweak-Knopf-Werten (Akzentfarbe, Dichte, usw.).
 - **Dateien** – `create-file`, `update-file`, `list-files`, `delete-file` für die Dateien in einem Designprojekt.
 - **Designsysteme** – `create-design-system`, `update-design-system`, `get-design-system`, `list-design-systems`, `delete-design-system`, `set-default-design-system` und `analyze-brand-assets` zum Sammeln von Markendaten vor der Analyse.
-- **Importieren** – `import-code`, `import-figma`, `import-github`, `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX) und `import-design-project`, um ein Designsystem aus einem vorhandenen Projekt zu entfernen.
+- **Importieren** — `index-design-system-with-builder` for Builder-backed code/GitHub design-system indexing, plus `import-figma`, `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **Export & Übergabe** – `export-html`, `export-pdf`, `export-svg`, `export-zip` und `export-coding-handoff`, um ein Design in eine Codierungstool-Übergabe umzuwandeln.
 - **Kontext und Navigation** – `view-screen` (aktuelles Design, offene Datei, Ansicht, ausstehende Frage oder Variantenraster), `get-design-snapshot` (aktueller Status, von dem aus ein externer Agent fortfahren kann) und `navigate`.
 
@@ -348,6 +348,71 @@ 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.
+
+Installiere `/visual-edit`, wenn ein Coding Agent eine laufende lokale App in
+Design öffnen soll, statt eigenständiges Prototype-HTML zu generieren:
+
+```bash
+npx @agent-native/core@latest skills add visual-edit
+```
+
+Sobald der Dev-Server der Ziel-App läuft, nutzt `/visual-edit`
+`npx @agent-native/core@latest design connect` plus `add-localhost-screens`, um
+jeden angeforderten Pfad oder jede URL als eigenen URL-gestützten iframe-Screen
+zu platzieren. Nummerierte Flows wie `localhost:1234/onboarding/1`,
+`/onboarding/2` und `/onboarding/3` bleiben als getrennte, geordnete Screens im
+Overview-Modus erhalten.
+
+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/skills-guide.mdx

@@ -118,6 +118,10 @@ El dominio skills sigue el mismo formato que el marco skills. Codifican patrones
 
 ## skills respaldado por aplicación {#app-backed-skills}
 
+Las skills respaldadas por apps actuales incluyen `visual-plan` y `visual-recap`
+de Plan, `visual-edit` de Design, `assets` de Assets y `content` para editar
+docs/blog/MDX desde el repositorio.
+
 skills, respaldado por una aplicación, empaqueta una aplicación nativa del agente como un artefacto del mercado de habilidades. El paquete puede incluir instrucciones del agente, skills exportado, metadatos del conector MCP, instrucciones de inicio alojadas/locales y superficies UI como aplicaciones MCP.
 
 > **Detalles completos a continuación:** la mecánica de skills respaldado por aplicaciones (formato de manifiesto, comandos CLI, adaptadores de mercado, hash de actualización automática) se tratan en [App-backed skills — full details](#app-backed-skills-full).
@@ -328,6 +332,7 @@ trabajo sin conexión o uso sensible a la privacidad.
 ```bash
 # Camino feliz: instrucciones exportadas más conector MCP alojado.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 
 # Edición de docs/blog/MDX con Content primero en el repositorio.