@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/server/transcript.js

@@ -0,0 +1,176 @@
+/**
+ * Proyección de mensajes de sesión al transcript del protocolo.
+ *
+ * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no
+ * casan es exactamente donde un turno puede desaparecer del transcript sin que
+ * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no
+ * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.
+ *
+ * Los tres desajustes reales:
+ *
+ * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo
+ *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes
+ *    propias, `pending` es streaming, y `deferred` — que no existe en el
+ *    protocolo — se trata como streaming, porque semánticamente el turno
+ *    todavía no ha terminado.
+ *
+ * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el
+ *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el
+ *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una
+ *    dependencia entre mensajes, no una conversión local.
+ *
+ * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de
+ *    forma estable a partir de la posición para que dos snapshots consecutivos
+ *    del mismo transcript den los mismos ids.
+ */
+/** Id estable por posición: el mismo transcript da siempre los mismos ids. */
+export function itemId(index) {
+    return `item-${index}`;
+}
+function toUsage(usage) {
+    if (!usage)
+        return undefined;
+    return {
+        input: Math.max(0, Math.trunc(usage.input ?? 0)),
+        output: Math.max(0, Math.trunc(usage.output ?? 0)),
+        cacheRead: Math.max(0, Math.trunc(usage.cacheRead ?? 0)),
+        cacheWrite: Math.max(0, Math.trunc(usage.cacheWrite ?? 0)),
+        ...(usage.reasoning !== undefined ? { reasoning: Math.max(0, Math.trunc(usage.reasoning)) } : {}),
+        totalTokens: Math.max(0, Math.trunc(usage.totalTokens ?? 0)),
+        cost: {
+            input: usage.cost?.input ?? 0,
+            output: usage.cost?.output ?? 0,
+            cacheRead: usage.cost?.cacheRead ?? 0,
+            cacheWrite: usage.cost?.cacheWrite ?? 0,
+            total: usage.cost?.total ?? 0,
+        },
+    };
+}
+function timestampOf(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;
+}
+function projectUser(message, index) {
+    const content = typeof message.content === "string"
+        ? [{ type: "text", text: message.content }]
+        : message.content.map((block) => block.type === "image"
+            ? { type: "image", data: block.data, mimeType: block.mimeType }
+            : { type: "text", text: block.text ?? "" });
+    return { id: itemId(index), role: "user", content, timestamp: timestampOf(message.timestamp) };
+}
+function projectAssistant(message, index) {
+    const content = message.content.map((block) => {
+        if (block.type === "toolCall") {
+            // Renombrado real: id/name/arguments → toolCallId/toolName/input.
+            return {
+                type: "toolCall",
+                toolCallId: block.id,
+                toolName: block.name,
+                input: (block.arguments ?? {}),
+            };
+        }
+        if (block.type === "thinking") {
+            return {
+                type: "thinking",
+                thinking: block.thinking ?? "",
+                ...(block.redacted !== undefined ? { redacted: Boolean(block.redacted) } : {}),
+            };
+        }
+        return { type: "text", text: block.text ?? "" };
+    });
+    const base = {
+        id: itemId(index),
+        role: "assistant",
+        content,
+        model: { provider: message.provider ?? "unknown", id: message.model ?? "unknown" },
+        ...(message.responseModel ? { responseModel: message.responseModel } : {}),
+        ...(toUsage(message.usage) ? { usage: toUsage(message.usage) } : {}),
+        timestamp: timestampOf(message.timestamp),
+    };
+    switch (message.stopReason) {
+        case "stop":
+        case "length":
+        case "toolUse":
+            return { ...base, status: "complete", stopReason: message.stopReason };
+        case "error":
+            return {
+                ...base,
+                status: "error",
+                stopReason: "error",
+                ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+            };
+        case "aborted":
+            return {
+                ...base,
+                status: "aborted",
+                stopReason: "aborted",
+                ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+            };
+        default:
+            // `pending` y `deferred`: el turno aún no ha cerrado. `deferred` no
+            // existe en el protocolo — tratarlo como streaming es lo único que no
+            // pierde el mensaje ni miente sobre su estado.
+            return { ...base, status: "streaming" };
+    }
+}
+function projectTool(message, index, input) {
+    const content = message.content.map((block) => block.type === "image"
+        ? { type: "image", data: block.data, mimeType: block.mimeType }
+        : { type: "text", text: block.text ?? "" });
+    const base = {
+        id: itemId(index),
+        role: "tool",
+        toolCallId: message.toolCallId,
+        toolName: message.toolName,
+        // El resultado NO trae los argumentos: vienen del ToolCall correlacionado.
+        input: (input ?? {}),
+        content,
+        ...(message.details !== undefined ? { details: message.details } : {}),
+        ...(toUsage(message.usage) ? { usage: toUsage(message.usage) } : {}),
+        timestamp: timestampOf(message.timestamp),
+    };
+    return message.isError
+        ? { ...base, status: "error", isError: true }
+        : { ...base, status: "complete", isError: false };
+}
+/**
+ * Proyecta el transcript completo.
+ *
+ * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo
+ * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna
+ * variante, se degrada a algo válido antes que desaparecer.
+ */
+export function projectTranscript(messages) {
+    // Primera pasada: índice de argumentos por toolCallId, para el punto 2.
+    const inputs = new Map();
+    for (const message of messages) {
+        if (message.role !== "assistant")
+            continue;
+        for (const block of message.content) {
+            if (block.type === "toolCall")
+                inputs.set(block.id, block.arguments ?? {});
+        }
+    }
+    const items = [];
+    messages.forEach((message, index) => {
+        if (message.role === "user")
+            items.push(projectUser(message, index));
+        else if (message.role === "assistant")
+            items.push(projectAssistant(message, index));
+        else if (message.role === "toolResult")
+            items.push(projectTool(message, index, inputs.get(message.toolCallId)));
+        // Sin `else`: cualquier rol desconocido se ignoraría en silencio. Se
+        // gestiona abajo para que el invariante siga siendo comprobable.
+        else {
+            items.push({
+                id: itemId(index),
+                role: "user",
+                content: [
+                    { type: "text", text: `[mensaje no reconocido: ${String(message.role)}]` },
+                ],
+                timestamp: timestampOf(message.timestamp),
+            });
+        }
+    });
+    return items;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/server/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/server/transcript.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Proyección de mensajes de sesión al transcript del protocolo.\n *\n * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no\n * casan es exactamente donde un turno puede desaparecer del transcript sin que\n * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no\n * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.\n *\n * Los tres desajustes reales:\n *\n * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo\n *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes\n *    propias, `pending` es streaming, y `deferred` — que no existe en el\n *    protocolo — se trata como streaming, porque semánticamente el turno\n *    todavía no ha terminado.\n *\n * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el\n *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el\n *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una\n *    dependencia entre mensajes, no una conversión local.\n *\n * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de\n *    forma estable a partir de la posición para que dos snapshots consecutivos\n *    del mismo transcript den los mismos ids.\n */\n\nimport type {\n\tAssistantMessage,\n\tMessage,\n\tUsage as SourceUsage,\n\tToolResultMessage,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tAssistantTranscriptItem,\n\tToolTranscriptItem,\n\tTranscriptItem,\n\tUsage,\n\tUserTranscriptItem,\n} from \"@earendil-works/pi-protocol\";\n\n/** Id estable por posición: el mismo transcript da siempre los mismos ids. */\nexport function itemId(index: number): string {\n\treturn `item-${index}`;\n}\n\nfunction toUsage(usage: SourceUsage | undefined): Usage | undefined {\n\tif (!usage) return undefined;\n\treturn {\n\t\tinput: Math.max(0, Math.trunc(usage.input ?? 0)),\n\t\toutput: Math.max(0, Math.trunc(usage.output ?? 0)),\n\t\tcacheRead: Math.max(0, Math.trunc(usage.cacheRead ?? 0)),\n\t\tcacheWrite: Math.max(0, Math.trunc(usage.cacheWrite ?? 0)),\n\t\t...(usage.reasoning !== undefined ? { reasoning: Math.max(0, Math.trunc(usage.reasoning)) } : {}),\n\t\ttotalTokens: Math.max(0, Math.trunc(usage.totalTokens ?? 0)),\n\t\tcost: {\n\t\t\tinput: usage.cost?.input ?? 0,\n\t\t\toutput: usage.cost?.output ?? 0,\n\t\t\tcacheRead: usage.cost?.cacheRead ?? 0,\n\t\t\tcacheWrite: usage.cost?.cacheWrite ?? 0,\n\t\t\ttotal: usage.cost?.total ?? 0,\n\t\t},\n\t};\n}\n\nfunction timestampOf(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;\n}\n\nfunction projectUser(message: UserMessage, index: number): UserTranscriptItem {\n\tconst content =\n\t\ttypeof message.content === \"string\"\n\t\t\t? [{ type: \"text\" as const, text: message.content }]\n\t\t\t: message.content.map((block) =>\n\t\t\t\t\tblock.type === \"image\"\n\t\t\t\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t\t\t\t);\n\treturn { id: itemId(index), role: \"user\", content, timestamp: timestampOf(message.timestamp) };\n}\n\nfunction projectAssistant(message: AssistantMessage, index: number): AssistantTranscriptItem {\n\tconst content = message.content.map((block) => {\n\t\tif (block.type === \"toolCall\") {\n\t\t\t// Renombrado real: id/name/arguments → toolCallId/toolName/input.\n\t\t\treturn {\n\t\t\t\ttype: \"toolCall\" as const,\n\t\t\t\ttoolCallId: block.id,\n\t\t\t\ttoolName: block.name,\n\t\t\t\tinput: (block.arguments ?? {}) as never,\n\t\t\t};\n\t\t}\n\t\tif (block.type === \"thinking\") {\n\t\t\treturn {\n\t\t\t\ttype: \"thinking\" as const,\n\t\t\t\tthinking: block.thinking ?? \"\",\n\t\t\t\t...(block.redacted !== undefined ? { redacted: Boolean(block.redacted) } : {}),\n\t\t\t};\n\t\t}\n\t\treturn { type: \"text\" as const, text: block.text ?? \"\" };\n\t});\n\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"assistant\" as const,\n\t\tcontent,\n\t\tmodel: { provider: message.provider ?? \"unknown\", id: message.model ?? \"unknown\" },\n\t\t...(message.responseModel ? { responseModel: message.responseModel } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\n\tswitch (message.stopReason) {\n\t\tcase \"stop\":\n\t\tcase \"length\":\n\t\tcase \"toolUse\":\n\t\t\treturn { ...base, status: \"complete\", stopReason: message.stopReason };\n\t\tcase \"error\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"error\",\n\t\t\t\tstopReason: \"error\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tcase \"aborted\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"aborted\",\n\t\t\t\tstopReason: \"aborted\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tdefault:\n\t\t\t// `pending` y `deferred`: el turno aún no ha cerrado. `deferred` no\n\t\t\t// existe en el protocolo — tratarlo como streaming es lo único que no\n\t\t\t// pierde el mensaje ni miente sobre su estado.\n\t\t\treturn { ...base, status: \"streaming\" };\n\t}\n}\n\nfunction projectTool(message: ToolResultMessage, index: number, input: unknown): ToolTranscriptItem {\n\tconst content = message.content.map((block) =>\n\t\tblock.type === \"image\"\n\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t);\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"tool\" as const,\n\t\ttoolCallId: message.toolCallId,\n\t\ttoolName: message.toolName,\n\t\t// El resultado NO trae los argumentos: vienen del ToolCall correlacionado.\n\t\tinput: (input ?? {}) as never,\n\t\tcontent,\n\t\t...(message.details !== undefined ? { details: message.details as never } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\treturn message.isError\n\t\t? { ...base, status: \"error\", isError: true }\n\t\t: { ...base, status: \"complete\", isError: false };\n}\n\n/**\n * Proyecta el transcript completo.\n *\n * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo\n * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna\n * variante, se degrada a algo válido antes que desaparecer.\n */\nexport function projectTranscript(messages: readonly Message[]): TranscriptItem[] {\n\t// Primera pasada: índice de argumentos por toolCallId, para el punto 2.\n\tconst inputs = new Map<string, unknown>();\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type === \"toolCall\") inputs.set(block.id, block.arguments ?? {});\n\t\t}\n\t}\n\n\tconst items: TranscriptItem[] = [];\n\tmessages.forEach((message, index) => {\n\t\tif (message.role === \"user\") items.push(projectUser(message, index));\n\t\telse if (message.role === \"assistant\") items.push(projectAssistant(message, index));\n\t\telse if (message.role === \"toolResult\") items.push(projectTool(message, index, inputs.get(message.toolCallId)));\n\t\t// Sin `else`: cualquier rol desconocido se ignoraría en silencio. Se\n\t\t// gestiona abajo para que el invariante siga siendo comprobable.\n\t\telse {\n\t\t\titems.push({\n\t\t\t\tid: itemId(index),\n\t\t\t\trole: \"user\",\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: \"text\", text: `[mensaje no reconocido: ${String((message as { role?: unknown }).role)}]` },\n\t\t\t\t],\n\t\t\t\ttimestamp: timestampOf((message as { timestamp?: unknown }).timestamp),\n\t\t\t});\n\t\t}\n\t});\n\treturn items;\n}\n"]}

