agentic-engineering-harness 0.6.12 → 0.6.14

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.
Files changed (67) hide show
  1. package/dist/agents/outputContracts.d.ts +44 -1
  2. package/dist/agents/outputContracts.js +12 -2
  3. package/dist/agents/outputContracts.js.map +1 -1
  4. package/dist/agents/reviewLifecycle.js +54 -14
  5. package/dist/agents/reviewLifecycle.js.map +1 -1
  6. package/dist/agents/waveExecutor.d.ts +2 -13
  7. package/dist/audit/run.d.ts +7 -0
  8. package/dist/audit/run.js +198 -32
  9. package/dist/audit/run.js.map +1 -1
  10. package/dist/core/run.js +103 -28
  11. package/dist/core/run.js.map +1 -1
  12. package/dist/main.js +118 -23
  13. package/dist/main.js.map +1 -1
  14. package/dist/operations/artifacts.d.ts +13 -0
  15. package/dist/operations/artifacts.js +45 -0
  16. package/dist/operations/artifacts.js.map +1 -0
  17. package/dist/operations/change.d.ts +11 -0
  18. package/dist/operations/change.js +144 -0
  19. package/dist/operations/change.js.map +1 -0
  20. package/dist/operations/completion.d.ts +4 -1
  21. package/dist/operations/completion.js +69 -89
  22. package/dist/operations/completion.js.map +1 -1
  23. package/dist/operations/controller.d.ts +8 -5
  24. package/dist/operations/controller.js +270 -131
  25. package/dist/operations/controller.js.map +1 -1
  26. package/dist/operations/executionContext.d.ts +15 -0
  27. package/dist/operations/executionContext.js +91 -0
  28. package/dist/operations/executionContext.js.map +1 -0
  29. package/dist/operations/interactive.js +6 -1
  30. package/dist/operations/interactive.js.map +1 -1
  31. package/dist/operations/leadBinding.d.ts +2 -0
  32. package/dist/operations/leadBinding.js +22 -0
  33. package/dist/operations/leadBinding.js.map +1 -0
  34. package/dist/operations/liveness.d.ts +35 -0
  35. package/dist/operations/liveness.js +308 -0
  36. package/dist/operations/liveness.js.map +1 -0
  37. package/dist/operations/mcp.js +72 -55
  38. package/dist/operations/mcp.js.map +1 -1
  39. package/dist/operations/monitorProcess.d.ts +8 -0
  40. package/dist/operations/monitorProcess.js +33 -0
  41. package/dist/operations/monitorProcess.js.map +1 -0
  42. package/dist/operations/portfolio.d.ts +35 -0
  43. package/dist/operations/portfolio.js +158 -0
  44. package/dist/operations/portfolio.js.map +1 -0
  45. package/dist/operations/state.d.ts +174 -17
  46. package/dist/operations/state.js +178 -163
  47. package/dist/operations/state.js.map +1 -1
  48. package/dist/operations/supervisor.d.ts +38 -0
  49. package/dist/operations/supervisor.js +195 -0
  50. package/dist/operations/supervisor.js.map +1 -0
  51. package/dist/paseo/launchSpec.d.ts +4 -0
  52. package/dist/paseo/launchSpec.js +32 -25
  53. package/dist/paseo/launchSpec.js.map +1 -1
  54. package/dist/paseo/sdk.d.ts +5 -0
  55. package/dist/paseo/sdk.js +35 -87
  56. package/dist/paseo/sdk.js.map +1 -1
  57. package/dist/paseo/start.d.ts +1 -1
  58. package/dist/paseo/start.js +46 -86
  59. package/dist/paseo/start.js.map +1 -1
  60. package/dist/workers/agentPrompt.d.ts +2 -0
  61. package/dist/workers/agentPrompt.js +157 -183
  62. package/dist/workers/agentPrompt.js.map +1 -1
  63. package/docs/OPERATION_SUPERVISION.md +198 -0
  64. package/package.json +1 -1
  65. package/presets/agents/orchestration.jsonc +14 -4
  66. package/skills/engineering-workflow/SKILL.md +149 -104
  67. package/templates/AGENTS.md +8 -0
package/templates/AGENTS.md CHANGED
@@ -12,6 +12,14 @@ Classify requests as:
12
12
 
13
13
  Do not use the informational exception for an ad-hoc engineering review. `aeh start` is the preferred Paseo entrypoint. A normal start creates a fresh lead; `aeh start --resume` is explicit reuse.
14
14
 
15
+ ### Harness-spawned bounded-agent exception
16
+
17
+ The interactive-entry rule applies to the top-level user-facing lead. A planner, reviewer, implementer, explorer, oracle, spec-manager or other bounded agent spawned by an existing AEH operation is already executing **inside** the Harness and must perform its assigned role directly.
18
+
19
+ Harness-spawned bounded agents must not recursively invoke `aeh start`, `aeh audit`, `aeh run`, `aeh operation start/execute/wait/cancel`, QUICK/SPEC authoring or another Harness workflow merely because their assignment is itself engineering work. Use repository/runtime tools within the granted permissions and return the assigned output contract. Controller recovery is allowed only when explicitly delegated.
20
+
21
+ `PASEO_AGENT_ID` identifies a Paseo session and does not grant lead authority. AEH's explicit runtime identity (`AEH_INTERACTIVE_LEAD`, `AEH_ORCHESTRATION_ALLOWED`, logical role/operation metadata) determines whether workflow orchestration is allowed. `--help`, `-h`, `--version` and read-only status inspection must remain side-effect free.
22
+
15
23
  ## Lead agent — thin orchestrator
16
24
 
17
25
  The lead owns user intent, high-level routing, true ambiguity and final semantic acceptance. It does **not** own routine repository exploration, environment repair, SDD authoring, implementation or a long-running controller shell.