agentic-engineering-harness 0.6.4 → 0.6.6

package/dist/operations/mcp.js

@@ -0,0 +1,129 @@
+import readline from "node:readline";
+import path from "node:path";
+import process from "node:process";
+import { cancelOperation, startDetachedOperation } from "./controller.js";
+import { loadOperation } from "./state.js";
+const tools = [
+    {
+        name: "aeh_operation_start_audit",
+        description: "Start a detached Harness AUDIT for this lead's fixed project root and return its durable operation record immediately.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                request: { type: "string" },
+                files: { type: "array", items: { type: "string" } },
+                domains: { type: "array", items: { type: "string" } },
+                risk: { type: "string", enum: ["low", "medium", "high"] },
+                reviewers: { type: "array", items: { type: "string" } }
+            },
+            required: ["request"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "aeh_operation_start_run",
+        description: "Start detached execution of an already prepared/sealed AEH task in this lead's fixed project root and return its operation record immediately.",
+        inputSchema: {
+            type: "object",
+            properties: { taskId: { type: "string" }, profile: { type: "string" } },
+            required: ["taskId"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "aeh_operation_status",
+        description: "Read durable status/phase/result for an AEH operation in this lead's fixed project root without blocking the caller.",
+        inputSchema: {
+            type: "object",
+            properties: { operationId: { type: "string" } },
+            required: ["operationId"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "aeh_operation_cancel",
+        description: "Cancel a running AEH operation in this lead's fixed project root and persist CANCELLED state.",
+        inputSchema: {
+            type: "object",
+            properties: { operationId: { type: "string" } },
+            required: ["operationId"],
+            additionalProperties: false
+        }
+    }
+];
+export async function serveOperationMcp() {
+    const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (request.id === undefined || request.id === null)
+            continue;
+        try {
+            write({ jsonrpc: "2.0", id: request.id, result: await handle(request) });
+        }
+        catch (error) {
+            write({ jsonrpc: "2.0", id: request.id, error: { code: -32603, message: error instanceof Error ? error.message : String(error) } });
+        }
+    }
+}
+async function handle(request) {
+    if (request.method === "initialize") {
+        return {
+            protocolVersion: typeof request.params?.protocolVersion === "string" ? request.params.protocolVersion : "2025-06-18",
+            capabilities: { tools: {} },
+            serverInfo: { name: "aeh-operation-controller", version: "1" }
+        };
+    }
+    if (request.method === "ping")
+        return {};
+    if (request.method === "tools/list")
+        return { tools };
+    if (request.method === "tools/call")
+        return callTool(request.params ?? {});
+    throw new Error(`Unsupported MCP method: ${request.method ?? "<missing>"}`);
+}
+async function callTool(params) {
+    const name = string(params.name, "tool name");
+    const args = object(params.arguments);
+    const root = controlRoot();
+    if (name === "aeh_operation_start_audit") {
+        const payload = {
+            request: string(args.request, "request"),
+            files: stringArray(args.files),
+            domains: stringArray(args.domains),
+            risk: risk(args.risk),
+            reviewers: stringArray(args.reviewers)
+        };
+        return toolResult(await startDetachedOperation(root, "audit", payload, { nodeExecutable: process.execPath, entryFile: path.resolve(process.argv[1]) }));
+    }
+    if (name === "aeh_operation_start_run") {
+        const payload = { taskId: string(args.taskId, "taskId"), profile: optionalString(args.profile) };
+        return toolResult(await startDetachedOperation(root, "run", payload, { nodeExecutable: process.execPath, entryFile: path.resolve(process.argv[1]) }));
+    }
+    if (name === "aeh_operation_status")
+        return toolResult(await loadOperation(root, string(args.operationId, "operationId")));
+    if (name === "aeh_operation_cancel")
+        return toolResult(await cancelOperation(root, string(args.operationId, "operationId")));
+    throw new Error(`Unknown AEH operation tool '${name}'.`);
+}
+function controlRoot() { return path.resolve(process.env.AEH_CONTROL_ROOT?.trim() || process.cwd()); }
+function toolResult(value) { return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }], structuredContent: value }; }
+function write(value) { process.stdout.write(`${JSON.stringify(value)}\n`); }
+function object(value) { return value && typeof value === "object" && !Array.isArray(value) ? value : {}; }
+function string(value, name) { if (typeof value !== "string" || !value.trim())
+    throw new Error(`${name} is required.`); return value.trim(); }
+function optionalString(value) { return typeof value === "string" && value.trim() ? value.trim() : undefined; }
+function stringArray(value) { if (value === undefined)
+    return undefined; if (!Array.isArray(value) || value.some((item) => typeof item !== "string"))
+    throw new Error("Expected an array of strings."); return value; }
+function risk(value) { if (value === undefined)
+    return undefined; if (value === "low" || value === "medium" || value === "high")
+    return value; throw new Error("risk must be low, medium or high."); }
+//# sourceMappingURL=mcp.js.map

