@hoilab/ada-cli 0.84.21 → 0.85.0

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,191 @@
+/**
+ * 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";
+import type { HallazgoParcial } from "./contrato/yield.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;
+    /**
+     * Da acceso a `web_search`/`web_fetch`. Opt-in explícito y independiente de
+     * `readOnly`: la red no se hereda de "solo lectura" porque un agente con red
+     * puede sacar fuera lo que ha leído.
+     */
+    web?: boolean;
+    /**
+     * Da acceso a las tools de navegador. Opt-in aparte de `web`: descargar una
+     * URL y conducir un navegador no son el mismo permiso.
+     */
+    browser?: 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;
+    /**
+     * Nombre de un agente definido por el usuario en `~/.ada/agents/<n>.md` o,
+     * si el proyecto es de confianza, en `<proyecto>/.ada/agents/<n>.md`. Sus
+     * ajustes se aplican como BASE: lo que se pase aquí explícitamente gana.
+     */
+    agentType?: string;
+    /**
+     * Se llama EN CUANTO el subagente entrega un hallazgo parcial (tool
+     * `yield`) — antes de que el subagente termine. Es la vía para consumir
+     * resultados incrementales sin esperar al final del run.
+     */
+    onYield?: (hallazgo: HallazgoParcial) => void;
+    /**
+     * Reintentos de validación de esquema tras una salida que no valida
+     * (además del primer intento). Solo aplica si hay esquema, de la llamada o
+     * del agente. Default: 2.
+     */
+    maxReintentosValidacion?: number;
+}
+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;
+    /**
+     * true cuando `result` es un YIELD FINAL FORZADO: el subagente se
+     * descarriló (error o timeout) pero había hallazgos entregados por
+     * `yield` — se devuelven en vez de perderse. NO se activa con un abort
+     * (`signal.aborted`): cancelar sigue devolviendo `null`, sin hallazgos,
+     * igual que un run completo cancelado. Ver agent-runner.ts.
+     */
+    descarrilado?: boolean;
+    /** Motivo del descarrilamiento (mensaje de error). Solo si `descarrilado`. */
+    motivoDescarrile?: string;
+    /** Hallazgos entregados por `yield` durante el run, en orden de entrega. */
+    hallazgos?: HallazgoParcial[];
+    /** Resultado de validar `result` contra el esquema declarado, si había uno. */
+    validacion?: {
+        valido: boolean;
+        intentos: number;
+        reparado: boolean;
+        errores?: 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ada Intelligence Engine — shared types (Fase 1).\n *\n * Workflows dinámicos: scripts JS en sandbox vm con agent/parallel/pipeline/\n * store/phase/workflow/checkpoint; subagentes via AgentSessionRuntime; journal\n * con resume determinista; SharedStore con deltas por agente.\n */\n\nimport type { TSchema } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { HallazgoParcial } from \"./contrato/yield.ts\";\n\n// ─── Meta y fases ───\n\nexport interface WorkflowPhase {\n\ttitle: string;\n\tdetail?: string;\n\tmodel?: string;\n}\n\nexport interface WorkflowMeta {\n\tname: string;\n\tdescription: string;\n\tphases?: WorkflowPhase[];\n\t/** Modelo por defecto para agentes sin ruta de fase ni model/tier. */\n\tmodel?: string;\n}\n\n// ─── Límites ───\n\nexport interface WorkflowLimits {\n\tmaxAgentsPerRun: number;\n\tmaxConcurrency: number;\n\tmaxRetries: number;\n\t/** Timeout por agente en ms; null = sin timeout. */\n\tagentTimeoutMs: number | null;\n\t/** Timeout del script vm en ms. */\n\tscriptTimeoutMs: number;\n\t/** Timeout del drain de agentes in-flight en ms (finito — adversarial B). */\n\tdrainTimeoutMs: number;\n}\n\nexport const DEFAULT_WORKFLOW_LIMITS: WorkflowLimits = {\n\tmaxAgentsPerRun: 100,\n\tmaxConcurrency: 4,\n\tmaxRetries: 3,\n\tagentTimeoutMs: 30 * 60 * 1000, // 30 min (Kimi Code alineado)\n\tscriptTimeoutMs: 5 * 60 * 1000, // 5 min\n\tdrainTimeoutMs: 30_000,\n};\n\n// ─── Subagente ───\n\nexport interface AgentRunOptions<TSchemaDef extends TSchema | undefined = TSchema | undefined> {\n\tprompt: string; // OBLIGATORIO\n\tlabel?: string; // nombre en la UI y nombre de la sesión del subagente\n\t/** Modelo \"provider/model\" o \"model\" — MODEL_NOT_FOUND si no resuelve. */\n\tmodel?: string;\n\t/** Tier (\"small\"|\"medium\"|\"big\") con fallback al modelo de sesión. */\n\ttier?: string;\n\t/** Fase actual (routing + UI). */\n\tphase?: string;\n\t/** Structured output (typebox). */\n\tschema?: TSchemaDef;\n\t/** Tools extra (web_search/web_fetch…). Se AÑADEN a las del agente. */\n\ttools?: ToolDefinition[];\n\t/**\n\t * Mínimo privilegio: el agente solo puede leer (`read`/`grep`/`find`/`ls`).\n\t * Para fases de análisis que no deben poder escribir ni ejecutar comandos.\n\t * No es un sandbox de SO — acota las tools del subagente, nada más.\n\t */\n\treadOnly?: boolean;\n\t/**\n\t * Da acceso a `web_search`/`web_fetch`. Opt-in explícito y independiente de\n\t * `readOnly`: la red no se hereda de \"solo lectura\" porque un agente con red\n\t * puede sacar fuera lo que ha leído.\n\t */\n\tweb?: boolean;\n\t/**\n\t * Da acceso a las tools de navegador. Opt-in aparte de `web`: descargar una\n\t * URL y conducir un navegador no son el mismo permiso.\n\t */\n\tbrowser?: boolean;\n\tinstructions?: string;\n\t/** Aislamiento git. */\n\tisolation?: \"none\" | \"worktree\";\n\t/** Clave determinista del worktree (runId:callIndex) — la pone el runtime. */\n\tisolationKey?: string;\n\ttimeoutMs?: number | null;\n\tsignal?: AbortSignal;\n\t/** Clave estable para cache/resume (el autor declara idempotencia). */\n\tstableKey?: string;\n\t/** cwd del agente (base o worktree). Default: cwd del run. */\n\tcwd?: string;\n\t/**\n\t * Nombre de un agente definido por el usuario en `~/.ada/agents/<n>.md` o,\n\t * si el proyecto es de confianza, en `<proyecto>/.ada/agents/<n>.md`. Sus\n\t * ajustes se aplican como BASE: lo que se pase aquí explícitamente gana.\n\t */\n\tagentType?: string;\n\t/**\n\t * Se llama EN CUANTO el subagente entrega un hallazgo parcial (tool\n\t * `yield`) — antes de que el subagente termine. Es la vía para consumir\n\t * resultados incrementales sin esperar al final del run.\n\t */\n\tonYield?: (hallazgo: HallazgoParcial) => void;\n\t/**\n\t * Reintentos de validación de esquema tras una salida que no valida\n\t * (además del primer intento). Solo aplica si hay esquema, de la llamada o\n\t * del agente. Default: 2.\n\t */\n\tmaxReintentosValidacion?: number;\n}\n\nexport interface AgentUsage {\n\tinput: number;\n\toutput: number;\n\ttotal: number;\n\tcost: number;\n\tcacheRead?: number;\n\tcacheWrite?: number;\n}\n\nexport interface AgentRunResult<T = unknown> {\n\tresult: T | null;\n\ttext: string;\n\tusage: AgentUsage;\n\tsessionId?: string;\n\t/** Rama `ada/wf/*` con el trabajo del agente, si corrió aislado y escribió. */\n\tworktreeBranch?: string;\n\t/**\n\t * true cuando `result` es un YIELD FINAL FORZADO: el subagente se\n\t * descarriló (error o timeout) pero había hallazgos entregados por\n\t * `yield` — se devuelven en vez de perderse. NO se activa con un abort\n\t * (`signal.aborted`): cancelar sigue devolviendo `null`, sin hallazgos,\n\t * igual que un run completo cancelado. Ver agent-runner.ts.\n\t */\n\tdescarrilado?: boolean;\n\t/** Motivo del descarrilamiento (mensaje de error). Solo si `descarrilado`. */\n\tmotivoDescarrile?: string;\n\t/** Hallazgos entregados por `yield` durante el run, en orden de entrega. */\n\thallazgos?: HallazgoParcial[];\n\t/** Resultado de validar `result` contra el esquema declarado, si había uno. */\n\tvalidacion?: {\n\t\tvalido: boolean;\n\t\tintentos: number;\n\t\treparado: boolean;\n\t\terrores?: string[];\n\t};\n}\n\n// ─── Journal ───\n\nexport interface JournalEntry {\n\tindex: number;\n\trunId?: string;\n\t/** sha256 de la identidad (prompt+model+phase+schema+stableKey). */\n\thash: string;\n\tresult: unknown;\n\t/** Deltas del store escritos por este agente (replay aditivo). */\n\tstoreDelta?: Record<string, unknown>;\n\t/** Marcado cuando el resultado vino de extracción de prosa (fallback schema). */\n\torigin?: \"structured\" | \"recovered\";\n}\n\n// ─── SharedStore ───\n\nexport interface SharedStoreApi {\n\tput(key: string, value: unknown): void;\n\tget<T = unknown>(key: string): T | undefined;\n\thas(key: string): boolean;\n\tdelete(key: string): void;\n\tentries(): Array<[string, unknown]>;\n}\n\n// ─── Checkpoint (gate humano) ───\n\nexport interface CheckpointOptions {\n\tdefault?: unknown;\n\theadless?: \"default\" | \"abort\";\n\tkind?: \"confirm\" | \"input\" | \"select\";\n\tchoices?: string[];\n}\n\n// ─── API del script (lo que recibe la función del vm) ───\n\nexport interface WorkflowApi {\n\tagent(options: AgentRunOptions): Promise<unknown>;\n\tparallel<R>(fns: Array<() => Promise<R>>): Promise<Array<Awaited<R>>>;\n\tpipeline<R>(fns: Array<(prev?: Awaited<R>) => Promise<R>>): Promise<Awaited<R>>;\n\tphase(title: string, detail?: string): void;\n\tstore: SharedStoreApi;\n\tcheckpoint<T>(promptText: string, options?: CheckpointOptions): Promise<T>;\n\targs: Record<string, unknown>;\n\tcwd: string;\n\trunId: string;\n\tlog(message: string): void;\n}\n\n// ─── Resultado del run ───\n\nexport interface WorkflowRunResult<T = unknown> {\n\tmeta: WorkflowMeta;\n\tresult: T;\n\tlogs: string[];\n\tphases: string[];\n\tagentCount: number;\n\tdurationMs: number;\n\trunId: string;\n\ttokenUsage: {\n\t\tinput: number;\n\t\toutput: number;\n\t\ttotal: number;\n\t\tcost: number;\n\t\tcacheRead?: number;\n\t\tcacheWrite?: number;\n\t};\n}\n\n// ─── Errores ───\n\nexport type WorkflowErrorCode =\n\t| \"WORKFLOW_INVALID_SCRIPT\"\n\t| \"WORKFLOW_SCRIPT_TIMEOUT\"\n\t| \"WORKFLOW_AGENT_TIMEOUT\"\n\t| \"WORKFLOW_MAX_AGENTS\"\n\t| \"WORKFLOW_ABORTED\"\n\t| \"WORKFLOW_BUDGET_EXCEEDED\"\n\t| \"WORKFLOW_RESUME_CORRUPT\"\n\t| \"MODEL_NOT_FOUND\";\n\nexport class WorkflowError extends Error {\n\treadonly code: WorkflowErrorCode;\n\treadonly recoverable: boolean;\n\n\tconstructor(code: WorkflowErrorCode, message: string, options: { recoverable?: boolean } = {}) {\n\t\tsuper(message);\n\t\tthis.name = \"WorkflowError\";\n\t\tthis.code = code;\n\t\tthis.recoverable = options.recoverable ?? true;\n\t}\n}\n"]}

