@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/workflows/save-as-skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `workflow save-as-skill` — empaqueta un run YA EJECUTADO como algo
+ * re-ejecutable por nombre.
+ *
+ * Todo el sustrato existía y nadie escribía en él: `PersistedRunState` guarda el
+ * script del run, sus args, fases y journal; `resolveWorkflowScriptByName` ya
+ * resuelve `<agentDir>/workflows/<name>.js` como script de usuario de primera
+ * clase. Solo faltaba el comando que uniera las dos cosas.
+ *
+ * Es estrictamente mejor que las "skills" auto-generadas de otros harnesses,
+ * que son descripciones que el modelo *cree* haber seguido: aquí el script
+ * guardado se ejecutó de verdad, y su procedencia (runId, args, resultado) queda
+ * en la cabecera.
+ */
+import type { PersistedRunState } from "./journal.ts";
+export interface SaveAsSkillResult {
+    ok: boolean;
+    error?: string;
+    filePath?: string;
+    name?: string;
+}
+export declare function saveRunAsSkill(options: {
+    agentDir: string;
+    name: string;
+    run: PersistedRunState;
+}): Promise<SaveAsSkillResult>;
+//# sourceMappingURL=save-as-skill.d.ts.map

package/dist/core/workflows/save-as-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-as-skill.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/save-as-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,iBAAiB,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsC7B","sourcesContent":["/**\n * `workflow save-as-skill` — empaqueta un run YA EJECUTADO como algo\n * re-ejecutable por nombre.\n *\n * Todo el sustrato existía y nadie escribía en él: `PersistedRunState` guarda el\n * script del run, sus args, fases y journal; `resolveWorkflowScriptByName` ya\n * resuelve `<agentDir>/workflows/<name>.js` como script de usuario de primera\n * clase. Solo faltaba el comando que uniera las dos cosas.\n *\n * Es estrictamente mejor que las \"skills\" auto-generadas de otros harnesses,\n * que son descripciones que el modelo *cree* haber seguido: aquí el script\n * guardado se ejecutó de verdad, y su procedencia (runId, args, resultado) queda\n * en la cabecera.\n */\n\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { PersistedRunState } from \"./journal.ts\";\nimport { resolveBuiltinWorkflowScript } from \"./resolve-script.ts\";\n\nexport interface SaveAsSkillResult {\n\tok: boolean;\n\terror?: string;\n\tfilePath?: string;\n\tname?: string;\n}\n\n/** Nombres válidos de fichero: sin rutas ni sorpresas. */\nconst VALID_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\n\nexport async function saveRunAsSkill(options: {\n\tagentDir: string;\n\tname: string;\n\trun: PersistedRunState;\n}): Promise<SaveAsSkillResult> {\n\tconst { agentDir, name, run } = options;\n\n\tif (!VALID_NAME.test(name)) {\n\t\treturn { ok: false, error: `Nombre inválido '${name}': usa letras, números, guion y guion bajo.` };\n\t}\n\n\t// Evidence gate: no se empaqueta un run que no llegó a terminar bien. Un\n\t// script \"reutilizable\" que nunca funcionó es peor que no tenerlo.\n\tif (run.status !== \"completed\") {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `El run ${run.runId} está en estado '${run.status}'. Solo se empaquetan runs completados (evidence gate).`,\n\t\t};\n\t}\n\n\t// Los builtins se resuelven ANTES que los scripts de usuario, así que\n\t// guardar con un nombre reservado crearía un fichero inalcanzable en\n\t// silencio. Mejor rechazarlo en el momento de guardar.\n\tif (resolveBuiltinWorkflowScript(name)) {\n\t\treturn { ok: false, error: `'${name}' es un workflow builtin. Elige otro nombre.` };\n\t}\n\n\t// Solo se guarda `run.script`: vino de un builtin o de un script de usuario\n\t// ya confiado. Nunca JS escrito por el modelo en caliente.\n\tconst header = [\n\t\t\"// Guardado por `workflow save-as-skill`.\",\n\t\t`// Procedencia: run ${run.runId} (${run.name}), completado ${run.updatedAt}.`,\n\t\t`// Args de aquella ejecución: ${JSON.stringify(run.args ?? {})}`,\n\t\trun.resultPath ? `// Resultado: ${run.resultPath}` : \"// Resultado: (no persistido)\",\n\t\t\"\",\n\t].join(\"\\n\");\n\n\tconst dir = join(agentDir, \"workflows\");\n\tawait mkdir(dir, { recursive: true });\n\tconst filePath = join(dir, `${name}.js`);\n\tawait writeFile(filePath, header + run.script, \"utf-8\");\n\treturn { ok: true, filePath, name };\n}\n"]}

package/dist/core/workflows/save-as-skill.js

@@ -0,0 +1,54 @@
+/**
+ * `workflow save-as-skill` — empaqueta un run YA EJECUTADO como algo
+ * re-ejecutable por nombre.
+ *
+ * Todo el sustrato existía y nadie escribía en él: `PersistedRunState` guarda el
+ * script del run, sus args, fases y journal; `resolveWorkflowScriptByName` ya
+ * resuelve `<agentDir>/workflows/<name>.js` como script de usuario de primera
+ * clase. Solo faltaba el comando que uniera las dos cosas.
+ *
+ * Es estrictamente mejor que las "skills" auto-generadas de otros harnesses,
+ * que son descripciones que el modelo *cree* haber seguido: aquí el script
+ * guardado se ejecutó de verdad, y su procedencia (runId, args, resultado) queda
+ * en la cabecera.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { resolveBuiltinWorkflowScript } from "./resolve-script.js";
+/** Nombres válidos de fichero: sin rutas ni sorpresas. */
+const VALID_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/i;
+export async function saveRunAsSkill(options) {
+    const { agentDir, name, run } = options;
+    if (!VALID_NAME.test(name)) {
+        return { ok: false, error: `Nombre inválido '${name}': usa letras, números, guion y guion bajo.` };
+    }
+    // Evidence gate: no se empaqueta un run que no llegó a terminar bien. Un
+    // script "reutilizable" que nunca funcionó es peor que no tenerlo.
+    if (run.status !== "completed") {
+        return {
+            ok: false,
+            error: `El run ${run.runId} está en estado '${run.status}'. Solo se empaquetan runs completados (evidence gate).`,
+        };
+    }
+    // Los builtins se resuelven ANTES que los scripts de usuario, así que
+    // guardar con un nombre reservado crearía un fichero inalcanzable en
+    // silencio. Mejor rechazarlo en el momento de guardar.
+    if (resolveBuiltinWorkflowScript(name)) {
+        return { ok: false, error: `'${name}' es un workflow builtin. Elige otro nombre.` };
+    }
+    // Solo se guarda `run.script`: vino de un builtin o de un script de usuario
+    // ya confiado. Nunca JS escrito por el modelo en caliente.
+    const header = [
+        "// Guardado por `workflow save-as-skill`.",
+        `// Procedencia: run ${run.runId} (${run.name}), completado ${run.updatedAt}.`,
+        `// Args de aquella ejecución: ${JSON.stringify(run.args ?? {})}`,
+        run.resultPath ? `// Resultado: ${run.resultPath}` : "// Resultado: (no persistido)",
+        "",
+    ].join("\n");
+    const dir = join(agentDir, "workflows");
+    await mkdir(dir, { recursive: true });
+    const filePath = join(dir, `${name}.js`);
+    await writeFile(filePath, header + run.script, "utf-8");
+    return { ok: true, filePath, name };
+}
+//# sourceMappingURL=save-as-skill.js.map

