agentic-engineering-harness 0.6.9 → 0.6.11

package/dist/agents/permissions.d.ts

@@ -1,5 +1,32 @@
 import type { HarnessProjectConfig } from "../core/types.js";
 import type { AgentExecutionSelection } from "./types.js";
+export type OpenCodeAgentBindingSource = "aeh-managed" | "explicit";
+export interface OpenCodeAgentBinding {
+    agentId: string;
+    source: OpenCodeAgentBindingSource;
+    managed: boolean;
+}
+export interface OpenCodeRuntimeProjection {
+    binding: OpenCodeAgentBinding;
+    config: Record<string, unknown>;
+    env: Record<string, string>;
+}
 export declare function validateExecutionCapabilities(selection: AgentExecutionSelection, transport: string): string[];
 export declare function permissionSummary(selection: AgentExecutionSelection): string;
-export declare function buildOpenCodeRuntimeConfig(selection: AgentExecutionSelection, config?: HarnessProjectConfig): Record<string, unknown>;
+/**
+ * Resolve the concrete OpenCode execution identity for an AEH logical agent.
+ *
+ * Explicit nativeAgent is an externally-authored OpenCode primary/all agent and
+ * is preserved exactly. Otherwise AEH owns the native identity and injects a
+ * primary agent with a deterministic collision-resistant name into the
+ * session-local OpenCode config.
+ */
+export declare function resolveOpenCodeAgentBinding(selection: AgentExecutionSelection): OpenCodeAgentBinding;
+/**
+ * Compile the inline OpenCode configuration used by direct, Podman and Paseo
+ * transports. OPENCODE_CONFIG_CONTENT is loaded after ordinary user/project
+ * config, so the AEH-managed identity and policy are deterministic without
+ * mutating the user's global OpenCode configuration.
+ */
+export declare function buildOpenCodeRuntimeConfig(selection: AgentExecutionSelection, config?: HarnessProjectConfig, binding?: OpenCodeAgentBinding): Record<string, unknown>;
+export declare function compileOpenCodeRuntimeProjection(selection: AgentExecutionSelection, config?: HarnessProjectConfig): OpenCodeRuntimeProjection;

package/dist/agents/permissions.js