package/dist/core/workflows/types.js

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+export const DEFAULT_WORKFLOW_LIMITS = {
+    maxAgentsPerRun: 100,
+    maxConcurrency: 4,
+    maxRetries: 3,
+    agentTimeoutMs: 30 * 60 * 1000, // 30 min (Kimi Code alineado)
+    scriptTimeoutMs: 5 * 60 * 1000, // 5 min
+    drainTimeoutMs: 30_000,
+};
+export class WorkflowError extends Error {
+    code;
+    recoverable;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = "WorkflowError";
+        this.code = code;
+        this.recoverable = options.recoverable ?? true;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/workflows/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoCH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACtD,eAAe,EAAE,GAAG;IACpB,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,8BAA8B;IAC9D,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ;IACxC,cAAc,EAAE,MAAM;CACtB,CAAC;AAsLF,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC9B,IAAI,CAAoB;IACxB,WAAW,CAAU;IAE9B,YAAY,IAAuB,EAAE,OAAe,EAAE,OAAO,GAA8B,EAAE,EAAE;QAC9F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAAA,CAC/C;CACD","sourcesContent":["/**\n * Ada Intelligence Engine — shared types (Fase 1).\n *\n * Workflows dinámicos: scripts JS en sandbox vm con agent/parallel/pipeline/\n * store/phase/workflow/checkpoint; subagentes via AgentSessionRuntime; journal\n * con resume determinista; SharedStore con deltas por agente.\n */\n\nimport type { TSchema } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { HallazgoParcial } from \"./contrato/yield.ts\";\n\n// ─── Meta y fases ───\n\nexport interface WorkflowPhase {\n\ttitle: string;\n\tdetail?: string;\n\tmodel?: string;\n}\n\nexport interface WorkflowMeta {\n\tname: string;\n\tdescription: string;\n\tphases?: WorkflowPhase[];\n\t/** Modelo por defecto para agentes sin ruta de fase ni model/tier. */\n\tmodel?: string;\n}\n\n// ─── Límites ───\n\nexport interface WorkflowLimits {\n\tmaxAgentsPerRun: number;\n\tmaxConcurrency: number;\n\tmaxRetries: number;\n\t/** Timeout por agente en ms; null = sin timeout. */\n\tagentTimeoutMs: number | null;\n\t/** Timeout del script vm en ms. */\n\tscriptTimeoutMs: number;\n\t/** Timeout del drain de agentes in-flight en ms (finito — adversarial B). */\n\tdrainTimeoutMs: number;\n}\n\nexport const DEFAULT_WORKFLOW_LIMITS: WorkflowLimits = {\n\tmaxAgentsPerRun: 100,\n\tmaxConcurrency: 4,\n\tmaxRetries: 3,\n\tagentTimeoutMs: 30 * 60 * 1000, // 30 min (Kimi Code alineado)\n\tscriptTimeoutMs: 5 * 60 * 1000, // 5 min\n\tdrainTimeoutMs: 30_000,\n};\n\n// ─── Subagente ───\n\nexport interface AgentRunOptions<TSchemaDef extends TSchema | undefined = TSchema | undefined> {\n\tprompt: string; // OBLIGATORIO\n\tlabel?: string; // nombre en la UI y nombre de la sesión del subagente\n\t/** Modelo \"provider/model\" o \"model\" — MODEL_NOT_FOUND si no resuelve. */\n\tmodel?: string;\n\t/** Tier (\"small\"|\"medium\"|\"big\") con fallback al modelo de sesión. */\n\ttier?: string;\n\t/** Fase actual (routing + UI). */\n\tphase?: string;\n\t/** Structured output (typebox). */\n\tschema?: TSchemaDef;\n\t/** Tools extra (web_search/web_fetch…). Se AÑADEN a las del agente. */\n\ttools?: ToolDefinition[];\n\t/**\n\t * Mínimo privilegio: el agente solo puede leer (`read`/`grep`/`find`/`ls`).\n\t * Para fases de análisis que no deben poder escribir ni ejecutar comandos.\n\t * No es un sandbox de SO — acota las tools del subagente, nada más.\n\t */\n\treadOnly?: boolean;\n\t/**\n\t * Da acceso a `web_search`/`web_fetch`. Opt-in explícito y independiente de\n\t * `readOnly`: la red no se hereda de \"solo lectura\" porque un agente con red\n\t * puede sacar fuera lo que ha leído.\n\t */\n\tweb?: boolean;\n\t/**\n\t * Da acceso a las tools de navegador. Opt-in aparte de `web`: descargar una\n\t * URL y conducir un navegador no son el mismo permiso.\n\t */\n\tbrowser?: boolean;\n\tinstructions?: string;\n\t/** Aislamiento git. */\n\tisolation?: \"none\" | \"worktree\";\n\t/** Clave determinista del worktree (runId:callIndex) — la pone el runtime. */\n\tisolationKey?: string;\n\ttimeoutMs?: number | null;\n\tsignal?: AbortSignal;\n\t/** Clave estable para cache/resume (el autor declara idempotencia). */\n\tstableKey?: string;\n\t/** cwd del agente (base o worktree). Default: cwd del run. */\n\tcwd?: string;\n\t/**\n\t * Nombre de un agente definido por el usuario en `~/.ada/agents/<n>.md` o,\n\t * si el proyecto es de confianza, en `<proyecto>/.ada/agents/<n>.md`. Sus\n\t * ajustes se aplican como BASE: lo que se pase aquí explícitamente gana.\n\t */\n\tagentType?: string;\n\t/**\n\t * Se llama EN CUANTO el subagente entrega un hallazgo parcial (tool\n\t * `yield`) — antes de que el subagente termine. Es la vía para consumir\n\t * resultados incrementales sin esperar al final del run.\n\t */\n\tonYield?: (hallazgo: HallazgoParcial) => void;\n\t/**\n\t * Reintentos de validación de esquema tras una salida que no valida\n\t * (además del primer intento). Solo aplica si hay esquema, de la llamada o\n\t * del agente. Default: 2.\n\t */\n\tmaxReintentosValidacion?: number;\n}\n\nexport interface AgentUsage {\n\tinput: number;\n\toutput: number;\n\ttotal: number;\n\tcost: number;\n\tcacheRead?: number;\n\tcacheWrite?: number;\n}\n\nexport interface AgentRunResult<T = unknown> {\n\tresult: T | null;\n\ttext: string;\n\tusage: AgentUsage;\n\tsessionId?: string;\n\t/** Rama `ada/wf/*` con el trabajo del agente, si corrió aislado y escribió. */\n\tworktreeBranch?: string;\n\t/**\n\t * true cuando `result` es un YIELD FINAL FORZADO: el subagente se\n\t * descarriló (error o timeout) pero había hallazgos entregados por\n\t * `yield` — se devuelven en vez de perderse. NO se activa con un abort\n\t * (`signal.aborted`): cancelar sigue devolviendo `null`, sin hallazgos,\n\t * igual que un run completo cancelado. Ver agent-runner.ts.\n\t */\n\tdescarrilado?: boolean;\n\t/** Motivo del descarrilamiento (mensaje de error). Solo si `descarrilado`. */\n\tmotivoDescarrile?: string;\n\t/** Hallazgos entregados por `yield` durante el run, en orden de entrega. */\n\thallazgos?: HallazgoParcial[];\n\t/** Resultado de validar `result` contra el esquema declarado, si había uno. */\n\tvalidacion?: {\n\t\tvalido: boolean;\n\t\tintentos: number;\n\t\treparado: boolean;\n\t\terrores?: string[];\n\t};\n}\n\n// ─── Journal ───\n\nexport interface JournalEntry {\n\tindex: number;\n\trunId?: string;\n\t/** sha256 de la identidad (prompt+model+phase+schema+stableKey). */\n\thash: string;\n\tresult: unknown;\n\t/** Deltas del store escritos por este agente (replay aditivo). */\n\tstoreDelta?: Record<string, unknown>;\n\t/** Marcado cuando el resultado vino de extracción de prosa (fallback schema). */\n\torigin?: \"structured\" | \"recovered\";\n}\n\n// ─── SharedStore ───\n\nexport interface SharedStoreApi {\n\tput(key: string, value: unknown): void;\n\tget<T = unknown>(key: string): T | undefined;\n\thas(key: string): boolean;\n\tdelete(key: string): void;\n\tentries(): Array<[string, unknown]>;\n}\n\n// ─── Checkpoint (gate humano) ───\n\nexport interface CheckpointOptions {\n\tdefault?: unknown;\n\theadless?: \"default\" | \"abort\";\n\tkind?: \"confirm\" | \"input\" | \"select\";\n\tchoices?: string[];\n}\n\n// ─── API del script (lo que recibe la función del vm) ───\n\nexport interface WorkflowApi {\n\tagent(options: AgentRunOptions): Promise<unknown>;\n\tparallel<R>(fns: Array<() => Promise<R>>): Promise<Array<Awaited<R>>>;\n\tpipeline<R>(fns: Array<(prev?: Awaited<R>) => Promise<R>>): Promise<Awaited<R>>;\n\tphase(title: string, detail?: string): void;\n\tstore: SharedStoreApi;\n\tcheckpoint<T>(promptText: string, options?: CheckpointOptions): Promise<T>;\n\targs: Record<string, unknown>;\n\tcwd: string;\n\trunId: string;\n\tlog(message: string): void;\n}\n\n// ─── Resultado del run ───\n\nexport interface WorkflowRunResult<T = unknown> {\n\tmeta: WorkflowMeta;\n\tresult: T;\n\tlogs: string[];\n\tphases: string[];\n\tagentCount: number;\n\tdurationMs: number;\n\trunId: string;\n\ttokenUsage: {\n\t\tinput: number;\n\t\toutput: number;\n\t\ttotal: number;\n\t\tcost: number;\n\t\tcacheRead?: number;\n\t\tcacheWrite?: number;\n\t};\n}\n\n// ─── Errores ───\n\nexport type WorkflowErrorCode =\n\t| \"WORKFLOW_INVALID_SCRIPT\"\n\t| \"WORKFLOW_SCRIPT_TIMEOUT\"\n\t| \"WORKFLOW_AGENT_TIMEOUT\"\n\t| \"WORKFLOW_MAX_AGENTS\"\n\t| \"WORKFLOW_ABORTED\"\n\t| \"WORKFLOW_BUDGET_EXCEEDED\"\n\t| \"WORKFLOW_RESUME_CORRUPT\"\n\t| \"MODEL_NOT_FOUND\";\n\nexport class WorkflowError extends Error {\n\treadonly code: WorkflowErrorCode;\n\treadonly recoverable: boolean;\n\n\tconstructor(code: WorkflowErrorCode, message: string, options: { recoverable?: boolean } = {}) {\n\t\tsuper(message);\n\t\tthis.name = \"WorkflowError\";\n\t\tthis.code = code;\n\t\tthis.recoverable = options.recoverable ?? true;\n\t}\n}\n"]}

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