package/dist/skills/ada-engine/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: ada-engine
+description: >
+  Orquestación autónoma: goal engine (objetivo de largo plazo con fases TDD y
+  juez con evidencia), workflows (deep-research, code-review, product-build,
+  codebase-audit, multi-perspective, scripts custom), grafo de trabajo
+  AUTÓNOMO. Cárgala SIEMPRE que el usuario pida: un objetivo grande o "goal",
+  investigación web profunda, revisión de código sistemática, construir un
+  producto con criterios, auditoría del repo, o análisis desde N perspectivas.
+  Si la tarea es una sola pasada (un fix, un script, responder algo), NO la
+  cargues — usa las tools normales.
+---
+
+# Ada Intelligence Engine — Opera SIN pensar
+
+Regla #1: **DECIDE tú, sin preguntar.** Si el usuario describe un objetivo,
+tú eliges goal, workflow o tools normales según el árbol de abajo, y ejecutas
+el procedimiento completo. Nunca respondas "¿quieres que lo haga con goal o
+workflow?" — ya lo decides tú.
+
+## Árbol de decisión (evalúa el pedido del usuario, elige el primero que aplique)
+
+```
+¿El usuario pide un OBJETIVO de largo plazo, iterativo, con criterios de éxito?
+   (ej: "arregla el login y verifícalo", "construye X", "mejora Y hasta que...")
+   → GOAL ENGINE. Ve a la Sección A.
+
+¿El usuario pide INVESTIGACIÓN / REVISIÓN / AUDITORÍA / ANÁLISIS MULTI-ÁNGULO?
+   (ej: "investiga Z", "revisa este código", "audita el repo", "compara A y B")
+   → WORKFLOW. Ve a la Sección B.
+
+¿El usuario pide UNA TAREA CONCRETA de una pasada?
+   (ej: "crea un script", "corrige este bug", "explica X", "escribe un test")
+   → TOOLS NORMALES. No hagas nada especial del engine.
+
+¿El usuario menciona "goal"/"workflow" EXPLÍCITAMENTE aunque la tarea parezca
+simple? → Respeta su elección y ve a la sección correspondiente.
+```
+
+## Sección A — GOAL (objetivo de largo plazo)
+
+### Procedimiento exacto (en este orden, sin saltarte pasos)
+
+1. **Crea el contrato** con la tool `goal_new`:
+   - `goal`: el objetivo verbatim del usuario.
+   - `doneCriteria`: 2-5 criterios **medibles y observables** (nunca vagos).
+     Si el usuario no los dio, **inventalos tú** a partir de su pedido.
+   - `verifyCommand`: comando de verificación si aplica (si no, "").
+2. **El goal queda en estado `setup`** — NO empieces a trabajar todavía.
+3. **Responde al usuario EXACTAMENTE con este formato** (corto, una línea):
+   ```
+   🎯 Goal creado: <id>
+   Criterios: <c1> · <c2> …
+   Apruebalo con: /goal approve <id>
+   ```
+   O si el usuario puede aprobar desde el panel: "Pulsa Approve en el panel Engine".
+4. **Cuando el goal esté aprobado** (estado `active`), el engine lanza un
+   **workflow dinámico por sub-tarea** (uno a la vez). El goal es el
+   CONTENEDOR — los pasos viven en los workflows. Tu trabajo:
+   - Si el plan (sub-tareas) está vacío: **divídelo tú** con la tool `todo`/
+     planificación — cada sub-tarea es UN paso concreto y verificable.
+   - El engine lanza el workflow de cada sub-tarea automáticamente; NO lo
+     lances tú a mano.
+   - Escribe código, corre tests, edita archivos. **El grafo se registra
+     SOLO** — no hagas nada para el grafo.
+5. **Cuando todas las sub-tareas estén done**, el juez evalúa los criterios.
+   Solo si emite `done`, el goal se completa. Nunca completes sin evidencia
+   real (archivo:línea, URL o salida de comando).
+
+### Cómo responder durante el goal (sin sobre-explicar)
+
+- Al completar una sub-tarea: `✓ <sub-tarea> — <1 línea de qué se hizo>`
+- Si algo bloquea: usa `goal_blocked` con el motivo y dile al usuario qué
+  necesitas.
+- Si una decisión necesita al usuario: `ask_user_question` (no adivines
+  criterios irreversibles como borrar datos o gastar dinero).
+
+## Sección B — WORKFLOW (investigación/revisión/auditoría)
+
+### Elegir el workflow (sin preguntar, según el pedido)
+
+| El usuario pide… | Lanzas… |
+|---|---|
+| Investigar algo con fuentes | `workflow run deep_research question="..."` |
+| Revisar código | `workflow run code_review` |
+| Construir un producto con criterios | `workflow run product_build brief="..."` |
+| Auditar el repo | `workflow run codebase_audit` |
+| Analizar desde N perspectivas | `workflow run multi_perspective problem="..."` |
+| Un flujo custom tuyo/guardado | `workflow run <nombre_script>` |
+
+### Procedimiento exacto
+
+1. Llama la tool `workflow` con `command: "run"` y el `name` + args.
+2. **La confirmación de coste es automática** (fail-closed 15s). No la
+   simules — el sistema la maneja. Si se confirma, el run arranca.
+3. **Responde al usuario EXACTAMENTE**:
+   ```
+   ⚡ Workflow lanzado: <name> (<runId>)
+   Fases: <f1> → <f2> → …
+   Sigue el progreso en el panel Engine o con /workflow status <runId>
+   ```
+4. Durante el run no bloquees esperando — el run es en background. Si el
+   usuario pregunta, usa `workflow status <runId>` y reporta fase actual,
+   agentes, tokens y coste.
+
+## Sección C — TOOLS NORMALES (una pasada)
+
+No cargues nada del engine. Haz la tarea con las tools normales
+(write/edit/bash/read). El grafo se registra solo si escribes archivos — no
+hagas nada especial. Responde normal.
+
+## Comportamiento global (aplica siempre)
+
+1. **Decide y ejecuta** — nunca preguntes "¿goal o workflow?".
+2. **Responde corto**: una línea de estado + el siguiente paso que el usuario
+   debe dar (si lo hay). No expliques el engine.
+3. **No registres el grafo manualmente** — es automático (escribir archivo →
+   ARTIFACT + implemented_by; test que pasa → verified_by; goal → spine).
+4. **Solo usa `graph_add_nodes`** cuando estés haciendo una auditoría y
+   quieras marcar `QA_FINDING`/`RISK`/`DECISION` concretos con su contexto.
+5. **Respeta los frenos**: si el bucle del goal se repite (3 turnos iguales),
+   pausa con `goal_blocked`/`goal_wait` y pide claridad. No fuerces.
+6. **Evidencia antes de done**: nunca declares un goal completado sin
+   `archivo:línea`/URL/comando que lo pruebe.
+
+## Referencia rápida (no la repitas al usuario)
+
+- **Modelo**: el goal es un CONTENEDOR; cada sub-tarea lanza un workflow
+  dinámico (goal_subtask). Cuando todas las sub-tareas done → juez → done.
+- **Tools del goal**: `goal_new` (crear contrato), `goal_complete` (cerrar con
+  evidencia), `goal_blocked`, `goal_wait`, `todo` (ver/crear sub-tareas),
+  `ask_user_question`.
+- **Tool `workflow`**: run/list/status/abort. Args: question=, brief=, problem=,
+  verifyCommand=, k=v custom.
+- **Scripts custom**: `~/.ada/agent/workflows/<nombre>.js` — se lanzan con
+  `workflow run <nombre>`. Cualquier JS con la API agent/parallel/pipeline/
+  phase/store/checkpoint/args/cwd/runId/log.
+- **Modelo**: los subagentes HEREDAN el modelo de la sesión principal por
+  defecto (misma auth → misma API key del chat). Los tiers cheap/main/judge
+  configuran overrides.
+- **Grafo**: autónomo (GraphSync). Consultas: `/graph gaps|context|search|gate`.
+- **Modelos**: tiers cheap/main/judge configurables; jueces intermedios baratos.
+
+## Prohibido
+
+- ✗ Responder "¿goal o workflow?" — decide tú.
+- ✗ Completar un goal sin evidencia citada.
+- ✗ Registrar el grafo manualmente (FILE/TASK) — automático.
+- ✗ Lanzar un workflow sin confirmación de coste (el sistema la pide; no la
+  eludas inventando resultados).
+- ✗ Crear goals o workflows desde un subagente — solo la sesión principal.
+- ✗ Inventar fuentes en deep_research — cada claim necesita ≥2 fuentes reales.
+- ✗ Consenso falso en multi_perspective — señala desacuerdos.