package/dist/operations/mcp.js.map

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

package/dist/operations/state.d.ts

@@ -0,0 +1,43 @@
+export type OperationKind = "audit" | "run";
+export type OperationStatus = "QUEUED" | "RUNNING" | "SUCCEEDED" | "FAILED" | "CANCELLED";
+export interface AuditOperationPayload {
+    request: string;
+    files?: string[];
+    domains?: string[];
+    risk?: "low" | "medium" | "high";
+    reviewers?: string[];
+}
+export interface RunOperationPayload {
+    taskId: string;
+    profile?: string;
+}
+export type OperationPayload = AuditOperationPayload | RunOperationPayload;
+export interface OperationRecord {
+    version: 1;
+    id: string;
+    kind: OperationKind;
+    status: OperationStatus;
+    phase: string;
+    root: string;
+    payload: OperationPayload;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    pid?: number;
+    workspaceId?: string;
+    workspaceWarning?: string;
+    cleanupWarnings?: string[];
+    result?: Record<string, unknown>;
+    error?: string;
+}
+export declare function operationFile(root: string, operationId: string): string;
+export declare function loadOperation(root: string, operationId: string): Promise<OperationRecord>;
+export declare function saveOperation(root: string, record: OperationRecord): Promise<void>;
+export declare function patchOperation(root: string, operationId: string, patch: Partial<OperationRecord>): Promise<OperationRecord>;
+export declare function currentOperationContext(): {
+    id?: string;
+    kind?: string;
+    workspaceId?: string;
+};
+export declare function updateCurrentOperationPhase(root: string, phase: string): Promise<void>;

package/dist/operations/state.js

