agentic-engineering-harness 0.6.0 → 0.6.2

package/dist/paseo/runtime.js

@@ -0,0 +1,158 @@
+import process from "node:process";
+import { buildPaseoBackgroundRunCommand, detectPaseoCapabilities, extractPaseoAgentId } from "./capabilities.js";
+import { PaseoSdkUnavailableError, createPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, probePaseoSdkAgent, runPaseoSdkAgent } 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 }
+};
+export async function launchManagedPaseoAgent(root, options, deps = DEFAULT_DEPS) {
+    if (preferSdk(options)) {
+        try {
+            const result = await deps.sdk.create(root, { ...options, timeoutMs: options.timeoutMs ?? timeoutMs(options.timeoutSeconds) });
+            return fromSdk(result);
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                throw error;
+            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.");
+}
+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 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" };
+    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" };
+}
+export async function probeManagedPaseoAgent(root, agentId, deps = DEFAULT_DEPS) {
+    if (!forceCli()) {
+        try {
+            return await deps.sdk.probe(root, agentId);
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                return false;
+        }
+    }
+    const probe = await deps.run(`paseo logs ${quote(agentId)} --tail 1`, { cwd: root, timeoutMs: 30_000 });
+    return probe.exitCode === 0;
+}
+export async function inspectManagedPaseoAgent(root, agentId, deps = DEFAULT_DEPS) {
+    if (!forceCli()) {
+        try {
+            return await deps.sdk.inspect(root, agentId);
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                return undefined;
+        }
+    }
+    return (await listCliAgents(root, deps)).find((agent) => agent.id === agentId);
+}
+export async function listManagedPaseoAgents(root, labels = {}, deps = DEFAULT_DEPS) {
+    if (!forceCli()) {
+        try {
+            return await deps.sdk.list(root, labels);
+        }
+        catch (error) {
+            if (!sdkCanFallback(error))
+                throw error;
+        }
+    }
+    return (await listCliAgents(root, deps)).filter((agent) => Object.entries(labels).every(([key, value]) => agent.labels?.[key] === value));
+}
+async function launchCli(root, options, deps, fallbackReason) {
+    if (options.prompt === undefined && options.systemPrompt !== undefined) {
+        throw new PaseoSdkUnavailableError(`Paseo SDK is required to create an idle systemPrompt-only agent. Refusing CLI fallback because it would expose session instructions as a user turn. ${fallbackReason}`);
+    }
+    const capabilities = await deps.detectCapabilities(root, deps.run);
+    const prompt = options.prompt;
+    if (prompt === undefined)
+        throw new Error("Paseo CLI fallback requires a prompt.");
+    const timeout = options.timeoutSeconds ?? Math.max(1, Math.ceil((options.timeoutMs ?? 1_800_000) / 1000));
+    if (options.outputSchema) {
+        if (!capabilities.outputSchema)
+            throw new Error(`Installed Paseo${capabilities.version ? ` ${capabilities.version}` : ""} does not advertise --output-schema required by this agent.`);
+        const parts = ["paseo run --quiet", `--title ${quote(options.title)}`, `--provider ${quote(options.provider)}`];
+        if (options.workspaceId)
+            parts.push(`--workspace ${quote(options.workspaceId)}`);
+        if (options.model)
+            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" };
+    }
+    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" };
+    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" };
+}
+async function listCliAgents(root, deps) {
+    const result = await deps.run("paseo ls -a -g --json", { cwd: root, timeoutMs: 30_000 });
+    if (result.exitCode !== 0 || !result.stdout.trim())
+        return [];
+    try {
+        const records = new Map();
+        collectCliAgents(JSON.parse(result.stdout), records);
+        return [...records.values()];
+    }
+    catch {
+        return [];
+    }
+}
+function collectCliAgents(value, out) {
+    if (Array.isArray(value)) {
+        for (const child of value)
+            collectCliAgents(child, out);
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    const record = value;
+    const id = firstString(record, ["id", "agentId", "agent_id"]);
+    if (id && ("status" in record || "title" in record || "labels" in record)) {
+        out.set(id, { id, title: firstString(record, ["title", "name"]), status: statusText(record.status), workspaceId: firstString(record, ["workspaceId", "workspace_id"]), labels: stringRecord(record.labels), raw: record });
+    }
+    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 sdkExitCode(status, error) { if (error)
+    return 1; return !status || status === "idle" ? 0 : status === "timeout" ? 124 : 1; }
+function firstString(record, keys) { for (const key of keys)
+    if (typeof record[key] === "string" && record[key])
+        return record[key]; return undefined; }
+function stringRecord(value) { if (!value || typeof value !== "object" || Array.isArray(value))
+    return undefined; const result = {}; for (const [key, item] of Object.entries(value))
+    if (typeof item === "string")
+        result[key] = item; return Object.keys(result).length ? result : undefined; }
+function statusText(value) { if (typeof value === "string")
+    return value; if (value && typeof value === "object" && typeof value.status === "string")
+    return value.status; return undefined; }
+function quote(value) { return `'${value.replaceAll("'", "'\\''")}'`; }
+//# sourceMappingURL=runtime.js.map

package/dist/paseo/runtime.js.map

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

package/dist/paseo/sdk.d.ts

@@ -0,0 +1,79 @@
+export interface PaseoSdkAgentOptions {
+    cwd: string;
+    workspaceId?: string;
+    provider: string;
+    model?: string;
+    title: string;
+    systemPrompt?: string;
+    prompt?: string;
+    outputSchema?: Record<string, unknown>;
+    labels?: Record<string, string>;
+    timeoutMs?: number;
+    waitForFinish?: boolean;
+}
+export interface PaseoSdkAgentResult {
+    id: string;
+    workspaceId?: string;
+    status?: string;
+    lastMessage?: string;
+    error?: string;
+}
+export interface PaseoSdkAgentRecord {
+    id: string;
+    title?: string;
+    status?: string;
+    workspaceId?: string;
+    labels?: Record<string, string>;
+    raw: Record<string, unknown>;
+}
+interface PaseoSdkTurnResult {
+    status: string;
+    lastMessage?: string;
+    error?: string;
+}
+interface PaseoSdkAgentHandle {
+    readonly id: string;
+    readonly workspaceId: string | null;
+    readonly status: unknown;
+    refresh(requestId?: string): Promise<{
+        agent: Record<string, unknown>;
+        project: unknown;
+    } | null>;
+    run(text: string, options?: {
+        timeoutMs?: number;
+    }): Promise<PaseoSdkTurnResult>;
+    waitForFinish(timeoutMs?: number): Promise<PaseoSdkTurnResult>;
+}
+interface PaseoSdkWorkspaceHandle {
+    readonly agents: {
+        create(options: Record<string, unknown>): Promise<PaseoSdkAgentHandle>;
+    };
+}
+interface PaseoSdkClient {
+    readonly agents: {
+        create(options: Record<string, unknown>): Promise<PaseoSdkAgentHandle>;
+        ref(agentId: string): PaseoSdkAgentHandle;
+        list(options?: Record<string, unknown>): Promise<{
+            entries: Array<{
+                agent: Record<string, unknown>;
+            }>;
+        }>;
+    };
+    readonly workspaces: {
+        ref(workspaceId: string): PaseoSdkWorkspaceHandle;
+    };
+    connect(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class PaseoSdkUnavailableError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function createPaseoSdkAgent(root: string, options: PaseoSdkAgentOptions): Promise<PaseoSdkAgentResult>;
+export declare function createPaseoSdkAgentWithClient(client: PaseoSdkClient, options: PaseoSdkAgentOptions): Promise<PaseoSdkAgentResult>;
+export declare function runPaseoSdkAgent(root: string, agentId: string, prompt: string, timeoutMs?: number): Promise<PaseoSdkAgentResult>;
+export declare function inspectPaseoSdkAgent(root: string, agentId: string): Promise<PaseoSdkAgentRecord | undefined>;
+export declare function probePaseoSdkAgent(root: string, agentId: string): Promise<boolean>;
+export declare function listPaseoSdkAgents(root: string, labels?: Record<string, string>): Promise<PaseoSdkAgentRecord[]>;
+export {};

package/dist/paseo/sdk.js

@@ -0,0 +1,161 @@
+import process from "node:process";
+import { pathToFileURL } from "node:url";
+import { resolvePaseoSdkFromCli } from "./sdkResolve.js";
+export class PaseoSdkUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "PaseoSdkUnavailableError";
+    }
+}
+export async function createPaseoSdkAgent(root, options) {
+    return withPaseoClient(root, async (client) => createPaseoSdkAgentWithClient(client, options));
+}
+export async function createPaseoSdkAgentWithClient(client, options) {
+    const config = { provider: providerModel(options.provider, options.model) };
+    if (options.systemPrompt)
+        config.systemPrompt = options.systemPrompt;
+    const createOptions = { config, title: options.title };
+    if (options.prompt !== undefined)
+        createOptions.prompt = options.prompt;
+    if (options.outputSchema)
+        createOptions.outputSchema = options.outputSchema;
+    if (options.labels && Object.keys(options.labels).length)
+        createOptions.labels = options.labels;
+    // Intentionally omit `parent`: AEH run/task labels own lifecycle relationships.
+    // Workspace placement does not imply parentage in the Paseo SDK.
+    const handle = options.workspaceId
+        ? await client.workspaces.ref(options.workspaceId).agents.create(createOptions)
+        : await client.agents.create({ ...createOptions, cwd: options.cwd });
+    if (options.prompt !== undefined && options.waitForFinish !== false) {
+        const turn = await handle.waitForFinish(options.timeoutMs);
+        return {
+            id: handle.id,
+            workspaceId: handle.workspaceId ?? undefined,
+            status: turn.status,
+            lastMessage: turn.lastMessage,
+            error: turn.error
+        };
+    }
+    return {
+        id: handle.id,
+        workspaceId: handle.workspaceId ?? undefined,
+        status: statusText(handle.status)
+    };
+}
+export async function runPaseoSdkAgent(root, agentId, prompt, timeoutMs) {
+    return withPaseoClient(root, async (client) => {
+        const handle = client.agents.ref(agentId);
+        const turn = await handle.run(prompt, { timeoutMs });
+        return { id: agentId, workspaceId: handle.workspaceId ?? undefined, status: turn.status, lastMessage: turn.lastMessage, error: turn.error };
+    });
+}
+export async function inspectPaseoSdkAgent(root, agentId) {
+    return withPaseoClient(root, async (client) => {
+        const refreshed = await client.agents.ref(agentId).refresh();
+        return refreshed ? normalizeRecord(refreshed.agent) : undefined;
+    });
+}
+export async function probePaseoSdkAgent(root, agentId) {
+    return Boolean(await inspectPaseoSdkAgent(root, agentId));
+}
+export async function listPaseoSdkAgents(root, labels = {}) {
+    return withPaseoClient(root, async (client) => {
+        const filter = { includeArchived: false };
+        if (Object.keys(labels).length)
+            filter.labels = labels;
+        const page = await client.agents.list({ filter });
+        return page.entries.map((entry) => normalizeRecord(entry.agent)).filter((agent) => labelsMatch(agent.labels, labels));
+    });
+}
+async function withPaseoClient(root, action) {
+    const sdk = await loadPaseoSdk(root);
+    const client = sdk.createPaseoClient({
+        url: process.env.PASEO_DAEMON_URL?.trim() || "ws://127.0.0.1:6767/ws",
+        clientId: `aeh-${process.pid}`,
+        password: process.env.PASEO_DAEMON_PASSWORD?.trim() || undefined
+    });
+    try {
+        try {
+            await client.connect();
+        }
+        catch (error) {
+            throw new PaseoSdkUnavailableError(`Unable to connect to the Paseo daemon through @getpaseo/client: ${String(error)}`, { cause: error });
+        }
+        return await action(client);
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+}
+async function loadPaseoSdk(root) {
+    // Prefer the client bundled with the active Paseo CLI. Paseo currently ships
+    // @getpaseo/client as an exact-version dependency of @getpaseo/cli, while the
+    // client SDK is explicitly not API-stable yet. Loading the co-installed copy
+    // therefore avoids protocol/API drift between an independently resolved SDK
+    // and the daemon that the active CLI starts.
+    const bundled = await resolvePaseoSdkFromCli(root);
+    if (bundled.resolved) {
+        try {
+            const sdk = await import(pathToFileURL(bundled.resolved).href);
+            if (typeof sdk.createPaseoClient === "function")
+                return sdk;
+        }
+        catch (error) {
+            bundled.diagnostics.push(`bundled import: ${String(error)}`);
+        }
+    }
+    // Compatibility fallback for installations that intentionally provide the
+    // SDK directly alongside AEH instead of through the Paseo CLI package. Keep
+    // the package specifier non-literal so TypeScript does not require this
+    // optional runtime package to be installed while compiling AEH.
+    const packageName = "@getpaseo/client";
+    let directError;
+    try {
+        const direct = await import(packageName);
+        if (typeof direct.createPaseoClient === "function")
+            return direct;
+    }
+    catch (error) {
+        directError = error;
+    }
+    const detail = bundled.diagnostics.length ? ` Resolution diagnostics: ${bundled.diagnostics.join("; ")}.` : "";
+    throw new PaseoSdkUnavailableError(`@getpaseo/client could not be resolved from the active Paseo CLI installation or directly.${detail}${directError ? ` Direct import: ${String(directError)}` : ""}`, { cause: directError });
+}
+function providerModel(provider, model) {
+    if (provider.includes("/"))
+        return provider;
+    if (!model)
+        throw new Error(`Paseo SDK requires an explicit model for provider '${provider}'.`);
+    return `${provider}/${model}`;
+}
+function normalizeRecord(raw) {
+    const id = stringField(raw, ["id", "agentId", "agent_id"]);
+    if (!id)
+        throw new Error("Paseo SDK returned an agent without an id.");
+    const labels = recordOfStrings(raw.labels);
+    return {
+        id,
+        title: stringField(raw, ["title", "name"]),
+        status: statusText(raw.status),
+        workspaceId: stringField(raw, ["workspaceId", "workspace_id"]),
+        labels,
+        raw
+    };
+}
+function labelsMatch(actual, expected) {
+    return Object.entries(expected).every(([key, value]) => actual?.[key] === value);
+}
+function stringField(record, keys) { for (const key of keys)
+    if (typeof record[key] === "string" && record[key])
+        return record[key]; return undefined; }
+function recordOfStrings(value) { if (!value || typeof value !== "object" || Array.isArray(value))
+    return undefined; const result = {}; for (const [key, item] of Object.entries(value))
+    if (typeof item === "string")
+        result[key] = item; return Object.keys(result).length ? result : undefined; }
+function statusText(value) { if (typeof value === "string")
+    return value; if (value && typeof value === "object") {
+    const nested = value.status;
+    if (typeof nested === "string")
+        return nested;
+} return undefined; }
+//# sourceMappingURL=sdk.js.map

package/dist/paseo/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/paseo/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAmEzD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAA6B;IACnF,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,MAAsB,EAAE,OAA6B;IACvG,MAAM,MAAM,GAA4B,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACrG,IAAI,OAAO,CAAC,YAAY;QAAE,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACrE,MAAM,aAAa,GAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxE,IAAI,OAAO,CAAC,YAAY;QAAE,aAAa,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM;QAAE,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhG,gFAAgF;IAChF,iEAAiE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW;QAChC,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;QAC/E,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS;YAC5C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS;QAC5C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe,EAAE,MAAc,EAAE,SAAkB;IACtG,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC9I,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAe;IACtE,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAe;IACpE,OAAO,OAAO,CAAC,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAAiC,EAAE;IACxF,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,MAAM,GAA4B,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;QACnE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAI,IAAY,EAAE,MAA8C;IAC5F,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAAC;QACnC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,wBAAwB;QACrE,QAAQ,EAAE,OAAO,OAAO,CAAC,GAAG,EAAE;QAC9B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,SAAS;KACjE,CAAC,CAAC;IACH,IAAI,CAAC;QACH,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAC/B,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,IAAI,wBAAwB,CAAC,mEAAmE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QAC3J,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAA8B,CAAC;YAC5F,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU;gBAAE,OAAO,GAAG,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,wEAAwE;IACxE,gEAAgE;IAChE,MAAM,WAAW,GAAG,kBAAkB,CAAC;IACvC,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAA8B,CAAC;QACtE,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU;YAAE,OAAO,MAAM,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,WAAW,GAAG,KAAK,CAAC;IAAC,CAAC;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,4BAA4B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/G,MAAM,IAAI,wBAAwB,CAChC,6FAA6F,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,mBAAmB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACnK,EAAE,KAAK,EAAE,WAAW,EAAE,CACvB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAc;IACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,QAAQ,IAAI,CAAC,CAAC;IAChG,OAAO,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,EAAE;QACF,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;QAC9B,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC9D,MAAM;QACN,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAA0C,EAAE,QAAgC;IAC/F,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;AACnF,CAAC;AACD,SAAS,WAAW,CAAC,MAA+B,EAAE,IAAc,IAAwB,KAAK,MAAM,GAAG,IAAI,IAAI;IAAE,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAW,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AACzN,SAAS,eAAe,CAAC,KAAc,IAAwC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,SAAS,CAAC,CAAC,MAAM,MAAM,GAA2B,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;IAAE,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACpY,SAAS,UAAU,CAAC,KAAc,IAAwB,IAAI,OAAO,KAAK,KAAK,QAAQ;IAAE,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;IAAC,MAAM,MAAM,GAAI,KAAiC,CAAC,MAAM,CAAC;IAAC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;AAAC,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC"}

package/dist/paseo/sdkResolve.d.ts

@@ -0,0 +1,17 @@
+import { runProcess, type ProcessResult } from "../utils/process.js";
+type ProcessRunner = (command: string, options: Parameters<typeof runProcess>[1]) => Promise<ProcessResult>;
+export interface PaseoSdkResolution {
+    resolved?: string;
+    diagnostics: string[];
+}
+/**
+ * Resolve the Paseo client that belongs to the active Paseo CLI installation.
+ *
+ * mise's npm backend installs tools into a synthetic project and may expose a
+ * shim on PATH instead of the real package binary. Resolving relative to that
+ * shim cannot see the CLI's node_modules. `mise which` and `mise where` expose
+ * the actual binary/install root, which lets Node resolve the exact client
+ * version shipped with that CLI.
+ */
+export declare function resolvePaseoSdkFromCli(root: string, runner?: ProcessRunner): Promise<PaseoSdkResolution>;
+export {};

package/dist/paseo/sdkResolve.js

@@ -0,0 +1,70 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { runProcess } from "../utils/process.js";
+const PASEO_CLIENT_PACKAGE = "@getpaseo/client";
+/**
+ * Resolve the Paseo client that belongs to the active Paseo CLI installation.
+ *
+ * mise's npm backend installs tools into a synthetic project and may expose a
+ * shim on PATH instead of the real package binary. Resolving relative to that
+ * shim cannot see the CLI's node_modules. `mise which` and `mise where` expose
+ * the actual binary/install root, which lets Node resolve the exact client
+ * version shipped with that CLI.
+ */
+export async function resolvePaseoSdkFromCli(root, runner = runProcess) {
+    const diagnostics = [];
+    const starts = new Set();
+    const commandPath = await capturePath(runner, "command -v paseo", root, "command -v paseo", diagnostics);
+    if (commandPath)
+        await addExecutableStarts(starts, commandPath);
+    const misePath = await capturePath(runner, "mise which paseo", root, "mise which paseo", diagnostics);
+    if (misePath)
+        await addExecutableStarts(starts, misePath);
+    const miseRoot = await capturePath(runner, "mise where 'npm:@getpaseo/cli'", root, "mise where npm:@getpaseo/cli", diagnostics);
+    if (miseRoot)
+        starts.add(path.resolve(miseRoot));
+    for (const start of starts) {
+        const resolved = resolvePackageWalkingUp(start, PASEO_CLIENT_PACKAGE);
+        if (resolved)
+            return { resolved, diagnostics };
+    }
+    return { diagnostics };
+}
+async function capturePath(runner, command, root, label, diagnostics) {
+    try {
+        const result = await runner(command, { cwd: root, timeoutMs: 15_000 });
+        const value = result.exitCode === 0 ? lastNonEmptyLine(result.stdout) : undefined;
+        diagnostics.push(`${label}: ${value ?? `unavailable (exit ${result.exitCode})`}`);
+        return value;
+    }
+    catch (error) {
+        diagnostics.push(`${label}: ${String(error)}`);
+        return undefined;
+    }
+}
+async function addExecutableStarts(starts, executable) {
+    const absolute = path.resolve(executable);
+    starts.add(path.dirname(absolute));
+    const real = await fs.realpath(absolute).catch(() => absolute);
+    starts.add(path.dirname(real));
+}
+function resolvePackageWalkingUp(start, packageName) {
+    let current = path.resolve(start);
+    for (let depth = 0; depth < 12; depth += 1) {
+        try {
+            const resolver = createRequire(path.join(current, "__aeh_paseo_sdk_loader__.cjs"));
+            return resolver.resolve(packageName);
+        }
+        catch { /* keep walking toward the npm synthetic-project root */ }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+function lastNonEmptyLine(value) {
+    return value.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).at(-1);
+}
+//# sourceMappingURL=sdkResolve.js.map

package/dist/paseo/sdkResolve.js.map

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

package/dist/paseo/start.d.ts

@@ -1,10 +1,12 @@
 import type { ResolvedAgentTopology } from "../agents/types.js";
 import { loadResolvedAgentTopology } from "../agents/config.js";
+import { reconcileHarnessAssets } from "../core/assets.js";
 import type { HarnessProjectConfig } from "../core/types.js";
 import { setupToolchain } from "../toolchain/setup.js";
 import { commandExists, runProcess } from "../utils/process.js";
 import { detectPaseoCapabilities } from "./capabilities.js";
-export declare const PASEO_BOOTSTRAP_VERSION = 3;
+import { launchManagedPaseoAgent, probeManagedPaseoAgent } from "./runtime.js";
+export declare const PASEO_BOOTSTRAP_VERSION = 4;
 export type PaseoSessionPolicy = "fresh-on-start" | "reuse-compatible" | "resume-explicit";
 export interface PaseoStartOptions {
     autoSetup?: boolean;
@@ -41,6 +43,7 @@ export interface PaseoStartResult {
     stateFile: string;
     bootstrapFile: string;
     paseoVersion?: string;
+    transport?: "sdk" | "cli";
 }
 interface PaseoStartDeps {
     run: typeof runProcess;
@@ -48,6 +51,9 @@ interface PaseoStartDeps {
     setupToolchain: typeof setupToolchain;
     loadTopology: typeof loadResolvedAgentTopology;
     detectCapabilities: typeof detectPaseoCapabilities;
+    launchAgent: typeof launchManagedPaseoAgent;
+    probeAgent: typeof probeManagedPaseoAgent;
+    reconcileAssets?: typeof reconcileHarnessAssets;
 }
 export declare function startPaseoHarness(root: string, config: HarnessProjectConfig, options?: PaseoStartOptions, deps?: PaseoStartDeps): Promise<PaseoStartResult>;
 export declare function buildPaseoLeadBootstrap(projectName: string, projectRoot: string, aehCommand: string, preferPaseoTools?: boolean, handoffPath?: string): string;