@hoilab/ada-cli 0.84.21 → 0.84.22

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"]}

package/dist/core/workflows/tool-workflow.js

@@ -0,0 +1,120 @@
+/**
+ * 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 } from "typebox";
+import { resolveBuiltinWorkflowScript, resolveWorkflowScriptByName } from "./resolve-script.js";
+function reply(ok, text) {
+    return {
+        details: undefined,
+        content: [
+            { type: "text", text: JSON.stringify({ ok, ...(typeof text === "object" ? text : { message: text }) }) },
+        ],
+    };
+}
+/** Crea la tool workflow para la sesión principal. */
+export function createWorkflowTool(ctx) {
+    const confirm = ctx.confirm ?? (async () => true);
+    return {
+        name: "workflow",
+        label: "Workflow",
+        description: "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.",
+        promptSnippet: "Lanza/gestiona workflows con confirmación de coste (workflow run|list|status|abort)",
+        promptGuidelines: [
+            "Usa workflow run para lanzar deep-research o code-review; pide siempre confirmación de coste.",
+            "Usa workflow status para consultar el estado de un run en curso.",
+            "Usa workflow abort para cancelar un run.",
+        ],
+        parameters: Type.Object({
+            command: Type.Union([
+                Type.Literal("run"),
+                Type.Literal("list"),
+                Type.Literal("status"),
+                Type.Literal("abort"),
+            ]),
+            name: Type.Optional(Type.String({
+                description: "Nombre del workflow / del run (deep_research, code_review, product_build, multi_perspective o script guardado)",
+            })),
+            question: Type.Optional(Type.String({ description: "Pregunta o brief (para deep-research)" })),
+            runId: Type.Optional(Type.String({ description: "id del run (para status/abort)" })),
+            await: Type.Optional(Type.Boolean({ description: "Esperar a que termine (default true)" })),
+        }),
+        async execute(_toolCallId, input, _signal, _onUpdate, _ctx) {
+            const manager = ctx.getManager();
+            switch (input.command) {
+                case "list": {
+                    if (!manager)
+                        return reply(false, "workflow manager no disponible");
+                    const runs = await manager.list().catch(() => []);
+                    return reply(true, { runs: runs.slice(0, 20), count: runs.length });
+                }
+                case "status": {
+                    if (!manager)
+                        return reply(false, "workflow manager no disponible");
+                    if (!input.runId)
+                        return reply(false, "workflow status exige runId");
+                    const state = await manager.state(input.runId).catch(() => null);
+                    return state
+                        ? reply(true, {
+                            runId: state.runId,
+                            name: state.name,
+                            status: state.status,
+                            agentCount: state.agentCount,
+                        })
+                        : reply(false, "run no encontrado");
+                }
+                case "abort": {
+                    if (!manager)
+                        return reply(false, "workflow manager no disponible");
+                    if (!input.runId)
+                        return reply(false, "workflow abort exige runId");
+                    const aborted = manager.abort(input.runId);
+                    return reply(true, { aborted, runId: input.runId });
+                }
+                case "run": {
+                    if (!manager)
+                        return reply(false, "workflow manager no disponible");
+                    const name = input.name ?? "";
+                    if (!name)
+                        return reply(false, "workflow run exige name");
+                    // Confirmación de coste estimado (nunca a ciegas).
+                    const estimated = estimateCost(name);
+                    const ok = await confirm(`Lanzar workflow "${name}"${input.question ? ` (${input.question})` : ""}.\n` +
+                        `Coste estimado: ~${estimated.usd} USD / ${estimated.tokens} tokens. ¿Continuar?`);
+                    if (!ok)
+                        return reply(false, "lanzamiento cancelado por el usuario");
+                    const script = resolveWorkflowScript(ctx.agentDir, name);
+                    if (!script)
+                        return reply(false, `script de workflow no encontrado: ${name} (builtin o <agentDir>/workflows/${name}.js)`);
+                    const toolSid = ctx.sessionId?.();
+                    const result = await manager
+                        .execute(script, {
+                        args: { question: input.question, name },
+                        await: input.await ?? true,
+                        displayName: name,
+                        ...(toolSid ? { sessionId: toolSid } : {}),
+                    })
+                        .catch((e) => ({ error: e instanceof Error ? e.message : String(e) }));
+                    if ("error" in result && result.error)
+                        return reply(false, result.error);
+                    return reply(true, result);
+                }
+            }
+        },
+    };
+}
+/** Coste estimado por tipo de workflow (heurística simple). */
+function estimateCost(name) {
+    const tokens = name.includes("deep") || name.includes("product") ? 60000 : 25000;
+    return { usd: Math.round(tokens * 0.00001 * 100) / 100, tokens };
+}
+/** Resuelve el script del workflow: builtin o guardado en <agentDir>/workflows/. */
+function resolveWorkflowScript(agentDir, name) {
+    if (!agentDir)
+        return resolveBuiltinWorkflowScript(name);
+    return resolveWorkflowScriptByName(agentDir, name)?.script ?? null;
+}
+//# sourceMappingURL=tool-workflow.js.map

package/dist/core/workflows/tool-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-workflow.js","sourceRoot":"","sources":["../../../src/core/workflows/tool-workflow.ts"],"names":[],"mappings":"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","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"]}