package/dist/core/workflows/save-as-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-as-skill.js","sourceRoot":"","sources":["../../../src/core/workflows/save-as-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AASnE,2DAA0D;AAC1D,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAIpC,EAA8B;IAC9B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAExC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAoB,IAAI,8CAA6C,EAAE,CAAC;IACpG,CAAC;IAED,0EAAyE;IACzE,oEAAmE;IACnE,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO;YACN,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,UAAU,GAAG,CAAC,KAAK,qBAAoB,GAAG,CAAC,MAAM,yDAAyD;SACjH,CAAC;IACH,CAAC;IAED,uEAAsE;IACtE,sEAAqE;IACrE,uDAAuD;IACvD,IAAI,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,8CAA8C,EAAE,CAAC;IACrF,CAAC;IAED,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,MAAM,GAAG;QACd,2CAA2C;QAC3C,uBAAuB,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,SAAS,GAAG;QAC9E,kCAAiC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;QACjE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,+BAA+B;QACpF,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAAA,CACpC","sourcesContent":["/**\n * `workflow save-as-skill` — empaqueta un run YA EJECUTADO como algo\n * re-ejecutable por nombre.\n *\n * Todo el sustrato existía y nadie escribía en él: `PersistedRunState` guarda el\n * script del run, sus args, fases y journal; `resolveWorkflowScriptByName` ya\n * resuelve `<agentDir>/workflows/<name>.js` como script de usuario de primera\n * clase. Solo faltaba el comando que uniera las dos cosas.\n *\n * Es estrictamente mejor que las \"skills\" auto-generadas de otros harnesses,\n * que son descripciones que el modelo *cree* haber seguido: aquí el script\n * guardado se ejecutó de verdad, y su procedencia (runId, args, resultado) queda\n * en la cabecera.\n */\n\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { PersistedRunState } from \"./journal.ts\";\nimport { resolveBuiltinWorkflowScript } from \"./resolve-script.ts\";\n\nexport interface SaveAsSkillResult {\n\tok: boolean;\n\terror?: string;\n\tfilePath?: string;\n\tname?: string;\n}\n\n/** Nombres válidos de fichero: sin rutas ni sorpresas. */\nconst VALID_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\n\nexport async function saveRunAsSkill(options: {\n\tagentDir: string;\n\tname: string;\n\trun: PersistedRunState;\n}): Promise<SaveAsSkillResult> {\n\tconst { agentDir, name, run } = options;\n\n\tif (!VALID_NAME.test(name)) {\n\t\treturn { ok: false, error: `Nombre inválido '${name}': usa letras, números, guion y guion bajo.` };\n\t}\n\n\t// Evidence gate: no se empaqueta un run que no llegó a terminar bien. Un\n\t// script \"reutilizable\" que nunca funcionó es peor que no tenerlo.\n\tif (run.status !== \"completed\") {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `El run ${run.runId} está en estado '${run.status}'. Solo se empaquetan runs completados (evidence gate).`,\n\t\t};\n\t}\n\n\t// Los builtins se resuelven ANTES que los scripts de usuario, así que\n\t// guardar con un nombre reservado crearía un fichero inalcanzable en\n\t// silencio. Mejor rechazarlo en el momento de guardar.\n\tif (resolveBuiltinWorkflowScript(name)) {\n\t\treturn { ok: false, error: `'${name}' es un workflow builtin. Elige otro nombre.` };\n\t}\n\n\t// Solo se guarda `run.script`: vino de un builtin o de un script de usuario\n\t// ya confiado. Nunca JS escrito por el modelo en caliente.\n\tconst header = [\n\t\t\"// Guardado por `workflow save-as-skill`.\",\n\t\t`// Procedencia: run ${run.runId} (${run.name}), completado ${run.updatedAt}.`,\n\t\t`// Args de aquella ejecución: ${JSON.stringify(run.args ?? {})}`,\n\t\trun.resultPath ? `// Resultado: ${run.resultPath}` : \"// Resultado: (no persistido)\",\n\t\t\"\",\n\t].join(\"\\n\");\n\n\tconst dir = join(agentDir, \"workflows\");\n\tawait mkdir(dir, { recursive: true });\n\tconst filePath = join(dir, `${name}.js`);\n\tawait writeFile(filePath, header + run.script, \"utf-8\");\n\treturn { ok: true, filePath, name };\n}\n"]}

package/dist/core/workflows/shared-store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SharedStore — KV en memoria compartido entre los subagentes de un run.
+ *
+ * Cada agente escribe deltas (`trackPut` con deltaKey `${runId}:${callIndex}`)
+ * que se journalizan; en resume se re-aplican en orden callSeq. Los valores
+ * previos se shadowean para rollback de retries fallidos (patrón
+ * pi-dynamic-workflows).
+ */
+export declare class SharedStore {
+    private readonly map;
+    private readonly agentDeltas;
+    private readonly priorValues;
+    put(key: string, value: unknown): void;
+    get<T = unknown>(key: string): T | undefined;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    entries(): Array<[string, unknown]>;
+    /**
+     * Escribe y registra el delta para `deltaKey` (run-unique).
+     * Shadowea el valor previo solo la primera vez dentro de la ventana.
+     */
+    trackPut(key: string, value: unknown, deltaKey: string): void;
+    /** Delta consolidado para journalizar (el agente terminó). */
+    commitDelta(deltaKey: string): Record<string, unknown>;
+    /** Rollback de las escrituras de un retry fallido. */
+    discardDelta(deltaKey: string): void;
+    /** Replay aditivo de deltas en orden callSeq (resume). */
+    applyDelta(delta: Record<string, unknown>): void;
+    get size(): number;
+}
+//# sourceMappingURL=shared-store.d.ts.map

package/dist/core/workflows/shared-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-store.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/shared-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwE;IAEpG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAErC;IAED,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE3C;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExB;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3B;IAED,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAElC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAmB5D;IAED,+DAA8D;IAC9D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKrD;IAED,sDAAsD;IACtD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUnC;IAED,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAI/C;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD","sourcesContent":["/**\n * SharedStore — KV en memoria compartido entre los subagentes de un run.\n *\n * Cada agente escribe deltas (`trackPut` con deltaKey `${runId}:${callIndex}`)\n * que se journalizan; en resume se re-aplican en orden callSeq. Los valores\n * previos se shadowean para rollback de retries fallidos (patrón\n * pi-dynamic-workflows).\n */\n\nexport class SharedStore {\n\tprivate readonly map = new Map<string, unknown>();\n\tprivate readonly agentDeltas = new Map<string, Record<string, unknown>>();\n\tprivate readonly priorValues = new Map<string, Map<string, { existed: boolean; value: unknown }>>();\n\n\tput(key: string, value: unknown): void {\n\t\tthis.map.set(key, value);\n\t}\n\n\tget<T = unknown>(key: string): T | undefined {\n\t\treturn this.map.get(key) as T | undefined;\n\t}\n\n\thas(key: string): boolean {\n\t\treturn this.map.has(key);\n\t}\n\n\tdelete(key: string): boolean {\n\t\treturn this.map.delete(key);\n\t}\n\n\tentries(): Array<[string, unknown]> {\n\t\treturn [...this.map.entries()];\n\t}\n\n\t/**\n\t * Escribe y registra el delta para `deltaKey` (run-unique).\n\t * Shadowea el valor previo solo la primera vez dentro de la ventana.\n\t */\n\ttrackPut(key: string, value: unknown, deltaKey: string): void {\n\t\tlet priors = this.priorValues.get(deltaKey);\n\t\tif (!priors) {\n\t\t\tpriors = new Map();\n\t\t\tthis.priorValues.set(deltaKey, priors);\n\t\t}\n\t\tif (!priors.has(key)) {\n\t\t\tpriors.set(\n\t\t\t\tkey,\n\t\t\t\tthis.map.has(key) ? { existed: true, value: this.map.get(key) } : { existed: false, value: undefined },\n\t\t\t);\n\t\t}\n\t\tthis.map.set(key, value);\n\t\tlet delta = this.agentDeltas.get(deltaKey);\n\t\tif (!delta) {\n\t\t\tdelta = {};\n\t\t\tthis.agentDeltas.set(deltaKey, delta);\n\t\t}\n\t\tdelta[key] = value;\n\t}\n\n\t/** Delta consolidado para journalizar (el agente terminó). */\n\tcommitDelta(deltaKey: string): Record<string, unknown> {\n\t\tconst delta = this.agentDeltas.get(deltaKey) ?? {};\n\t\tthis.agentDeltas.delete(deltaKey);\n\t\tthis.priorValues.delete(deltaKey);\n\t\treturn delta;\n\t}\n\n\t/** Rollback de las escrituras de un retry fallido. */\n\tdiscardDelta(deltaKey: string): void {\n\t\tconst priors = this.priorValues.get(deltaKey);\n\t\tif (priors) {\n\t\t\tfor (const [key, prior] of priors) {\n\t\t\t\tif (prior.existed) this.map.set(key, prior.value);\n\t\t\t\telse this.map.delete(key);\n\t\t\t}\n\t\t}\n\t\tthis.agentDeltas.delete(deltaKey);\n\t\tthis.priorValues.delete(deltaKey);\n\t}\n\n\t/** Replay aditivo de deltas en orden callSeq (resume). */\n\tapplyDelta(delta: Record<string, unknown>): void {\n\t\tfor (const [key, value] of Object.entries(delta)) {\n\t\t\tthis.map.set(key, value);\n\t\t}\n\t}\n\n\tget size(): number {\n\t\treturn this.map.size;\n\t}\n}\n"]}

package/dist/core/workflows/shared-store.js

