pi-subagents 0.50.0 → 0.51.0

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 (92) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/agents/gpt-pro.md +17 -0
  3. package/async-retention-discovery-worker.mjs +180 -0
  4. package/docs/agents.md +35 -2
  5. package/docs/configuration.md +30 -12
  6. package/docs/extension-api.md +42 -1
  7. package/docs/observability.md +4 -4
  8. package/docs/tool-reference.md +38 -39
  9. package/docs/workflows.md +169 -3
  10. package/package.json +4 -2
  11. package/skills/pi-subagents/SKILL.md +5 -4
  12. package/skills/pi-subagents/references/constraints-and-recipes.md +6 -4
  13. package/skills/pi-subagents/references/execution-controls.md +18 -15
  14. package/skills/pi-subagents/references/management-authoring-rpc.md +3 -3
  15. package/skills/pi-subagents/references/prompting-and-roles.md +2 -2
  16. package/src/agents/agent-management.ts +100 -345
  17. package/src/agents/agents.ts +125 -25
  18. package/src/api/external-job-provider.ts +185 -0
  19. package/src/api/preflight.ts +31 -6
  20. package/src/api/shared-types.ts +2 -0
  21. package/src/extension/config.ts +3 -3
  22. package/src/extension/doctor.ts +3 -6
  23. package/src/extension/fanout-child.ts +2 -2
  24. package/src/extension/index.ts +165 -88
  25. package/src/extension/public-execution.ts +28 -1
  26. package/src/extension/schemas.ts +12 -35
  27. package/src/extension/tool-description.ts +35 -24
  28. package/src/inspectors/herdr/actions.ts +2 -2
  29. package/src/inspectors/herdr/inspector-runner.ts +2 -1
  30. package/src/inspectors/herdr/project-panes.ts +2 -2
  31. package/src/intercom/native-supervisor-channel.ts +30 -9
  32. package/src/missions/lifecycle.ts +6 -1
  33. package/src/missions/store.ts +4 -9
  34. package/src/profiles/profiles.ts +3 -1
  35. package/src/runs/background/active-run-index.ts +31 -8
  36. package/src/runs/background/async-execution.ts +49 -31
  37. package/src/runs/background/async-job-tracker.ts +20 -4
  38. package/src/runs/background/async-resume.ts +28 -13
  39. package/src/runs/background/async-retention.ts +888 -0
  40. package/src/runs/background/async-status.ts +39 -53
  41. package/src/runs/background/chain-append.ts +3 -33
  42. package/src/runs/background/control-channel.ts +14 -68
  43. package/src/runs/background/index-segment.ts +59 -0
  44. package/src/runs/background/notify.ts +3 -1
  45. package/src/runs/background/result-files.ts +158 -90
  46. package/src/runs/background/result-watcher.ts +72 -20
  47. package/src/runs/background/retained-children.ts +13 -3
  48. package/src/runs/background/run-id-query.ts +7 -0
  49. package/src/runs/background/run-id-resolver.ts +11 -9
  50. package/src/runs/background/run-status.ts +27 -18
  51. package/src/runs/background/scheduled-runs.ts +22 -4
  52. package/src/runs/background/stale-run-reconciler.ts +6 -3
  53. package/src/runs/background/steering.ts +11 -1
  54. package/src/runs/background/subagent-runner.ts +250 -138
  55. package/src/runs/background/subagent-wait.ts +7 -7
  56. package/src/runs/background/terminal-run-index.ts +129 -0
  57. package/src/runs/background/wait-completions.ts +21 -4
  58. package/src/runs/background/wait-subscriptions.ts +80 -1
  59. package/src/runs/foreground/async-steering-action.ts +21 -14
  60. package/src/runs/foreground/execution.ts +2 -0
  61. package/src/runs/foreground/subagent-executor.ts +460 -1536
  62. package/src/runs/foreground/workflow-foreground-steering.ts +6 -5
  63. package/src/runs/shared/chain-outputs.ts +1 -3
  64. package/src/runs/shared/external-job-bridge.ts +450 -0
  65. package/src/runs/shared/external-job-runner.ts +286 -0
  66. package/src/runs/shared/mcp-direct-tool-allowlist.ts +14 -0
  67. package/src/runs/shared/model-fallback.ts +22 -5
  68. package/src/runs/shared/orca-progress-tabs.ts +84 -22
  69. package/src/runs/shared/parallel-handoff.ts +46 -4
  70. package/src/runs/shared/parallel-utils.ts +4 -15
  71. package/src/runs/shared/permissions.ts +5 -1
  72. package/src/runs/shared/pi-args.ts +8 -1
  73. package/src/runs/shared/subagent-control.ts +26 -4
  74. package/src/runs/shared/subagent-prompt-runtime.ts +12 -6
  75. package/src/runs/shared/workflow-graph.ts +1 -23
  76. package/src/runs/shared/worktree.ts +12 -1
  77. package/src/shared/atomic-json.ts +22 -2
  78. package/src/shared/capacity-resilient-json.ts +102 -0
  79. package/src/shared/completion-owner.ts +14 -0
  80. package/src/shared/file-system-retry.ts +49 -1
  81. package/src/shared/fork-context.ts +42 -0
  82. package/src/shared/prompt-resources.ts +0 -40
  83. package/src/shared/settings.ts +3 -27
  84. package/src/shared/types.ts +60 -26
  85. package/src/shared/utils.ts +8 -0
  86. package/src/shared/watch-strategy.ts +10 -0
  87. package/src/slash/slash-commands.ts +11 -3
  88. package/src/tui/fleet.ts +63 -15
  89. package/src/workflows/chat-progress.ts +1 -1
  90. package/src/workflows/scripted-workflow.ts +207 -65
  91. package/src/runs/foreground/chain-clarify.ts +0 -1354
  92. package/src/runs/foreground/chain-execution.ts +0 -1581
