agentic-engineering-harness 0.6.10 → 0.6.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -22,6 +22,7 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
22
22
  const openCode = selection?.runtimeAdapter === "opencode" && provider === "opencode"
23
23
  ? compileOpenCodeRuntimeProjection(selection, config)
24
24
  : undefined;
25
+ const explicitOpenCodeMode = openCode && !openCode.binding.managed ? openCode.binding.agentId : undefined;
25
26
  const labels = {
26
27
  "aeh.project": config.project.name,
27
28
  "aeh.kind": "worker",
@@ -47,8 +48,15 @@ export async function compilePaseoAgentLaunchSpec(root, config, contract, option
47
48
  title,
48
49
  provider,
49
50
  model,
50
- modeId: openCode?.binding.agentId,
51
- modeSource: openCode?.binding.source,
51
+ // Paseo validates an explicit mode against the provider catalog before it
52
+ // launches the per-session OpenCode process. AEH-managed agents exist only
53
+ // in OPENCODE_CONFIG_CONTENT for that process, so exposing their generated
54
+ // id as modeId makes Paseo reject them before OpenCode can load the config.
55
+ // Leave modeId unset for managed identities: Paseo then omits the OpenCode
56
+ // prompt `agent` field and the injected default_agent selects the managed
57
+ // primary deterministically inside the session.
58
+ modeId: explicitOpenCodeMode,
59
+ modeSource: explicitOpenCodeMode ? openCode?.binding.source : undefined,
52
60
  thinkingOptionId: openCode ? selection?.variant : undefined,
53
61
  env: openCode?.env,
54
62
  nativeAgentId: openCode?.binding.agentId,
@@ -1 +1 @@
1
- {"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;IAEhB,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,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO;QACjC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM;QACpC,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"}
1
+ {"version":3,"file":"launchSpec.js","sourceRoot":"","sources":["../../src/paseo/launchSpec.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@ AEH treats Paseo as the authority for agent runtime state and generic agent orch
10
10
  | Agent current state | Paseo | `agents.ref(id).refetch()` |
11
11
  | Agent context-window usage | Paseo/provider | `AgentSnapshot.lastUsage` |
12
12
  | Provider/model availability | Paseo | provider snapshot/listModels/diagnostic |
13
- | OpenCode native execution identity | AEH topology + Paseo mode bridge | AEH runtime projection -> `modeId` |
13
+ | OpenCode native execution identity | AEH topology + session-local OpenCode config | AEH runtime projection -> `OPENCODE_CONFIG_CONTENT` / `default_agent`; explicit external agents may use Paseo `modeId` |
14
14
  | Generic create/send/status/activity tools | Paseo | injected native/MCP Paseo tools |
15
15
  | AUDIT/RUN operation state | AEH | `aeh-control` / operation state |
16
16
  | Detached operation completion wake-up | AEH + Paseo dispatch | durable completion target + follow-up to existing lead |
@@ -155,9 +155,9 @@ The generated OpenCode configuration contains the concrete model, projected perm
155
155
  OPENCODE_CONFIG_CONTENT=<compiled JSON>
156
156
  ```
157
157
 
158
- For Paseo execution AEH also passes the same ID as `AgentSessionConfig.modeId`. Paseo therefore dispatches the turn to the same native OpenCode agent that AEH compiled. The launch environment is passed as top-level create-agent `env`, not embedded in `AgentSessionConfig`.
158
+ For an AEH-managed generated identity, Paseo **must not** receive that generated ID as `AgentSessionConfig.modeId`. Paseo validates explicit modes against its provider catalog before the per-session OpenCode process starts, so a session-local generated agent cannot exist at that validation point. AEH leaves `modeId` unset; Paseo therefore omits the OpenCode prompt `agent` selector, and OpenCode deterministically selects the injected session-local `default_agent`. The launch environment is passed as top-level create-agent `env`, not embedded in `AgentSessionConfig`.
159
159
 
160
- If `execution.nativeAgent` is explicitly configured, AEH preserves that exact external identity instead of synthesizing a replacement. Before dispatch, AEH uses Paseo provider mode discovery to verify that the requested native agent is selectable for the target cwd. Missing explicit agents fail before a user prompt is sent; AEH does not silently fall back to OpenCode's default agent.
160
+ If `execution.nativeAgent` is explicitly configured, AEH preserves that exact external identity instead of synthesizing a replacement. Because that identity is expected to exist in the provider-visible configuration, AEH passes it as Paseo `modeId` and uses provider mode discovery to verify that it is selectable for the target cwd. Missing explicit agents fail before a user prompt is sent; AEH does not silently fall back to OpenCode's default agent.
161
161
 
162
162
  The same compiled binding is used by direct and Podman OpenCode execution. Transport therefore does not change native identity.
163
163
 
@@ -168,11 +168,10 @@ Relevant labels/traces include:
168
168
  ```text
169
169
  aeh.native-agent
170
170
  aeh.native-agent.source
171
- harness.paseo.agent.identity
172
171
  harness.paseo.provider.mode.preflight
173
172
  ```
174
173
 
175
- `aeh.native-agent.source` is `aeh-managed` for compiled identities and `explicit` for externally configured native agents.
174
+ `aeh.native-agent.source` is `aeh-managed` for compiled identities and `explicit` for externally configured native agents. Provider mode preflight applies only when AEH actually supplies an explicit `modeId`; generated session-local identities are represented by the native-agent labels and inline OpenCode configuration instead of a Paseo mode.
176
175
 
177
176
  ## Intentional CLI parity gaps (P2)
178
177
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-engineering-harness",
3
- "version": "0.6.10",
3
+ "version": "0.6.11",
4
4
  "description": "OSS-first engineering harness for deterministic, spec-driven, issue-driven, audit-governed and orchestration-first multi-agent software delivery.",
5
5
  "type": "module",
6
6
  "bin": {