@@ -0,0 +1,42 @@
+/**
+ * Worktree — aislamiento git por agente.
+ *
+ * Cuando un agente pide `isolation: "worktree"` (o tiene tools de escritura),
+ * corre en un worktree desechable sobre su propia rama: los subagentes pueden
+ * editar los mismos archivos sin conflicto. El nombre es determinista
+ * (runId+callIndex) para que el resume reencuentre el mismo worktree.
+ * Sin auto-merge: la ruta se expone al caller. Limpieza best-effort.
+ */
+export interface Worktree {
+    /** True cuando se creó un worktree real; false = corrió en el árbol compartido. */
+    isolated: boolean;
+    /** cwd del agente (worktree cuando aislado, si no el base). */
+    cwd: string;
+    branch?: string;
+    repoRoot?: string;
+    reason?: string;
+}
+/**
+ * Crea un worktree aislado bajo `<repoRoot>/.ada/worktrees/<name>` en la rama
+ * `ada/wf/<name>`. Fallback a no-op (árbol compartido) ante cualquier fallo.
+ */
+export declare function createWorktree(baseCwd: string, name: string): Promise<Worktree>;
+/**
+ * Cierra un worktree CONSERVANDO el trabajo: commitea lo que haya en su rama y
+ * retira solo el directorio.
+ *
+ * Retirar el worktree sin más borraría los cambios sin commitear del agente, y
+ * entonces el aislamiento no serviría de nada: los escritores paralelos no
+ * chocarían, pero su trabajo se perdería igual. Sin auto-merge a propósito — la
+ * rama queda para que un humano la revise (`git branch --list 'ada/wf/*'`).
+ *
+ * Si el agente no tocó nada (p.ej. una fase de análisis de solo lectura), borra
+ * también la rama: no hay nada que conservar y las ramas vacías son ruido.
+ */
+export declare function finalizeWorktree(wt: Worktree, message: string): Promise<{
+    branch?: string;
+    kept: boolean;
+}>;
+/** Elimina un worktree y su rama, DESCARTANDO el trabajo. Best-effort. */
+export declare function removeWorktree(wt: Worktree): Promise<void>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/core/workflows/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,WAAW,QAAQ;IACxB,sFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkBrF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBjH;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE","sourcesContent":["/**\n * Worktree — aislamiento git por agente.\n *\n * Cuando un agente pide `isolation: \"worktree\"` (o tiene tools de escritura),\n * corre en un worktree desechable sobre su propia rama: los subagentes pueden\n * editar los mismos archivos sin conflicto. El nombre es determinista\n * (runId+callIndex) para que el resume reencuentre el mismo worktree.\n * Sin auto-merge: la ruta se expone al caller. Limpieza best-effort.\n */\n\nimport { execFile } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\n// execFile (no shell): los argumentos van en array, sin interpolar en una cadena.\nconst execFileAsync = promisify(execFile);\n\nexport interface Worktree {\n\t/** True cuando se creó un worktree real; false = corrió en el árbol compartido. */\n\tisolated: boolean;\n\t/** cwd del agente (worktree cuando aislado, si no el base). */\n\tcwd: string;\n\tbranch?: string;\n\trepoRoot?: string;\n\treason?: string;\n}\n\nfunction slug(name: string): string {\n\treturn (\n\t\tname\n\t\t\t.toLowerCase()\n\t\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t\t.replace(/^-+|-+$/g, \"\")\n\t\t\t.slice(0, 48) || \"agent\"\n\t);\n}\n\n/**\n * Crea un worktree aislado bajo `<repoRoot>/.ada/worktrees/<name>` en la rama\n * `ada/wf/<name>`. Fallback a no-op (árbol compartido) ante cualquier fallo.\n */\nexport async function createWorktree(baseCwd: string, name: string): Promise<Worktree> {\n\tconst id = slug(name);\n\tlet repoRoot: string;\n\ttry {\n\t\tconst { stdout } = await execFileAsync(\"git\", [\"-C\", baseCwd, \"rev-parse\", \"--show-toplevel\"]);\n\t\trepoRoot = stdout.trim();\n\t} catch {\n\t\treturn { isolated: false, cwd: baseCwd, reason: \"not a git repository\" };\n\t}\n\n\tconst path = join(repoRoot, \".ada\", \"worktrees\", id);\n\tconst branch = `ada/wf/${id}`;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", repoRoot, \"worktree\", \"add\", \"-b\", branch, path, \"HEAD\"]);\n\t\treturn { isolated: true, cwd: path, branch, repoRoot };\n\t} catch (error) {\n\t\treturn { isolated: false, cwd: baseCwd, reason: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\n/**\n * Cierra un worktree CONSERVANDO el trabajo: commitea lo que haya en su rama y\n * retira solo el directorio.\n *\n * Retirar el worktree sin más borraría los cambios sin commitear del agente, y\n * entonces el aislamiento no serviría de nada: los escritores paralelos no\n * chocarían, pero su trabajo se perdería igual. Sin auto-merge a propósito — la\n * rama queda para que un humano la revise (`git branch --list 'ada/wf/*'`).\n *\n * Si el agente no tocó nada (p.ej. una fase de análisis de solo lectura), borra\n * también la rama: no hay nada que conservar y las ramas vacías son ruido.\n */\nexport async function finalizeWorktree(wt: Worktree, message: string): Promise<{ branch?: string; kept: boolean }> {\n\tif (!wt.isolated || !wt.repoRoot) return { kept: false };\n\tlet kept = false;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.cwd, \"add\", \"-A\"]);\n\t\t// `commit` sale distinto de 0 cuando no hay nada que commitear; eso no es\n\t\t// un error, es el camino normal de un agente que no escribió.\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.cwd, \"commit\", \"-m\", message]);\n\t\tkept = true;\n\t} catch {\n\t\tkept = false;\n\t}\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"worktree\", \"remove\", \"--force\", wt.cwd]);\n\t} catch {\n\t\t// ya no existe / locked — continuar\n\t}\n\tif (!kept && wt.branch) {\n\t\ttry {\n\t\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"branch\", \"-D\", wt.branch]);\n\t\t} catch {\n\t\t\t// rama ya borrada\n\t\t}\n\t}\n\treturn { branch: kept ? wt.branch : undefined, kept };\n}\n\n/** Elimina un worktree y su rama, DESCARTANDO el trabajo. Best-effort. */\nexport async function removeWorktree(wt: Worktree): Promise<void> {\n\tif (!wt.isolated || !wt.repoRoot) return;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"worktree\", \"remove\", \"--force\", wt.cwd]);\n\t} catch {\n\t\t// ya no existe / locked — continuar\n\t}\n\tif (wt.branch) {\n\t\ttry {\n\t\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"branch\", \"-D\", wt.branch]);\n\t\t} catch {\n\t\t\t// rama ya borrada\n\t\t}\n\t}\n}\n"]}