@@ -1,30 +1,189 @@
-export function validateExecutionCapabilities(selection, transport) { const issues = []; if (selection.nativeAgent && selection.runtimeCapabilities.nativeAgent === false)
-    issues.push(`Runtime ${selection.runtimeName} cannot select native agent ${selection.nativeAgent}.`); if (selection.nativeAgent && transport === "paseo" && selection.runtimeCapabilities.nativeAgentViaPaseo !== true)
-    issues.push(`Agent ${selection.logicalAgent} requires nativeAgent=${selection.nativeAgent}, but runtime ${selection.runtimeName} does not declare nativeAgentViaPaseo. Use transport=direct/podman or configure a Paseo provider that exposes this native agent.`); if (selection.variant && selection.runtimeCapabilities.variantSelection === false)
-    issues.push(`Runtime ${selection.runtimeName} cannot select variant ${selection.variant}.`); if (selection.role === "implementer" && selection.permissions.write === "deny")
-    issues.push(`Implementer ${selection.logicalAgent} denies write permission.`); if ((selection.role === "reviewer" || selection.role === "validator") && selection.permissions.write === "allow")
-    issues.push(`${selection.role} ${selection.logicalAgent} explicitly allows writes; read-only roles should use write=deny unless intentionally mutating.`); if (selection.role === "orchestrator" && selection.permissions.delegate === "deny")
-    issues.push(`Orchestrator ${selection.logicalAgent} denies delegation.`); return issues; }
-export function permissionSummary(selection) { return Object.entries(selection.permissions).map(([key, value]) => `${key}=${value}`).join(", ") || "unspecified"; }
-export function buildOpenCodeRuntimeConfig(selection, config) { const permission = {}; const p = selection.permissions; if (p.read)
-    permission.read = p.read; if (p.write)
-    permission.edit = p.write; if (p.network) {
-    permission.webfetch = p.network;
-    permission.websearch = p.network;
-} if (p.delegate)
-    permission.task = p.delegate; const bash = buildBashPermission(p.shell, p.gitWrite); if (bash)
-    permission.bash = bash; if (selection.skills.length && !selection.skills.includes("*"))
-    permission.skill = Object.fromEntries([["*", "deny"], ...selection.skills.map((skill) => [skill, "allow"])]); const mcp = {}; const tools = {}; const configured = config?.mcp?.servers ?? {}; for (const [name, server] of Object.entries(configured)) {
-    const selected = selection.mcps.includes(name) && server.enabled !== false;
-    tools[`${name}_*`] = selected;
-    if (selected)
-        mcp[name] = toOpenCodeMcp(server);
-} for (const name of selection.mcps)
-    if (!configured[name])
-        tools[`${name}_*`] = true; return { $schema: "https://opencode.ai/config.json", permission, ...(Object.keys(mcp).length ? { mcp } : {}), ...(Object.keys(tools).length ? { tools } : {}) }; }
-function toOpenCodeMcp(server) { if (server.type === "local")
-    return { type: "local", command: server.command, enabled: true, ...(server.environment ? { environment: server.environment } : {}), ...(server.timeoutMs ? { timeout: server.timeoutMs } : {}) }; return { type: "remote", url: server.url, enabled: true, ...(server.headers ? { headers: server.headers } : {}), ...(server.oauth !== undefined ? { oauth: server.oauth } : {}), ...(server.timeoutMs ? { timeout: server.timeoutMs } : {}) }; }
-function buildBashPermission(shell, gitWrite) { if (!gitWrite)
-    return shell; const result = { "*": shell ?? "ask" }; for (const pattern of ["git add *", "git commit *", "git push *", "git tag *", "git checkout *", "git switch *", "git reset *", "git clean *", "git restore *", "git merge *", "git rebase *", "git cherry-pick *"])
-    result[pattern] = gitWrite; return result; }
+import { createHash } from "node:crypto";
+export function validateExecutionCapabilities(selection, transport) {
+    const issues = [];
+    if (selection.nativeAgent && selection.runtimeCapabilities.nativeAgent === false) {
+        issues.push(`Runtime ${selection.runtimeName} cannot select native agent ${selection.nativeAgent}.`);
+    }
+    const nativeAgentViaPaseo = selection.runtimeCapabilities.nativeAgentViaPaseo === true ||
+        (selection.runtimeAdapter === "opencode" && selection.paseoProvider === "opencode");
+    if (selection.nativeAgent && transport === "paseo" && !nativeAgentViaPaseo) {
+        issues.push(`Agent ${selection.logicalAgent} requires nativeAgent=${selection.nativeAgent}, but runtime ${selection.runtimeName} does not support that native agent through Paseo.`);
+    }
+    if (selection.variant && selection.runtimeCapabilities.variantSelection === false) {
+        issues.push(`Runtime ${selection.runtimeName} cannot select variant ${selection.variant}.`);
+    }
+    if (selection.role === "implementer" && selection.permissions.write === "deny") {
+        issues.push(`Implementer ${selection.logicalAgent} denies write permission.`);
+    }
+    if ((selection.role === "reviewer" || selection.role === "validator") &&
+        selection.permissions.write === "allow") {
+        issues.push(`${selection.role} ${selection.logicalAgent} explicitly allows writes; read-only roles should use write=deny unless intentionally mutating.`);
+    }
+    if (selection.role === "orchestrator" && selection.permissions.delegate === "deny") {
+        issues.push(`Orchestrator ${selection.logicalAgent} denies delegation.`);
+    }
+    return issues;
+}
+export function permissionSummary(selection) {
+    return (Object.entries(selection.permissions)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(", ") || "unspecified");
+}
+/**
+ * Resolve the concrete OpenCode execution identity for an AEH logical agent.
+ *
+ * Explicit nativeAgent is an externally-authored OpenCode primary/all agent and
+ * is preserved exactly. Otherwise AEH owns the native identity and injects a
+ * primary agent with a deterministic collision-resistant name into the
+ * session-local OpenCode config.
+ */
+export function resolveOpenCodeAgentBinding(selection) {
+    const explicit = selection.nativeAgent?.trim();
+    if (explicit) {
+        return { agentId: explicit, source: "explicit", managed: false };
+    }
+    return {
+        agentId: managedOpenCodeAgentId(selection.logicalAgent),
+        source: "aeh-managed",
+        managed: true
+    };
+}
+/**
+ * Compile the inline OpenCode configuration used by direct, Podman and Paseo
+ * transports. OPENCODE_CONFIG_CONTENT is loaded after ordinary user/project
+ * config, so the AEH-managed identity and policy are deterministic without
+ * mutating the user's global OpenCode configuration.
+ */
+export function buildOpenCodeRuntimeConfig(selection, config, binding = resolveOpenCodeAgentBinding(selection)) {
+    const permission = buildOpenCodePermission(selection);
+    const mcp = {};
+    const tools = {};
+    const configured = config?.mcp?.servers ?? {};
+    for (const [name, server] of Object.entries(configured)) {
+        const selected = selection.mcps.includes(name) && server.enabled !== false;
+        tools[`${name}_*`] = selected;
+        if (selected)
+            mcp[name] = toOpenCodeMcp(server);
+    }
+    for (const name of selection.mcps) {
+        if (!configured[name])
+            tools[`${name}_*`] = true;
+    }
+    const managedAgent = binding.managed
+        ? {
+            agent: {
+                [binding.agentId]: {
+                    mode: "primary",
+                    description: selection.description ??
+                        `AEH-managed OpenCode execution identity for ${selection.logicalAgent}.`,
+                    model: selection.modelId,
+                    prompt: `AEH execution identity: ${selection.logicalAgent}. Follow the task-scoped AEH charter, frozen control-plane context, permissions and acceptance criteria supplied with each turn.`,
+                    ...(selection.variant ? { variant: selection.variant } : {}),
+                    ...(selection.temperature !== undefined
+                        ? { temperature: selection.temperature }
+                        : {}),
+                    ...(Object.keys(permission).length ? { permission } : {})
+                }
+            },
+            default_agent: binding.agentId
+        }
+        : {};
+    return {
+        $schema: "https://opencode.ai/config.json",
+        permission,
+        ...managedAgent,
+        ...(Object.keys(mcp).length ? { mcp } : {}),
+        ...(Object.keys(tools).length ? { tools } : {})
+    };
+}
+export function compileOpenCodeRuntimeProjection(selection, config) {
+    const binding = resolveOpenCodeAgentBinding(selection);
+    const runtimeConfig = buildOpenCodeRuntimeConfig(selection, config, binding);
+    return {
+        binding,
+        config: runtimeConfig,
+        env: {
+            OPENCODE_CONFIG_CONTENT: JSON.stringify(runtimeConfig)
+        }
+    };
+}
+function buildOpenCodePermission(selection) {
+    const permission = {};
+    const p = selection.permissions;
+    if (p.read)
+        permission.read = p.read;
+    if (p.write)
+        permission.edit = p.write;
+    if (p.network) {
+        permission.webfetch = p.network;
+        permission.websearch = p.network;
+    }
+    if (p.delegate)
+        permission.task = p.delegate;
+    const bash = buildBashPermission(p.shell, p.gitWrite);
+    if (bash)
+        permission.bash = bash;
+    if (selection.skills.length && !selection.skills.includes("*")) {
+        permission.skill = Object.fromEntries([
+            ["*", "deny"],
+            ...selection.skills.map((skill) => [skill, "allow"])
+        ]);
+    }
+    return permission;
+}
+function managedOpenCodeAgentId(logicalAgent) {
+    const original = logicalAgent.trim();
+    if (!original)
+        throw new Error("AEH logical agent name is required for OpenCode identity.");
+    const slug = original
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "agent";
+    const normalizedOriginal = original.toLowerCase();
+    if (slug === normalizedOriginal)
+        return `aeh-${slug}`;
+    const digest = createHash("sha256").update(original).digest("hex").slice(0, 8);
+    return `aeh-${slug}-${digest}`;
+}
+function toOpenCodeMcp(server) {
+    if (server.type === "local") {
+        return {
+            type: "local",
+            command: server.command,
+            enabled: true,
+            ...(server.environment ? { environment: server.environment } : {}),
+            ...(server.timeoutMs ? { timeout: server.timeoutMs } : {})
+        };
+    }
+    return {
+        type: "remote",
+        url: server.url,
+        enabled: true,
+        ...(server.headers ? { headers: server.headers } : {}),
+        ...(server.oauth !== undefined ? { oauth: server.oauth } : {}),
+        ...(server.timeoutMs ? { timeout: server.timeoutMs } : {})
+    };
+}
+function buildBashPermission(shell, gitWrite) {
+    if (!gitWrite)
+        return shell;
+    const result = { "*": shell ?? "ask" };
+    for (const pattern of [
+        "git add *",
+        "git commit *",
+        "git push *",
+        "git tag *",
+        "git checkout *",
+        "git switch *",
+        "git reset *",
+        "git clean *",
+        "git restore *",
+        "git merge *",
+        "git rebase *",
+        "git cherry-pick *"
+    ]) {
+        result[pattern] = gitWrite;
+    }
+    return result;
+}
 //# sourceMappingURL=permissions.js.map

