@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/system-prompt.d.ts

@@ -3,6 +3,23 @@
  */
 import { type Skill } from "./skills.ts";
 export interface BuildSystemPromptOptions {
+    /**
+     * Modo plan activo: el prompt gana la sección que dice que el árbol es de
+     * solo lectura. Declarado aquí arriba, y no junto a los demás campos, para
+     * que el hunk de sincronización se pegue al del `import` de `montar.ts` en
+     * vez de abrir uno nuevo: el presupuesto de fork está a 118/118.
+     */
+    modoPlan?: boolean;
+    /**
+     * Tools que el usuario ha denegado (`permissions.denied`).
+     *
+     * La sección de modo plan enumera las tools que SIGUEN valiendo, y `decidir()`
+     * consulta el `deny` del usuario ANTES del modo: sin esto la sección promete
+     * una tool que el guardián rechaza, que es exactamente el rechazo inesperado
+     * que la sección existe para evitarle al modelo. Pegado a `modoPlan` para que
+     * los dos caigan en el mismo hunk de sincronización (medido: sigue en 2).
+     */
+    toolsDenegadas?: readonly string[];
     /** Custom system prompt (replaces default). */
     customPrompt?: string;
     /** Tools to include in prompt. Default: [read, bash, edit, write] */

package/dist/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAsI3E","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside Ada (ada-cli), a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA6I3E","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { montarPromptDelSistema } from \"./prompts/montar.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/**\n\t * Modo plan activo: el prompt gana la sección que dice que el árbol es de\n\t * solo lectura. Declarado aquí arriba, y no junto a los demás campos, para\n\t * que el hunk de sincronización se pegue al del `import` de `montar.ts` en\n\t * vez de abrir uno nuevo: el presupuesto de fork está a 118/118.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * La sección de modo plan enumera las tools que SIGUEN valiendo, y `decidir()`\n\t * consulta el `deny` del usuario ANTES del modo: sin esto la sección promete\n\t * una tool que el guardián rechaza, que es exactamente el rechazo inesperado\n\t * que la sección existe para evitarle al modelo. Pegado a `modoPlan` para que\n\t * los dos caigan en el mismo hunk de sincronización (medido: sigue en 2).\n\t */\n\ttoolsDenegadas?: readonly string[];\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\t// La doctrina vive en `core/prompts/sistema.md` y se monta con plantillas\n\t// condicionales: cada sección existe SOLO si su capacidad existe. Antes aquí\n\t// había dos directrices («Be concise», «Show file paths clearly») y un bloque\n\t// sobre la documentación de Ada — y de las trece capacidades que habíamos\n\t// construido, NINGUNA aparecía. Ver `core/prompts/montar.ts`.\n\tlet prompt = `${montarPromptDelSistema({\n\t\tnombresDeHerramienta: tools,\n\t\tfrasesDeHerramienta: toolSnippets,\n\t\tmodoPlan: options.modoPlan === true,\n\t\ttoolsDenegadas: options.toolsDenegadas,\n\t})}\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n${guidelines ? `\\nProject guidelines:\\n${guidelines}\\n` : \"\"}\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}

package/dist/core/system-prompt.js

@@ -2,6 +2,7 @@
  * System prompt construction and project context loading
  */
 import { getDocsPath, getExamplesPath, getReadmePath } from "../config.js";
+import { montarPromptDelSistema } from "./prompts/montar.js";
 import { formatSkillsForPrompt } from "./skills.js";
 /** Build the system prompt with tools, guidelines, and context */
 export function buildSystemPrompt(options) {
@@ -70,16 +71,23 @@ export function buildSystemPrompt(options) {
     addGuideline("Be concise in your responses");
     addGuideline("Show file paths clearly when working with files");
     const guidelines = guidelinesList.map((g) => `- ${g}`).join("\n");
-    let prompt = `You are an expert coding assistant operating inside Ada (ada-cli), a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.
+    // La doctrina vive en `core/prompts/sistema.md` y se monta con plantillas
+    // condicionales: cada sección existe SOLO si su capacidad existe. Antes aquí
+    // había dos directrices («Be concise», «Show file paths clearly») y un bloque
+    // sobre la documentación de Ada — y de las trece capacidades que habíamos
+    // construido, NINGUNA aparecía. Ver `core/prompts/montar.ts`.
+    let prompt = `${montarPromptDelSistema({
+        nombresDeHerramienta: tools,
+        frasesDeHerramienta: toolSnippets,
+        modoPlan: options.modoPlan === true,
+        toolsDenegadas: options.toolsDenegadas,
+    })}
 
 Available tools:
 ${toolsList}
 
 In addition to the tools above, you may have access to other custom tools depending on the project.
-
-Guidelines:
-${guidelines}
-
+${guidelines ? `\nProject guidelines:\n${guidelines}\n` : ""}
 Ada documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):
 - Main documentation: ${readmePath}
 - Additional docs: ${docsPath}

package/dist/core/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\tlet prompt = `You are an expert coding assistant operating inside Ada (ada-cli), a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n${guidelines}\n\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { montarPromptDelSistema } from \"./prompts/montar.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/**\n\t * Modo plan activo: el prompt gana la sección que dice que el árbol es de\n\t * solo lectura. Declarado aquí arriba, y no junto a los demás campos, para\n\t * que el hunk de sincronización se pegue al del `import` de `montar.ts` en\n\t * vez de abrir uno nuevo: el presupuesto de fork está a 118/118.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * La sección de modo plan enumera las tools que SIGUEN valiendo, y `decidir()`\n\t * consulta el `deny` del usuario ANTES del modo: sin esto la sección promete\n\t * una tool que el guardián rechaza, que es exactamente el rechazo inesperado\n\t * que la sección existe para evitarle al modelo. Pegado a `modoPlan` para que\n\t * los dos caigan en el mismo hunk de sincronización (medido: sigue en 2).\n\t */\n\ttoolsDenegadas?: readonly string[];\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\t// La doctrina vive en `core/prompts/sistema.md` y se monta con plantillas\n\t// condicionales: cada sección existe SOLO si su capacidad existe. Antes aquí\n\t// había dos directrices («Be concise», «Show file paths clearly») y un bloque\n\t// sobre la documentación de Ada — y de las trece capacidades que habíamos\n\t// construido, NINGUNA aparecía. Ver `core/prompts/montar.ts`.\n\tlet prompt = `${montarPromptDelSistema({\n\t\tnombresDeHerramienta: tools,\n\t\tfrasesDeHerramienta: toolSnippets,\n\t\tmodoPlan: options.modoPlan === true,\n\t\ttoolsDenegadas: options.toolsDenegadas,\n\t})}\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n${guidelines ? `\\nProject guidelines:\\n${guidelines}\\n` : \"\"}\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}

package/dist/core/telemetria/otlp.d.ts

@@ -0,0 +1,122 @@
+/**
+ * OTLP que NO PUEDE filtrar contenido.
+ *
+ * La casilla que marca un comité de compras es «exporta a OpenTelemetry». Eso
+ * lo tiene cualquiera: el contrato es un puñado de variables de entorno
+ * (`OTEL_EXPORTER_OTLP_ENDPOINT` y compañía) y un JSON con una forma fija. Lo
+ * que no tiene cualquiera es exportar SIN convertir el colector de
+ * observabilidad del cliente en un tratamiento de datos personales que nadie ha
+ * inventariado.
+ *
+ * El competidor trae una variable para capturar el CUERPO de los mensajes —el
+ * patrón se llama `CAPTURE_MESSAGE_CONTENT` en la especificación de OTel para
+ * GenAI—. Activarla mete prompts y respuestas del modelo en un almacén de
+ * trazas: un segundo depósito de justo aquello que el RGPD manda minimizar, y
+ * encima uno del que el DPO no suele saber nada porque lo administra el equipo
+ * de plataforma.
+ *
+ * PROPIEDAD DE DISEÑO, y es lo que este módulo vende:
+ *
+ *   NO EXISTE en este fichero ninguna variable de entorno, opción, parámetro ni
+ *   bandera que active la exportación de contenido. No es que venga apagada por
+ *   defecto: es que no está. Una opción apagada la enciende alguien un martes;
+ *   un mecanismo que no existe no se enciende.
+ *
+ * Hay una prueba que recorre el fuente de este módulo comprobándolo, con los
+ * comentarios quitados —porque este párrafo nombra el patrón que persigue y si
+ * no, se acusaría a sí misma—. Ver `test/otlp-sin-contenido.test.ts`.
+ *
+ * TRES CINTURONES, no uno:
+ *
+ *   1. `atributosDeSuceso` trabaja con una LISTA BLANCA explícita. Lo que no
+ *      está, no sale. Es la misma regla que ya cumple `audit/libro.ts`: se
+ *      registra la FORMA de lo que pasó, nunca su contenido.
+ *   2. El descarte es CONTABLE. Sale en `ada.atributos_descartados`, para que
+ *      «este suceso traía cinco claves que no exporto» sea un dato y no un
+ *      silencio. Un filtro mudo es indistinguible de un filtro roto.
+ *   3. `sinContenido` es la red por debajo: cualquier valor con salto de línea o
+ *      más largo que 200 caracteres se cae aunque su clave esté en la lista.
+ *      Sirve para el día en que alguien añada una clave sin pensarlo.
+ *
+ * LO QUE ESTE MÓDULO NO HACE. No envía nada. Construye el cuerpo y lo devuelve;
+ * quien lo suba a un colector es otro, y así este fichero no tiene ninguna
+ * salida a la red que auditar.
+ */
+import type { EntradaDelLibro } from "../audit/libro.ts";
+/** Las tres señales del contrato OTLP. Se nombran en español como el resto. */
+export type SenalOtlp = "trazas" | "logs" | "metricas";
+export interface ConfiguracionOtlp {
+    estado: "sin-configurar" | "configurada" | "invalida";
+    porSenal: Partial<Record<SenalOtlp, {
+        endpoint: string;
+        protocolo: "http/protobuf" | "http/json";
+    }>>;
+    motivo: string;
+}
+/**
+ * Lee la configuración del entorno, con TRES estados y sin inventarse nada.
+ *
+ * La base (`OTEL_EXPORTER_OTLP_ENDPOINT` / `_PROTOCOL`) vale para las tres
+ * señales; la variable específica de una señal la sobreescribe.
+ *
+ * Lo que NO hace, y es deliberado: no cae a `http/protobuf` cuando falta el
+ * protocolo, aunque sea el defecto de la especificación. Un endpoint sin
+ * protocolo declarado sale como `invalida`. El motivo es el de siempre: elegir
+ * en silencio por el operador convierte un despiste suyo en una configuración
+ * nuestra, y el día que el colector no reciba nada nadie sabrá por qué.
+ */
+export declare function configuracionOtlp(env?: NodeJS.ProcessEnv): ConfiguracionOtlp;
+/** Nombre del contador de descartes. Se expone porque las pruebas lo miran. */
+export declare const CLAVE_DESCARTADOS = "ada.atributos_descartados";
+/**
+ * Las claves sospechosas de llevar texto libre.
+ *
+ * Dos señales, las dos baratas y las dos difíciles de fingir por un dato de
+ * forma: un salto de línea (un hash no los tiene, un diff sí) y una longitud
+ * que ningún identificador nuestro alcanza.
+ *
+ * Es un cinturón POR ENCIMA de la lista blanca, no un sustituto. Sola dejaría
+ * pasar una ruta de 40 caracteres; la lista blanca sola dejaría pasar lo que
+ * alguien añada mañana sin pensarlo. Hacen falta las dos.
+ */
+export declare function sinContenido(atributos: Record<string, unknown>): string[];
+/**
+ * Los atributos de un suceso, filtrados y con el descarte contado.
+ *
+ * `ada.atributos_descartados` cuenta lo que se quedó fuera: claves que no están
+ * en la lista blanca, claves cuyo valor no es un escalar exportable y claves
+ * que `sinContenido` marcó. Sin ese número, un filtro que se comiera todo y un
+ * suceso que no traía nada darían el mismo span.
+ *
+ * Una clave de la lista blanca con valor `null` no cuenta como descarte y no
+ * sale: en el libro `null` significa «el fichero no existía» o «no había
+ * credencial activa», y un atributo ausente en OTLP significa exactamente eso.
+ */
+export declare function atributosDeSuceso(entrada: EntradaDelLibro): Record<string, string | number | boolean>;
+/**
+ * Un span de OTLP a partir de una entrada del libro.
+ *
+ * `traceId` sale de la sesión y `spanId` de la sesión más el número de
+ * secuencia: los sucesos de una misma sesión cuelgan de la misma traza sin que
+ * haya que guardar estado en ningún sitio, y dos procesos que exporten el mismo
+ * libro producen los mismos identificadores en vez de duplicar la traza.
+ *
+ * Si el sello de tiempo no se puede leer, los dos tiempos van a cero y el span
+ * lo dice en `ada.sello_ilegible`. Poner la hora actual sería inventarse un
+ * dato: en un registro de cumplimiento, una hora inventada es peor que un cero.
+ */
+export declare function spanDeSuceso(entrada: EntradaDelLibro): object;
+/**
+ * El cuerpo `ResourceSpans` de OTLP/JSON, listo para que otro lo suba.
+ *
+ * La forma es la del estándar y no se improvisa:
+ * `resourceSpans[] -> scopeSpans[] -> spans[]`, con `traceId` y `spanId` en
+ * hexadecimal y los tiempos en nanosegundos desde epoch como cadena, porque son
+ * enteros de 64 bits y un `number` de JavaScript no los sostiene.
+ *
+ * Una lista vacía devuelve un cuerpo con cero spans y NO un cuerpo vacío: el
+ * colector tiene que poder distinguir «esta sesión no tuvo sucesos» de «no se
+ * exportó nada».
+ */
+export declare function cuerpoOtlp(entradas: readonly EntradaDelLibro[]): object;
+//# sourceMappingURL=otlp.d.ts.map

package/dist/core/telemetria/otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../src/core/telemetria/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,iFAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,UAAU,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,eAAe,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC,CAAC;IACrG,MAAM,EAAE,MAAM,CAAC;CACf;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAmEzF;AA6DD,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAK7D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAOzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CA8BrG;AAoCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAwB7D;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAcvE","sourcesContent":["/**\n * OTLP que NO PUEDE filtrar contenido.\n *\n * La casilla que marca un comité de compras es «exporta a OpenTelemetry». Eso\n * lo tiene cualquiera: el contrato es un puñado de variables de entorno\n * (`OTEL_EXPORTER_OTLP_ENDPOINT` y compañía) y un JSON con una forma fija. Lo\n * que no tiene cualquiera es exportar SIN convertir el colector de\n * observabilidad del cliente en un tratamiento de datos personales que nadie ha\n * inventariado.\n *\n * El competidor trae una variable para capturar el CUERPO de los mensajes —el\n * patrón se llama `CAPTURE_MESSAGE_CONTENT` en la especificación de OTel para\n * GenAI—. Activarla mete prompts y respuestas del modelo en un almacén de\n * trazas: un segundo depósito de justo aquello que el RGPD manda minimizar, y\n * encima uno del que el DPO no suele saber nada porque lo administra el equipo\n * de plataforma.\n *\n * PROPIEDAD DE DISEÑO, y es lo que este módulo vende:\n *\n *   NO EXISTE en este fichero ninguna variable de entorno, opción, parámetro ni\n *   bandera que active la exportación de contenido. No es que venga apagada por\n *   defecto: es que no está. Una opción apagada la enciende alguien un martes;\n *   un mecanismo que no existe no se enciende.\n *\n * Hay una prueba que recorre el fuente de este módulo comprobándolo, con los\n * comentarios quitados —porque este párrafo nombra el patrón que persigue y si\n * no, se acusaría a sí misma—. Ver `test/otlp-sin-contenido.test.ts`.\n *\n * TRES CINTURONES, no uno:\n *\n *   1. `atributosDeSuceso` trabaja con una LISTA BLANCA explícita. Lo que no\n *      está, no sale. Es la misma regla que ya cumple `audit/libro.ts`: se\n *      registra la FORMA de lo que pasó, nunca su contenido.\n *   2. El descarte es CONTABLE. Sale en `ada.atributos_descartados`, para que\n *      «este suceso traía cinco claves que no exporto» sea un dato y no un\n *      silencio. Un filtro mudo es indistinguible de un filtro roto.\n *   3. `sinContenido` es la red por debajo: cualquier valor con salto de línea o\n *      más largo que 200 caracteres se cae aunque su clave esté en la lista.\n *      Sirve para el día en que alguien añada una clave sin pensarlo.\n *\n * LO QUE ESTE MÓDULO NO HACE. No envía nada. Construye el cuerpo y lo devuelve;\n * quien lo suba a un colector es otro, y así este fichero no tiene ninguna\n * salida a la red que auditar.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { EntradaDelLibro } from \"../audit/libro.ts\";\n\n/** Las tres señales del contrato OTLP. Se nombran en español como el resto. */\nexport type SenalOtlp = \"trazas\" | \"logs\" | \"metricas\";\n\nexport interface ConfiguracionOtlp {\n\testado: \"sin-configurar\" | \"configurada\" | \"invalida\";\n\tporSenal: Partial<Record<SenalOtlp, { endpoint: string; protocolo: \"http/protobuf\" | \"http/json\" }>>;\n\tmotivo: string;\n}\n\nconst SENALES: readonly SenalOtlp[] = [\"trazas\", \"logs\", \"metricas\"];\n\n/** Los dos únicos protocolos que este exportador sabe rendir. */\nconst PROTOCOLOS = [\"http/protobuf\", \"http/json\"] as const;\ntype Protocolo = (typeof PROTOCOLOS)[number];\n\n/**\n * El contrato estándar, tal cual. Los nombres son los de OpenTelemetry y no se\n * traducen: son lo que un comité de compras busca en la documentación.\n */\nconst VARIABLE_ENDPOINT_BASE = \"OTEL_EXPORTER_OTLP_ENDPOINT\";\nconst VARIABLE_PROTOCOLO_BASE = \"OTEL_EXPORTER_OTLP_PROTOCOL\";\nconst VARIABLES_POR_SENAL: Record<SenalOtlp, { endpoint: string; protocolo: string }> = {\n\ttrazas: { endpoint: \"OTEL_EXPORTER_OTLP_TRACES_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_TRACES_PROTOCOL\" },\n\tlogs: { endpoint: \"OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_LOGS_PROTOCOL\" },\n\tmetricas: { endpoint: \"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL\" },\n};\n\n/** Una variable vacía o con solo espacios cuenta como no puesta. */\nfunction valor(env: NodeJS.ProcessEnv, nombre: string): string | undefined {\n\tconst crudo = env[nombre];\n\tif (typeof crudo !== \"string\") return undefined;\n\tconst limpio = crudo.trim();\n\treturn limpio === \"\" ? undefined : limpio;\n}\n\nfunction esUrlHttp(candidato: string): boolean {\n\ttry {\n\t\tconst url = new URL(candidato);\n\t\treturn url.protocol === \"http:\" || url.protocol === \"https:\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Lee la configuración del entorno, con TRES estados y sin inventarse nada.\n *\n * La base (`OTEL_EXPORTER_OTLP_ENDPOINT` / `_PROTOCOL`) vale para las tres\n * señales; la variable específica de una señal la sobreescribe.\n *\n * Lo que NO hace, y es deliberado: no cae a `http/protobuf` cuando falta el\n * protocolo, aunque sea el defecto de la especificación. Un endpoint sin\n * protocolo declarado sale como `invalida`. El motivo es el de siempre: elegir\n * en silencio por el operador convierte un despiste suyo en una configuración\n * nuestra, y el día que el colector no reciba nada nadie sabrá por qué.\n */\nexport function configuracionOtlp(env: NodeJS.ProcessEnv = process.env): ConfiguracionOtlp {\n\tconst endpointBase = valor(env, VARIABLE_ENDPOINT_BASE);\n\tconst protocoloBase = valor(env, VARIABLE_PROTOCOLO_BASE);\n\n\tconst porSenal: ConfiguracionOtlp[\"porSenal\"] = {};\n\tconst problemas: string[] = [];\n\t/** Señales con protocolo declarado y ningún endpoint donde mandarlo. */\n\tconst protocoloHuerfano: SenalOtlp[] = [];\n\n\tfor (const senal of SENALES) {\n\t\tconst variables = VARIABLES_POR_SENAL[senal];\n\t\tconst endpoint = valor(env, variables.endpoint) ?? endpointBase;\n\t\tconst protocolo = valor(env, variables.protocolo) ?? protocoloBase;\n\n\t\tif (endpoint === undefined) {\n\t\t\tif (protocolo !== undefined) protocoloHuerfano.push(senal);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!esUrlHttp(endpoint)) {\n\t\t\tproblemas.push(`${senal}: el endpoint recibido (${endpoint}) no es una URL http:// ni https://`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (protocolo === undefined) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: hay endpoint (${endpoint}) y ningun protocolo declarado; ` +\n\t\t\t\t\t`declara ${variables.protocolo} o ${VARIABLE_PROTOCOLO_BASE} con ${PROTOCOLOS.join(\" o \")} ` +\n\t\t\t\t\t\"(no se asume ninguno por defecto)\",\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!(PROTOCOLOS as readonly string[]).includes(protocolo)) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: el protocolo recibido (${protocolo}) no es valido; los unicos validos son ${PROTOCOLOS.join(\" y \")}`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tporSenal[senal] = { endpoint, protocolo: protocolo as Protocolo };\n\t}\n\n\t// Una señal mal configurada NO entra en `porSenal`: quien lea esto no puede\n\t// acabar exportando a un sitio que no supimos validar.\n\tif (problemas.length > 0) {\n\t\treturn { estado: \"invalida\", porSenal, motivo: problemas.join(\"; \") };\n\t}\n\n\tconst configuradas = Object.keys(porSenal) as SenalOtlp[];\n\tif (configuradas.length > 0) {\n\t\tconst detalle = configuradas.map((s) => `${s} -> ${porSenal[s]?.endpoint} (${porSenal[s]?.protocolo})`);\n\t\treturn { estado: \"configurada\", porSenal, motivo: `exportacion OTLP activa para ${detalle.join(\", \")}` };\n\t}\n\n\t// El tercer estado se dice entero: «no hay endpoint» y «hay protocolo pero\n\t// no hay endpoint» son dos situaciones distintas para quien la está montando.\n\tif (protocoloHuerfano.length > 0) {\n\t\treturn {\n\t\t\testado: \"sin-configurar\",\n\t\t\tporSenal,\n\t\t\tmotivo:\n\t\t\t\t`hay protocolo declarado para ${protocoloHuerfano.join(\", \")} pero ningun endpoint: ` +\n\t\t\t\t`sin ${VARIABLE_ENDPOINT_BASE} (o el especifico de la senal) no hay nada que exportar`,\n\t\t};\n\t}\n\treturn {\n\t\testado: \"sin-configurar\",\n\t\tporSenal,\n\t\tmotivo: `no hay ninguna variable ${VARIABLE_ENDPOINT_BASE} en el entorno: la exportacion OTLP esta apagada`,\n\t};\n}\n\n/**\n * LA LISTA BLANCA. Clave del suceso -> nombre del atributo OTLP.\n *\n * Todo lo que hay aquí es FORMA: qué pasó, con qué herramienta, cómo acabó,\n * cuánto ocupó. Nada de aquí puede llevar texto del usuario.\n *\n * Lo que NO está, y no por olvido:\n *\n *   · `argv` — el texto del comando. Es la clave más golosa y la que más caro\n *     sale: un comando lleva rutas, nombres de cliente y a veces un secreto\n *     pegado en la línea.\n *   · `ruta` — la ruta completa del fichero. El nombre de un fichero ya es un\n *     dato: `/casos/2024/despido-<nombre>.docx` identifica a una persona sin\n *     que haga falta abrirlo. Del fichero salen sus hashes y nada más.\n *   · `motivo` — texto libre de la política. Hoy son frases nuestras; mañana\n *     alguien mete ahí lo que el modelo dijo.\n *   · `extension` — ruta en disco de la extensión, mismo argumento que `ruta`.\n *   · `violaciones` — lista de texto libre del sandbox.\n *\n * Y nunca, en ninguna versión: el prompt, la respuesta del modelo o el\n * contenido de un fichero. No hay clave en `SucesoDeSesion` que los lleve, y\n * este módulo existe para que siga sin haberla.\n */\nconst LISTA_BLANCA: Readonly<Record<string, string>> = {\n\ttipo: \"ada.suceso.tipo\",\n\t// tool\n\tnombre: \"ada.tool.nombre\",\n\tok: \"ada.tool.ok\",\n\tdecision: \"ada.permiso.veredicto\",\n\t// comando\n\tcodigo: \"ada.comando.codigo\",\n\tsandbox: \"ada.comando.encierro\",\n\torigen: \"ada.comando.origen\",\n\t// modelo\n\tproveedor: \"ada.modelo.proveedor\",\n\tmodelo: \"ada.modelo.nombre\",\n\tentrada: \"ada.modelo.tokens_entrada\",\n\tsalida: \"ada.modelo.tokens_salida\",\n\tmotivoParada: \"ada.modelo.motivo_parada\",\n\t// fichero: solo los hashes, jamás la ruta\n\tantes: \"ada.fichero.hash_antes\",\n\tdespues: \"ada.fichero.hash_despues\",\n\ttool: \"ada.fichero.tool\",\n\t// red: el dominio, nunca la ruta ni los parametros (ahi viajan los tokens)\n\tdominio: \"ada.red.dominio\",\n\tpermitido: \"ada.red.permitido\",\n\t// credenciales: el identificador, jamas el valor\n\taccion: \"ada.credencial.accion\",\n\tcredencialId: \"ada.credencial.id\",\n\tresultado: \"ada.credencial.resultado\",\n\t// purga por retencion\n\tpolitica: \"ada.politica.nombre\",\n\tentradas: \"ada.purga.entradas\",\n\thashDeCierre: \"ada.purga.hash_de_cierre\",\n\t// medidas genericas, si el suceso las trae\n\tbytes: \"ada.bytes\",\n\tduracionMs: \"ada.duracion_ms\",\n};\n\n/** Nombre del contador de descartes. Se expone porque las pruebas lo miran. */\nexport const CLAVE_DESCARTADOS = \"ada.atributos_descartados\";\n\n/** Un valor de cadena más largo que esto ya no es forma: es texto. */\nconst LARGO_MAXIMO = 200;\n\n/**\n * Las claves sospechosas de llevar texto libre.\n *\n * Dos señales, las dos baratas y las dos difíciles de fingir por un dato de\n * forma: un salto de línea (un hash no los tiene, un diff sí) y una longitud\n * que ningún identificador nuestro alcanza.\n *\n * Es un cinturón POR ENCIMA de la lista blanca, no un sustituto. Sola dejaría\n * pasar una ruta de 40 caracteres; la lista blanca sola dejaría pasar lo que\n * alguien añada mañana sin pensarlo. Hacen falta las dos.\n */\nexport function sinContenido(atributos: Record<string, unknown>): string[] {\n\tconst sospechosas: string[] = [];\n\tfor (const [clave, valorDelAtributo] of Object.entries(atributos)) {\n\t\tif (typeof valorDelAtributo !== \"string\") continue;\n\t\tif (valorDelAtributo.length > LARGO_MAXIMO || /[\\r\\n]/.test(valorDelAtributo)) sospechosas.push(clave);\n\t}\n\treturn sospechosas;\n}\n\n/**\n * Los atributos de un suceso, filtrados y con el descarte contado.\n *\n * `ada.atributos_descartados` cuenta lo que se quedó fuera: claves que no están\n * en la lista blanca, claves cuyo valor no es un escalar exportable y claves\n * que `sinContenido` marcó. Sin ese número, un filtro que se comiera todo y un\n * suceso que no traía nada darían el mismo span.\n *\n * Una clave de la lista blanca con valor `null` no cuenta como descarte y no\n * sale: en el libro `null` significa «el fichero no existía» o «no había\n * credencial activa», y un atributo ausente en OTLP significa exactamente eso.\n */\nexport function atributosDeSuceso(entrada: EntradaDelLibro): Record<string, string | number | boolean> {\n\tconst candidatos: Record<string, string | number | boolean> = {\n\t\t\"ada.sesion\": entrada.sesion,\n\t\t\"ada.seq\": entrada.seq,\n\t};\n\tlet descartados = 0;\n\n\tfor (const [clave, valorCrudo] of Object.entries(entrada.suceso ?? {})) {\n\t\tconst nombre = LISTA_BLANCA[clave];\n\t\tif (nombre === undefined) {\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (valorCrudo === null || valorCrudo === undefined) continue;\n\t\tif (typeof valorCrudo !== \"string\" && typeof valorCrudo !== \"number\" && typeof valorCrudo !== \"boolean\") {\n\t\t\t// Un objeto o un array en una clave blanca: no se aplana ni se\n\t\t\t// serializa, porque serializar es justo por donde entraría el texto.\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tcandidatos[nombre] = valorCrudo;\n\t}\n\n\tfor (const clave of sinContenido(candidatos)) {\n\t\tdelete candidatos[clave];\n\t\tdescartados++;\n\t}\n\n\tcandidatos[CLAVE_DESCARTADOS] = descartados;\n\treturn candidatos;\n}\n\n/** Un identificador hexadecimal derivado del suceso, estable entre procesos. */\nfunction hex(material: string, bytes: number): string {\n\treturn createHash(\"sha256\")\n\t\t.update(material)\n\t\t.digest(\"hex\")\n\t\t.slice(0, bytes * 2);\n}\n\n/** El atributo tal y como lo espera OTLP/JSON: clave y valor etiquetado. */\nfunction atributoOtlp(clave: string, valorDelAtributo: string | number | boolean): object {\n\tif (typeof valorDelAtributo === \"boolean\") return { key: clave, value: { boolValue: valorDelAtributo } };\n\tif (typeof valorDelAtributo === \"number\") {\n\t\treturn Number.isInteger(valorDelAtributo)\n\t\t\t? { key: clave, value: { intValue: String(valorDelAtributo) } }\n\t\t\t: { key: clave, value: { doubleValue: valorDelAtributo } };\n\t}\n\treturn { key: clave, value: { stringValue: valorDelAtributo } };\n}\n\n/** Códigos de `SpanKind` de OTLP. Solo se usan estos dos. */\nconst SPAN_KIND_INTERNAL = 1;\nconst SPAN_KIND_CLIENT = 3;\n/** Códigos de `StatusCode`: 0 sin fijar, 2 error. El 1 (`OK`) se reserva. */\nconst STATUS_UNSET = 0;\nconst STATUS_ERROR = 2;\n\n/** ¿El suceso terminó mal? Se mira la forma, nunca el texto del error. */\nfunction fueError(suceso: Record<string, unknown>): boolean {\n\tif (suceso.ok === false) return true;\n\tif (typeof suceso.codigo === \"number\" && suceso.codigo !== 0) return true;\n\tif (suceso.permitido === false) return true;\n\treturn false;\n}\n\n/**\n * Un span de OTLP a partir de una entrada del libro.\n *\n * `traceId` sale de la sesión y `spanId` de la sesión más el número de\n * secuencia: los sucesos de una misma sesión cuelgan de la misma traza sin que\n * haya que guardar estado en ningún sitio, y dos procesos que exporten el mismo\n * libro producen los mismos identificadores en vez de duplicar la traza.\n *\n * Si el sello de tiempo no se puede leer, los dos tiempos van a cero y el span\n * lo dice en `ada.sello_ilegible`. Poner la hora actual sería inventarse un\n * dato: en un registro de cumplimiento, una hora inventada es peor que un cero.\n */\nexport function spanDeSuceso(entrada: EntradaDelLibro): object {\n\tconst suceso = (entrada.suceso ?? {}) as Record<string, unknown>;\n\tconst tipo = typeof suceso.tipo === \"string\" ? suceso.tipo : \"desconocido\";\n\tconst atributos = atributosDeSuceso(entrada);\n\n\tconst milis = Date.parse(entrada.ts);\n\tconst ilegible = Number.isNaN(milis);\n\tif (ilegible) atributos[\"ada.sello_ilegible\"] = true;\n\tconst inicio = ilegible ? 0n : BigInt(milis) * 1_000_000n;\n\tconst duracion =\n\t\ttypeof suceso.duracionMs === \"number\" && suceso.duracionMs > 0 ? BigInt(Math.round(suceso.duracionMs)) : 0n;\n\n\treturn {\n\t\ttraceId: hex(`traza:${entrada.sesion}`, 16),\n\t\tspanId: hex(`span:${entrada.sesion}:${entrada.seq}`, 8),\n\t\tname: `ada.${tipo}`,\n\t\tkind: tipo === \"red\" || tipo === \"modelo\" ? SPAN_KIND_CLIENT : SPAN_KIND_INTERNAL,\n\t\tstartTimeUnixNano: String(inicio),\n\t\tendTimeUnixNano: String(inicio + duracion * 1_000_000n),\n\t\tattributes: Object.entries(atributos).map(([clave, v]) => atributoOtlp(clave, v)),\n\t\t// El estado va sin `message`: el texto de un error es contenido, y este\n\t\t// es el hueco por donde se colaria.\n\t\tstatus: { code: fueError(suceso) ? STATUS_ERROR : STATUS_UNSET },\n\t};\n}\n\n/** Lo que se anuncia como productor de las trazas. Nada de esto es un dato del usuario. */\nconst RECURSO: readonly (readonly [string, string])[] = [\n\t[\"service.name\", \"ada\"],\n\t[\"telemetry.sdk.name\", \"ada-libro-de-sesion\"],\n\t[\"telemetry.sdk.language\", \"nodejs\"],\n];\n\n/**\n * El cuerpo `ResourceSpans` de OTLP/JSON, listo para que otro lo suba.\n *\n * La forma es la del estándar y no se improvisa:\n * `resourceSpans[] -> scopeSpans[] -> spans[]`, con `traceId` y `spanId` en\n * hexadecimal y los tiempos en nanosegundos desde epoch como cadena, porque son\n * enteros de 64 bits y un `number` de JavaScript no los sostiene.\n *\n * Una lista vacía devuelve un cuerpo con cero spans y NO un cuerpo vacío: el\n * colector tiene que poder distinguir «esta sesión no tuvo sucesos» de «no se\n * exportó nada».\n */\nexport function cuerpoOtlp(entradas: readonly EntradaDelLibro[]): object {\n\treturn {\n\t\tresourceSpans: [\n\t\t\t{\n\t\t\t\tresource: { attributes: RECURSO.map(([clave, v]) => atributoOtlp(clave, v)) },\n\t\t\t\tscopeSpans: [\n\t\t\t\t\t{\n\t\t\t\t\t\tscope: { name: \"ada.core.audit.libro\", version: \"1\" },\n\t\t\t\t\t\tspans: entradas.map(spanDeSuceso),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n}\n"]}