package/dist/skills/skill-creator/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: skill-creator
+description: Use when the user asks to create, write or package a new Ada skill. Covers the SKILL.md layout, the frontmatter limits Ada's loader actually enforces, where to place the file so it is discovered, and the two Ada-specific rules a skill must never break.
+---
+
+# Crear una skill de Ada
+
+Una skill es un fichero `SKILL.md` con frontmatter YAML. Ada las carga bajo
+demanda: el modelo ve el `name` y la `description` siempre, y el cuerpo solo
+cuando la invoca.
+
+## Límites que el loader impone de verdad
+
+Estos números salen de `src/core/skills.ts`, no de la especificación genérica.
+Pasarse hace que la skill se rechace con un diagnóstico que el usuario
+normalmente no ve:
+
+| Campo | Límite | Regla |
+|---|---|---|
+| `name` | 64 caracteres | **Debe coincidir con el nombre del directorio.** `skills/mi-skill/SKILL.md` → `name: mi-skill` |
+| `description` | 1024 caracteres | Es lo único que el modelo lee para decidir si la invoca |
+
+## Dónde ponerla
+
+| Ruta | Alcance |
+|---|---|
+| `.ada/agent/skills/<nombre>/SKILL.md` | Solo este proyecto (gana sobre la global) |
+| `~/.ada/agent/skills/<nombre>/SKILL.md` | Todos los proyectos |
+| `~/.agents/skills/<nombre>/SKILL.md` | Compartida con otros agentes compatibles |
+
+Precedencia: proyecto → global → paquete → builtin. Una skill de proyecto con el
+mismo nombre que una builtin la sustituye.
+
+## Escribir la descripción
+
+Es la parte que más se falla. La `description` no describe la skill: describe
+**cuándo usarla**. El modelo la lee sin haber leído el cuerpo.
+
+Mal: `Herramienta para bases de datos.`
+Bien: `Use when reviewing database migrations: checks for missing rollbacks, non-concurrent index creation, and locking DDL on large tables.`
+
+## Dos reglas que una skill de Ada NO debe romper
+
+Esto es lo específico de Ada, y no está en ningún otro sitio:
+
+1. **Nunca instruyas a un subagente para que llame a `goal_*`, `workflow` o
+   `graph_add_nodes`.** No es una convención: esas tools no existen en el
+   registro de un subagente, así que la instrucción fallaría. La orquestación
+   vive solo en la sesión principal, a propósito.
+
+2. **Nunca declares algo como hecho sin una cita `fichero:línea`.** El juez del
+   goal y los gates del grafo exigen evidencia observada. Una skill que enseñe
+   al modelo a afirmar "ya está arreglado" sin cita está enseñándole a saltarse
+   la propiedad central del producto.
+
+## Plantilla
+
+```markdown
+---
+name: revisar-migraciones
+description: Use when reviewing database migration files, before merging schema changes, or when the user mentions Alembic/Flyway/Prisma migrations. Checks rollback coverage, index concurrency and locking DDL.
+---
+
+# Revisar migraciones
+
+## Cuándo aplica
+Ficheros bajo `migrations/`, `alembic/versions/` o `prisma/migrations/`.
+
+## Pasos
+1. Comprueba que cada `up` tiene su `down`. Cita `fichero:línea` de los que no.
+2. Marca los `CREATE INDEX` sin `CONCURRENTLY` sobre tablas de >1M filas.
+3. Marca el DDL que toma un lock exclusivo en horario de producción.
+
+## Salida
+Una lista por severidad, cada hallazgo con su cita `fichero:línea`. Si no hay
+hallazgos, dilo — no rellenes.
+```
+
+## Empaquetar un workflow ya ejecutado
+
+Si lo que quieres reutilizar es un *procedimiento* que ya corrió, no escribas
+una skill: guarda el run.
+
+```
+workflow save-as-skill <runId> <nombre>
+```
+
+Eso guarda el script que **se ejecutó de verdad**, con su procedencia (runId,
+args, resultado) en la cabecera. Solo acepta runs completados. Es más fiable que
+una skill escrita a mano describiendo lo que uno cree que hizo.