package/skills/pi-subagents/references/prompting-and-roles.md CHANGED
@@ -16,7 +16,7 @@ Parent extensions may register a session-scoped, out-of-band ceiling through `pi
16
16
  - **Regular skill specialists**: when discovery shows proactive skill subagent suggestions and the current work is broad enough, launch a small fresh-context fanout that asks one subagent per relevant regularly used skill to apply that skill's perspective to the task
17
17
  - **Long-running work**: launch async/background runs and inspect them later. For mutation-capable work, bound the delivery slice and elapsed runtime, then request checkpoints after active tool work returns. Reserve hard turn and tool-call caps for explicitly read-only children.
18
18
  - **Subagent control**: watch needs-attention signals and soft-interrupt only when a delegated run is genuinely blocked
19
- - **Agent authoring**: create, update, or override agents and chains for a project
19
+ - **Agent authoring**: create, update, or override project agents. Treat saved chain records as legacy inspection or migration inputs, not as a current authoring target.
20
20
 
21
21
  ## Tool vs Slash Commands
22
22
 
@@ -255,4 +255,4 @@ override can opt one builtin back in. Existing custom-agent frontmatter remains
255
255
 
256
256
  Set `subagents.defaultExtensions` to give agents without an `extensions` field a shared child extension allowlist. Omit it to preserve ambient extension discovery, set it to `[]` to disable ambient extensions by default, or use `agentOverrides.<name>.extensions` for one agent. Explicit custom-agent frontmatter still wins.
257
257
 
258
- Tool description modes live in `~/.pi/agent/extensions/subagent/config.json`, not `subagents` settings. Set `toolDescriptionMode` to `compact` to reduce tool-description prompt cost while keeping the execution, async/`subagent_wait`, child-safety, one-writer, management/action, and artifact/status guardrails. Set it to `custom` to read `subagent-tool-description.md` from the project config dir or agent dir; invalid custom files fall back to full mode and the safety guidance is still appended.
258
+ Tool description modes live in `~/.pi/agent/extensions/subagent/config.json`, not `subagents` settings. The default uses split prompt metadata: a short tool description plus active `promptSnippet` and `promptGuidelines`. Set `toolDescriptionMode` to `full` or `compact` to force one description string, or `custom` to read `subagent-tool-description.md` from the project config dir or agent dir; invalid custom files fall back to full mode and the safety guidance is still appended.