package/dist/core/workflows/worktree.js

@@ -0,0 +1,107 @@
+/**
+ * Worktree — aislamiento git por agente.
+ *
+ * Cuando un agente pide `isolation: "worktree"` (o tiene tools de escritura),
+ * corre en un worktree desechable sobre su propia rama: los subagentes pueden
+ * editar los mismos archivos sin conflicto. El nombre es determinista
+ * (runId+callIndex) para que el resume reencuentre el mismo worktree.
+ * Sin auto-merge: la ruta se expone al caller. Limpieza best-effort.
+ */
+import { execFile } from "node:child_process";
+import { join } from "node:path";
+import { promisify } from "node:util";
+// execFile (no shell): los argumentos van en array, sin interpolar en una cadena.
+const execFileAsync = promisify(execFile);
+function slug(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48) || "agent");
+}
+/**
+ * Crea un worktree aislado bajo `<repoRoot>/.ada/worktrees/<name>` en la rama
+ * `ada/wf/<name>`. Fallback a no-op (árbol compartido) ante cualquier fallo.
+ */
+export async function createWorktree(baseCwd, name) {
+    const id = slug(name);
+    let repoRoot;
+    try {
+        const { stdout } = await execFileAsync("git", ["-C", baseCwd, "rev-parse", "--show-toplevel"]);
+        repoRoot = stdout.trim();
+    }
+    catch {
+        return { isolated: false, cwd: baseCwd, reason: "not a git repository" };
+    }
+    const path = join(repoRoot, ".ada", "worktrees", id);
+    const branch = `ada/wf/${id}`;
+    try {
+        await execFileAsync("git", ["-C", repoRoot, "worktree", "add", "-b", branch, path, "HEAD"]);
+        return { isolated: true, cwd: path, branch, repoRoot };
+    }
+    catch (error) {
+        return { isolated: false, cwd: baseCwd, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Cierra un worktree CONSERVANDO el trabajo: commitea lo que haya en su rama y
+ * retira solo el directorio.
+ *
+ * Retirar el worktree sin más borraría los cambios sin commitear del agente, y
+ * entonces el aislamiento no serviría de nada: los escritores paralelos no
+ * chocarían, pero su trabajo se perdería igual. Sin auto-merge a propósito — la
+ * rama queda para que un humano la revise (`git branch --list 'ada/wf/*'`).
+ *
+ * Si el agente no tocó nada (p.ej. una fase de análisis de solo lectura), borra
+ * también la rama: no hay nada que conservar y las ramas vacías son ruido.
+ */
+export async function finalizeWorktree(wt, message) {
+    if (!wt.isolated || !wt.repoRoot)
+        return { kept: false };
+    let kept = false;
+    try {
+        await execFileAsync("git", ["-C", wt.cwd, "add", "-A"]);
+        // `commit` sale distinto de 0 cuando no hay nada que commitear; eso no es
+        // un error, es el camino normal de un agente que no escribió.
+        await execFileAsync("git", ["-C", wt.cwd, "commit", "-m", message]);
+        kept = true;
+    }
+    catch {
+        kept = false;
+    }
+    try {
+        await execFileAsync("git", ["-C", wt.repoRoot, "worktree", "remove", "--force", wt.cwd]);
+    }
+    catch {
+        // ya no existe / locked — continuar
+    }
+    if (!kept && wt.branch) {
+        try {
+            await execFileAsync("git", ["-C", wt.repoRoot, "branch", "-D", wt.branch]);
+        }
+        catch {
+            // rama ya borrada
+        }
+    }
+    return { branch: kept ? wt.branch : undefined, kept };
+}
+/** Elimina un worktree y su rama, DESCARTANDO el trabajo. Best-effort. */
+export async function removeWorktree(wt) {
+    if (!wt.isolated || !wt.repoRoot)
+        return;
+    try {
+        await execFileAsync("git", ["-C", wt.repoRoot, "worktree", "remove", "--force", wt.cwd]);
+    }
+    catch {
+        // ya no existe / locked — continuar
+    }
+    if (wt.branch) {
+        try {
+            await execFileAsync("git", ["-C", wt.repoRoot, "branch", "-D", wt.branch]);
+        }
+        catch {
+            // rama ya borrada
+        }
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/core/workflows/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../../src/core/workflows/worktree.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Worktree — aislamiento git por agente.\n *\n * Cuando un agente pide `isolation: \"worktree\"` (o tiene tools de escritura),\n * corre en un worktree desechable sobre su propia rama: los subagentes pueden\n * editar los mismos archivos sin conflicto. El nombre es determinista\n * (runId+callIndex) para que el resume reencuentre el mismo worktree.\n * Sin auto-merge: la ruta se expone al caller. Limpieza best-effort.\n */\n\nimport { execFile } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\n\n// execFile (no shell): los argumentos van en array, sin interpolar en una cadena.\nconst execFileAsync = promisify(execFile);\n\nexport interface Worktree {\n\t/** True cuando se creó un worktree real; false = corrió en el árbol compartido. */\n\tisolated: boolean;\n\t/** cwd del agente (worktree cuando aislado, si no el base). */\n\tcwd: string;\n\tbranch?: string;\n\trepoRoot?: string;\n\treason?: string;\n}\n\nfunction slug(name: string): string {\n\treturn (\n\t\tname\n\t\t\t.toLowerCase()\n\t\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t\t.replace(/^-+|-+$/g, \"\")\n\t\t\t.slice(0, 48) || \"agent\"\n\t);\n}\n\n/**\n * Crea un worktree aislado bajo `<repoRoot>/.ada/worktrees/<name>` en la rama\n * `ada/wf/<name>`. Fallback a no-op (árbol compartido) ante cualquier fallo.\n */\nexport async function createWorktree(baseCwd: string, name: string): Promise<Worktree> {\n\tconst id = slug(name);\n\tlet repoRoot: string;\n\ttry {\n\t\tconst { stdout } = await execFileAsync(\"git\", [\"-C\", baseCwd, \"rev-parse\", \"--show-toplevel\"]);\n\t\trepoRoot = stdout.trim();\n\t} catch {\n\t\treturn { isolated: false, cwd: baseCwd, reason: \"not a git repository\" };\n\t}\n\n\tconst path = join(repoRoot, \".ada\", \"worktrees\", id);\n\tconst branch = `ada/wf/${id}`;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", repoRoot, \"worktree\", \"add\", \"-b\", branch, path, \"HEAD\"]);\n\t\treturn { isolated: true, cwd: path, branch, repoRoot };\n\t} catch (error) {\n\t\treturn { isolated: false, cwd: baseCwd, reason: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\n/**\n * Cierra un worktree CONSERVANDO el trabajo: commitea lo que haya en su rama y\n * retira solo el directorio.\n *\n * Retirar el worktree sin más borraría los cambios sin commitear del agente, y\n * entonces el aislamiento no serviría de nada: los escritores paralelos no\n * chocarían, pero su trabajo se perdería igual. Sin auto-merge a propósito — la\n * rama queda para que un humano la revise (`git branch --list 'ada/wf/*'`).\n *\n * Si el agente no tocó nada (p.ej. una fase de análisis de solo lectura), borra\n * también la rama: no hay nada que conservar y las ramas vacías son ruido.\n */\nexport async function finalizeWorktree(wt: Worktree, message: string): Promise<{ branch?: string; kept: boolean }> {\n\tif (!wt.isolated || !wt.repoRoot) return { kept: false };\n\tlet kept = false;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.cwd, \"add\", \"-A\"]);\n\t\t// `commit` sale distinto de 0 cuando no hay nada que commitear; eso no es\n\t\t// un error, es el camino normal de un agente que no escribió.\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.cwd, \"commit\", \"-m\", message]);\n\t\tkept = true;\n\t} catch {\n\t\tkept = false;\n\t}\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"worktree\", \"remove\", \"--force\", wt.cwd]);\n\t} catch {\n\t\t// ya no existe / locked — continuar\n\t}\n\tif (!kept && wt.branch) {\n\t\ttry {\n\t\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"branch\", \"-D\", wt.branch]);\n\t\t} catch {\n\t\t\t// rama ya borrada\n\t\t}\n\t}\n\treturn { branch: kept ? wt.branch : undefined, kept };\n}\n\n/** Elimina un worktree y su rama, DESCARTANDO el trabajo. Best-effort. */\nexport async function removeWorktree(wt: Worktree): Promise<void> {\n\tif (!wt.isolated || !wt.repoRoot) return;\n\ttry {\n\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"worktree\", \"remove\", \"--force\", wt.cwd]);\n\t} catch {\n\t\t// ya no existe / locked — continuar\n\t}\n\tif (wt.branch) {\n\t\ttry {\n\t\t\tawait execFileAsync(\"git\", [\"-C\", wt.repoRoot, \"branch\", \"-D\", wt.branch]);\n\t\t} catch {\n\t\t\t// rama ya borrada\n\t\t}\n\t}\n}\n"]}