package/dist/core/workflows/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Ada Intelligence Engine — shared types (Fase 1).
+ *
+ * Workflows dinámicos: scripts JS en sandbox vm con agent/parallel/pipeline/
+ * store/phase/workflow/checkpoint; subagentes via AgentSessionRuntime; journal
+ * con resume determinista; SharedStore con deltas por agente.
+ */
+import type { TSchema } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+export interface WorkflowPhase {
+    title: string;
+    detail?: string;
+    model?: string;
+}
+export interface WorkflowMeta {
+    name: string;
+    description: string;
+    phases?: WorkflowPhase[];
+    /** Modelo por defecto para agentes sin ruta de fase ni model/tier. */
+    model?: string;
+}
+export interface WorkflowLimits {
+    maxAgentsPerRun: number;
+    maxConcurrency: number;
+    maxRetries: number;
+    /** Timeout por agente en ms; null = sin timeout. */
+    agentTimeoutMs: number | null;
+    /** Timeout del script vm en ms. */
+    scriptTimeoutMs: number;
+    /** Timeout del drain de agentes in-flight en ms (finito — adversarial B). */
+    drainTimeoutMs: number;
+}
+export declare const DEFAULT_WORKFLOW_LIMITS: WorkflowLimits;
+export interface AgentRunOptions<TSchemaDef extends TSchema | undefined = TSchema | undefined> {
+    prompt: string;
+    label?: string;
+    /** Modelo "provider/model" o "model" — MODEL_NOT_FOUND si no resuelve. */
+    model?: string;
+    /** Tier ("small"|"medium"|"big") con fallback al modelo de sesión. */
+    tier?: string;
+    /** Fase actual (routing + UI). */
+    phase?: string;
+    /** Structured output (typebox). */
+    schema?: TSchemaDef;
+    /** Tools extra (web_search/web_fetch…). Se AÑADEN a las del agente. */
+    tools?: ToolDefinition[];
+    /**
+     * Mínimo privilegio: el agente solo puede leer (`read`/`grep`/`find`/`ls`).
+     * Para fases de análisis que no deben poder escribir ni ejecutar comandos.
+     * No es un sandbox de SO — acota las tools del subagente, nada más.
+     */
+    readOnly?: boolean;
+    instructions?: string;
+    /** Aislamiento git. */
+    isolation?: "none" | "worktree";
+    /** Clave determinista del worktree (runId:callIndex) — la pone el runtime. */
+    isolationKey?: string;
+    timeoutMs?: number | null;
+    signal?: AbortSignal;
+    /** Clave estable para cache/resume (el autor declara idempotencia). */
+    stableKey?: string;
+    /** cwd del agente (base o worktree). Default: cwd del run. */
+    cwd?: string;
+}
+export interface AgentUsage {
+    input: number;
+    output: number;
+    total: number;
+    cost: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
+export interface AgentRunResult<T = unknown> {
+    result: T | null;
+    text: string;
+    usage: AgentUsage;
+    sessionId?: string;
+    /** Rama `ada/wf/*` con el trabajo del agente, si corrió aislado y escribió. */
+    worktreeBranch?: string;
+}
+export interface JournalEntry {
+    index: number;
+    runId?: string;
+    /** sha256 de la identidad (prompt+model+phase+schema+stableKey). */
+    hash: string;
+    result: unknown;
+    /** Deltas del store escritos por este agente (replay aditivo). */
+    storeDelta?: Record<string, unknown>;
+    /** Marcado cuando el resultado vino de extracción de prosa (fallback schema). */
+    origin?: "structured" | "recovered";
+}
+export interface SharedStoreApi {
+    put(key: string, value: unknown): void;
+    get<T = unknown>(key: string): T | undefined;
+    has(key: string): boolean;
+    delete(key: string): void;
+    entries(): Array<[string, unknown]>;
+}
+export interface CheckpointOptions {
+    default?: unknown;
+    headless?: "default" | "abort";
+    kind?: "confirm" | "input" | "select";
+    choices?: string[];
+}
+export interface WorkflowApi {
+    agent(options: AgentRunOptions): Promise<unknown>;
+    parallel<R>(fns: Array<() => Promise<R>>): Promise<Array<Awaited<R>>>;
+    pipeline<R>(fns: Array<(prev?: Awaited<R>) => Promise<R>>): Promise<Awaited<R>>;
+    phase(title: string, detail?: string): void;
+    store: SharedStoreApi;
+    checkpoint<T>(promptText: string, options?: CheckpointOptions): Promise<T>;
+    args: Record<string, unknown>;
+    cwd: string;
+    runId: string;
+    log(message: string): void;
+}
+export interface WorkflowRunResult<T = unknown> {
+    meta: WorkflowMeta;
+    result: T;
+    logs: string[];
+    phases: string[];
+    agentCount: number;
+    durationMs: number;
+    runId: string;
+    tokenUsage: {
+        input: number;
+        output: number;
+        total: number;
+        cost: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+}
+export type WorkflowErrorCode = "WORKFLOW_INVALID_SCRIPT" | "WORKFLOW_SCRIPT_TIMEOUT" | "WORKFLOW_AGENT_TIMEOUT" | "WORKFLOW_MAX_AGENTS" | "WORKFLOW_ABORTED" | "WORKFLOW_BUDGET_EXCEEDED" | "WORKFLOW_RESUME_CORRUPT" | "MODEL_NOT_FOUND";
+export declare class WorkflowError extends Error {
+    readonly code: WorkflowErrorCode;
+    readonly recoverable: boolean;
+    constructor(code: WorkflowErrorCode, message: string, options?: {
+        recoverable?: boolean;
+    });
+}
+//# sourceMappingURL=types.d.ts.map