@@ -0,0 +1,127 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+const OPERATIONS_DIR = ".harness/operations";
+const LOCK_RETRY_MS = 20;
+const LOCK_TIMEOUT_MS = 10_000;
+const STALE_LOCK_MS = 30_000;
+export function operationFile(root, operationId) {
+    return path.resolve(root, OPERATIONS_DIR, `${safeId(operationId)}.json`);
+}
+export async function loadOperation(root, operationId) {
+    return JSON.parse(await fs.readFile(operationFile(root, operationId), "utf8"));
+}
+export async function saveOperation(root, record) {
+    const file = operationFile(root, record.id);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await withOperationLock(file, async () => writeRecord(file, record));
+}
+export async function patchOperation(root, operationId, patch) {
+    const file = operationFile(root, operationId);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    return withOperationLock(file, async () => {
+        const current = JSON.parse(await fs.readFile(file, "utf8"));
+        const guardedPatch = guardTerminalTransition(current, patch);
+        const next = { ...current, ...guardedPatch, id: current.id, kind: current.kind, version: 1, updatedAt: new Date().toISOString() };
+        await writeRecord(file, next);
+        return next;
+    });
+}
+export function currentOperationContext() {
+    return {
+        id: process.env.AEH_OPERATION_ID?.trim() || undefined,
+        kind: process.env.AEH_OPERATION_KIND?.trim() || undefined,
+        workspaceId: process.env.AEH_OPERATION_WORKSPACE_ID?.trim() || undefined
+    };
+}
+export async function updateCurrentOperationPhase(root, phase) {
+    const operationId = currentOperationContext().id;
+    if (!operationId)
+        return;
+    try {
+        await patchOperation(root, operationId, { phase });
+    }
+    catch { /* direct/non-controller execution has no operation state to update */ }
+}
+async function writeRecord(file, record) {
+    const temp = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await fs.writeFile(temp, `${JSON.stringify(record, null, 2)}\n`);
+    try {
+        await fs.rename(temp, file);
+    }
+    finally {
+        await fs.rm(temp, { force: true }).catch(() => undefined);
+    }
+}
+async function withOperationLock(file, action) {
+    const lock = `${file}.lock`;
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        let handle;
+        try {
+            handle = await fs.open(lock, "wx");
+            try {
+                await handle.writeFile(`${process.pid}\n`);
+                return await action();
+            }
+            finally {
+                await handle.close().catch(() => undefined);
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+            }
+        }
+        catch (error) {
+            if (handle) {
+                await handle.close().catch(() => undefined);
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+                throw error;
+            }
+            if (!isAlreadyExists(error))
+                throw error;
+            if (await canRecoverLock(lock)) {
+                await fs.rm(lock, { force: true }).catch(() => undefined);
+                continue;
+            }
+            if (Date.now() >= deadline)
+                throw new Error(`Timed out acquiring operation state lock for ${path.basename(file)}.`);
+            await delay(LOCK_RETRY_MS);
+        }
+    }
+}
+async function canRecoverLock(lock) {
+    try {
+        const [rawPid, stat] = await Promise.all([fs.readFile(lock, "utf8").catch(() => ""), fs.stat(lock)]);
+        const ownerPid = Number.parseInt(rawPid.trim(), 10);
+        if (Number.isInteger(ownerPid) && ownerPid > 0 && !processAlive(ownerPid))
+            return true;
+        return Date.now() - stat.mtimeMs > STALE_LOCK_MS;
+    }
+    catch {
+        return true;
+    }
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !/ESRCH/.test(String(error));
+    }
+}
+function guardTerminalTransition(current, patch) {
+    if (!isTerminal(current.status))
+        return patch;
+    const guarded = {};
+    if (patch.cleanupWarnings)
+        guarded.cleanupWarnings = patch.cleanupWarnings;
+    return guarded;
+}
+function isTerminal(status) { return status === "SUCCEEDED" || status === "FAILED" || status === "CANCELLED"; }
+function isAlreadyExists(error) { return Boolean(error && typeof error === "object" && "code" in error && error.code === "EEXIST"); }
+function delay(ms) { return new Promise((resolve) => setTimeout(resolve, ms)); }
+function safeId(value) {
+    if (!/^[A-Za-z0-9._-]+$/.test(value))
+        throw new Error(`Invalid operation id '${value}'.`);
+    return value;
+}
+//# sourceMappingURL=state.js.map

package/dist/operations/state.js.map

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

package/dist/paseo/launchSpec.d.ts

@@ -0,0 +1,25 @@
+import type { AgentExecutionSelection } from "../agents/types.js";
+import type { HarnessProjectConfig, TaskContract } from "../core/types.js";
+export interface PaseoLaunchSpecOptions {
+    selection?: AgentExecutionSelection;
+    logicalAgent?: string;
+    provider?: string;
+    model?: string;
+    titlePrefix?: string;
+    phase?: string;
+    kind?: string;
+}
+export interface PaseoAgentLaunchSpec {
+    cwd: string;
+    title: string;
+    provider: string;
+    model?: string;
+    workspaceId?: string;
+    labels: Record<string, string>;
+    timeoutSeconds: number;
+    operationId: string;
+    operationKind: string;
+    phase: string;
+}
+export declare function compilePaseoAgentLaunchSpec(root: string, config: HarnessProjectConfig, contract: TaskContract, options?: PaseoLaunchSpecOptions): Promise<PaseoAgentLaunchSpec>;
+export declare function inferAgentPhase(selection: AgentExecutionSelection | undefined, logicalAgent: string): string;

package/dist/paseo/launchSpec.js