package/dist/telegram/api.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Cliente de la Bot API de Telegram. Sin dependencias.
+ *
+ * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`
+ * por la misma razón que el resto del producto evita dependencias: es un CLI
+ * que se instala en máquinas ajenas, y cada paquete añadido es superficie de
+ * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio
+ * cabe en un fichero.
+ *
+ * El long polling es la única forma sensata aquí: un webhook exigiría exponer un
+ * puerto público desde el portátil de alguien.
+ */
+export interface TelegramUser {
+    id: number;
+    is_bot?: boolean;
+    username?: string;
+    first_name?: string;
+}
+export interface TelegramMessage {
+    message_id: number;
+    from?: TelegramUser;
+    chat: {
+        id: number;
+        type: string;
+    };
+    text?: string;
+    date: number;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    callback_query?: {
+        id: string;
+        from: TelegramUser;
+        data?: string;
+        message?: TelegramMessage;
+    };
+}
+export interface ApiOptions {
+    token: string;
+    fetchImpl?: typeof fetch;
+    /** Segundos que el servidor retiene la petición sin novedades. */
+    longPollSeconds?: number;
+}
+export declare class TelegramApiError extends Error {
+    method: string;
+    status: number;
+    description: string;
+    /** Segundos que Telegram pide esperar (429). */
+    retryAfter?: number;
+    constructor(method: string, status: number, description: string, retryAfter?: number);
+}
+export declare class TelegramApi {
+    private token;
+    private fetchImpl;
+    private longPollSeconds;
+    constructor(options: ApiOptions);
+    private call;
+    /** Identidad del bot. Sirve para validar el token antes de hacer nada. */
+    getMe(signal?: AbortSignal): Promise<TelegramUser>;
+    /**
+     * Long poll. `offset` confirma como recibidas todas las actualizaciones
+     * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.
+     */
+    getUpdates(offset: number, signal?: AbortSignal): Promise<TelegramUpdate[]>;
+    sendMessage(chatId: number, text: string, options?: {
+        replyTo?: number;
+    }): Promise<TelegramMessage>;
+    editMessage(chatId: number, messageId: number, text: string): Promise<unknown>;
+    /** Indicador de "escribiendo…". Caduca solo a los ~5 s. */
+    sendTyping(chatId: number): Promise<unknown>;
+}
+/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */
+export declare function splitForTelegram(text: string, limit?: number): string[];
+//# sourceMappingURL=api.d.ts.map

package/dist/telegram/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/telegram/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC;CAC9F;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,mEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAOnF;CACD;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,OAAO,EAAE,UAAU,EAI9B;YAQa,IAAI;IAwBlB,0EAA0E;IAC1E,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAEjD;IAED;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAM1E;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAStG;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;IAED,6DAA2D;IAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3C;CACD;AAED,4EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,MAAM,EAAE,CAcrE","sourcesContent":["/**\n * Cliente de la Bot API de Telegram. Sin dependencias.\n *\n * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`\n * por la misma razón que el resto del producto evita dependencias: es un CLI\n * que se instala en máquinas ajenas, y cada paquete añadido es superficie de\n * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio\n * cabe en un fichero.\n *\n * El long polling es la única forma sensata aquí: un webhook exigiría exponer un\n * puerto público desde el portátil de alguien.\n */\n\nconst BASE = \"https://api.telegram.org\";\n\nexport interface TelegramUser {\n\tid: number;\n\tis_bot?: boolean;\n\tusername?: string;\n\tfirst_name?: string;\n}\n\nexport interface TelegramMessage {\n\tmessage_id: number;\n\tfrom?: TelegramUser;\n\tchat: { id: number; type: string };\n\ttext?: string;\n\tdate: number;\n}\n\nexport interface TelegramUpdate {\n\tupdate_id: number;\n\tmessage?: TelegramMessage;\n\tcallback_query?: { id: string; from: TelegramUser; data?: string; message?: TelegramMessage };\n}\n\nexport interface ApiOptions {\n\ttoken: string;\n\tfetchImpl?: typeof fetch;\n\t/** Segundos que el servidor retiene la petición sin novedades. */\n\tlongPollSeconds?: number;\n}\n\nexport class TelegramApiError extends Error {\n\tmethod: string;\n\tstatus: number;\n\tdescription: string;\n\t/** Segundos que Telegram pide esperar (429). */\n\tretryAfter?: number;\n\n\tconstructor(method: string, status: number, description: string, retryAfter?: number) {\n\t\tsuper(`${method}: ${description} (HTTP ${status})`);\n\t\tthis.name = \"TelegramApiError\";\n\t\tthis.method = method;\n\t\tthis.status = status;\n\t\tthis.description = description;\n\t\tthis.retryAfter = retryAfter;\n\t}\n}\n\nexport class TelegramApi {\n\tprivate token: string;\n\tprivate fetchImpl: typeof fetch;\n\tprivate longPollSeconds: number;\n\n\tconstructor(options: ApiOptions) {\n\t\tthis.token = options.token;\n\t\tthis.fetchImpl = options.fetchImpl ?? fetch;\n\t\tthis.longPollSeconds = options.longPollSeconds ?? 25;\n\t}\n\n\t/**\n\t * Llama a un método de la Bot API.\n\t *\n\t * El token va en la URL porque así lo define Telegram; por eso `toString()`\n\t * de esta clase y cualquier traza deben evitar imprimir la URL entera.\n\t */\n\tprivate async call<T>(method: string, params: Record<string, unknown>, signal?: AbortSignal): Promise<T> {\n\t\tconst response = await this.fetchImpl(`${BASE}/bot${this.token}/${method}`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(params),\n\t\t\tsignal,\n\t\t});\n\t\tconst body = (await response.json().catch(() => ({}))) as {\n\t\t\tok?: boolean;\n\t\t\tresult?: T;\n\t\t\tdescription?: string;\n\t\t\tparameters?: { retry_after?: number };\n\t\t};\n\t\tif (!response.ok || !body.ok) {\n\t\t\tthrow new TelegramApiError(\n\t\t\t\tmethod,\n\t\t\t\tresponse.status,\n\t\t\t\tbody.description ?? \"sin descripción\",\n\t\t\t\tbody.parameters?.retry_after,\n\t\t\t);\n\t\t}\n\t\treturn body.result as T;\n\t}\n\n\t/** Identidad del bot. Sirve para validar el token antes de hacer nada. */\n\tgetMe(signal?: AbortSignal): Promise<TelegramUser> {\n\t\treturn this.call<TelegramUser>(\"getMe\", {}, signal);\n\t}\n\n\t/**\n\t * Long poll. `offset` confirma como recibidas todas las actualizaciones\n\t * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.\n\t */\n\tgetUpdates(offset: number, signal?: AbortSignal): Promise<TelegramUpdate[]> {\n\t\treturn this.call<TelegramUpdate[]>(\n\t\t\t\"getUpdates\",\n\t\t\t{ offset, timeout: this.longPollSeconds, allowed_updates: [\"message\", \"callback_query\"] },\n\t\t\tsignal,\n\t\t);\n\t}\n\n\tsendMessage(chatId: number, text: string, options: { replyTo?: number } = {}): Promise<TelegramMessage> {\n\t\treturn this.call<TelegramMessage>(\"sendMessage\", {\n\t\t\tchat_id: chatId,\n\t\t\ttext,\n\t\t\t// Sin parse_mode: el texto del agente puede contener Markdown roto o\n\t\t\t// caracteres que Telegram rechazaría, y un 400 por formato perdería el\n\t\t\t// mensaje entero. Texto plano siempre llega.\n\t\t\t...(options.replyTo ? { reply_to_message_id: options.replyTo } : {}),\n\t\t});\n\t}\n\n\teditMessage(chatId: number, messageId: number, text: string): Promise<unknown> {\n\t\treturn this.call(\"editMessageText\", { chat_id: chatId, message_id: messageId, text });\n\t}\n\n\t/** Indicador de \"escribiendo…\". Caduca solo a los ~5 s. */\n\tsendTyping(chatId: number): Promise<unknown> {\n\t\treturn this.call(\"sendChatAction\", { chat_id: chatId, action: \"typing\" }).catch(() => undefined);\n\t}\n}\n\n/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */\nexport function splitForTelegram(text: string, limit = 4000): string[] {\n\tif (text.length <= limit) return [text];\n\tconst partes: string[] = [];\n\tlet resto = text;\n\twhile (resto.length > limit) {\n\t\t// Se corta en el último salto de línea que quepa para no partir una\n\t\t// palabra ni un bloque de código por la mitad.\n\t\tconst corte = resto.lastIndexOf(\"\\n\", limit);\n\t\tconst en = corte > limit * 0.5 ? corte : limit;\n\t\tpartes.push(resto.slice(0, en));\n\t\tresto = resto.slice(en).replace(/^\\n/, \"\");\n\t}\n\tif (resto) partes.push(resto);\n\treturn partes;\n}\n"]}

