@nubl/maestro 0.0.0 → 0.1.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.
- package/README.md +56 -3
- package/dist/config.json.example +30 -0
- package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
- package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
- package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
- package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
- package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
- package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/accept-groups.js +70 -0
- package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
- package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
- package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/accept-runner.js +161 -0
- package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
- package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
- package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/activity-file.js +454 -0
- package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
- package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
- package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
- package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
- package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
- package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
- package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
- package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
- package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
- package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
- package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
- package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/child/entry.js +3 -0
- package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
- package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
- package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/child/protocol.js +510 -0
- package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
- package/dist/maestro/adapters/pi/completion.d.ts +45 -0
- package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/completion.js +295 -0
- package/dist/maestro/adapters/pi/completion.js.map +1 -0
- package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
- package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/launch-command.js +75 -0
- package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
- package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
- package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/launch-operations.js +270 -0
- package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
- package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
- package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/launch-resume.js +183 -0
- package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
- package/dist/maestro/adapters/pi/launch.d.ts +148 -0
- package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/launch.js +655 -0
- package/dist/maestro/adapters/pi/launch.js.map +1 -0
- package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
- package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/model-registry.js +29 -0
- package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
- package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
- package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
- package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
- package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
- package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/process-identity.js +248 -0
- package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
- package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
- package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/process-tree.js +69 -0
- package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
- package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
- package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/script-shell.js +43 -0
- package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
- package/dist/maestro/adapters/pi/session.d.ts +207 -0
- package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/session.js +714 -0
- package/dist/maestro/adapters/pi/session.js.map +1 -0
- package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
- package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
- package/dist/maestro/adapters/pi/task-model-init.js +47 -0
- package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
- package/dist/maestro/core/accept.d.ts +150 -0
- package/dist/maestro/core/accept.d.ts.map +1 -0
- package/dist/maestro/core/accept.js +243 -0
- package/dist/maestro/core/accept.js.map +1 -0
- package/dist/maestro/core/activity.d.ts +4 -0
- package/dist/maestro/core/activity.d.ts.map +1 -0
- package/dist/maestro/core/activity.js +18 -0
- package/dist/maestro/core/activity.js.map +1 -0
- package/dist/maestro/core/child-busy.d.ts +14 -0
- package/dist/maestro/core/child-busy.d.ts.map +1 -0
- package/dist/maestro/core/child-busy.js +14 -0
- package/dist/maestro/core/child-busy.js.map +1 -0
- package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
- package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
- package/dist/maestro/core/config/guidelines-config.js +60 -0
- package/dist/maestro/core/config/guidelines-config.js.map +1 -0
- package/dist/maestro/core/config/herdr-config.d.ts +13 -0
- package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
- package/dist/maestro/core/config/herdr-config.js +65 -0
- package/dist/maestro/core/config/herdr-config.js.map +1 -0
- package/dist/maestro/core/config/model-config.d.ts +92 -0
- package/dist/maestro/core/config/model-config.d.ts.map +1 -0
- package/dist/maestro/core/config/model-config.js +522 -0
- package/dist/maestro/core/config/model-config.js.map +1 -0
- package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
- package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
- package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
- package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
- package/dist/maestro/core/config/pane-config.d.ts +15 -0
- package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
- package/dist/maestro/core/config/pane-config.js +101 -0
- package/dist/maestro/core/config/pane-config.js.map +1 -0
- package/dist/maestro/core/config/persistent-config.d.ts +7 -0
- package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
- package/dist/maestro/core/config/persistent-config.js +72 -0
- package/dist/maestro/core/config/persistent-config.js.map +1 -0
- package/dist/maestro/core/config/role-config.d.ts +7 -0
- package/dist/maestro/core/config/role-config.d.ts.map +1 -0
- package/dist/maestro/core/config/role-config.js +74 -0
- package/dist/maestro/core/config/role-config.js.map +1 -0
- package/dist/maestro/core/config/spawning-config.d.ts +7 -0
- package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
- package/dist/maestro/core/config/spawning-config.js +65 -0
- package/dist/maestro/core/config/spawning-config.js.map +1 -0
- package/dist/maestro/core/config/supervision-config.d.ts +7 -0
- package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
- package/dist/maestro/core/config/supervision-config.js +69 -0
- package/dist/maestro/core/config/supervision-config.js.map +1 -0
- package/dist/maestro/core/config/task-model-init.d.ts +118 -0
- package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
- package/dist/maestro/core/config/task-model-init.js +168 -0
- package/dist/maestro/core/config/task-model-init.js.map +1 -0
- package/dist/maestro/core/config/task-model-types.d.ts +36 -0
- package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
- package/dist/maestro/core/config/task-model-types.js +17 -0
- package/dist/maestro/core/config/task-model-types.js.map +1 -0
- package/dist/maestro/core/config/type-guards.d.ts +22 -0
- package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
- package/dist/maestro/core/config/type-guards.js +31 -0
- package/dist/maestro/core/config/type-guards.js.map +1 -0
- package/dist/maestro/core/deadline.d.ts +11 -0
- package/dist/maestro/core/deadline.d.ts.map +1 -0
- package/dist/maestro/core/deadline.js +30 -0
- package/dist/maestro/core/deadline.js.map +1 -0
- package/dist/maestro/core/declared-skills.d.ts +16 -0
- package/dist/maestro/core/declared-skills.d.ts.map +1 -0
- package/dist/maestro/core/declared-skills.js +52 -0
- package/dist/maestro/core/declared-skills.js.map +1 -0
- package/dist/maestro/core/delegation-depth.d.ts +38 -0
- package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
- package/dist/maestro/core/delegation-depth.js +59 -0
- package/dist/maestro/core/delegation-depth.js.map +1 -0
- package/dist/maestro/core/git-environment.d.ts +3 -0
- package/dist/maestro/core/git-environment.d.ts.map +1 -0
- package/dist/maestro/core/git-environment.js +29 -0
- package/dist/maestro/core/git-environment.js.map +1 -0
- package/dist/maestro/core/harness-adapter.d.ts +89 -0
- package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
- package/dist/maestro/core/harness-adapter.js +2 -0
- package/dist/maestro/core/harness-adapter.js.map +1 -0
- package/dist/maestro/core/host-text.d.ts +49 -0
- package/dist/maestro/core/host-text.d.ts.map +1 -0
- package/dist/maestro/core/host-text.js +106 -0
- package/dist/maestro/core/host-text.js.map +1 -0
- package/dist/maestro/core/index.d.ts +4 -0
- package/dist/maestro/core/index.d.ts.map +1 -0
- package/dist/maestro/core/index.js +2 -0
- package/dist/maestro/core/index.js.map +1 -0
- package/dist/maestro/core/lifecycle.d.ts +16 -0
- package/dist/maestro/core/lifecycle.d.ts.map +1 -0
- package/dist/maestro/core/lifecycle.js +429 -0
- package/dist/maestro/core/lifecycle.js.map +1 -0
- package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
- package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
- package/dist/maestro/core/opened-primary-workspace.js +49 -0
- package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
- package/dist/maestro/core/platform-support.d.ts +15 -0
- package/dist/maestro/core/platform-support.d.ts.map +1 -0
- package/dist/maestro/core/platform-support.js +23 -0
- package/dist/maestro/core/platform-support.js.map +1 -0
- package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
- package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
- package/dist/maestro/core/realpath-without-opening.js +45 -0
- package/dist/maestro/core/realpath-without-opening.js.map +1 -0
- package/dist/maestro/core/roles/discovery.d.ts +64 -0
- package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
- package/dist/maestro/core/roles/discovery.js +422 -0
- package/dist/maestro/core/roles/discovery.js.map +1 -0
- package/dist/maestro/core/routing.d.ts +115 -0
- package/dist/maestro/core/routing.d.ts.map +1 -0
- package/dist/maestro/core/routing.js +449 -0
- package/dist/maestro/core/routing.js.map +1 -0
- package/dist/maestro/core/script-launch.d.ts +47 -0
- package/dist/maestro/core/script-launch.d.ts.map +1 -0
- package/dist/maestro/core/script-launch.js +102 -0
- package/dist/maestro/core/script-launch.js.map +1 -0
- package/dist/maestro/core/shell.d.ts +2 -0
- package/dist/maestro/core/shell.d.ts.map +1 -0
- package/dist/maestro/core/shell.js +4 -0
- package/dist/maestro/core/shell.js.map +1 -0
- package/dist/maestro/core/specialist-notice.d.ts +36 -0
- package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
- package/dist/maestro/core/specialist-notice.js +41 -0
- package/dist/maestro/core/specialist-notice.js.map +1 -0
- package/dist/maestro/core/status.d.ts +87 -0
- package/dist/maestro/core/status.d.ts.map +1 -0
- package/dist/maestro/core/status.js +369 -0
- package/dist/maestro/core/status.js.map +1 -0
- package/dist/maestro/core/supervision.d.ts +56 -0
- package/dist/maestro/core/supervision.d.ts.map +1 -0
- package/dist/maestro/core/supervision.js +249 -0
- package/dist/maestro/core/supervision.js.map +1 -0
- package/dist/maestro/core/surface-provider.d.ts +200 -0
- package/dist/maestro/core/surface-provider.d.ts.map +1 -0
- package/dist/maestro/core/surface-provider.js +71 -0
- package/dist/maestro/core/surface-provider.js.map +1 -0
- package/dist/maestro/core/types.d.ts +388 -0
- package/dist/maestro/core/types.d.ts.map +1 -0
- package/dist/maestro/core/types.js +2 -0
- package/dist/maestro/core/types.js.map +1 -0
- package/dist/maestro/core/undelivered-children.d.ts +27 -0
- package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
- package/dist/maestro/core/undelivered-children.js +31 -0
- package/dist/maestro/core/undelivered-children.js.map +1 -0
- package/dist/maestro/core/wake.d.ts +32 -0
- package/dist/maestro/core/wake.d.ts.map +1 -0
- package/dist/maestro/core/wake.js +125 -0
- package/dist/maestro/core/wake.js.map +1 -0
- package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
- package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
- package/dist/maestro/core/worktree-cleanup.js +278 -0
- package/dist/maestro/core/worktree-cleanup.js.map +1 -0
- package/dist/maestro/core/worktree.d.ts +50 -0
- package/dist/maestro/core/worktree.d.ts.map +1 -0
- package/dist/maestro/core/worktree.js +23 -0
- package/dist/maestro/core/worktree.js.map +1 -0
- package/dist/maestro/engine.d.ts +5 -0
- package/dist/maestro/engine.d.ts.map +1 -0
- package/dist/maestro/engine.js +5 -0
- package/dist/maestro/engine.js.map +1 -0
- package/dist/maestro/pi/child.d.ts +8 -0
- package/dist/maestro/pi/child.d.ts.map +1 -0
- package/dist/maestro/pi/child.js +8 -0
- package/dist/maestro/pi/child.js.map +1 -0
- package/dist/maestro/pi/extension.d.ts +10 -0
- package/dist/maestro/pi/extension.d.ts.map +1 -0
- package/dist/maestro/pi/extension.js +8 -0
- package/dist/maestro/pi/extension.js.map +1 -0
- package/dist/maestro/pi/subagents-index.d.ts +9 -0
- package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
- package/dist/maestro/pi/subagents-index.js +9 -0
- package/dist/maestro/pi/subagents-index.js.map +1 -0
- package/dist/maestro/pi.d.ts +9 -0
- package/dist/maestro/pi.d.ts.map +1 -0
- package/dist/maestro/pi.js +7 -0
- package/dist/maestro/pi.js.map +1 -0
- package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
- package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
- package/dist/maestro/runtime/accept-recheck.js +92 -0
- package/dist/maestro/runtime/accept-recheck.js.map +1 -0
- package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
- package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
- package/dist/maestro/runtime/delegated-marker.js +200 -0
- package/dist/maestro/runtime/delegated-marker.js.map +1 -0
- package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
- package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
- package/dist/maestro/runtime/host-surface-binding.js +2 -0
- package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
- package/dist/maestro/runtime/index.d.ts +10 -0
- package/dist/maestro/runtime/index.d.ts.map +1 -0
- package/dist/maestro/runtime/index.js +6 -0
- package/dist/maestro/runtime/index.js.map +1 -0
- package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
- package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
- package/dist/maestro/runtime/pi-persistent-io.js +64 -0
- package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
- package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
- package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
- package/dist/maestro/runtime/pi-run-session-types.js +2 -0
- package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
- package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
- package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
- package/dist/maestro/runtime/pi-run-session.js +809 -0
- package/dist/maestro/runtime/pi-run-session.js.map +1 -0
- package/dist/maestro/runtime/run-session.d.ts +129 -0
- package/dist/maestro/runtime/run-session.d.ts.map +1 -0
- package/dist/maestro/runtime/run-session.js +680 -0
- package/dist/maestro/runtime/run-session.js.map +1 -0
- package/dist/maestro/runtime/surface-retention.d.ts +3 -0
- package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
- package/dist/maestro/runtime/surface-retention.js +5 -0
- package/dist/maestro/runtime/surface-retention.js.map +1 -0
- package/dist/maestro/runtime/task-model-init.d.ts +34 -0
- package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
- package/dist/maestro/runtime/task-model-init.js +78 -0
- package/dist/maestro/runtime/task-model-init.js.map +1 -0
- package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
- package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
- package/dist/maestro/runtime/worktree-operations.js +633 -0
- package/dist/maestro/runtime/worktree-operations.js.map +1 -0
- package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
- package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
- package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
- package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
- package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
- package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
- package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
- package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
- package/dist/maestro/testing/index.d.ts +5 -0
- package/dist/maestro/testing/index.d.ts.map +1 -0
- package/dist/maestro/testing/index.js +5 -0
- package/dist/maestro/testing/index.js.map +1 -0
- package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
- package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
- package/dist/maestro/testing/surface-provider.conformance.js +167 -0
- package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
- package/dist/pi-extension/subagents/catalog.d.ts +70 -0
- package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
- package/dist/pi-extension/subagents/catalog.js +231 -0
- package/dist/pi-extension/subagents/catalog.js.map +1 -0
- package/dist/pi-extension/subagents/config-path.d.ts +6 -0
- package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
- package/dist/pi-extension/subagents/config-path.js +21 -0
- package/dist/pi-extension/subagents/config-path.js.map +1 -0
- package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
- package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
- package/dist/pi-extension/subagents/control-tools.js +150 -0
- package/dist/pi-extension/subagents/control-tools.js.map +1 -0
- package/dist/pi-extension/subagents/controls.d.ts +52 -0
- package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
- package/dist/pi-extension/subagents/controls.js +173 -0
- package/dist/pi-extension/subagents/controls.js.map +1 -0
- package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
- package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
- package/dist/pi-extension/subagents/deferred-tools.js +67 -0
- package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
- package/dist/pi-extension/subagents/delivery.d.ts +22 -0
- package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
- package/dist/pi-extension/subagents/delivery.js +365 -0
- package/dist/pi-extension/subagents/delivery.js.map +1 -0
- package/dist/pi-extension/subagents/extension.d.ts +100 -0
- package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
- package/dist/pi-extension/subagents/extension.js +367 -0
- package/dist/pi-extension/subagents/extension.js.map +1 -0
- package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
- package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
- package/dist/pi-extension/subagents/launch-tools.js +373 -0
- package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
- package/dist/pi-extension/subagents/launch.d.ts +86 -0
- package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
- package/dist/pi-extension/subagents/launch.js +133 -0
- package/dist/pi-extension/subagents/launch.js.map +1 -0
- package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
- package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
- package/dist/pi-extension/subagents/model-registry.js +52 -0
- package/dist/pi-extension/subagents/model-registry.js.map +1 -0
- package/dist/pi-extension/subagents/observation.d.ts +38 -0
- package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
- package/dist/pi-extension/subagents/observation.js +168 -0
- package/dist/pi-extension/subagents/observation.js.map +1 -0
- package/dist/pi-extension/subagents/persistent.d.ts +72 -0
- package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
- package/dist/pi-extension/subagents/persistent.js +322 -0
- package/dist/pi-extension/subagents/persistent.js.map +1 -0
- package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
- package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
- package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
- package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
- package/dist/pi-extension/subagents/presentation.d.ts +149 -0
- package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
- package/dist/pi-extension/subagents/presentation.js +419 -0
- package/dist/pi-extension/subagents/presentation.js.map +1 -0
- package/dist/pi-extension/subagents/state.d.ts +183 -0
- package/dist/pi-extension/subagents/state.d.ts.map +1 -0
- package/dist/pi-extension/subagents/state.js +92 -0
- package/dist/pi-extension/subagents/state.js.map +1 -0
- package/dist/pi-extension/subagents/task-models.d.ts +9 -0
- package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
- package/dist/pi-extension/subagents/task-models.js +293 -0
- package/dist/pi-extension/subagents/task-models.js.map +1 -0
- package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
- package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
- package/dist/pi-extension/subagents/tool-boundary.js +53 -0
- package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
- package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
- package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
- package/dist/pi-extension/subagents/worktree-tools.js +185 -0
- package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
- package/dist/provenance.json +5 -0
- package/package.json +540 -27
- package/index.d.ts +0 -1
- package/index.js +0 -2
|
@@ -0,0 +1,510 @@
|
|
|
1
|
+
import { Type } from "@sinclair/typebox";
|
|
2
|
+
import { writeFileSync } from "node:fs";
|
|
3
|
+
import { appendPersistentTaskEvent, consumePersistentTaskInbox, readPersistentDeliveryLedger, readPersistentTaskEvents, } from "../session.js";
|
|
4
|
+
import { createSubagentActivityRecorder } from "../activity-file.js";
|
|
5
|
+
import { createDoneNudge } from "./done-nudge.js";
|
|
6
|
+
import { registerDeclaredSkills } from "./declared-skills.js";
|
|
7
|
+
import { isChildBusy } from "../../../core/child-busy.js";
|
|
8
|
+
import { readOwnProcessIdentity, writeProcessIdentityRecord, } from "../process-identity.js";
|
|
9
|
+
import { isString } from "../../../core/config/type-guards.js";
|
|
10
|
+
import { hasUndeliveredChildren } from "../../../core/undelivered-children.js";
|
|
11
|
+
import { ACCEPT_FILE_ENV, } from "../../../core/accept.js";
|
|
12
|
+
import { readAcceptSpecFile } from "../accept-runner.js";
|
|
13
|
+
import { createChildAcceptLoop } from "./accept-check.js";
|
|
14
|
+
import { childNoticeRefusal, NOTICE_CAP, NOTICE_CHILD_INTERVAL_MS, } from "../../../core/specialist-notice.js";
|
|
15
|
+
export function shouldMarkUserTookOver(agentStarted) {
|
|
16
|
+
return agentStarted;
|
|
17
|
+
}
|
|
18
|
+
export function shouldAutoExitOnAgentEnd(_userTookOver, messages, runAborted = false) {
|
|
19
|
+
// Escape during a tool lets Pi start the next provider request on the
|
|
20
|
+
// aborted signal, which lazyStream records as stopReason "error".
|
|
21
|
+
if (runAborted)
|
|
22
|
+
return false;
|
|
23
|
+
// Manual input should not strand an auto-exit subagent. If the latest agent
|
|
24
|
+
// turn completed normally, close the session. Escape/abort still leaves it
|
|
25
|
+
// open for inspection or another prompt.
|
|
26
|
+
//
|
|
27
|
+
// stopReason: "error" (e.g. exhausted retries on a provider overload) also
|
|
28
|
+
// returns true — we want to shut down so the parent is woken up — but we
|
|
29
|
+
// pair this with findLatestAssistantError() so the parent learns it was an
|
|
30
|
+
// error, not a clean completion.
|
|
31
|
+
if (messages) {
|
|
32
|
+
for (let i = messages.length - 1; i >= 0; i--) {
|
|
33
|
+
const msg = messages[i];
|
|
34
|
+
if (msg?.role === "assistant") {
|
|
35
|
+
return msg.stopReason !== "aborted";
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return true;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* If the last assistant message in the turn ended with `stopReason: "error"`
|
|
43
|
+
* (typically auto-retry exhausted on an overload / rate limit / server error),
|
|
44
|
+
* return its error info so the parent orchestrator can surface a clear
|
|
45
|
+
* failure instead of silently treating the run as completed.
|
|
46
|
+
*
|
|
47
|
+
* Returns `null` when the latest assistant turn completed normally or was
|
|
48
|
+
* aborted by the user (handled separately by shouldAutoExitOnAgentEnd).
|
|
49
|
+
*/
|
|
50
|
+
export function findLatestAssistantError(messages) {
|
|
51
|
+
if (!messages)
|
|
52
|
+
return null;
|
|
53
|
+
for (let i = messages.length - 1; i >= 0; i--) {
|
|
54
|
+
const msg = messages[i];
|
|
55
|
+
if (msg?.role !== "assistant")
|
|
56
|
+
continue;
|
|
57
|
+
if (msg.stopReason !== "error")
|
|
58
|
+
return null;
|
|
59
|
+
const raw = isString(msg.errorMessage) ? msg.errorMessage.trim() : "";
|
|
60
|
+
return {
|
|
61
|
+
errorMessage: raw ||
|
|
62
|
+
"Subagent agent loop ended with stopReason=error (no errorMessage field).",
|
|
63
|
+
stopReason: "error",
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
return null;
|
|
67
|
+
}
|
|
68
|
+
export function buildCompletionSidecar(messages, accept) {
|
|
69
|
+
const errorInfo = findLatestAssistantError(messages);
|
|
70
|
+
if (errorInfo)
|
|
71
|
+
return { type: "error", ...errorInfo };
|
|
72
|
+
// Only a check that ran adds its report; the sidecar never holds output.
|
|
73
|
+
return accept ? { type: "done", accept } : { type: "done" };
|
|
74
|
+
}
|
|
75
|
+
export function buildPersistentTaskEvent(task, generation) {
|
|
76
|
+
return {
|
|
77
|
+
version: 1,
|
|
78
|
+
type: "task-done",
|
|
79
|
+
task,
|
|
80
|
+
generation,
|
|
81
|
+
at: new Date().toISOString(),
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
export function isPersistentStopDirective(inbox) {
|
|
85
|
+
return inbox?.type === "stop";
|
|
86
|
+
}
|
|
87
|
+
function findUnsettledPersistentTask(sessionFile, generation) {
|
|
88
|
+
const settledTasks = new Set(readPersistentTaskEvents(sessionFile)
|
|
89
|
+
.filter((event) => event.type !== "notice" && event.generation === generation)
|
|
90
|
+
.map((event) => event.task));
|
|
91
|
+
return (readPersistentDeliveryLedger(sessionFile)
|
|
92
|
+
.filter((entry) => entry.generation === generation &&
|
|
93
|
+
entry.outcome === "dispatched" &&
|
|
94
|
+
!settledTasks.has(entry.task))
|
|
95
|
+
.at(-1)?.task ?? "");
|
|
96
|
+
}
|
|
97
|
+
export function parseDeniedTools(rawValue) {
|
|
98
|
+
return (rawValue ?? "")
|
|
99
|
+
.split(",")
|
|
100
|
+
.map((value) => value.trim())
|
|
101
|
+
.filter(Boolean);
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* A managed worktree child names its own process at load from immutable
|
|
105
|
+
* kernel facts, which Pi's process-title rewrite cannot alter.
|
|
106
|
+
*/
|
|
107
|
+
export function recordProcessIdentity(id, sessionFile, file = process.env.PI_SUBAGENT_PROCESS_FILE) {
|
|
108
|
+
if (!file || !id || !sessionFile)
|
|
109
|
+
return;
|
|
110
|
+
try {
|
|
111
|
+
writeProcessIdentityRecord(file, {
|
|
112
|
+
version: 1,
|
|
113
|
+
id,
|
|
114
|
+
sessionFile,
|
|
115
|
+
...readOwnProcessIdentity(),
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
// Unrecorded identity leaves a worktree cancel unconfirmed, never guessed.
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
export function createChildExtension(renderWidget) {
|
|
123
|
+
return function subagentChildExtension(pi) {
|
|
124
|
+
let toolNames = [];
|
|
125
|
+
let denied = [];
|
|
126
|
+
// Read subagent identity from env vars (set by parent orchestrator)
|
|
127
|
+
const subagentName = process.env.PI_SUBAGENT_NAME ?? "";
|
|
128
|
+
const subagentAgent = process.env.PI_SUBAGENT_AGENT ?? "";
|
|
129
|
+
const deniedToolsValue = process.env.PI_DENY_TOOLS;
|
|
130
|
+
const autoExit = process.env.PI_SUBAGENT_AUTO_EXIT === "1";
|
|
131
|
+
const persistent = process.env.PI_SUBAGENT_PERSISTENT === "1";
|
|
132
|
+
// The parent opted this specialist into notices at launch (ADR-0019).
|
|
133
|
+
const notify = persistent && process.env.PI_SUBAGENT_NOTIFY === "1";
|
|
134
|
+
const generation = process.env.PI_SUBAGENT_GENERATION_ID ?? "";
|
|
135
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
136
|
+
const initialTask = process.env.PI_SUBAGENT_TASK_ID ?? "";
|
|
137
|
+
let currentTask = persistent
|
|
138
|
+
? findUnsettledPersistentTask(sessionFile ?? "", generation) ||
|
|
139
|
+
(initialTask &&
|
|
140
|
+
!readPersistentTaskEvents(sessionFile ?? "").some((event) => event.type !== "notice" &&
|
|
141
|
+
event.task === initialTask &&
|
|
142
|
+
event.generation === generation)
|
|
143
|
+
? initialTask
|
|
144
|
+
: "")
|
|
145
|
+
: "";
|
|
146
|
+
const recorder = createSubagentActivityRecorder({
|
|
147
|
+
runningChildId: process.env.PI_SUBAGENT_ID,
|
|
148
|
+
activityFile: process.env.PI_SUBAGENT_ACTIVITY_FILE,
|
|
149
|
+
persistent,
|
|
150
|
+
});
|
|
151
|
+
recordProcessIdentity(process.env.PI_SUBAGENT_ID, sessionFile);
|
|
152
|
+
// The role's declared skills, as this child's own Pi loaded them.
|
|
153
|
+
registerDeclaredSkills(pi);
|
|
154
|
+
let userTookOver = false;
|
|
155
|
+
let agentStarted = false;
|
|
156
|
+
let latestAgentMessages;
|
|
157
|
+
let completionFinalized = false;
|
|
158
|
+
let sessionContext;
|
|
159
|
+
// A child without auto-exit closes only through subagent_done, so one that
|
|
160
|
+
// forgets it is asked once whether its task is complete.
|
|
161
|
+
const doneNudge = !autoExit && !persistent
|
|
162
|
+
? createDoneNudge({
|
|
163
|
+
// A run that starts between the idle check and delivery queues the
|
|
164
|
+
// question instead of rejecting it.
|
|
165
|
+
send: (message) => pi.sendUserMessage(message, { deliverAs: "followUp" }),
|
|
166
|
+
isBusy: () => isChildBusy(pi.events),
|
|
167
|
+
})
|
|
168
|
+
: undefined;
|
|
169
|
+
// Show widget + status bar on session start
|
|
170
|
+
pi.on("session_start", (_event, ctx) => {
|
|
171
|
+
sessionContext = ctx;
|
|
172
|
+
recorder.sessionStart();
|
|
173
|
+
const tools = pi.getAllTools();
|
|
174
|
+
toolNames = tools.map((t) => t.name).sort();
|
|
175
|
+
denied = parseDeniedTools(deniedToolsValue);
|
|
176
|
+
renderWidget?.(ctx, { subagentName, subagentAgent, toolNames, denied });
|
|
177
|
+
});
|
|
178
|
+
pi.on("input", () => {
|
|
179
|
+
recorder.input();
|
|
180
|
+
// Ignore the initial task message that starts an autonomous subagent.
|
|
181
|
+
// Only inputs after the first agent run has started count as user takeover.
|
|
182
|
+
if (!shouldMarkUserTookOver(agentStarted))
|
|
183
|
+
return;
|
|
184
|
+
userTookOver = true;
|
|
185
|
+
});
|
|
186
|
+
pi.on("before_agent_start", () => {
|
|
187
|
+
recorder.beforeAgentStart();
|
|
188
|
+
doneNudge?.runStarting();
|
|
189
|
+
});
|
|
190
|
+
pi.on("agent_start", () => {
|
|
191
|
+
agentStarted = true;
|
|
192
|
+
recorder.agentStart();
|
|
193
|
+
});
|
|
194
|
+
pi.on("agent_end", (event) => {
|
|
195
|
+
latestAgentMessages = event.messages;
|
|
196
|
+
recorder.agentEndWaiting();
|
|
197
|
+
if (autoExit) {
|
|
198
|
+
// Reset any recorded manual input marker. Auto-exit is decided by whether
|
|
199
|
+
// the latest agent turn completed normally, not by who initiated it.
|
|
200
|
+
userTookOver = false;
|
|
201
|
+
}
|
|
202
|
+
});
|
|
203
|
+
// The accept check runs at the final actionable boundary, where Pi awaits
|
|
204
|
+
// the handler and may continue once; agent_settled only notifies.
|
|
205
|
+
const acceptSpec = autoExit && !persistent
|
|
206
|
+
? readAcceptSpecFile(process.env[ACCEPT_FILE_ENV])
|
|
207
|
+
: undefined;
|
|
208
|
+
const acceptLoop = acceptSpec
|
|
209
|
+
? createChildAcceptLoop({ spec: acceptSpec, cwd: process.cwd() })
|
|
210
|
+
: undefined;
|
|
211
|
+
if (acceptLoop)
|
|
212
|
+
pi.on("agent_before_settle", async (event, ctx) => {
|
|
213
|
+
// A settle that will not exit (undelivered children) checks later.
|
|
214
|
+
if (completionFinalized || hasUndeliveredChildren())
|
|
215
|
+
return undefined;
|
|
216
|
+
return acceptLoop.beforeSettle(event, ctx.signal);
|
|
217
|
+
});
|
|
218
|
+
pi.on("agent_settled", (event, ctx) => {
|
|
219
|
+
const runAborted = event?.aborted === true;
|
|
220
|
+
if (doneNudge && !completionFinalized) {
|
|
221
|
+
doneNudge.settled(latestAgentMessages, runAborted, ctx);
|
|
222
|
+
}
|
|
223
|
+
if (persistent && !completionFinalized) {
|
|
224
|
+
let messages = latestAgentMessages;
|
|
225
|
+
try {
|
|
226
|
+
const branchMessages = ctx.sessionManager
|
|
227
|
+
.getBranch()
|
|
228
|
+
.flatMap((entry) => entry.type === "message" ? [entry.message] : []);
|
|
229
|
+
if (branchMessages.length > 0)
|
|
230
|
+
messages = branchMessages;
|
|
231
|
+
}
|
|
232
|
+
catch {
|
|
233
|
+
// Fall back to the latest low-level run when session evidence is unavailable.
|
|
234
|
+
}
|
|
235
|
+
if (currentTask &&
|
|
236
|
+
shouldAutoExitOnAgentEnd(userTookOver, messages, runAborted)) {
|
|
237
|
+
appendPersistentTaskEvent(process.env.PI_SUBAGENT_SESSION ?? "", buildPersistentTaskEvent(currentTask, generation));
|
|
238
|
+
currentTask = "";
|
|
239
|
+
recorder.agentEndWaiting();
|
|
240
|
+
}
|
|
241
|
+
return;
|
|
242
|
+
}
|
|
243
|
+
if (!autoExit || completionFinalized)
|
|
244
|
+
return;
|
|
245
|
+
let messages = latestAgentMessages;
|
|
246
|
+
try {
|
|
247
|
+
const branchMessages = ctx.sessionManager
|
|
248
|
+
.getBranch()
|
|
249
|
+
.flatMap((entry) => entry.type === "message" ? [entry.message] : []);
|
|
250
|
+
if (branchMessages.length > 0)
|
|
251
|
+
messages = branchMessages;
|
|
252
|
+
}
|
|
253
|
+
catch {
|
|
254
|
+
// Fall back to the latest low-level run when session evidence is unavailable.
|
|
255
|
+
}
|
|
256
|
+
if (!shouldAutoExitOnAgentEnd(userTookOver, messages, runAborted))
|
|
257
|
+
return;
|
|
258
|
+
// Children this session launched deliver their results as steers. Exiting
|
|
259
|
+
// now would drop them, so wait: the last delivery starts a new turn, and
|
|
260
|
+
// its settlement reaches this point again. A settled error still exits so
|
|
261
|
+
// the parent learns of it promptly.
|
|
262
|
+
if (findLatestAssistantError(messages) === null &&
|
|
263
|
+
hasUndeliveredChildren())
|
|
264
|
+
return;
|
|
265
|
+
completionFinalized = true;
|
|
266
|
+
// Surface a settled stopReason: "error" to the parent via the .exit
|
|
267
|
+
// sidecar. Transient errors followed by retry or compaction never reach
|
|
268
|
+
// this point as the latest assistant message.
|
|
269
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
270
|
+
if (sessionFile) {
|
|
271
|
+
try {
|
|
272
|
+
writeFileSync(`${sessionFile}.exit`, JSON.stringify(buildCompletionSidecar(messages, acceptLoop?.report())));
|
|
273
|
+
}
|
|
274
|
+
catch {
|
|
275
|
+
// Best effort — the watcher can still detect the terminal sentinel
|
|
276
|
+
// after shutdown if the completion sidecar cannot be written.
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
recorder.agentEndDone();
|
|
280
|
+
ctx.shutdown();
|
|
281
|
+
});
|
|
282
|
+
pi.on("turn_start", (event) => {
|
|
283
|
+
recorder.turnStart(event.turnIndex);
|
|
284
|
+
});
|
|
285
|
+
pi.on("turn_end", (event) => {
|
|
286
|
+
recorder.turnEnd(event.turnIndex);
|
|
287
|
+
});
|
|
288
|
+
pi.on("before_provider_request", () => {
|
|
289
|
+
recorder.beforeProviderRequest();
|
|
290
|
+
});
|
|
291
|
+
pi.on("after_provider_response", () => {
|
|
292
|
+
recorder.afterProviderResponse();
|
|
293
|
+
});
|
|
294
|
+
pi.on("message_update", (event) => {
|
|
295
|
+
recorder.messageUpdate(event.assistantMessageEvent?.type);
|
|
296
|
+
});
|
|
297
|
+
pi.on("tool_execution_start", (event) => {
|
|
298
|
+
recorder.toolExecutionStart(event.toolCallId, event.toolName);
|
|
299
|
+
});
|
|
300
|
+
pi.on("tool_call", (event) => {
|
|
301
|
+
recorder.toolCall(event.toolCallId, event.toolName);
|
|
302
|
+
});
|
|
303
|
+
pi.on("tool_execution_update", (event) => {
|
|
304
|
+
recorder.toolExecutionUpdate(event.toolCallId, event.toolName);
|
|
305
|
+
});
|
|
306
|
+
pi.on("tool_result", (event) => {
|
|
307
|
+
recorder.toolResult(event.toolCallId, event.toolName);
|
|
308
|
+
});
|
|
309
|
+
pi.on("tool_execution_end", (event) => {
|
|
310
|
+
recorder.toolExecutionEnd(event.toolCallId, event.toolName);
|
|
311
|
+
});
|
|
312
|
+
pi.on("session_shutdown", async (event) => {
|
|
313
|
+
if (inboxPoller)
|
|
314
|
+
clearInterval(inboxPoller);
|
|
315
|
+
doneNudge?.cancel();
|
|
316
|
+
recorder.sessionShutdown(event.reason);
|
|
317
|
+
// A check still running belongs to this session: stop it, bounded.
|
|
318
|
+
await acceptLoop?.shutdown();
|
|
319
|
+
});
|
|
320
|
+
pi.registerTool({
|
|
321
|
+
name: "caller_ping",
|
|
322
|
+
label: "Caller Ping",
|
|
323
|
+
description: "Send a help request to the parent agent and exit this session. " +
|
|
324
|
+
"The parent will be notified with your message and can resume this session with a response. " +
|
|
325
|
+
"Use when you're stuck, need clarification, or need the parent to take action.",
|
|
326
|
+
parameters: Type.Object({
|
|
327
|
+
message: Type.String({ description: "What you need help with" }),
|
|
328
|
+
}),
|
|
329
|
+
async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
|
|
330
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
331
|
+
if (!sessionFile) {
|
|
332
|
+
throw new Error("caller_ping is only available in subagent contexts. " +
|
|
333
|
+
"PI_SUBAGENT_SESSION environment variable is not set.");
|
|
334
|
+
}
|
|
335
|
+
// The parent ignores a help request for no task; an opted-in
|
|
336
|
+
// specialist has a tool that reaches it.
|
|
337
|
+
if (notify && !currentTask)
|
|
338
|
+
throw new Error("caller_ping has no current task to ask about, so the parent would ignore it. " +
|
|
339
|
+
"Use caller_notify to tell the parent something changed.");
|
|
340
|
+
recorder.callerPing();
|
|
341
|
+
if (persistent) {
|
|
342
|
+
appendPersistentTaskEvent(sessionFile, {
|
|
343
|
+
type: "help-request",
|
|
344
|
+
task: currentTask,
|
|
345
|
+
generation,
|
|
346
|
+
message: params.message,
|
|
347
|
+
});
|
|
348
|
+
currentTask = "";
|
|
349
|
+
return {
|
|
350
|
+
content: [
|
|
351
|
+
{
|
|
352
|
+
type: "text",
|
|
353
|
+
text: "Help request sent. Stay available for subagent_send.",
|
|
354
|
+
},
|
|
355
|
+
],
|
|
356
|
+
details: {},
|
|
357
|
+
};
|
|
358
|
+
}
|
|
359
|
+
const exitData = {
|
|
360
|
+
type: "ping",
|
|
361
|
+
name: process.env.PI_SUBAGENT_NAME ?? "subagent",
|
|
362
|
+
message: params.message,
|
|
363
|
+
};
|
|
364
|
+
writeFileSync(`${sessionFile}.exit`, JSON.stringify(exitData));
|
|
365
|
+
completionFinalized = true;
|
|
366
|
+
ctx.shutdown();
|
|
367
|
+
return {
|
|
368
|
+
content: [
|
|
369
|
+
{
|
|
370
|
+
type: "text",
|
|
371
|
+
text: "Ping sent. Session will exit and parent will be notified.",
|
|
372
|
+
},
|
|
373
|
+
],
|
|
374
|
+
details: {},
|
|
375
|
+
};
|
|
376
|
+
},
|
|
377
|
+
});
|
|
378
|
+
if (notify)
|
|
379
|
+
pi.registerTool({
|
|
380
|
+
name: "caller_notify",
|
|
381
|
+
label: "Caller Notify",
|
|
382
|
+
description: "Wake the parent agent with a short notice that something changed, without ending or completing any task. " +
|
|
383
|
+
`Only for a persistent specialist whose parent opted in; at most ${NOTICE_CAP} notices, at least ${NOTICE_CHILD_INTERVAL_MS / 1_000} seconds apart. ` +
|
|
384
|
+
"Send one only when something the parent cares about changed, never to say that nothing changed.",
|
|
385
|
+
parameters: Type.Object({
|
|
386
|
+
message: Type.String({
|
|
387
|
+
description: "What changed, in a sentence or two",
|
|
388
|
+
}),
|
|
389
|
+
}),
|
|
390
|
+
async execute(_toolCallId, params) {
|
|
391
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
392
|
+
if (!sessionFile)
|
|
393
|
+
throw new Error("caller_notify is only available in persistent subagent contexts. " +
|
|
394
|
+
"PI_SUBAGENT_SESSION environment variable is not set.");
|
|
395
|
+
// Counted from the event file, so a child /reload keeps its place.
|
|
396
|
+
const sent = readPersistentTaskEvents(sessionFile).filter((event) => event.type === "notice" && event.generation === generation);
|
|
397
|
+
const last = sent.at(-1);
|
|
398
|
+
const refusal = childNoticeRefusal({
|
|
399
|
+
sent: sent.length,
|
|
400
|
+
lastAt: last ? Date.parse(last.at) : undefined,
|
|
401
|
+
}, Date.now());
|
|
402
|
+
if (refusal)
|
|
403
|
+
throw new Error(refusal);
|
|
404
|
+
const sequence = sent.length + 1;
|
|
405
|
+
// No activity change: a notice neither starts nor ends a task.
|
|
406
|
+
appendPersistentTaskEvent(sessionFile, {
|
|
407
|
+
type: "notice",
|
|
408
|
+
task: "",
|
|
409
|
+
generation,
|
|
410
|
+
message: params.message,
|
|
411
|
+
sequence,
|
|
412
|
+
});
|
|
413
|
+
return {
|
|
414
|
+
content: [
|
|
415
|
+
{
|
|
416
|
+
type: "text",
|
|
417
|
+
text: `Notice ${sequence} of ${NOTICE_CAP} sent. ` +
|
|
418
|
+
"It does not end or complete any task; continue your current work or stay available for subagent_send.",
|
|
419
|
+
},
|
|
420
|
+
],
|
|
421
|
+
details: {},
|
|
422
|
+
};
|
|
423
|
+
},
|
|
424
|
+
});
|
|
425
|
+
let inboxPoller;
|
|
426
|
+
if (persistent) {
|
|
427
|
+
inboxPoller = setInterval(() => {
|
|
428
|
+
try {
|
|
429
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
430
|
+
if (!sessionFile || currentTask)
|
|
431
|
+
return;
|
|
432
|
+
const inbox = consumePersistentTaskInbox(sessionFile);
|
|
433
|
+
if (!inbox)
|
|
434
|
+
return;
|
|
435
|
+
if (isPersistentStopDirective(inbox)) {
|
|
436
|
+
try {
|
|
437
|
+
writeFileSync(`${sessionFile}.exit`, JSON.stringify({ type: "done" }));
|
|
438
|
+
}
|
|
439
|
+
catch {
|
|
440
|
+
// The parent can still confirm the shell exit marker.
|
|
441
|
+
}
|
|
442
|
+
completionFinalized = true;
|
|
443
|
+
recorder.subagentDone();
|
|
444
|
+
// The run that asked for help belongs to no task, and shutdown waits for idle.
|
|
445
|
+
if (sessionContext && !sessionContext.isIdle())
|
|
446
|
+
sessionContext.abort();
|
|
447
|
+
sessionContext?.shutdown();
|
|
448
|
+
return;
|
|
449
|
+
}
|
|
450
|
+
currentTask = inbox.task;
|
|
451
|
+
recorder.taskStart();
|
|
452
|
+
// After caller_ping the run that asked for help may still be streaming.
|
|
453
|
+
pi.sendUserMessage(inbox.message, { deliverAs: "followUp" });
|
|
454
|
+
}
|
|
455
|
+
catch {
|
|
456
|
+
// A malformed or transiently unavailable inbox must not kill the poller.
|
|
457
|
+
}
|
|
458
|
+
}, 1000);
|
|
459
|
+
}
|
|
460
|
+
if (autoExit)
|
|
461
|
+
return;
|
|
462
|
+
pi.registerTool({
|
|
463
|
+
name: "subagent_done",
|
|
464
|
+
label: "Subagent Done",
|
|
465
|
+
description: "Call this tool when you have completed your task. " +
|
|
466
|
+
"It will close this session and return your results to the main session. " +
|
|
467
|
+
"Your LAST assistant message before calling this becomes the summary returned to the caller.",
|
|
468
|
+
parameters: Type.Object({}),
|
|
469
|
+
async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
|
|
470
|
+
const sessionFile = process.env.PI_SUBAGENT_SESSION;
|
|
471
|
+
recorder.subagentDone();
|
|
472
|
+
if (persistent) {
|
|
473
|
+
if (!sessionFile || !currentTask) {
|
|
474
|
+
return {
|
|
475
|
+
content: [
|
|
476
|
+
{
|
|
477
|
+
type: "text",
|
|
478
|
+
text: "No current task. Staying available for subagent_send.",
|
|
479
|
+
},
|
|
480
|
+
],
|
|
481
|
+
details: {},
|
|
482
|
+
};
|
|
483
|
+
}
|
|
484
|
+
appendPersistentTaskEvent(sessionFile, buildPersistentTaskEvent(currentTask, generation));
|
|
485
|
+
currentTask = "";
|
|
486
|
+
return {
|
|
487
|
+
content: [
|
|
488
|
+
{
|
|
489
|
+
type: "text",
|
|
490
|
+
text: "Task complete. Staying available for subagent_send.",
|
|
491
|
+
},
|
|
492
|
+
],
|
|
493
|
+
details: {},
|
|
494
|
+
};
|
|
495
|
+
}
|
|
496
|
+
if (sessionFile) {
|
|
497
|
+
writeFileSync(`${sessionFile}.exit`, JSON.stringify({ type: "done" }));
|
|
498
|
+
}
|
|
499
|
+
completionFinalized = true;
|
|
500
|
+
ctx.shutdown();
|
|
501
|
+
return {
|
|
502
|
+
content: [{ type: "text", text: "Shutting down subagent session." }],
|
|
503
|
+
details: {},
|
|
504
|
+
};
|
|
505
|
+
},
|
|
506
|
+
});
|
|
507
|
+
};
|
|
508
|
+
}
|
|
509
|
+
export default createChildExtension();
|
|
510
|
+
//# sourceMappingURL=protocol.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../../maestro/adapters/pi/child/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extension loaded into sub-agents.\n * - Shows agent identity + available tools as a compact styled widget above the editor\n * - Provides a `subagent_done` tool for interactive agents to self-terminate\n */\nimport type {\n\tExtensionAPI,\n\tExtensionContext,\n} from \"@earendil-works/pi-coding-agent\";\nimport { Type } from \"@sinclair/typebox\";\nimport { writeFileSync } from \"node:fs\";\nimport {\n\tappendPersistentTaskEvent,\n\tconsumePersistentTaskInbox,\n\treadPersistentDeliveryLedger,\n\treadPersistentTaskEvents,\n} from \"../session.ts\";\nimport { createSubagentActivityRecorder } from \"../activity-file.ts\";\nimport { createDoneNudge } from \"./done-nudge.ts\";\nimport { registerDeclaredSkills } from \"./declared-skills.ts\";\nimport { isChildBusy } from \"../../../core/child-busy.ts\";\nimport {\n\treadOwnProcessIdentity,\n\twriteProcessIdentityRecord,\n} from \"../process-identity.ts\";\nimport { isString } from \"../../../core/config/type-guards.ts\";\nimport { hasUndeliveredChildren } from \"../../../core/undelivered-children.ts\";\nimport {\n\tACCEPT_FILE_ENV,\n\ttype ChildAcceptReport,\n} from \"../../../core/accept.ts\";\nimport { readAcceptSpecFile } from \"../accept-runner.ts\";\nimport { createChildAcceptLoop } from \"./accept-check.ts\";\nimport {\n\tchildNoticeRefusal,\n\tNOTICE_CAP,\n\tNOTICE_CHILD_INTERVAL_MS,\n} from \"../../../core/specialist-notice.ts\";\n\nexport function shouldMarkUserTookOver(agentStarted: boolean): boolean {\n\treturn agentStarted;\n}\n\nexport function shouldAutoExitOnAgentEnd(\n\t_userTookOver: boolean,\n\tmessages: any[] | undefined,\n\trunAborted = false,\n): boolean {\n\t// Escape during a tool lets Pi start the next provider request on the\n\t// aborted signal, which lazyStream records as stopReason \"error\".\n\tif (runAborted) return false;\n\t// Manual input should not strand an auto-exit subagent. If the latest agent\n\t// turn completed normally, close the session. Escape/abort still leaves it\n\t// open for inspection or another prompt.\n\t//\n\t// stopReason: \"error\" (e.g. exhausted retries on a provider overload) also\n\t// returns true — we want to shut down so the parent is woken up — but we\n\t// pair this with findLatestAssistantError() so the parent learns it was an\n\t// error, not a clean completion.\n\tif (messages) {\n\t\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\t\tconst msg = messages[i];\n\t\t\tif (msg?.role === \"assistant\") {\n\t\t\t\treturn msg.stopReason !== \"aborted\";\n\t\t\t}\n\t\t}\n\t}\n\n\treturn true;\n}\n\nexport interface SubagentErrorInfo {\n\terrorMessage: string;\n\tstopReason: \"error\";\n}\n\n/**\n * If the last assistant message in the turn ended with `stopReason: \"error\"`\n * (typically auto-retry exhausted on an overload / rate limit / server error),\n * return its error info so the parent orchestrator can surface a clear\n * failure instead of silently treating the run as completed.\n *\n * Returns `null` when the latest assistant turn completed normally or was\n * aborted by the user (handled separately by shouldAutoExitOnAgentEnd).\n */\nexport function findLatestAssistantError(\n\tmessages: any[] | undefined,\n): SubagentErrorInfo | null {\n\tif (!messages) return null;\n\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\tconst msg = messages[i];\n\t\tif (msg?.role !== \"assistant\") continue;\n\t\tif (msg.stopReason !== \"error\") return null;\n\t\tconst raw = isString(msg.errorMessage) ? msg.errorMessage.trim() : \"\";\n\t\treturn {\n\t\t\terrorMessage:\n\t\t\t\traw ||\n\t\t\t\t\"Subagent agent loop ended with stopReason=error (no errorMessage field).\",\n\t\t\tstopReason: \"error\",\n\t\t};\n\t}\n\treturn null;\n}\n\nexport function buildCompletionSidecar(\n\tmessages: any[] | undefined,\n\taccept?: ChildAcceptReport,\n):\n\t| { type: \"done\"; accept?: ChildAcceptReport }\n\t| { type: \"error\"; errorMessage: string; stopReason: \"error\" } {\n\tconst errorInfo = findLatestAssistantError(messages);\n\tif (errorInfo) return { type: \"error\", ...errorInfo };\n\t// Only a check that ran adds its report; the sidecar never holds output.\n\treturn accept ? { type: \"done\", accept } : { type: \"done\" };\n}\n\nexport function buildPersistentTaskEvent(task: string, generation: string) {\n\treturn {\n\t\tversion: 1 as const,\n\t\ttype: \"task-done\" as const,\n\t\ttask,\n\t\tgeneration,\n\t\tat: new Date().toISOString(),\n\t};\n}\n\nexport function isPersistentStopDirective(\n\tinbox: ReturnType<typeof consumePersistentTaskInbox>,\n): boolean {\n\treturn inbox?.type === \"stop\";\n}\n\nfunction findUnsettledPersistentTask(\n\tsessionFile: string,\n\tgeneration: string,\n): string {\n\tconst settledTasks = new Set(\n\t\treadPersistentTaskEvents(sessionFile)\n\t\t\t.filter(\n\t\t\t\t(event) => event.type !== \"notice\" && event.generation === generation,\n\t\t\t)\n\t\t\t.map((event) => event.task),\n\t);\n\treturn (\n\t\treadPersistentDeliveryLedger(sessionFile)\n\t\t\t.filter(\n\t\t\t\t(entry) =>\n\t\t\t\t\tentry.generation === generation &&\n\t\t\t\t\tentry.outcome === \"dispatched\" &&\n\t\t\t\t\t!settledTasks.has(entry.task),\n\t\t\t)\n\t\t\t.at(-1)?.task ?? \"\"\n\t);\n}\n\nexport function parseDeniedTools(rawValue: string | undefined): string[] {\n\treturn (rawValue ?? \"\")\n\t\t.split(\",\")\n\t\t.map((value) => value.trim())\n\t\t.filter(Boolean);\n}\n\n/**\n * A managed worktree child names its own process at load from immutable\n * kernel facts, which Pi's process-title rewrite cannot alter.\n */\nexport function recordProcessIdentity(\n\tid: string | undefined,\n\tsessionFile: string | undefined,\n\tfile = process.env.PI_SUBAGENT_PROCESS_FILE,\n): void {\n\tif (!file || !id || !sessionFile) return;\n\ttry {\n\t\twriteProcessIdentityRecord(file, {\n\t\t\tversion: 1,\n\t\t\tid,\n\t\t\tsessionFile,\n\t\t\t...readOwnProcessIdentity(),\n\t\t});\n\t} catch {\n\t\t// Unrecorded identity leaves a worktree cancel unconfirmed, never guessed.\n\t}\n}\n\nexport type ChildPresentationHook = (\n\tctx: ExtensionContext,\n\tidentity: {\n\t\tsubagentName: string;\n\t\tsubagentAgent: string;\n\t\ttoolNames: string[];\n\t\tdenied: string[];\n\t},\n) => void;\n\nexport function createChildExtension(renderWidget?: ChildPresentationHook) {\n\treturn function subagentChildExtension(pi: ExtensionAPI) {\n\t\tlet toolNames: string[] = [];\n\t\tlet denied: string[] = [];\n\n\t\t// Read subagent identity from env vars (set by parent orchestrator)\n\t\tconst subagentName = process.env.PI_SUBAGENT_NAME ?? \"\";\n\t\tconst subagentAgent = process.env.PI_SUBAGENT_AGENT ?? \"\";\n\t\tconst deniedToolsValue = process.env.PI_DENY_TOOLS;\n\t\tconst autoExit = process.env.PI_SUBAGENT_AUTO_EXIT === \"1\";\n\t\tconst persistent = process.env.PI_SUBAGENT_PERSISTENT === \"1\";\n\t\t// The parent opted this specialist into notices at launch (ADR-0019).\n\t\tconst notify = persistent && process.env.PI_SUBAGENT_NOTIFY === \"1\";\n\t\tconst generation = process.env.PI_SUBAGENT_GENERATION_ID ?? \"\";\n\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\tconst initialTask = process.env.PI_SUBAGENT_TASK_ID ?? \"\";\n\t\tlet currentTask = persistent\n\t\t\t? findUnsettledPersistentTask(sessionFile ?? \"\", generation) ||\n\t\t\t\t(initialTask &&\n\t\t\t\t!readPersistentTaskEvents(sessionFile ?? \"\").some(\n\t\t\t\t\t(event) =>\n\t\t\t\t\t\tevent.type !== \"notice\" &&\n\t\t\t\t\t\tevent.task === initialTask &&\n\t\t\t\t\t\tevent.generation === generation,\n\t\t\t\t)\n\t\t\t\t\t? initialTask\n\t\t\t\t\t: \"\")\n\t\t\t: \"\";\n\t\tconst recorder = createSubagentActivityRecorder({\n\t\t\trunningChildId: process.env.PI_SUBAGENT_ID,\n\t\t\tactivityFile: process.env.PI_SUBAGENT_ACTIVITY_FILE,\n\t\t\tpersistent,\n\t\t});\n\t\trecordProcessIdentity(process.env.PI_SUBAGENT_ID, sessionFile);\n\t\t// The role's declared skills, as this child's own Pi loaded them.\n\t\tregisterDeclaredSkills(pi);\n\n\t\tlet userTookOver = false;\n\t\tlet agentStarted = false;\n\t\tlet latestAgentMessages: any[] | undefined;\n\t\tlet completionFinalized = false;\n\t\tlet sessionContext:\n\t\t\t| Pick<ExtensionContext, \"isIdle\" | \"abort\" | \"shutdown\">\n\t\t\t| undefined;\n\t\t// A child without auto-exit closes only through subagent_done, so one that\n\t\t// forgets it is asked once whether its task is complete.\n\t\tconst doneNudge =\n\t\t\t!autoExit && !persistent\n\t\t\t\t? createDoneNudge({\n\t\t\t\t\t\t// A run that starts between the idle check and delivery queues the\n\t\t\t\t\t\t// question instead of rejecting it.\n\t\t\t\t\t\tsend: (message) =>\n\t\t\t\t\t\t\tpi.sendUserMessage(message, { deliverAs: \"followUp\" }),\n\t\t\t\t\t\tisBusy: () => isChildBusy(pi.events),\n\t\t\t\t\t})\n\t\t\t\t: undefined;\n\n\t\t// Show widget + status bar on session start\n\t\tpi.on(\"session_start\", (_event, ctx) => {\n\t\t\tsessionContext = ctx;\n\t\t\trecorder.sessionStart();\n\t\t\tconst tools = pi.getAllTools();\n\t\t\ttoolNames = tools.map((t) => t.name).sort();\n\t\t\tdenied = parseDeniedTools(deniedToolsValue);\n\n\t\t\trenderWidget?.(ctx, { subagentName, subagentAgent, toolNames, denied });\n\t\t});\n\n\t\tpi.on(\"input\", () => {\n\t\t\trecorder.input();\n\t\t\t// Ignore the initial task message that starts an autonomous subagent.\n\t\t\t// Only inputs after the first agent run has started count as user takeover.\n\t\t\tif (!shouldMarkUserTookOver(agentStarted)) return;\n\t\t\tuserTookOver = true;\n\t\t});\n\n\t\tpi.on(\"before_agent_start\", () => {\n\t\t\trecorder.beforeAgentStart();\n\t\t\tdoneNudge?.runStarting();\n\t\t});\n\n\t\tpi.on(\"agent_start\", () => {\n\t\t\tagentStarted = true;\n\t\t\trecorder.agentStart();\n\t\t});\n\n\t\tpi.on(\"agent_end\", (event) => {\n\t\t\tlatestAgentMessages = event.messages;\n\t\t\trecorder.agentEndWaiting();\n\t\t\tif (autoExit) {\n\t\t\t\t// Reset any recorded manual input marker. Auto-exit is decided by whether\n\t\t\t\t// the latest agent turn completed normally, not by who initiated it.\n\t\t\t\tuserTookOver = false;\n\t\t\t}\n\t\t});\n\n\t\t// The accept check runs at the final actionable boundary, where Pi awaits\n\t\t// the handler and may continue once; agent_settled only notifies.\n\t\tconst acceptSpec =\n\t\t\tautoExit && !persistent\n\t\t\t\t? readAcceptSpecFile(process.env[ACCEPT_FILE_ENV])\n\t\t\t\t: undefined;\n\t\tconst acceptLoop = acceptSpec\n\t\t\t? createChildAcceptLoop({ spec: acceptSpec, cwd: process.cwd() })\n\t\t\t: undefined;\n\t\tif (acceptLoop)\n\t\t\tpi.on(\"agent_before_settle\", async (event, ctx) => {\n\t\t\t\t// A settle that will not exit (undelivered children) checks later.\n\t\t\t\tif (completionFinalized || hasUndeliveredChildren()) return undefined;\n\t\t\t\treturn acceptLoop.beforeSettle(event, ctx.signal);\n\t\t\t});\n\n\t\tpi.on(\"agent_settled\", (event, ctx) => {\n\t\t\tconst runAborted = event?.aborted === true;\n\t\t\tif (doneNudge && !completionFinalized) {\n\t\t\t\tdoneNudge.settled(latestAgentMessages, runAborted, ctx);\n\t\t\t}\n\t\t\tif (persistent && !completionFinalized) {\n\t\t\t\tlet messages = latestAgentMessages;\n\t\t\t\ttry {\n\t\t\t\t\tconst branchMessages = ctx.sessionManager\n\t\t\t\t\t\t.getBranch()\n\t\t\t\t\t\t.flatMap((entry) =>\n\t\t\t\t\t\t\tentry.type === \"message\" ? [entry.message] : [],\n\t\t\t\t\t\t);\n\t\t\t\t\tif (branchMessages.length > 0) messages = branchMessages;\n\t\t\t\t} catch {\n\t\t\t\t\t// Fall back to the latest low-level run when session evidence is unavailable.\n\t\t\t\t}\n\t\t\t\tif (\n\t\t\t\t\tcurrentTask &&\n\t\t\t\t\tshouldAutoExitOnAgentEnd(userTookOver, messages, runAborted)\n\t\t\t\t) {\n\t\t\t\t\tappendPersistentTaskEvent(\n\t\t\t\t\t\tprocess.env.PI_SUBAGENT_SESSION ?? \"\",\n\t\t\t\t\t\tbuildPersistentTaskEvent(currentTask, generation),\n\t\t\t\t\t);\n\t\t\t\t\tcurrentTask = \"\";\n\t\t\t\t\trecorder.agentEndWaiting();\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!autoExit || completionFinalized) return;\n\n\t\t\tlet messages = latestAgentMessages;\n\t\t\ttry {\n\t\t\t\tconst branchMessages = ctx.sessionManager\n\t\t\t\t\t.getBranch()\n\t\t\t\t\t.flatMap((entry) =>\n\t\t\t\t\t\tentry.type === \"message\" ? [entry.message] : [],\n\t\t\t\t\t);\n\t\t\t\tif (branchMessages.length > 0) messages = branchMessages;\n\t\t\t} catch {\n\t\t\t\t// Fall back to the latest low-level run when session evidence is unavailable.\n\t\t\t}\n\n\t\t\tif (!shouldAutoExitOnAgentEnd(userTookOver, messages, runAborted)) return;\n\t\t\t// Children this session launched deliver their results as steers. Exiting\n\t\t\t// now would drop them, so wait: the last delivery starts a new turn, and\n\t\t\t// its settlement reaches this point again. A settled error still exits so\n\t\t\t// the parent learns of it promptly.\n\t\t\tif (\n\t\t\t\tfindLatestAssistantError(messages) === null &&\n\t\t\t\thasUndeliveredChildren()\n\t\t\t)\n\t\t\t\treturn;\n\t\t\tcompletionFinalized = true;\n\n\t\t\t// Surface a settled stopReason: \"error\" to the parent via the .exit\n\t\t\t// sidecar. Transient errors followed by retry or compaction never reach\n\t\t\t// this point as the latest assistant message.\n\t\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\t\tif (sessionFile) {\n\t\t\t\ttry {\n\t\t\t\t\twriteFileSync(\n\t\t\t\t\t\t`${sessionFile}.exit`,\n\t\t\t\t\t\tJSON.stringify(\n\t\t\t\t\t\t\tbuildCompletionSidecar(messages, acceptLoop?.report()),\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\t// Best effort — the watcher can still detect the terminal sentinel\n\t\t\t\t\t// after shutdown if the completion sidecar cannot be written.\n\t\t\t\t}\n\t\t\t}\n\n\t\t\trecorder.agentEndDone();\n\t\t\tctx.shutdown();\n\t\t});\n\n\t\tpi.on(\"turn_start\", (event) => {\n\t\t\trecorder.turnStart(event.turnIndex);\n\t\t});\n\n\t\tpi.on(\"turn_end\", (event) => {\n\t\t\trecorder.turnEnd(event.turnIndex);\n\t\t});\n\n\t\tpi.on(\"before_provider_request\", () => {\n\t\t\trecorder.beforeProviderRequest();\n\t\t});\n\n\t\tpi.on(\"after_provider_response\", () => {\n\t\t\trecorder.afterProviderResponse();\n\t\t});\n\n\t\tpi.on(\"message_update\", (event) => {\n\t\t\trecorder.messageUpdate(event.assistantMessageEvent?.type);\n\t\t});\n\n\t\tpi.on(\"tool_execution_start\", (event) => {\n\t\t\trecorder.toolExecutionStart(event.toolCallId, event.toolName);\n\t\t});\n\n\t\tpi.on(\"tool_call\", (event) => {\n\t\t\trecorder.toolCall(event.toolCallId, event.toolName);\n\t\t});\n\n\t\tpi.on(\"tool_execution_update\", (event) => {\n\t\t\trecorder.toolExecutionUpdate(event.toolCallId, event.toolName);\n\t\t});\n\n\t\tpi.on(\"tool_result\", (event) => {\n\t\t\trecorder.toolResult(event.toolCallId, event.toolName);\n\t\t});\n\n\t\tpi.on(\"tool_execution_end\", (event) => {\n\t\t\trecorder.toolExecutionEnd(event.toolCallId, event.toolName);\n\t\t});\n\n\t\tpi.on(\"session_shutdown\", async (event) => {\n\t\t\tif (inboxPoller) clearInterval(inboxPoller);\n\t\t\tdoneNudge?.cancel();\n\t\t\trecorder.sessionShutdown(event.reason);\n\t\t\t// A check still running belongs to this session: stop it, bounded.\n\t\t\tawait acceptLoop?.shutdown();\n\t\t});\n\n\t\tpi.registerTool({\n\t\t\tname: \"caller_ping\",\n\t\t\tlabel: \"Caller Ping\",\n\t\t\tdescription:\n\t\t\t\t\"Send a help request to the parent agent and exit this session. \" +\n\t\t\t\t\"The parent will be notified with your message and can resume this session with a response. \" +\n\t\t\t\t\"Use when you're stuck, need clarification, or need the parent to take action.\",\n\t\t\tparameters: Type.Object({\n\t\t\t\tmessage: Type.String({ description: \"What you need help with\" }),\n\t\t\t}),\n\t\t\tasync execute(_toolCallId, params, _signal, _onUpdate, ctx) {\n\t\t\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\t\t\tif (!sessionFile) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\"caller_ping is only available in subagent contexts. \" +\n\t\t\t\t\t\t\t\"PI_SUBAGENT_SESSION environment variable is not set.\",\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// The parent ignores a help request for no task; an opted-in\n\t\t\t\t// specialist has a tool that reaches it.\n\t\t\t\tif (notify && !currentTask)\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\"caller_ping has no current task to ask about, so the parent would ignore it. \" +\n\t\t\t\t\t\t\t\"Use caller_notify to tell the parent something changed.\",\n\t\t\t\t\t);\n\t\t\t\trecorder.callerPing();\n\t\t\t\tif (persistent) {\n\t\t\t\t\tappendPersistentTaskEvent(sessionFile, {\n\t\t\t\t\t\ttype: \"help-request\",\n\t\t\t\t\t\ttask: currentTask,\n\t\t\t\t\t\tgeneration,\n\t\t\t\t\t\tmessage: params.message,\n\t\t\t\t\t});\n\t\t\t\t\tcurrentTask = \"\";\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\ttext: \"Help request sent. Stay available for subagent_send.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst exitData = {\n\t\t\t\t\ttype: \"ping\" as const,\n\t\t\t\t\tname: process.env.PI_SUBAGENT_NAME ?? \"subagent\",\n\t\t\t\t\tmessage: params.message,\n\t\t\t\t};\n\t\t\t\twriteFileSync(`${sessionFile}.exit`, JSON.stringify(exitData));\n\t\t\t\tcompletionFinalized = true;\n\n\t\t\t\tctx.shutdown();\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: \"Ping sent. Session will exit and parent will be notified.\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\n\t\tif (notify)\n\t\t\tpi.registerTool({\n\t\t\t\tname: \"caller_notify\",\n\t\t\t\tlabel: \"Caller Notify\",\n\t\t\t\tdescription:\n\t\t\t\t\t\"Wake the parent agent with a short notice that something changed, without ending or completing any task. \" +\n\t\t\t\t\t`Only for a persistent specialist whose parent opted in; at most ${NOTICE_CAP} notices, at least ${NOTICE_CHILD_INTERVAL_MS / 1_000} seconds apart. ` +\n\t\t\t\t\t\"Send one only when something the parent cares about changed, never to say that nothing changed.\",\n\t\t\t\tparameters: Type.Object({\n\t\t\t\t\tmessage: Type.String({\n\t\t\t\t\t\tdescription: \"What changed, in a sentence or two\",\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t\tasync execute(_toolCallId, params) {\n\t\t\t\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\t\t\t\tif (!sessionFile)\n\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t\"caller_notify is only available in persistent subagent contexts. \" +\n\t\t\t\t\t\t\t\t\"PI_SUBAGENT_SESSION environment variable is not set.\",\n\t\t\t\t\t\t);\n\t\t\t\t\t// Counted from the event file, so a child /reload keeps its place.\n\t\t\t\t\tconst sent = readPersistentTaskEvents(sessionFile).filter(\n\t\t\t\t\t\t(event) =>\n\t\t\t\t\t\t\tevent.type === \"notice\" && event.generation === generation,\n\t\t\t\t\t);\n\t\t\t\t\tconst last = sent.at(-1);\n\t\t\t\t\tconst refusal = childNoticeRefusal(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsent: sent.length,\n\t\t\t\t\t\t\tlastAt: last ? Date.parse(last.at) : undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tDate.now(),\n\t\t\t\t\t);\n\t\t\t\t\tif (refusal) throw new Error(refusal);\n\t\t\t\t\tconst sequence = sent.length + 1;\n\t\t\t\t\t// No activity change: a notice neither starts nor ends a task.\n\t\t\t\t\tappendPersistentTaskEvent(sessionFile, {\n\t\t\t\t\t\ttype: \"notice\",\n\t\t\t\t\t\ttask: \"\",\n\t\t\t\t\t\tgeneration,\n\t\t\t\t\t\tmessage: params.message,\n\t\t\t\t\t\tsequence,\n\t\t\t\t\t});\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\ttext:\n\t\t\t\t\t\t\t\t\t`Notice ${sequence} of ${NOTICE_CAP} sent. ` +\n\t\t\t\t\t\t\t\t\t\"It does not end or complete any task; continue your current work or stay available for subagent_send.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t});\n\n\t\tlet inboxPoller: ReturnType<typeof setInterval> | undefined;\n\t\tif (persistent) {\n\t\t\tinboxPoller = setInterval(() => {\n\t\t\t\ttry {\n\t\t\t\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\t\t\t\tif (!sessionFile || currentTask) return;\n\t\t\t\t\tconst inbox = consumePersistentTaskInbox(sessionFile);\n\t\t\t\t\tif (!inbox) return;\n\t\t\t\t\tif (isPersistentStopDirective(inbox)) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\twriteFileSync(\n\t\t\t\t\t\t\t\t`${sessionFile}.exit`,\n\t\t\t\t\t\t\t\tJSON.stringify({ type: \"done\" }),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// The parent can still confirm the shell exit marker.\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcompletionFinalized = true;\n\t\t\t\t\t\trecorder.subagentDone();\n\t\t\t\t\t\t// The run that asked for help belongs to no task, and shutdown waits for idle.\n\t\t\t\t\t\tif (sessionContext && !sessionContext.isIdle())\n\t\t\t\t\t\t\tsessionContext.abort();\n\t\t\t\t\t\tsessionContext?.shutdown();\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tcurrentTask = inbox.task;\n\t\t\t\t\trecorder.taskStart();\n\t\t\t\t\t// After caller_ping the run that asked for help may still be streaming.\n\t\t\t\t\tpi.sendUserMessage(inbox.message, { deliverAs: \"followUp\" });\n\t\t\t\t} catch {\n\t\t\t\t\t// A malformed or transiently unavailable inbox must not kill the poller.\n\t\t\t\t}\n\t\t\t}, 1000);\n\t\t}\n\n\t\tif (autoExit) return;\n\n\t\tpi.registerTool({\n\t\t\tname: \"subagent_done\",\n\t\t\tlabel: \"Subagent Done\",\n\t\t\tdescription:\n\t\t\t\t\"Call this tool when you have completed your task. \" +\n\t\t\t\t\"It will close this session and return your results to the main session. \" +\n\t\t\t\t\"Your LAST assistant message before calling this becomes the summary returned to the caller.\",\n\t\t\tparameters: Type.Object({}),\n\t\t\tasync execute(_toolCallId, _params, _signal, _onUpdate, ctx) {\n\t\t\t\tconst sessionFile = process.env.PI_SUBAGENT_SESSION;\n\t\t\t\trecorder.subagentDone();\n\t\t\t\tif (persistent) {\n\t\t\t\t\tif (!sessionFile || !currentTask) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\t\ttext: \"No current task. Staying available for subagent_send.\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\tappendPersistentTaskEvent(\n\t\t\t\t\t\tsessionFile,\n\t\t\t\t\t\tbuildPersistentTaskEvent(currentTask, generation),\n\t\t\t\t\t);\n\t\t\t\t\tcurrentTask = \"\";\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\ttext: \"Task complete. Staying available for subagent_send.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tdetails: {},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tif (sessionFile) {\n\t\t\t\t\twriteFileSync(\n\t\t\t\t\t\t`${sessionFile}.exit`,\n\t\t\t\t\t\tJSON.stringify({ type: \"done\" }),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcompletionFinalized = true;\n\t\t\t\tctx.shutdown();\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Shutting down subagent session.\" }],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t},\n\t\t});\n\t};\n}\n\nexport default createChildExtension();\n"]}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { NativeExecutionInspection } from "../../core/surface-provider.ts";
|
|
2
|
+
import { type ChildAcceptReport } from "../../core/accept.ts";
|
|
3
|
+
/**
|
|
4
|
+
* Where a persistent child's launch line records Pi's exit code once Pi has
|
|
5
|
+
* exited. Unlike the on-screen marker, a shell prompt cannot scroll it away.
|
|
6
|
+
*/
|
|
7
|
+
export declare function shellExitFileFor(sessionFile: string): string;
|
|
8
|
+
export interface CompletionResult {
|
|
9
|
+
reason: "done" | "ping" | "sentinel" | "error";
|
|
10
|
+
exitCode: number;
|
|
11
|
+
ping?: {
|
|
12
|
+
name: string;
|
|
13
|
+
message: string;
|
|
14
|
+
};
|
|
15
|
+
errorMessage?: string;
|
|
16
|
+
/** Who wrote errorMessage: the child's sidecar, or the host's own diagnostic. */
|
|
17
|
+
errorSource?: "child" | "host";
|
|
18
|
+
/** The child's own accept-check report; evidence, never the verdict. */
|
|
19
|
+
accept?: ChildAcceptReport;
|
|
20
|
+
}
|
|
21
|
+
export interface CompletionOptions {
|
|
22
|
+
/** Native lifetime evidence is independent of OSC agent/task status. */
|
|
23
|
+
inspectExecution?: () => Promise<NativeExecutionInspection>;
|
|
24
|
+
intervalMs: number;
|
|
25
|
+
readTerminalTail: () => Promise<string>;
|
|
26
|
+
inspectPane?: () => Promise<import("../../core/types.ts").PaneInspection>;
|
|
27
|
+
/** Bounded artifact grace after explicit pane disappearance. Default: 500ms. */
|
|
28
|
+
paneDisappearanceGraceMs?: number;
|
|
29
|
+
onPaneInspection?: (inspection: import("../../core/types.ts").PaneInspection, observedAt: number) => void;
|
|
30
|
+
sessionFile?: string;
|
|
31
|
+
/** Persistent lifetime ownership cannot end on a pre-shutdown sidecar. */
|
|
32
|
+
requireProcessExit?: boolean;
|
|
33
|
+
/** Only launch-verified process identity, never transcript or activity state. */
|
|
34
|
+
inspectProcess?: () => "alive" | "exited" | "unknown";
|
|
35
|
+
/** The launch line's post-exit record ({@link shellExitFileFor}); admitted unless the identity is alive. */
|
|
36
|
+
shellExitFile?: string;
|
|
37
|
+
onTick?: (elapsedSeconds: number) => void;
|
|
38
|
+
/** Wait for a local file wake-up or a scheduled reconciliation. */
|
|
39
|
+
waitForNextCheck?: (signal: AbortSignal) => Promise<"wake" | "reconcile">;
|
|
40
|
+
/** Drain local task evidence before any terminal fallback. */
|
|
41
|
+
onLocalEvidence?: () => void;
|
|
42
|
+
}
|
|
43
|
+
export declare function interpretExitSidecar(payload: any): CompletionResult;
|
|
44
|
+
export declare function waitForCompletion(signal: AbortSignal, options: CompletionOptions): Promise<CompletionResult>;
|
|
45
|
+
//# sourceMappingURL=completion.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../../maestro/adapters/pi/completion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAIhF,OAAO,EAEN,KAAK,iBAAiB,EACtB,MAAM,sBAAsB,CAAC;AAK9B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAWD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,wEAAwE;IACxE,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IACjC,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,qBAAqB,EAAE,cAAc,CAAC,CAAC;IAC1E,gFAAgF;IAChF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,CAClB,UAAU,EAAE,OAAO,qBAAqB,EAAE,cAAc,EACxD,UAAU,EAAE,MAAM,KACd,IAAI,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IAC1E,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB,CA2CnE;AA2ED,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAmB3B"}
|