@@ -0,0 +1,69 @@
+import { deliveryWorkspaceId } from "../delivery/handoff.js";
+import { currentOperationContext } from "../operations/state.js";
+export async function compilePaseoAgentLaunchSpec(root, config, contract, options = {}) {
+    const selection = options.selection;
+    const worker = config.orchestration?.worker;
+    const logicalAgent = options.logicalAgent ?? selection?.logicalAgent ?? "worker";
+    const provider = options.provider ?? selection?.paseoProvider ?? worker?.provider ?? "opencode";
+    const model = options.model ?? (selection ? (selection.runtimeAdapter === "codex" ? selection.modelName : selection.modelId) : worker?.model);
+    const operation = currentOperationContext();
+    const operationId = operation.id ?? contract.task.id;
+    const operationKind = operation.kind ?? options.kind ?? inferOperationKind(contract);
+    const phase = options.phase ?? inferAgentPhase(selection, logicalAgent);
+    const deliveryId = await deliveryWorkspaceId(root, config, contract.task.id);
+    const workspaceId = deliveryId ?? operation.workspaceId;
+    const title = `${options.titlePrefix ?? worker?.titlePrefix ?? "aeh"}-${contract.task.id}-${logicalAgent}`;
+    const labels = {
+        "aeh.project": config.project.name,
+        "aeh.kind": "worker",
+        "aeh.task": contract.task.id,
+        "aeh.role": logicalAgent,
+        "aeh.operation": operationId,
+        "aeh.operation.kind": operationKind,
+        "aeh.operation.phase": phase
+    };
+    if (selection?.profile)
+        labels["aeh.profile"] = selection.profile;
+    if (workspaceId && workspaceId === operation.workspaceId && !deliveryId)
+        labels["aeh.workspace.kind"] = "orchestration";
+    if (workspaceId && deliveryId)
+        labels["aeh.workspace.kind"] = "delivery";
+    return {
+        cwd: root,
+        title,
+        provider,
+        model,
+        workspaceId,
+        labels,
+        timeoutSeconds: worker?.timeoutSeconds ?? 1800,
+        operationId,
+        operationKind,
+        phase
+    };
+}
+export function inferAgentPhase(selection, logicalAgent) {
+    const role = selection?.role?.toLowerCase() ?? "";
+    const name = logicalAgent.toLowerCase();
+    if (role === "planner" || name.includes("planner"))
+        return "planning";
+    if (role === "reviewer" || name.includes("reviewer"))
+        return "review";
+    if (role === "escalation" || name.includes("oracle"))
+        return "diagnosis";
+    if (name.includes("spec-manager"))
+        return "spec-authoring";
+    if (name.includes("environment-manager"))
+        return "environment-recovery";
+    if (role === "implementer" || name.includes("implementer") || name.includes("worker"))
+        return "implementation";
+    return "work";
+}
+function inferOperationKind(contract) {
+    const intent = contract.routing?.intent?.trim();
+    if (intent === "audit")
+        return "audit";
+    if (intent)
+        return intent;
+    return contract.mode === "quick" ? "quick" : "run";
+}
+//# sourceMappingURL=launchSpec.js.map

package/dist/paseo/launchSpec.js.map

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

package/dist/paseo/runtime.d.ts

@@ -1,5 +1,5 @@
 import { detectPaseoCapabilities } from "./capabilities.js";