package/dist/agents/permissions.js.map

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

package/dist/paseo/launchSpec.d.ts

@@ -1,3 +1,4 @@
+import { type OpenCodeAgentBindingSource } from "../agents/permissions.js";
 import type { AgentExecutionSelection } from "../agents/types.js";
 import type { HarnessProjectConfig, TaskContract } from "../core/types.js";
 export interface PaseoLaunchSpecOptions {
@@ -14,6 +15,11 @@ export interface PaseoAgentLaunchSpec {
     title: string;
     provider: string;
     model?: string;
+    modeId?: string;
+    modeSource?: OpenCodeAgentBindingSource;
+    thinkingOptionId?: string;
+    env?: Record<string, string>;
+    nativeAgentId?: string;
     workspaceId?: string;
     labels: Record<string, string>;
     timeoutSeconds: number;

package/dist/paseo/launchSpec.js

@@ -1,3 +1,4 @@
+import { compileOpenCodeRuntimeProjection } from "../agents/permissions.js";
 import { deliveryWorkspaceId } from "../delivery/handoff.js";
 import { currentOperationContext } from "../operations/state.js";
 export async function compilePaseoAgentLaunchSpec(root, config, contract, options = {}) {
@@ -5,7 +6,12 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
     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 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);
@@ -13,6 +19,10 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
     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 openCode = selection?.runtimeAdapter === "opencode" && provider === "opencode"
+        ? compileOpenCodeRuntimeProjection(selection, config)
+        : undefined;
+    const explicitOpenCodeMode = openCode && !openCode.binding.managed ? openCode.binding.agentId : undefined;
     const labels = {
         "aeh.project": config.project.name,
         "aeh.kind": "worker",
@@ -24,8 +34,13 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
     };
     if (selection?.profile)
         labels["aeh.profile"] = selection.profile;
-    if (workspaceId && workspaceId === operation.workspaceId && !deliveryId)
+    if (openCode) {
+        labels["aeh.native-agent"] = openCode.binding.agentId;
+        labels["aeh.native-agent.source"] = openCode.binding.source;
+    }
+    if (workspaceId && workspaceId === operation.workspaceId && !deliveryId) {
         labels["aeh.workspace.kind"] = "orchestration";
+    }
     if (workspaceId && deliveryId)
         labels["aeh.workspace.kind"] = "delivery";
     return {
@@ -33,6 +48,18 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
         title,
         provider,
         model,
+        // Paseo validates an explicit mode against the provider catalog before it
+        // launches the per-session OpenCode process. AEH-managed agents exist only
+        // in OPENCODE_CONFIG_CONTENT for that process, so exposing their generated
+        // id as modeId makes Paseo reject them before OpenCode can load the config.
+        // Leave modeId unset for managed identities: Paseo then omits the OpenCode
+        // prompt `agent` field and the injected default_agent selects the managed
+        // primary deterministically inside the session.
+        modeId: explicitOpenCodeMode,
+        modeSource: explicitOpenCodeMode ? openCode?.binding.source : undefined,
+        thinkingOptionId: openCode ? selection?.variant : undefined,
+        env: openCode?.env,
+        nativeAgentId: openCode?.binding.agentId,
         workspaceId,
         labels,
         timeoutSeconds: worker?.timeoutSeconds ?? 1800,
@@ -54,8 +81,11 @@ export function inferAgentPhase(selection, logicalAgent) {
         return "spec-authoring";
     if (name.includes("environment-manager"))
         return "environment-recovery";
-    if (role === "implementer" || name.includes("implementer") || name.includes("worker"))
+    if (role === "implementer" ||
+        name.includes("implementer") ||
+        name.includes("worker")) {
         return "implementation";
+    }
     return "work";
 }
 function inferOperationKind(contract) {

package/dist/paseo/launchSpec.js.map

@@ -1 +1 @@
-{"version":3,"file":"launchSpec.js","sourceRoot":"","sources":["../../src/paseo/launchSpec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"launchSpec.js","sourceRoot":"","sources":["../../src/paseo/launchSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAEjC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AA8BjE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAY,EACZ,MAA4B,EAC5B,QAAsB,EACtB,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,SAAS,EAAE,YAAY,IAAI,QAAQ,CAAC;IACjF,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ,IAAI,SAAS,EAAE,aAAa,IAAI,MAAM,EAAE,QAAQ,IAAI,UAAU,CAAC;IACjF,MAAM,KAAK,GACT,OAAO,CAAC,KAAK;QACb,CAAC,SAAS;YACR,CAAC,CAAC,SAAS,CAAC,cAAc,KAAK,OAAO;gBACpC,CAAC,CAAC,SAAS,CAAC,SAAS;gBACrB,CAAC,CAAC,SAAS,CAAC,OAAO;YACrB,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrB,MAAM,SAAS,GAAG,uBAAuB,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,UAAU,IAAI,SAAS,CAAC,WAAW,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE,WAAW,IAAI,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,YAAY,EAAE,CAAC;IAE3G,MAAM,QAAQ,GACZ,SAAS,EAAE,cAAc,KAAK,UAAU,IAAI,QAAQ,KAAK,UAAU;QACjE,CAAC,CAAC,gCAAgC,CAAC,SAAS,EAAE,MAAM,CAAC;QACrD,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,oBAAoB,GACxB,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,MAAM,MAAM,GAA2B;QACrC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QAClC,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;QAC5B,UAAU,EAAE,YAAY;QACxB,eAAe,EAAE,WAAW;QAC5B,oBAAoB,EAAE,aAAa;QACnC,qBAAqB,EAAE,KAAK;KAC7B,CAAC;IACF,IAAI,SAAS,EAAE,OAAO;QAAE,MAAM,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QACtD,MAAM,CAAC,yBAAyB,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9D,CAAC;IACD,IAAI,WAAW,IAAI,WAAW,KAAK,SAAS,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QACxE,MAAM,CAAC,oBAAoB,CAAC,GAAG,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,WAAW,IAAI,UAAU;QAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,UAAU,CAAC;IAEzE,OAAO;QACL,GAAG,EAAE,IAAI;QACT,KAAK;QACL,QAAQ;QACR,KAAK;QACL,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,4EAA4E;QAC5E,2EAA2E;QAC3E,0EAA0E;QAC1E,gDAAgD;QAChD,MAAM,EAAE,oBAAoB;QAC5B,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACvE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;QAC3D,GAAG,EAAE,QAAQ,EAAE,GAAG;QAClB,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO;QACxC,WAAW;QACX,MAAM;QACN,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,IAAI;QAC9C,WAAW;QACX,aAAa;QACb,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAA8C,EAC9C,YAAoB;IAEpB,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IACtE,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtE,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAAE,OAAO,sBAAsB,CAAC;IACxE,IACE,IAAI,KAAK,aAAa;QACtB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACvB,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAsB;IAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC"}

package/dist/paseo/modePreflight.d.ts

@@ -0,0 +1,15 @@
+export interface PaseoProviderModePreflightResult {
+    ok: boolean;
+    provider: string;
+    modeId: string;
+    availableModes: string[];
+    source: "paseo-provider-modes";
+    message: string;
+}
+/**
+ * Validate an externally-authored provider mode before AEH dispatches work.
+ * This is intentionally fail-closed: an explicit nativeAgent is part of the
+ * frozen execution contract, so silently falling back to an ambient default
+ * would execute a different agent than the one AEH selected.
+ */
+export declare function preflightPaseoProviderMode(root: string, provider: string, modeId: string, cwd?: string): Promise<PaseoProviderModePreflightResult>;

package/dist/paseo/modePreflight.js

@@ -0,0 +1,118 @@
+import process from "node:process";
+import { pathToFileURL } from "node:url";
+import { PaseoSdkUnavailableError } from "./sdk.js";
+import { resolvePaseoSdkFromCli } from "./sdkResolve.js";
+import { recordPaseoTrace } from "./trace.js";
+/**
+ * Validate an externally-authored provider mode before AEH dispatches work.
+ * This is intentionally fail-closed: an explicit nativeAgent is part of the
+ * frozen execution contract, so silently falling back to an ambient default
+ * would execute a different agent than the one AEH selected.
+ */
+export async function preflightPaseoProviderMode(root, provider, modeId, cwd = root) {
+    const normalizedProvider = provider.trim();
+    const normalizedMode = modeId.trim();
+    if (!normalizedProvider)
+        throw new Error("Paseo provider is required for mode preflight.");
+    if (!normalizedMode)
+        throw new Error("Paseo modeId is required for mode preflight.");
+    const sdk = await loadSdk(root);
+    const client = sdk.createPaseoClient({
+        url: process.env.PASEO_DAEMON_URL?.trim() || "ws://127.0.0.1:6767/ws",
+        clientId: `aeh-mode-preflight-${process.pid}`,
+        password: process.env.PASEO_DAEMON_PASSWORD?.trim() || undefined
+    });
+    try {
+        await client.connect();
+        if (typeof client.providers?.listModes !== "function") {
+            throw new Error("The active Paseo SDK does not expose providers.listModes(), which AEH requires to validate an explicit native OpenCode agent before dispatch.");
+        }
+        const response = await client.providers.listModes(normalizedProvider, { cwd });
+        const availableModes = modeIds(response);
+        const ok = availableModes.includes(normalizedMode);
+        const result = {
+            ok,
+            provider: normalizedProvider,
+            modeId: normalizedMode,
+            availableModes,
+            source: "paseo-provider-modes",
+            message: ok
+                ? `Paseo provider ${normalizedProvider} exposes mode ${normalizedMode}.`
+                : availableModes.length
+                    ? `Paseo provider ${normalizedProvider} does not expose requested mode ${normalizedMode}.`
+                    : `Paseo provider ${normalizedProvider} reported no selectable modes for ${cwd}.`
+        };
+        await recordPaseoTrace(root, "provider.mode.preflight", {
+            ok,
+            provider: normalizedProvider,
+            modeId: normalizedMode,
+            availableModeCount: availableModes.length,
+            source: result.source,
+            message: result.message
+        });
+        return result;
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+}
+async function loadSdk(root) {
+    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(`mode preflight bundled import: ${String(error)}`);
+        }
+    }
+    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(`Paseo SDK could not be resolved for explicit provider-mode preflight.${detail}${directError ? ` Direct import: ${String(directError)}` : ""}`, { cause: directError });
+}
+function modeIds(value) {
+    const result = new Set();
+    const visit = (item) => {
+        if (Array.isArray(item)) {
+            for (const child of item)
+                visit(child);
+            return;
+        }
+        if (!item || typeof item !== "object")
+            return;
+        const record = item;
+        const id = stringField(record, ["id", "modeId", "mode_id"]);
+        if (id &&
+            ("label" in record ||
+                "description" in record ||
+                "colorTier" in record ||
+                "isDefault" in record)) {
+            result.add(id);
+        }
+        for (const child of Object.values(record))
+            visit(child);
+    };
+    visit(value);
+    return [...result];
+}
+function stringField(record, keys) {
+    for (const key of keys) {
+        if (typeof record[key] === "string" && record[key])
+            return record[key];
+    }
+    return undefined;
+}
+//# sourceMappingURL=modePreflight.js.map

package/dist/paseo/modePreflight.js.map

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

package/dist/paseo/runtime.d.ts

@@ -1,10 +1,13 @@
+import type { OpenCodeAgentBindingSource } from "../agents/permissions.js";
 import { runProcess } from "../utils/process.js";
 import { detectPaseoCapabilities } from "./capabilities.js";
+import { preflightPaseoProviderMode } from "./modePreflight.js";
 import { capturePaseoAgentTurnBaseline, preflightPaseoProviderModel, waitForPaseoAgentNative, type PaseoTurnBaseline } from "./native.js";
 import { createPaseoSdkAgent, dispatchPaseoSdkAgent, inspectPaseoSdkAgent, listPaseoSdkAgents, materializePaseoSdkAgent, probePaseoSdkAgent, runPaseoSdkAgent, waitPaseoSdkAgent, type PaseoSdkAgentOptions, type PaseoSdkAgentRecord } from "./sdk.js";
 import { recordPaseoTrace } from "./trace.js";
 export interface ManagedPaseoAgentOptions extends PaseoSdkAgentOptions {
     timeoutSeconds?: number;
+    modeSource?: OpenCodeAgentBindingSource;
 }
 export interface ManagedPaseoAgentResult {
     id?: string;
@@ -22,6 +25,7 @@ interface PaseoRuntimeDeps {
     trace?: typeof recordPaseoTrace;
     native?: {
         preflight: typeof preflightPaseoProviderModel;
+        preflightMode: typeof preflightPaseoProviderMode;
         wait: typeof waitForPaseoAgentNative;
         capture?: typeof capturePaseoAgentTurnBaseline;
     };