package/dist/telegram/api.js

@@ -0,0 +1,104 @@
+/**
+ * Cliente de la Bot API de Telegram. Sin dependencias.
+ *
+ * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`
+ * por la misma razón que el resto del producto evita dependencias: es un CLI
+ * que se instala en máquinas ajenas, y cada paquete añadido es superficie de
+ * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio
+ * cabe en un fichero.
+ *
+ * El long polling es la única forma sensata aquí: un webhook exigiría exponer un
+ * puerto público desde el portátil de alguien.
+ */
+const BASE = "https://api.telegram.org";
+export class TelegramApiError extends Error {
+    method;
+    status;
+    description;
+    /** Segundos que Telegram pide esperar (429). */
+    retryAfter;
+    constructor(method, status, description, retryAfter) {
+        super(`${method}: ${description} (HTTP ${status})`);
+        this.name = "TelegramApiError";
+        this.method = method;
+        this.status = status;
+        this.description = description;
+        this.retryAfter = retryAfter;
+    }
+}
+export class TelegramApi {
+    token;
+    fetchImpl;
+    longPollSeconds;
+    constructor(options) {
+        this.token = options.token;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.longPollSeconds = options.longPollSeconds ?? 25;
+    }
+    /**
+     * Llama a un método de la Bot API.
+     *
+     * El token va en la URL porque así lo define Telegram; por eso `toString()`
+     * de esta clase y cualquier traza deben evitar imprimir la URL entera.
+     */
+    async call(method, params, signal) {
+        const response = await this.fetchImpl(`${BASE}/bot${this.token}/${method}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(params),
+            signal,
+        });
+        const body = (await response.json().catch(() => ({})));
+        if (!response.ok || !body.ok) {
+            throw new TelegramApiError(method, response.status, body.description ?? "sin descripción", body.parameters?.retry_after);
+        }
+        return body.result;
+    }
+    /** Identidad del bot. Sirve para validar el token antes de hacer nada. */
+    getMe(signal) {
+        return this.call("getMe", {}, signal);
+    }
+    /**
+     * Long poll. `offset` confirma como recibidas todas las actualizaciones
+     * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.
+     */
+    getUpdates(offset, signal) {
+        return this.call("getUpdates", { offset, timeout: this.longPollSeconds, allowed_updates: ["message", "callback_query"] }, signal);
+    }
+    sendMessage(chatId, text, options = {}) {
+        return this.call("sendMessage", {
+            chat_id: chatId,
+            text,
+            // Sin parse_mode: el texto del agente puede contener Markdown roto o
+            // caracteres que Telegram rechazaría, y un 400 por formato perdería el
+            // mensaje entero. Texto plano siempre llega.
+            ...(options.replyTo ? { reply_to_message_id: options.replyTo } : {}),
+        });
+    }
+    editMessage(chatId, messageId, text) {
+        return this.call("editMessageText", { chat_id: chatId, message_id: messageId, text });
+    }
+    /** Indicador de "escribiendo…". Caduca solo a los ~5 s. */
+    sendTyping(chatId) {
+        return this.call("sendChatAction", { chat_id: chatId, action: "typing" }).catch(() => undefined);
+    }
+}
+/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */
+export function splitForTelegram(text, limit = 4000) {
+    if (text.length <= limit)
+        return [text];
+    const partes = [];
+    let resto = text;
+    while (resto.length > limit) {
+        // Se corta en el último salto de línea que quepa para no partir una
+        // palabra ni un bloque de código por la mitad.
+        const corte = resto.lastIndexOf("\n", limit);
+        const en = corte > limit * 0.5 ? corte : limit;
+        partes.push(resto.slice(0, en));
+        resto = resto.slice(en).replace(/^\n/, "");
+    }
+    if (resto)
+        partes.push(resto);
+    return partes;
+}
+//# sourceMappingURL=api.js.map