-import { createPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, probePaseoSdkAgent, runPaseoSdkAgent, type PaseoSdkAgentOptions, type PaseoSdkAgentRecord } from "./sdk.js";
+import { createPaseoSdkAgent, dispatchPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, materializePaseoSdkAgent, probePaseoSdkAgent, runPaseoSdkAgent, waitPaseoSdkAgent, type PaseoSdkAgentOptions, type PaseoSdkAgentRecord } from "./sdk.js";
 import { runProcess } from "../utils/process.js";
 export interface ManagedPaseoAgentOptions extends PaseoSdkAgentOptions {
     timeoutSeconds?: number;
@@ -10,6 +10,7 @@ export interface ManagedPaseoAgentResult {
     stdout: string;
     stderr: string;
     status?: string;
+    workspaceId?: string;
     transport: "sdk" | "cli";
 }
 interface PaseoRuntimeDeps {
@@ -17,6 +18,9 @@ interface PaseoRuntimeDeps {
     detectCapabilities: typeof detectPaseoCapabilities;
     sdk: {
         create: typeof createPaseoSdkAgent;
+        materialize: typeof materializePaseoSdkAgent;
+        dispatch: typeof dispatchPaseoSdkAgent;
+        wait: typeof waitPaseoSdkAgent;
         run: typeof runPaseoSdkAgent;
         probe: typeof probePaseoSdkAgent;
         inspect: typeof inspectPaseoSdkAgent;
@@ -24,6 +28,9 @@ interface PaseoRuntimeDeps {
     };
 }
 export declare function launchManagedPaseoAgent(root: string, options: ManagedPaseoAgentOptions, deps?: PaseoRuntimeDeps): Promise<ManagedPaseoAgentResult>;
+export declare function materializeManagedPaseoAgent(root: string, options: ManagedPaseoAgentOptions, deps?: PaseoRuntimeDeps): Promise<ManagedPaseoAgentResult>;
+export declare function dispatchManagedPaseoAgent(root: string, agentId: string, prompt: string, timeoutSeconds?: number, deps?: PaseoRuntimeDeps): Promise<ManagedPaseoAgentResult>;
+export declare function waitManagedPaseoAgent(root: string, agentId: string, timeoutSeconds?: number, deps?: PaseoRuntimeDeps): Promise<ManagedPaseoAgentResult>;
 export declare function continueManagedPaseoAgent(root: string, agentId: string, prompt: string, timeoutSeconds?: number, deps?: PaseoRuntimeDeps): Promise<ManagedPaseoAgentResult>;
 export declare function probeManagedPaseoAgent(root: string, agentId: string, deps?: PaseoRuntimeDeps): Promise<boolean>;
 export declare function inspectManagedPaseoAgent(root: string, agentId: string, deps?: PaseoRuntimeDeps): Promise<PaseoSdkAgentRecord | undefined>;

package/dist/paseo/runtime.js

@@ -1,17 +1,25 @@
 import process from "node:process";
 import { buildPaseoBackgroundRunCommand, detectPaseoCapabilities, extractPaseoAgentId } from "./capabilities.js";
-import { PaseoSdkUnavailableError, createPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, probePaseoSdkAgent, runPaseoSdkAgent } from "./sdk.js";
+import { PaseoSdkUnavailableError, createPaseoSdkAgent, dispatchPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, materializePaseoSdkAgent, probePaseoSdkAgent, runPaseoSdkAgent, waitPaseoSdkAgent } from "./sdk.js";
 import { runProcess } from "../utils/process.js";
 const DEFAULT_DEPS = {
     run: runProcess,
     detectCapabilities: detectPaseoCapabilities,
-    sdk: { create: createPaseoSdkAgent, run: runPaseoSdkAgent, probe: probePaseoSdkAgent, inspect: inspectPaseoSdkAgent, list: listPaseoSdkAgents }
+    sdk: {
+        create: createPaseoSdkAgent,
+        materialize: materializePaseoSdkAgent,
+        dispatch: dispatchPaseoSdkAgent,
+        wait: waitPaseoSdkAgent,
+        run: runPaseoSdkAgent,
+        probe: probePaseoSdkAgent,
+        inspect: inspectPaseoSdkAgent,
+        list: listPaseoSdkAgents
+    }
 };
 export async function launchManagedPaseoAgent(root, options, deps = DEFAULT_DEPS) {
-    if (preferSdk(options)) {
+    if (!forceCli()) {
         try {
-            const result = await deps.sdk.create(root, { ...options, timeoutMs: options.timeoutMs ?? timeoutMs(options.timeoutSeconds) });
-            return fromSdk(result);
+            return fromSdk(await deps.sdk.create(root, { ...options, timeoutMs: options.timeoutMs ?? timeoutMs(options.timeoutSeconds) }));
         }
         catch (error) {
             if (!sdkCanFallback(error))
@@ -19,25 +27,62 @@ export async function launchManagedPaseoAgent(root, options, deps = DEFAULT_DEPS
             return launchCli(root, options, deps, `SDK unavailable: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    return launchCli(root, options, deps, "SDK skipped because no explicit provider/model was available or AEH_PASEO_FORCE_CLI=1.");
+    return launchCli(root, options, deps, "AEH_PASEO_FORCE_CLI=1 forced the compatibility lifecycle.");
 }
-export async function continueManagedPaseoAgent(root, agentId, prompt, timeoutSeconds, deps = DEFAULT_DEPS) {
+export async function materializeManagedPaseoAgent(root, options, deps = DEFAULT_DEPS) {
+    if (forceCli())
+        throw new PaseoSdkUnavailableError("Idle agent materialization is SDK-only; AEH_PASEO_FORCE_CLI=1 is active.");
+    try {
+        return fromSdk(await deps.sdk.materialize(root, { ...options, prompt: undefined, waitForFinish: false }));
+    }
+    catch (error) {
+        if (sdkCanFallback(error))
+            throw new PaseoSdkUnavailableError(`Paseo SDK is required to materialize an idle visible agent. ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        throw error;
+    }
+}
+export async function dispatchManagedPaseoAgent(root, agentId, prompt, timeoutSeconds, deps = DEFAULT_DEPS) {
     if (!forceCli()) {
         try {
-            return fromSdk(await deps.sdk.run(root, agentId, prompt, timeoutMs(timeoutSeconds)));
+            return fromSdk(await deps.sdk.dispatch(root, agentId, prompt, timeoutMs(timeoutSeconds)));
         }
         catch (error) {
             if (!sdkCanFallback(error))
                 throw error;
         }
     }
-    const timeout = timeoutSeconds ?? 1800;
     const send = await deps.run(`paseo send ${quote(agentId)} --no-wait ${quote(prompt)}`, { cwd: root, timeoutMs: 60_000 });
-    if (send.exitCode !== 0)
-        return { id: agentId, exitCode: send.exitCode, stdout: send.stdout, stderr: send.stderr, transport: "cli" };
+    return { id: agentId, exitCode: send.exitCode, stdout: send.stdout, stderr: send.stderr, status: send.exitCode === 0 ? "working" : "failed", transport: "cli" };
+}
+export async function waitManagedPaseoAgent(root, agentId, timeoutSeconds, deps = DEFAULT_DEPS) {
+    if (!forceCli()) {
+        try {
+            return fromSdk(await deps.sdk.wait(root, agentId, timeoutMs(timeoutSeconds)));
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                throw error;
+        }
+    }
+    const timeout = timeoutSeconds ?? 1800;
     const wait = await deps.run(`paseo wait ${quote(agentId)} --timeout ${timeout}`, { cwd: root, timeoutMs: (timeout + 30) * 1000 });
     const logs = await deps.run(`paseo logs ${quote(agentId)} --tail 200`, { cwd: root, timeoutMs: 60_000 });
-    return { id: agentId, exitCode: wait.exitCode, stdout: logs.stdout || wait.stdout, stderr: [send.stderr, wait.stderr, logs.stderr].filter(Boolean).join("\n"), transport: "cli" };
+    return { id: agentId, exitCode: wait.exitCode, stdout: logs.stdout || wait.stdout, stderr: [wait.stderr, logs.stderr].filter(Boolean).join("\n"), status: wait.exitCode === 0 ? "idle" : "failed", transport: "cli" };
+}
+export async function continueManagedPaseoAgent(root, agentId, prompt, timeoutSeconds, deps = DEFAULT_DEPS) {
+    if (!forceCli()) {
+        try {
+            return fromSdk(await deps.sdk.run(root, agentId, prompt, timeoutMs(timeoutSeconds)));
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                throw error;
+        }
+    }
+    const sent = await dispatchManagedPaseoAgent(root, agentId, prompt, timeoutSeconds, deps);
+    if (sent.exitCode !== 0)
+        return sent;
+    return waitManagedPaseoAgent(root, agentId, timeoutSeconds, deps);
 }
 export async function probeManagedPaseoAgent(root, agentId, deps = DEFAULT_DEPS) {
     if (!forceCli()) {
@@ -95,18 +140,17 @@ async function launchCli(root, options, deps, fallbackReason) {
             parts.push(`--model ${quote(options.model)}`);
         parts.push(`--output-schema ${quote(JSON.stringify(options.outputSchema))}`, quote(prompt));
         const result = await deps.run(parts.join(" "), { cwd: root, timeoutMs: timeout * 1000 });
-        return { exitCode: result.exitCode, stdout: result.stdout, stderr: [fallbackReason, result.stderr].filter(Boolean).join("\n"), transport: "cli" };
+        return { exitCode: result.exitCode, stdout: result.stdout, stderr: [fallbackReason, result.stderr].filter(Boolean).join("\n"), status: result.exitCode === 0 ? "idle" : "failed", transport: "cli" };
     }
     const command = buildPaseoBackgroundRunCommand({ title: options.title, provider: options.provider, model: options.model, workspaceId: options.workspaceId, prompt }, capabilities);
     const launch = await deps.run(command, { cwd: root, timeoutMs: 60_000 });
     if (launch.exitCode !== 0)
-        return { exitCode: launch.exitCode, stdout: launch.stdout, stderr: [fallbackReason, launch.stderr].filter(Boolean).join("\n"), transport: "cli" };
+        return { exitCode: launch.exitCode, stdout: launch.stdout, stderr: [fallbackReason, launch.stderr].filter(Boolean).join("\n"), status: "failed", transport: "cli" };
     const id = extractPaseoAgentId(launch.stdout);
     if (!id)
-        return { exitCode: 1, stdout: launch.stdout, stderr: [fallbackReason, "Paseo returned no parseable agent id."].join("\n"), transport: "cli" };
-    const wait = await deps.run(`paseo wait ${quote(id)} --timeout ${timeout}`, { cwd: root, timeoutMs: (timeout + 30) * 1000 });
-    const logs = await deps.run(`paseo logs ${quote(id)} --tail 200`, { cwd: root, timeoutMs: 60_000 });
-    return { id, exitCode: wait.exitCode, stdout: logs.stdout || wait.stdout || launch.stdout, stderr: [fallbackReason, launch.stderr, wait.stderr, logs.stderr].filter(Boolean).join("\n"), transport: "cli" };
+        return { exitCode: 1, stdout: launch.stdout, stderr: [fallbackReason, "Paseo returned no parseable agent id."].join("\n"), status: "failed", transport: "cli" };
+    const waited = await waitManagedPaseoAgent(root, id, timeout, { ...deps, sdk: deps.sdk });
+    return { ...waited, stderr: [fallbackReason, launch.stderr, waited.stderr].filter(Boolean).join("\n") };
 }
 async function listCliAgents(root, deps) {
     const result = await deps.run("paseo ls -a -g --json", { cwd: root, timeoutMs: 30_000 });
@@ -137,13 +181,14 @@ function collectCliAgents(value, out) {
     for (const child of Object.values(record))
         collectCliAgents(child, out);
 }
-function preferSdk(options) { return !forceCli() && (Boolean(options.model) || options.provider.includes("/")); }
 function forceCli() { return process.env.AEH_PASEO_FORCE_CLI === "1"; }
 function sdkCanFallback(error) { return error instanceof PaseoSdkUnavailableError || (error instanceof Error && error.name === "PaseoSdkUnavailableError"); }
 function timeoutMs(seconds) { return (seconds ?? 1800) * 1000; }
-function fromSdk(result) { return { id: result.id, exitCode: sdkExitCode(result.status, result.error), stdout: result.lastMessage ?? "", stderr: result.error ?? "", status: result.status, transport: "sdk" }; }
+function fromSdk(result) { return { id: result.id, exitCode: sdkExitCode(result.status, result.error), stdout: result.lastMessage ?? "", stderr: result.error ?? "", status: result.status, workspaceId: result.workspaceId, transport: "sdk" }; }
 function sdkExitCode(status, error) { if (error)
-    return 1; return !status || status === "idle" ? 0 : status === "timeout" ? 124 : 1; }
+    return 1; if (status === "timeout")
+    return 124; if (status === "failed" || status === "error" || status === "cancelled")
+    return 1; return 0; }
 function firstString(record, keys) { for (const key of keys)
     if (typeof record[key] === "string" && record[key])
         return record[key]; return undefined; }