@@ -0,0 +1,80 @@
+/**
+ * SharedStore — KV en memoria compartido entre los subagentes de un run.
+ *
+ * Cada agente escribe deltas (`trackPut` con deltaKey `${runId}:${callIndex}`)
+ * que se journalizan; en resume se re-aplican en orden callSeq. Los valores
+ * previos se shadowean para rollback de retries fallidos (patrón
+ * pi-dynamic-workflows).
+ */
+export class SharedStore {
+    map = new Map();
+    agentDeltas = new Map();
+    priorValues = new Map();
+    put(key, value) {
+        this.map.set(key, value);
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    delete(key) {
+        return this.map.delete(key);
+    }
+    entries() {
+        return [...this.map.entries()];
+    }
+    /**
+     * Escribe y registra el delta para `deltaKey` (run-unique).
+     * Shadowea el valor previo solo la primera vez dentro de la ventana.
+     */
+    trackPut(key, value, deltaKey) {
+        let priors = this.priorValues.get(deltaKey);
+        if (!priors) {
+            priors = new Map();
+            this.priorValues.set(deltaKey, priors);
+        }
+        if (!priors.has(key)) {
+            priors.set(key, this.map.has(key) ? { existed: true, value: this.map.get(key) } : { existed: false, value: undefined });
+        }
+        this.map.set(key, value);
+        let delta = this.agentDeltas.get(deltaKey);
+        if (!delta) {
+            delta = {};
+            this.agentDeltas.set(deltaKey, delta);
+        }
+        delta[key] = value;
+    }
+    /** Delta consolidado para journalizar (el agente terminó). */
+    commitDelta(deltaKey) {
+        const delta = this.agentDeltas.get(deltaKey) ?? {};
+        this.agentDeltas.delete(deltaKey);
+        this.priorValues.delete(deltaKey);
+        return delta;
+    }
+    /** Rollback de las escrituras de un retry fallido. */
+    discardDelta(deltaKey) {
+        const priors = this.priorValues.get(deltaKey);
+        if (priors) {
+            for (const [key, prior] of priors) {
+                if (prior.existed)
+                    this.map.set(key, prior.value);
+                else
+                    this.map.delete(key);
+            }
+        }
+        this.agentDeltas.delete(deltaKey);
+        this.priorValues.delete(deltaKey);
+    }
+    /** Replay aditivo de deltas en orden callSeq (resume). */
+    applyDelta(delta) {
+        for (const [key, value] of Object.entries(delta)) {
+            this.map.set(key, value);
+        }
+    }
+    get size() {
+        return this.map.size;
+    }
+}
+//# sourceMappingURL=shared-store.js.map

package/dist/core/workflows/shared-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-store.js","sourceRoot":"","sources":["../../../src/core/workflows/shared-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SharedStore — KV en memoria compartido entre los subagentes de un run.\n *\n * Cada agente escribe deltas (`trackPut` con deltaKey `${runId}:${callIndex}`)\n * que se journalizan; en resume se re-aplican en orden callSeq. Los valores\n * previos se shadowean para rollback de retries fallidos (patrón\n * pi-dynamic-workflows).\n */\n\nexport class SharedStore {\n\tprivate readonly map = new Map<string, unknown>();\n\tprivate readonly agentDeltas = new Map<string, Record<string, unknown>>();\n\tprivate readonly priorValues = new Map<string, Map<string, { existed: boolean; value: unknown }>>();\n\n\tput(key: string, value: unknown): void {\n\t\tthis.map.set(key, value);\n\t}\n\n\tget<T = unknown>(key: string): T | undefined {\n\t\treturn this.map.get(key) as T | undefined;\n\t}\n\n\thas(key: string): boolean {\n\t\treturn this.map.has(key);\n\t}\n\n\tdelete(key: string): boolean {\n\t\treturn this.map.delete(key);\n\t}\n\n\tentries(): Array<[string, unknown]> {\n\t\treturn [...this.map.entries()];\n\t}\n\n\t/**\n\t * Escribe y registra el delta para `deltaKey` (run-unique).\n\t * Shadowea el valor previo solo la primera vez dentro de la ventana.\n\t */\n\ttrackPut(key: string, value: unknown, deltaKey: string): void {\n\t\tlet priors = this.priorValues.get(deltaKey);\n\t\tif (!priors) {\n\t\t\tpriors = new Map();\n\t\t\tthis.priorValues.set(deltaKey, priors);\n\t\t}\n\t\tif (!priors.has(key)) {\n\t\t\tpriors.set(\n\t\t\t\tkey,\n\t\t\t\tthis.map.has(key) ? { existed: true, value: this.map.get(key) } : { existed: false, value: undefined },\n\t\t\t);\n\t\t}\n\t\tthis.map.set(key, value);\n\t\tlet delta = this.agentDeltas.get(deltaKey);\n\t\tif (!delta) {\n\t\t\tdelta = {};\n\t\t\tthis.agentDeltas.set(deltaKey, delta);\n\t\t}\n\t\tdelta[key] = value;\n\t}\n\n\t/** Delta consolidado para journalizar (el agente terminó). */\n\tcommitDelta(deltaKey: string): Record<string, unknown> {\n\t\tconst delta = this.agentDeltas.get(deltaKey) ?? {};\n\t\tthis.agentDeltas.delete(deltaKey);\n\t\tthis.priorValues.delete(deltaKey);\n\t\treturn delta;\n\t}\n\n\t/** Rollback de las escrituras de un retry fallido. */\n\tdiscardDelta(deltaKey: string): void {\n\t\tconst priors = this.priorValues.get(deltaKey);\n\t\tif (priors) {\n\t\t\tfor (const [key, prior] of priors) {\n\t\t\t\tif (prior.existed) this.map.set(key, prior.value);\n\t\t\t\telse this.map.delete(key);\n\t\t\t}\n\t\t}\n\t\tthis.agentDeltas.delete(deltaKey);\n\t\tthis.priorValues.delete(deltaKey);\n\t}\n\n\t/** Replay aditivo de deltas en orden callSeq (resume). */\n\tapplyDelta(delta: Record<string, unknown>): void {\n\t\tfor (const [key, value] of Object.entries(delta)) {\n\t\t\tthis.map.set(key, value);\n\t\t}\n\t}\n\n\tget size(): number {\n\t\treturn this.map.size;\n\t}\n}\n"]}

package/dist/core/workflows/subagent-host.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SubagentHost — subagente de producción: crea una sesión real del SDK
+ * (createAgentSession) con el modelo resuelto, tools configuradas y límites.
+ *
+ * El subagente comparte el mismo runtime (memoria/vault/redacción) porque
+ * createAgentSession construye un DefaultResourceLoader con el mismo agentDir
+ * y el SettingsManager compartido → los subagentes heredan la memoria, el
+ * vault (@vault:) y la censura de secretos (adversarial §17).
+ *
+ * NOTA (seguridad, fairy-tales): los subagentes usan un agentDir PROPIO
+ * efímero cuando se pide aislamiento (nada de extensiones/paquetes dentro);
+ * las guardas del engine se re-inyectan explícitamente.
+ */
+import type { Model } from "@earendil-works/pi-ai";
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { SubagentSession } from "./agent-runner.ts";
+export interface CreateSubagentSessionOptions {
+    cwd: string;
+    agentDir: string;
+    modelSpec?: string;
+    tools?: string[];
+    customTools?: ToolDefinition[];
+    sessionName?: string;
+    instructions?: string;
+    /** Modelo de la sesión principal: los subagentes lo HEREDAN por defecto. */
+    hostModel?: {
+        provider: string;
+        modelId: string;
+    };
+}
+/**
+ * Crea un subagente real. Devuelve la sesión con su disposición y el usage.
+ */
+export declare function createSubagentSession(options: CreateSubagentSessionOptions): Promise<SubagentSession>;
+/** Thinking level del tier (workflows.models.<tier>Thinking); undefined = default. */
+export declare function thinkingForTier(agentDir: string, tier: "cheap" | "main" | "judge"): string | undefined;
+/**
+ * Resuelve el modelSpec de un subagente a un Model concreto.
+ * - "tier:cheap" → cascada:
+ *     1. workflows.models.cheap ("provider/model" directo)
+ *     2. workflows.models.cheapCandidates (lista del usuario, en orden)
+ *     3. DISCOVERY DINÁMICO: el modelo más barato con coste declarado de los
+ *        proveedores CONECTADOS (refleja siempre el catálogo real del SDK)
+ *     4. fallback estático curado (solo si el discovery no encontró nada)
+ * - "tier:main"/"tier:judge" → workflows.models.main/judge, si no default.
+ * - "provider/model" → directo si está autenticado.
+ * Devuelve undefined → createAgentSession usa su resolución por defecto.
+ */
+export declare function resolveSubagentModel(agentDir: string, spec: string | undefined): Promise<Model<any> | undefined>;
+//# sourceMappingURL=subagent-host.d.ts.map

package/dist/core/workflows/subagent-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-host.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/subagent-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,WAAW,4BAA4B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA4E;IAC5E,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC3G;AAsDD,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAItG;AA2CD;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GACtB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAwDjC","sourcesContent":["/**\n * SubagentHost — subagente de producción: crea una sesión real del SDK\n * (createAgentSession) con el modelo resuelto, tools configuradas y límites.\n *\n * El subagente comparte el mismo runtime (memoria/vault/redacción) porque\n * createAgentSession construye un DefaultResourceLoader con el mismo agentDir\n * y el SettingsManager compartido → los subagentes heredan la memoria, el\n * vault (@vault:) y la censura de secretos (adversarial §17).\n *\n * NOTA (seguridad, fairy-tales): los subagentes usan un agentDir PROPIO\n * efímero cuando se pide aislamiento (nada de extensiones/paquetes dentro);\n * las guardas del engine se re-inyectan explícitamente.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Model } from \"@earendil-works/pi-ai\";\nimport type { AgentSession } from \"../agent-session.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { ModelRuntime } from \"../model-runtime.ts\";\nimport { createAgentSession } from \"../sdk.ts\";\nimport type { SubagentSession } from \"./agent-runner.ts\";\nimport type { AgentUsage } from \"./types.ts\";\n\nexport interface CreateSubagentSessionOptions {\n\tcwd: string;\n\tagentDir: string;\n\tmodelSpec?: string;\n\ttools?: string[];\n\tcustomTools?: ToolDefinition[];\n\tsessionName?: string;\n\tinstructions?: string;\n\t/** Modelo de la sesión principal: los subagentes lo HEREDAN por defecto. */\n\thostModel?: { provider: string; modelId: string };\n}\n\n/**\n * Crea un subagente real. Devuelve la sesión con su disposición y el usage.\n */\nexport async function createSubagentSession(options: CreateSubagentSessionOptions): Promise<SubagentSession> {\n\t// Routing por spec/tier (§16.2 budget): \"tier:cheap\" resuelve el modelo\n\t// barato, \"provider/model\" el explícito, y cualquier fallo cae al default.\n\tlet model = await resolveSubagentModel(options.agentDir, options.modelSpec);\n\t// Los subagentes HEREDAN el modelo de la sesión principal: si no hay spec/tier\n\t// explícito y el host tiene un modelo en uso, ese es el que se usa (misma\n\t// auth → misma API key del chat).\n\tif (!model && options.hostModel?.provider && options.hostModel.modelId) {\n\t\tmodel =\n\t\t\t(await resolveSubagentModel(options.agentDir, `${options.hostModel.provider}/${options.hostModel.modelId}`)) ??\n\t\t\tundefined;\n\t}\n\t// Thinking por tier: solo cuando el spec es tier:X y hay override en settings.\n\tconst tierMatch = options.modelSpec?.startsWith(\"tier:\")\n\t\t? (options.modelSpec.slice(5) as \"cheap\" | \"main\" | \"judge\")\n\t\t: undefined;\n\tconst thinkingLevel = tierMatch ? thinkingForTier(options.agentDir, tierMatch) : undefined;\n\n\tconst { session } = await createAgentSession({\n\t\tcwd: options.cwd,\n\t\tagentDir: options.agentDir,\n\t\ttools: options.tools,\n\t\tcustomTools: options.customTools,\n\t\t...(model ? { model } : {}),\n\t\t...(thinkingLevel ? { thinkingLevel: thinkingLevel as never } : {}),\n\t\tisSubagent: true, // anti-recursión: el HOST es el único dueño del bucle del goal\n\t});\n\n\t// Nombre de sesión + instrucciones: no hay opción directa en\n\t// createAgentSession para ambos; la instrucción va en el prompt.\n\treturn {\n\t\tsession,\n\t\tdispose: () => {\n\t\t\ttry {\n\t\t\t\tsession.dispose();\n\t\t\t} catch {\n\t\t\t\t// best-effort\n\t\t\t}\n\t\t},\n\t\tgetUsage: () => usageFromSession(session),\n\t};\n}\n\n/** Extraer el usage real de la sesión del subagente. */\nfunction usageFromSession(session: AgentSession): AgentUsage {\n\ttry {\n\t\tconst stats = session.getSessionStats();\n\t\tconst tokens = stats.tokens;\n\t\treturn {\n\t\t\tinput: tokens.input,\n\t\t\toutput: tokens.output,\n\t\t\ttotal: tokens.total,\n\t\t\tcost: stats.cost ?? 0,\n\t\t\tcacheRead: tokens.cacheRead,\n\t\t\tcacheWrite: tokens.cacheWrite,\n\t\t};\n\t} catch {\n\t\treturn { input: 0, output: 0, total: 0, cost: 0, cacheRead: 0, cacheWrite: 0 };\n\t}\n}\n\n/**\n * Fallback de emergencia: solo se usa si el discovery dinámico no encuentra\n * NINGÚN modelo con coste entre los proveedores conectados. Cada entrada se\n * valida con hasConfiguredAuth — sin credenciales se cae al default (fail-safe).\n */\nconst CHEAP_MODEL_CANDIDATES: Array<[provider: string, modelId: string]> = [\n\t[\"anthropic\", \"claude-haiku-4-5\"],\n\t[\"google\", \"gemini-2.5-flash\"],\n\t[\"google\", \"gemini-2.0-flash\"],\n\t[\"openai\", \"gpt-4o-mini\"],\n\t[\"openai\", \"gpt-5-mini\"],\n];\n\ninterface ModelsConfig {\n\tcheap?: string;\n\tmain?: string;\n\tjudge?: string;\n\tcheapCandidates?: string[];\n\tcheapThinking?: string;\n\tmainThinking?: string;\n\tjudgeThinking?: string;\n}\n\n/** Lee workflows.models del settings.json del agentDir (sin SettingsManager — función pura). */\nfunction readModelsConfig(agentDir: string): ModelsConfig {\n\ttry {\n\t\tconst raw = readFileSync(join(agentDir, \"settings.json\"), \"utf-8\");\n\t\tconst parsed = JSON.parse(raw) as { workflows?: { models?: ModelsConfig } };\n\t\treturn parsed?.workflows?.models ?? {};\n\t} catch {\n\t\treturn {};\n\t}\n}\n\n/** Thinking level del tier (workflows.models.<tier>Thinking); undefined = default. */\nexport function thinkingForTier(agentDir: string, tier: \"cheap\" | \"main\" | \"judge\"): string | undefined {\n\tconst cfg = readModelsConfig(agentDir);\n\tconst value = tier === \"cheap\" ? cfg.cheapThinking : tier === \"judge\" ? cfg.judgeThinking : cfg.mainThinking;\n\treturn typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\n/** Parsea \"provider/model\" → [provider, model]; null si malformado. */\nfunction parseSpec(spec: string): [string, string] | null {\n\tconst slash = spec.indexOf(\"/\");\n\tif (slash <= 0 || slash === spec.length - 1) return null;\n\treturn [spec.slice(0, slash), spec.slice(slash + 1)];\n}\n\n/**\n * Discovery DINÁMICO de modelos baratos: recorre los proveedores CONECTADOS\n * (hasConfiguredAuth) del runtime, toma sus modelos con coste declarado y los\n * ordena por precio (input+output) ascendente. La lista siempre refleja lo\n * que el usuario tiene disponible de verdad — nunca modelos inexistentes.\n */\nfunction discoverCheapModels(runtime: ModelRuntime, max = 6): Array<[string, string]> {\n\tconst scored: Array<{ provider: string; model: string; cost: number }> = [];\n\tfor (const provider of runtime.getProviders()) {\n\t\tif (!runtime.hasConfiguredAuth(provider.id)) continue;\n\t\tfor (const model of runtime.getModels(provider.id)) {\n\t\t\tconst m = model as { modelId?: string; id?: string; cost?: { input?: number; output?: number } };\n\t\t\tconst modelId = m.modelId ?? m.id;\n\t\t\tconst cost = m.cost;\n\t\t\tif (!modelId || !cost || typeof cost.input !== \"number\" || typeof cost.output !== \"number\") continue;\n\t\t\tscored.push({ provider: provider.id, model: modelId, cost: cost.input + cost.output });\n\t\t}\n\t}\n\treturn scored\n\t\t.sort((a, b) => a.cost - b.cost)\n\t\t.slice(0, max)\n\t\t.map((x) => [x.provider, x.model]);\n}\n\n/** Lista del usuario (workflows.models.cheapCandidates). [] si no está configurada. */\nfunction userCheapCandidates(agentDir: string): Array<[string, string]> {\n\tconst configured = readModelsConfig(agentDir).cheapCandidates;\n\tif (!Array.isArray(configured) || configured.length === 0) return [];\n\t// Solo entradas válidas \"provider/model\" (las malas se saltan).\n\treturn configured\n\t\t.map((c) => (typeof c === \"string\" ? parseSpec(c) : null))\n\t\t.filter((c): c is [string, string] => c !== null);\n}\n\n/**\n * Resuelve el modelSpec de un subagente a un Model concreto.\n * - \"tier:cheap\" → cascada:\n *     1. workflows.models.cheap (\"provider/model\" directo)\n *     2. workflows.models.cheapCandidates (lista del usuario, en orden)\n *     3. DISCOVERY DINÁMICO: el modelo más barato con coste declarado de los\n *        proveedores CONECTADOS (refleja siempre el catálogo real del SDK)\n *     4. fallback estático curado (solo si el discovery no encontró nada)\n * - \"tier:main\"/\"tier:judge\" → workflows.models.main/judge, si no default.\n * - \"provider/model\" → directo si está autenticado.\n * Devuelve undefined → createAgentSession usa su resolución por defecto.\n */\nexport async function resolveSubagentModel(\n\tagentDir: string,\n\tspec: string | undefined,\n): Promise<Model<any> | undefined> {\n\tif (!spec) return undefined;\n\tlet runtime: ModelRuntime;\n\ttry {\n\t\truntime = await ModelRuntime.create({\n\t\t\tauthPath: join(agentDir, \"auth.json\"),\n\t\t\tmodelsPath: join(agentDir, \"models.json\"),\n\t\t});\n\t} catch {\n\t\treturn undefined; // fail-safe: default\n\t}\n\tconst tryGet = (provider: string, modelId: string): Model<any> | undefined => {\n\t\tconst m = runtime.getModel(provider, modelId);\n\t\treturn m && runtime.hasConfiguredAuth(provider) ? m : undefined;\n\t};\n\n\tif (spec.startsWith(\"tier:\")) {\n\t\tconst tier = spec.slice(5);\n\t\t// Settings override PRIMERO: workflows.models.<tier> = \"provider/model\"\n\t\tconst models = readModelsConfig(agentDir);\n\t\tconst override = tier === \"cheap\" ? models.cheap : tier === \"judge\" ? models.judge : models.main;\n\t\tconst overrideSpec = override ? parseSpec(override) : null;\n\t\tif (overrideSpec) {\n\t\t\tconst m = tryGet(overrideSpec[0], overrideSpec[1]);\n\t\t\tif (m) return m;\n\t\t}\n\t\tif (tier === \"cheap\") {\n\t\t\t// 1. Lista explícita del usuario (workflows.models.cheapCandidates).\n\t\t\tfor (const candidate of userCheapCandidates(agentDir)) {\n\t\t\t\tconst m = tryGet(candidate[0], candidate[1]);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\t// 2. DISCOVERY DINÁMICO: el más barato con coste declarado entre los\n\t\t\t// proveedores CONECTADOS — refleja siempre el catálogo real del SDK.\n\t\t\tfor (const [providerId, modelId] of discoverCheapModels(runtime)) {\n\t\t\t\tconst m = tryGet(providerId, modelId);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\t// 3. Fallback estático de emergencia (solo si el discovery no encontró\n\t\t\t// nada — p.ej. catálogos sin costes declarados).\n\t\t\tfor (const candidate of CHEAP_MODEL_CANDIDATES) {\n\t\t\t\tconst m = tryGet(candidate[0], candidate[1]);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\treturn undefined;\n\t\t}\n\t\t// tier:main / tier:judge sin override → default del host (fail-safe)\n\t\treturn undefined;\n\t}\n\n\t// \"provider/model\" explícito\n\tconst slash = spec.indexOf(\"/\");\n\tif (slash <= 0 || slash === spec.length - 1) return undefined;\n\tconst provider = spec.slice(0, slash);\n\tconst modelId = spec.slice(slash + 1);\n\treturn tryGet(provider, modelId) ?? undefined;\n}\n"]}

package/dist/core/workflows/subagent-host.js

@@ -0,0 +1,225 @@
+/**
+ * SubagentHost — subagente de producción: crea una sesión real del SDK
+ * (createAgentSession) con el modelo resuelto, tools configuradas y límites.
+ *
+ * El subagente comparte el mismo runtime (memoria/vault/redacción) porque
+ * createAgentSession construye un DefaultResourceLoader con el mismo agentDir
+ * y el SettingsManager compartido → los subagentes heredan la memoria, el
+ * vault (@vault:) y la censura de secretos (adversarial §17).
+ *
+ * NOTA (seguridad, fairy-tales): los subagentes usan un agentDir PROPIO
+ * efímero cuando se pide aislamiento (nada de extensiones/paquetes dentro);
+ * las guardas del engine se re-inyectan explícitamente.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ModelRuntime } from "../model-runtime.js";
+import { createAgentSession } from "../sdk.js";
+/**
+ * Crea un subagente real. Devuelve la sesión con su disposición y el usage.
+ */
+export async function createSubagentSession(options) {
+    // Routing por spec/tier (§16.2 budget): "tier:cheap" resuelve el modelo
+    // barato, "provider/model" el explícito, y cualquier fallo cae al default.
+    let model = await resolveSubagentModel(options.agentDir, options.modelSpec);
+    // Los subagentes HEREDAN el modelo de la sesión principal: si no hay spec/tier
+    // explícito y el host tiene un modelo en uso, ese es el que se usa (misma
+    // auth → misma API key del chat).
+    if (!model && options.hostModel?.provider && options.hostModel.modelId) {
+        model =
+            (await resolveSubagentModel(options.agentDir, `${options.hostModel.provider}/${options.hostModel.modelId}`)) ??
+                undefined;
+    }
+    // Thinking por tier: solo cuando el spec es tier:X y hay override en settings.
+    const tierMatch = options.modelSpec?.startsWith("tier:")
+        ? options.modelSpec.slice(5)
+        : undefined;
+    const thinkingLevel = tierMatch ? thinkingForTier(options.agentDir, tierMatch) : undefined;
+    const { session } = await createAgentSession({
+        cwd: options.cwd,
+        agentDir: options.agentDir,
+        tools: options.tools,
+        customTools: options.customTools,
+        ...(model ? { model } : {}),
+        ...(thinkingLevel ? { thinkingLevel: thinkingLevel } : {}),
+        isSubagent: true, // anti-recursión: el HOST es el único dueño del bucle del goal
+    });
+    // Nombre de sesión + instrucciones: no hay opción directa en
+    // createAgentSession para ambos; la instrucción va en el prompt.
+    return {
+        session,
+        dispose: () => {
+            try {
+                session.dispose();
+            }
+            catch {
+                // best-effort
+            }
+        },
+        getUsage: () => usageFromSession(session),
+    };
+}
+/** Extraer el usage real de la sesión del subagente. */
+function usageFromSession(session) {
+    try {
+        const stats = session.getSessionStats();
+        const tokens = stats.tokens;
+        return {
+            input: tokens.input,
+            output: tokens.output,
+            total: tokens.total,
+            cost: stats.cost ?? 0,
+            cacheRead: tokens.cacheRead,
+            cacheWrite: tokens.cacheWrite,
+        };
+    }
+    catch {
+        return { input: 0, output: 0, total: 0, cost: 0, cacheRead: 0, cacheWrite: 0 };
+    }
+}
+/**
+ * Fallback de emergencia: solo se usa si el discovery dinámico no encuentra
+ * NINGÚN modelo con coste entre los proveedores conectados. Cada entrada se
+ * valida con hasConfiguredAuth — sin credenciales se cae al default (fail-safe).
+ */
+const CHEAP_MODEL_CANDIDATES = [
+    ["anthropic", "claude-haiku-4-5"],
+    ["google", "gemini-2.5-flash"],
+    ["google", "gemini-2.0-flash"],
+    ["openai", "gpt-4o-mini"],
+    ["openai", "gpt-5-mini"],
+];
+/** Lee workflows.models del settings.json del agentDir (sin SettingsManager — función pura). */
+function readModelsConfig(agentDir) {
+    try {
+        const raw = readFileSync(join(agentDir, "settings.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed?.workflows?.models ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Thinking level del tier (workflows.models.<tier>Thinking); undefined = default. */
+export function thinkingForTier(agentDir, tier) {
+    const cfg = readModelsConfig(agentDir);
+    const value = tier === "cheap" ? cfg.cheapThinking : tier === "judge" ? cfg.judgeThinking : cfg.mainThinking;
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/** Parsea "provider/model" → [provider, model]; null si malformado. */
+function parseSpec(spec) {
+    const slash = spec.indexOf("/");
+    if (slash <= 0 || slash === spec.length - 1)
+        return null;
+    return [spec.slice(0, slash), spec.slice(slash + 1)];
+}
+/**
+ * Discovery DINÁMICO de modelos baratos: recorre los proveedores CONECTADOS
+ * (hasConfiguredAuth) del runtime, toma sus modelos con coste declarado y los
+ * ordena por precio (input+output) ascendente. La lista siempre refleja lo
+ * que el usuario tiene disponible de verdad — nunca modelos inexistentes.
+ */
+function discoverCheapModels(runtime, max = 6) {
+    const scored = [];
+    for (const provider of runtime.getProviders()) {
+        if (!runtime.hasConfiguredAuth(provider.id))
+            continue;
+        for (const model of runtime.getModels(provider.id)) {
+            const m = model;
+            const modelId = m.modelId ?? m.id;
+            const cost = m.cost;
+            if (!modelId || !cost || typeof cost.input !== "number" || typeof cost.output !== "number")
+                continue;
+            scored.push({ provider: provider.id, model: modelId, cost: cost.input + cost.output });
+        }
+    }
+    return scored
+        .sort((a, b) => a.cost - b.cost)
+        .slice(0, max)
+        .map((x) => [x.provider, x.model]);
+}
+/** Lista del usuario (workflows.models.cheapCandidates). [] si no está configurada. */
+function userCheapCandidates(agentDir) {
+    const configured = readModelsConfig(agentDir).cheapCandidates;
+    if (!Array.isArray(configured) || configured.length === 0)
+        return [];
+    // Solo entradas válidas "provider/model" (las malas se saltan).
+    return configured
+        .map((c) => (typeof c === "string" ? parseSpec(c) : null))
+        .filter((c) => c !== null);
+}
+/**
+ * Resuelve el modelSpec de un subagente a un Model concreto.
+ * - "tier:cheap" → cascada:
+ *     1. workflows.models.cheap ("provider/model" directo)
+ *     2. workflows.models.cheapCandidates (lista del usuario, en orden)
+ *     3. DISCOVERY DINÁMICO: el modelo más barato con coste declarado de los
+ *        proveedores CONECTADOS (refleja siempre el catálogo real del SDK)
+ *     4. fallback estático curado (solo si el discovery no encontró nada)
+ * - "tier:main"/"tier:judge" → workflows.models.main/judge, si no default.
+ * - "provider/model" → directo si está autenticado.
+ * Devuelve undefined → createAgentSession usa su resolución por defecto.
+ */
+export async function resolveSubagentModel(agentDir, spec) {
+    if (!spec)
+        return undefined;
+    let runtime;
+    try {
+        runtime = await ModelRuntime.create({
+            authPath: join(agentDir, "auth.json"),
+            modelsPath: join(agentDir, "models.json"),
+        });
+    }
+    catch {
+        return undefined; // fail-safe: default
+    }
+    const tryGet = (provider, modelId) => {
+        const m = runtime.getModel(provider, modelId);
+        return m && runtime.hasConfiguredAuth(provider) ? m : undefined;
+    };
+    if (spec.startsWith("tier:")) {
+        const tier = spec.slice(5);
+        // Settings override PRIMERO: workflows.models.<tier> = "provider/model"
+        const models = readModelsConfig(agentDir);
+        const override = tier === "cheap" ? models.cheap : tier === "judge" ? models.judge : models.main;
+        const overrideSpec = override ? parseSpec(override) : null;
+        if (overrideSpec) {
+            const m = tryGet(overrideSpec[0], overrideSpec[1]);
+            if (m)
+                return m;
+        }
+        if (tier === "cheap") {
+            // 1. Lista explícita del usuario (workflows.models.cheapCandidates).
+            for (const candidate of userCheapCandidates(agentDir)) {
+                const m = tryGet(candidate[0], candidate[1]);
+                if (m)
+                    return m;
+            }
+            // 2. DISCOVERY DINÁMICO: el más barato con coste declarado entre los
+            // proveedores CONECTADOS — refleja siempre el catálogo real del SDK.
+            for (const [providerId, modelId] of discoverCheapModels(runtime)) {
+                const m = tryGet(providerId, modelId);
+                if (m)
+                    return m;
+            }
+            // 3. Fallback estático de emergencia (solo si el discovery no encontró
+            // nada — p.ej. catálogos sin costes declarados).
+            for (const candidate of CHEAP_MODEL_CANDIDATES) {
+                const m = tryGet(candidate[0], candidate[1]);
+                if (m)
+                    return m;
+            }
+            return undefined;
+        }
+        // tier:main / tier:judge sin override → default del host (fail-safe)
+        return undefined;
+    }
+    // "provider/model" explícito
+    const slash = spec.indexOf("/");
+    if (slash <= 0 || slash === spec.length - 1)
+        return undefined;
+    const provider = spec.slice(0, slash);
+    const modelId = spec.slice(slash + 1);
+    return tryGet(provider, modelId) ?? undefined;
+}
+//# sourceMappingURL=subagent-host.js.map

package/dist/core/workflows/subagent-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-host.js","sourceRoot":"","sources":["../../../src/core/workflows/subagent-host.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubagentHost — subagente de producción: crea una sesión real del SDK\n * (createAgentSession) con el modelo resuelto, tools configuradas y límites.\n *\n * El subagente comparte el mismo runtime (memoria/vault/redacción) porque\n * createAgentSession construye un DefaultResourceLoader con el mismo agentDir\n * y el SettingsManager compartido → los subagentes heredan la memoria, el\n * vault (@vault:) y la censura de secretos (adversarial §17).\n *\n * NOTA (seguridad, fairy-tales): los subagentes usan un agentDir PROPIO\n * efímero cuando se pide aislamiento (nada de extensiones/paquetes dentro);\n * las guardas del engine se re-inyectan explícitamente.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Model } from \"@earendil-works/pi-ai\";\nimport type { AgentSession } from \"../agent-session.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { ModelRuntime } from \"../model-runtime.ts\";\nimport { createAgentSession } from \"../sdk.ts\";\nimport type { SubagentSession } from \"./agent-runner.ts\";\nimport type { AgentUsage } from \"./types.ts\";\n\nexport interface CreateSubagentSessionOptions {\n\tcwd: string;\n\tagentDir: string;\n\tmodelSpec?: string;\n\ttools?: string[];\n\tcustomTools?: ToolDefinition[];\n\tsessionName?: string;\n\tinstructions?: string;\n\t/** Modelo de la sesión principal: los subagentes lo HEREDAN por defecto. */\n\thostModel?: { provider: string; modelId: string };\n}\n\n/**\n * Crea un subagente real. Devuelve la sesión con su disposición y el usage.\n */\nexport async function createSubagentSession(options: CreateSubagentSessionOptions): Promise<SubagentSession> {\n\t// Routing por spec/tier (§16.2 budget): \"tier:cheap\" resuelve el modelo\n\t// barato, \"provider/model\" el explícito, y cualquier fallo cae al default.\n\tlet model = await resolveSubagentModel(options.agentDir, options.modelSpec);\n\t// Los subagentes HEREDAN el modelo de la sesión principal: si no hay spec/tier\n\t// explícito y el host tiene un modelo en uso, ese es el que se usa (misma\n\t// auth → misma API key del chat).\n\tif (!model && options.hostModel?.provider && options.hostModel.modelId) {\n\t\tmodel =\n\t\t\t(await resolveSubagentModel(options.agentDir, `${options.hostModel.provider}/${options.hostModel.modelId}`)) ??\n\t\t\tundefined;\n\t}\n\t// Thinking por tier: solo cuando el spec es tier:X y hay override en settings.\n\tconst tierMatch = options.modelSpec?.startsWith(\"tier:\")\n\t\t? (options.modelSpec.slice(5) as \"cheap\" | \"main\" | \"judge\")\n\t\t: undefined;\n\tconst thinkingLevel = tierMatch ? thinkingForTier(options.agentDir, tierMatch) : undefined;\n\n\tconst { session } = await createAgentSession({\n\t\tcwd: options.cwd,\n\t\tagentDir: options.agentDir,\n\t\ttools: options.tools,\n\t\tcustomTools: options.customTools,\n\t\t...(model ? { model } : {}),\n\t\t...(thinkingLevel ? { thinkingLevel: thinkingLevel as never } : {}),\n\t\tisSubagent: true, // anti-recursión: el HOST es el único dueño del bucle del goal\n\t});\n\n\t// Nombre de sesión + instrucciones: no hay opción directa en\n\t// createAgentSession para ambos; la instrucción va en el prompt.\n\treturn {\n\t\tsession,\n\t\tdispose: () => {\n\t\t\ttry {\n\t\t\t\tsession.dispose();\n\t\t\t} catch {\n\t\t\t\t// best-effort\n\t\t\t}\n\t\t},\n\t\tgetUsage: () => usageFromSession(session),\n\t};\n}\n\n/** Extraer el usage real de la sesión del subagente. */\nfunction usageFromSession(session: AgentSession): AgentUsage {\n\ttry {\n\t\tconst stats = session.getSessionStats();\n\t\tconst tokens = stats.tokens;\n\t\treturn {\n\t\t\tinput: tokens.input,\n\t\t\toutput: tokens.output,\n\t\t\ttotal: tokens.total,\n\t\t\tcost: stats.cost ?? 0,\n\t\t\tcacheRead: tokens.cacheRead,\n\t\t\tcacheWrite: tokens.cacheWrite,\n\t\t};\n\t} catch {\n\t\treturn { input: 0, output: 0, total: 0, cost: 0, cacheRead: 0, cacheWrite: 0 };\n\t}\n}\n\n/**\n * Fallback de emergencia: solo se usa si el discovery dinámico no encuentra\n * NINGÚN modelo con coste entre los proveedores conectados. Cada entrada se\n * valida con hasConfiguredAuth — sin credenciales se cae al default (fail-safe).\n */\nconst CHEAP_MODEL_CANDIDATES: Array<[provider: string, modelId: string]> = [\n\t[\"anthropic\", \"claude-haiku-4-5\"],\n\t[\"google\", \"gemini-2.5-flash\"],\n\t[\"google\", \"gemini-2.0-flash\"],\n\t[\"openai\", \"gpt-4o-mini\"],\n\t[\"openai\", \"gpt-5-mini\"],\n];\n\ninterface ModelsConfig {\n\tcheap?: string;\n\tmain?: string;\n\tjudge?: string;\n\tcheapCandidates?: string[];\n\tcheapThinking?: string;\n\tmainThinking?: string;\n\tjudgeThinking?: string;\n}\n\n/** Lee workflows.models del settings.json del agentDir (sin SettingsManager — función pura). */\nfunction readModelsConfig(agentDir: string): ModelsConfig {\n\ttry {\n\t\tconst raw = readFileSync(join(agentDir, \"settings.json\"), \"utf-8\");\n\t\tconst parsed = JSON.parse(raw) as { workflows?: { models?: ModelsConfig } };\n\t\treturn parsed?.workflows?.models ?? {};\n\t} catch {\n\t\treturn {};\n\t}\n}\n\n/** Thinking level del tier (workflows.models.<tier>Thinking); undefined = default. */\nexport function thinkingForTier(agentDir: string, tier: \"cheap\" | \"main\" | \"judge\"): string | undefined {\n\tconst cfg = readModelsConfig(agentDir);\n\tconst value = tier === \"cheap\" ? cfg.cheapThinking : tier === \"judge\" ? cfg.judgeThinking : cfg.mainThinking;\n\treturn typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\n/** Parsea \"provider/model\" → [provider, model]; null si malformado. */\nfunction parseSpec(spec: string): [string, string] | null {\n\tconst slash = spec.indexOf(\"/\");\n\tif (slash <= 0 || slash === spec.length - 1) return null;\n\treturn [spec.slice(0, slash), spec.slice(slash + 1)];\n}\n\n/**\n * Discovery DINÁMICO de modelos baratos: recorre los proveedores CONECTADOS\n * (hasConfiguredAuth) del runtime, toma sus modelos con coste declarado y los\n * ordena por precio (input+output) ascendente. La lista siempre refleja lo\n * que el usuario tiene disponible de verdad — nunca modelos inexistentes.\n */\nfunction discoverCheapModels(runtime: ModelRuntime, max = 6): Array<[string, string]> {\n\tconst scored: Array<{ provider: string; model: string; cost: number }> = [];\n\tfor (const provider of runtime.getProviders()) {\n\t\tif (!runtime.hasConfiguredAuth(provider.id)) continue;\n\t\tfor (const model of runtime.getModels(provider.id)) {\n\t\t\tconst m = model as { modelId?: string; id?: string; cost?: { input?: number; output?: number } };\n\t\t\tconst modelId = m.modelId ?? m.id;\n\t\t\tconst cost = m.cost;\n\t\t\tif (!modelId || !cost || typeof cost.input !== \"number\" || typeof cost.output !== \"number\") continue;\n\t\t\tscored.push({ provider: provider.id, model: modelId, cost: cost.input + cost.output });\n\t\t}\n\t}\n\treturn scored\n\t\t.sort((a, b) => a.cost - b.cost)\n\t\t.slice(0, max)\n\t\t.map((x) => [x.provider, x.model]);\n}\n\n/** Lista del usuario (workflows.models.cheapCandidates). [] si no está configurada. */\nfunction userCheapCandidates(agentDir: string): Array<[string, string]> {\n\tconst configured = readModelsConfig(agentDir).cheapCandidates;\n\tif (!Array.isArray(configured) || configured.length === 0) return [];\n\t// Solo entradas válidas \"provider/model\" (las malas se saltan).\n\treturn configured\n\t\t.map((c) => (typeof c === \"string\" ? parseSpec(c) : null))\n\t\t.filter((c): c is [string, string] => c !== null);\n}\n\n/**\n * Resuelve el modelSpec de un subagente a un Model concreto.\n * - \"tier:cheap\" → cascada:\n *     1. workflows.models.cheap (\"provider/model\" directo)\n *     2. workflows.models.cheapCandidates (lista del usuario, en orden)\n *     3. DISCOVERY DINÁMICO: el modelo más barato con coste declarado de los\n *        proveedores CONECTADOS (refleja siempre el catálogo real del SDK)\n *     4. fallback estático curado (solo si el discovery no encontró nada)\n * - \"tier:main\"/\"tier:judge\" → workflows.models.main/judge, si no default.\n * - \"provider/model\" → directo si está autenticado.\n * Devuelve undefined → createAgentSession usa su resolución por defecto.\n */\nexport async function resolveSubagentModel(\n\tagentDir: string,\n\tspec: string | undefined,\n): Promise<Model<any> | undefined> {\n\tif (!spec) return undefined;\n\tlet runtime: ModelRuntime;\n\ttry {\n\t\truntime = await ModelRuntime.create({\n\t\t\tauthPath: join(agentDir, \"auth.json\"),\n\t\t\tmodelsPath: join(agentDir, \"models.json\"),\n\t\t});\n\t} catch {\n\t\treturn undefined; // fail-safe: default\n\t}\n\tconst tryGet = (provider: string, modelId: string): Model<any> | undefined => {\n\t\tconst m = runtime.getModel(provider, modelId);\n\t\treturn m && runtime.hasConfiguredAuth(provider) ? m : undefined;\n\t};\n\n\tif (spec.startsWith(\"tier:\")) {\n\t\tconst tier = spec.slice(5);\n\t\t// Settings override PRIMERO: workflows.models.<tier> = \"provider/model\"\n\t\tconst models = readModelsConfig(agentDir);\n\t\tconst override = tier === \"cheap\" ? models.cheap : tier === \"judge\" ? models.judge : models.main;\n\t\tconst overrideSpec = override ? parseSpec(override) : null;\n\t\tif (overrideSpec) {\n\t\t\tconst m = tryGet(overrideSpec[0], overrideSpec[1]);\n\t\t\tif (m) return m;\n\t\t}\n\t\tif (tier === \"cheap\") {\n\t\t\t// 1. Lista explícita del usuario (workflows.models.cheapCandidates).\n\t\t\tfor (const candidate of userCheapCandidates(agentDir)) {\n\t\t\t\tconst m = tryGet(candidate[0], candidate[1]);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\t// 2. DISCOVERY DINÁMICO: el más barato con coste declarado entre los\n\t\t\t// proveedores CONECTADOS — refleja siempre el catálogo real del SDK.\n\t\t\tfor (const [providerId, modelId] of discoverCheapModels(runtime)) {\n\t\t\t\tconst m = tryGet(providerId, modelId);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\t// 3. Fallback estático de emergencia (solo si el discovery no encontró\n\t\t\t// nada — p.ej. catálogos sin costes declarados).\n\t\t\tfor (const candidate of CHEAP_MODEL_CANDIDATES) {\n\t\t\t\tconst m = tryGet(candidate[0], candidate[1]);\n\t\t\t\tif (m) return m;\n\t\t\t}\n\t\t\treturn undefined;\n\t\t}\n\t\t// tier:main / tier:judge sin override → default del host (fail-safe)\n\t\treturn undefined;\n\t}\n\n\t// \"provider/model\" explícito\n\tconst slash = spec.indexOf(\"/\");\n\tif (slash <= 0 || slash === spec.length - 1) return undefined;\n\tconst provider = spec.slice(0, slash);\n\tconst modelId = spec.slice(slash + 1);\n\treturn tryGet(provider, modelId) ?? undefined;\n}\n"]}

package/dist/core/workflows/tool-workflow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Ada Intelligence Engine — tool `workflow` para el agente principal (§16.1).
+ *
+ * Permite al agente lanzar/consultar/abortar workflows con CONFIRMACIÓN de
+ * coste estimado (nunca ejecuta un run costoso a ciegas). Resuelve el
+ * WorkflowManager por llamada vía getter inyectado.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { WorkflowManager } from "./manager.ts";
+export interface WorkflowToolContext {
+    /** getter que devuelve el mangager (lazy). */
+    getManager: () => WorkflowManager | null;
+    /** Confirmación humana inyectable (para tests). Devuelve true si ok. */
+    confirm?: (prompt: string) => Promise<boolean>;
+    /** agentDir para resolver scripts guardados del usuario. */
+    agentDir?: string;
+    /** SessionId de la sesión que lanza (el panel filtra los runs por esto). */
+    sessionId?: () => string | undefined;
+}
+/** Crea la tool workflow para la sesión principal. */
+export declare function createWorkflowTool(ctx: WorkflowToolContext): ToolDefinition;
+//# sourceMappingURL=tool-workflow.d.ts.map

package/dist/core/workflows/tool-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-workflow.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/tool-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAqC,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACzC,yEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACrC;AAaD,uDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,CAsG3E","sourcesContent":["/**\n * Ada Intelligence Engine — tool `workflow` para el agente principal (§16.1).\n *\n * Permite al agente lanzar/consultar/abortar workflows con CONFIRMACIÓN de\n * coste estimado (nunca ejecuta un run costoso a ciegas). Resuelve el\n * WorkflowManager por llamada vía getter inyectado.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ExtensionContext, ToolDefinition } from \"../extensions/types.ts\";\nimport type { WorkflowManager } from \"./manager.ts\";\nimport { resolveBuiltinWorkflowScript, resolveWorkflowScriptByName } from \"./resolve-script.ts\";\n\nexport interface WorkflowToolContext {\n\t/** getter que devuelve el mangager (lazy). */\n\tgetManager: () => WorkflowManager | null;\n\t/** Confirmación humana inyectable (para tests). Devuelve true si ok. */\n\tconfirm?: (prompt: string) => Promise<boolean>;\n\t/** agentDir para resolver scripts guardados del usuario. */\n\tagentDir?: string;\n\t/** SessionId de la sesión que lanza (el panel filtra los runs por esto). */\n\tsessionId?: () => string | undefined;\n}\n\ntype OkResult = AgentToolResult<undefined>;\n\nfunction reply(ok: boolean, text: unknown): OkResult {\n\treturn {\n\t\tdetails: undefined,\n\t\tcontent: [\n\t\t\t{ type: \"text\", text: JSON.stringify({ ok, ...(typeof text === \"object\" ? text : { message: text }) }) },\n\t\t],\n\t};\n}\n\n/** Crea la tool workflow para la sesión principal. */\nexport function createWorkflowTool(ctx: WorkflowToolContext): ToolDefinition {\n\tconst confirm = ctx.confirm ?? (async () => true);\n\treturn {\n\t\tname: \"workflow\",\n\t\tlabel: \"Workflow\",\n\t\tdescription:\n\t\t\t\"Lanza o gestiona un workflow del Ada Intelligence Engine (deep-research, code-review, product-build, multi-perspective, o un script guardado). SIEMPRE pide confirmación del coste estimado antes de lanzar un run costoso. Subcomandos: run | list | status | abort.\",\n\t\tpromptSnippet: \"Lanza/gestiona workflows con confirmación de coste (workflow run|list|status|abort)\",\n\t\tpromptGuidelines: [\n\t\t\t\"Usa workflow run para lanzar deep-research o code-review; pide siempre confirmación de coste.\",\n\t\t\t\"Usa workflow status para consultar el estado de un run en curso.\",\n\t\t\t\"Usa workflow abort para cancelar un run.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\tcommand: Type.Union([\n\t\t\t\tType.Literal(\"run\"),\n\t\t\t\tType.Literal(\"list\"),\n\t\t\t\tType.Literal(\"status\"),\n\t\t\t\tType.Literal(\"abort\"),\n\t\t\t]),\n\t\t\tname: Type.Optional(\n\t\t\t\tType.String({\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Nombre del workflow / del run (deep_research, code_review, product_build, multi_perspective o script guardado)\",\n\t\t\t\t}),\n\t\t\t),\n\t\t\tquestion: Type.Optional(Type.String({ description: \"Pregunta o brief (para deep-research)\" })),\n\t\t\trunId: Type.Optional(Type.String({ description: \"id del run (para status/abort)\" })),\n\t\t\tawait: Type.Optional(Type.Boolean({ description: \"Esperar a que termine (default true)\" })),\n\t\t}),\n\t\tasync execute(\n\t\t\t_toolCallId: string,\n\t\t\tinput: {\n\t\t\t\tcommand: \"run\" | \"list\" | \"status\" | \"abort\";\n\t\t\t\tname?: string;\n\t\t\t\tquestion?: string;\n\t\t\t\trunId?: string;\n\t\t\t\tawait?: boolean;\n\t\t\t},\n\t\t\t_signal: AbortSignal | undefined,\n\t\t\t_onUpdate: unknown,\n\t\t\t_ctx: ExtensionContext,\n\t\t): Promise<OkResult> {\n\t\t\tconst manager = ctx.getManager();\n\n\t\t\tswitch (input.command) {\n\t\t\t\tcase \"list\": {\n\t\t\t\t\tif (!manager) return reply(false, \"workflow manager no disponible\");\n\t\t\t\t\tconst runs = await manager.list().catch(() => []);\n\t\t\t\t\treturn reply(true, { runs: runs.slice(0, 20), count: runs.length });\n\t\t\t\t}\n\t\t\t\tcase \"status\": {\n\t\t\t\t\tif (!manager) return reply(false, \"workflow manager no disponible\");\n\t\t\t\t\tif (!input.runId) return reply(false, \"workflow status exige runId\");\n\t\t\t\t\tconst state = await manager.state(input.runId).catch(() => null);\n\t\t\t\t\treturn state\n\t\t\t\t\t\t? reply(true, {\n\t\t\t\t\t\t\t\trunId: state.runId,\n\t\t\t\t\t\t\t\tname: state.name,\n\t\t\t\t\t\t\t\tstatus: state.status,\n\t\t\t\t\t\t\t\tagentCount: state.agentCount,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t: reply(false, \"run no encontrado\");\n\t\t\t\t}\n\t\t\t\tcase \"abort\": {\n\t\t\t\t\tif (!manager) return reply(false, \"workflow manager no disponible\");\n\t\t\t\t\tif (!input.runId) return reply(false, \"workflow abort exige runId\");\n\t\t\t\t\tconst aborted = manager.abort(input.runId);\n\t\t\t\t\treturn reply(true, { aborted, runId: input.runId });\n\t\t\t\t}\n\t\t\t\tcase \"run\": {\n\t\t\t\t\tif (!manager) return reply(false, \"workflow manager no disponible\");\n\t\t\t\t\tconst name = input.name ?? \"\";\n\t\t\t\t\tif (!name) return reply(false, \"workflow run exige name\");\n\t\t\t\t\t// Confirmación de coste estimado (nunca a ciegas).\n\t\t\t\t\tconst estimated = estimateCost(name);\n\t\t\t\t\tconst ok = await confirm(\n\t\t\t\t\t\t`Lanzar workflow \"${name}\"${input.question ? ` (${input.question})` : \"\"}.\\n` +\n\t\t\t\t\t\t\t`Coste estimado: ~${estimated.usd} USD / ${estimated.tokens} tokens. ¿Continuar?`,\n\t\t\t\t\t);\n\t\t\t\t\tif (!ok) return reply(false, \"lanzamiento cancelado por el usuario\");\n\t\t\t\t\tconst script = resolveWorkflowScript(ctx.agentDir, name);\n\t\t\t\t\tif (!script)\n\t\t\t\t\t\treturn reply(\n\t\t\t\t\t\t\tfalse,\n\t\t\t\t\t\t\t`script de workflow no encontrado: ${name} (builtin o <agentDir>/workflows/${name}.js)`,\n\t\t\t\t\t\t);\n\t\t\t\t\tconst toolSid = ctx.sessionId?.();\n\t\t\t\t\tconst result = await manager\n\t\t\t\t\t\t.execute(script, {\n\t\t\t\t\t\t\targs: { question: input.question, name },\n\t\t\t\t\t\t\tawait: input.await ?? true,\n\t\t\t\t\t\t\tdisplayName: name,\n\t\t\t\t\t\t\t...(toolSid ? { sessionId: toolSid } : {}),\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.catch((e) => ({ error: e instanceof Error ? e.message : String(e) }));\n\t\t\t\t\tif (\"error\" in result && result.error) return reply(false, result.error);\n\t\t\t\t\treturn reply(true, result);\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t};\n}\n\n/** Coste estimado por tipo de workflow (heurística simple). */\nfunction estimateCost(name: string): { usd: number; tokens: number } {\n\tconst tokens = name.includes(\"deep\") || name.includes(\"product\") ? 60000 : 25000;\n\treturn { usd: Math.round(tokens * 0.00001 * 100) / 100, tokens };\n}\n\n/** Resuelve el script del workflow: builtin o guardado en <agentDir>/workflows/. */\nfunction resolveWorkflowScript(agentDir: string | undefined, name: string): string | null {\n\tif (!agentDir) return resolveBuiltinWorkflowScript(name);\n\treturn resolveWorkflowScriptByName(agentDir, name)?.script ?? null;\n}\n"]}