@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,173 @@
|
|
|
1
|
+
import { markInterruptRequested } from "../../maestro/core/lifecycle.js";
|
|
2
|
+
import { encodeHostValue, HOST_ERROR_CHARS, jsonArgument, } from "../../maestro/core/host-text.js";
|
|
3
|
+
export const SUBAGENT_CANCEL_DESCRIPTION = "Cancel a running non-persistent subagent, including an interrupted one. " +
|
|
4
|
+
"The host stops its process and delivers exactly one cancelled result, with no model fallback, retry, or recovery. Do not poll for it. " +
|
|
5
|
+
"A legacy pane closes; Core confirms exit and removes its terminal record after delivery. " +
|
|
6
|
+
"A worktree child keeps the workspace, checkout, commits, and manifest. " +
|
|
7
|
+
"Returns confirmed, requested (launch still in flight), unconfirmed (still running; call again), or already-terminal. " +
|
|
8
|
+
"Persistent specialists are rejected; use subagent_stop.";
|
|
9
|
+
export const SUBAGENT_CANCEL_SNIPPET = "Cancel a running non-persistent subagent; one cancelled result arrives later";
|
|
10
|
+
function cancelStatusText(displayName, report, worktree) {
|
|
11
|
+
const name = encodeHostValue(displayName);
|
|
12
|
+
const noRetry = "No model fallback, retry, or recovery will start.";
|
|
13
|
+
switch (report.status) {
|
|
14
|
+
case "confirmed":
|
|
15
|
+
return worktree
|
|
16
|
+
? `Cancelled subagent "${name}": its Pi process exit is confirmed; the worktree workspace, checkout, commits, and manifest are retained. ${noRetry} One cancelled result will be delivered automatically.`
|
|
17
|
+
: `Cancelled subagent "${name}": its owned process exit is confirmed. ${noRetry} One cancelled result will be delivered automatically.`;
|
|
18
|
+
case "requested":
|
|
19
|
+
return `Cancel recorded for subagent "${name}"; its in-flight launch is terminated as soon as it is acquired. ${noRetry} One cancelled result will be delivered after termination is confirmed.`;
|
|
20
|
+
case "unconfirmed":
|
|
21
|
+
return `Cancel recorded for subagent "${name}", but termination is unconfirmed: ${encodeHostValue(report.error ?? "unknown error", HOST_ERROR_CHARS)}. The run stays live and owned. ${noRetry} Call subagent_cancel again to retry termination.`;
|
|
22
|
+
case "already-terminal":
|
|
23
|
+
return `Subagent "${name}" already reached a terminal result; nothing was cancelled.`;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/** Interrupt and cancel controls bound to one extension instance. */
|
|
27
|
+
export function createControls({ runtime, updateWidget, observeRunningSubagent, }) {
|
|
28
|
+
const runningSubagents = runtime.runningSubagents;
|
|
29
|
+
function resolveInterruptTarget(params) {
|
|
30
|
+
const requestedId = params.id?.trim();
|
|
31
|
+
if (requestedId) {
|
|
32
|
+
const running = runningSubagents.get(requestedId);
|
|
33
|
+
return running
|
|
34
|
+
? { running }
|
|
35
|
+
: {
|
|
36
|
+
error: `No running subagent with id "${encodeHostValue(requestedId)}".`,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
const requestedName = params.name?.trim();
|
|
40
|
+
if (!requestedName) {
|
|
41
|
+
return { error: "Provide a running subagent id or exact display name." };
|
|
42
|
+
}
|
|
43
|
+
const matches = Array.from(runningSubagents.values()).filter((running) => running.name === requestedName);
|
|
44
|
+
if (matches.length === 1)
|
|
45
|
+
return { running: matches[0] };
|
|
46
|
+
if (matches.length === 0) {
|
|
47
|
+
return {
|
|
48
|
+
error: `No running subagent named "${encodeHostValue(requestedName)}".`,
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
const candidates = matches
|
|
52
|
+
.map((running) => `${encodeHostValue(running.name)} [${encodeHostValue(running.id)}]`)
|
|
53
|
+
.join(", ");
|
|
54
|
+
return {
|
|
55
|
+
error: `Ambiguous subagent name "${encodeHostValue(requestedName)}". Matches: ${candidates}`,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
async function requestSubagentInterrupt(running, interruptPaneKey = () => runtime.session.interrupt(runtime.session.getControlTaskId(running.id))) {
|
|
59
|
+
try {
|
|
60
|
+
await interruptPaneKey(running.surface);
|
|
61
|
+
return { ok: true };
|
|
62
|
+
}
|
|
63
|
+
catch (error) {
|
|
64
|
+
return {
|
|
65
|
+
error: `Failed to send Escape to subagent "${encodeHostValue(running.name)}" via herdr: ` +
|
|
66
|
+
encodeHostValue(error?.message ?? String(error), HOST_ERROR_CHARS),
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
async function handleSubagentInterrupt(params, interruptPaneKey) {
|
|
71
|
+
const resolved = resolveInterruptTarget(params);
|
|
72
|
+
if ("error" in resolved) {
|
|
73
|
+
return {
|
|
74
|
+
content: [{ type: "text", text: resolved.error }],
|
|
75
|
+
details: { error: resolved.error },
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
const running = resolved.running;
|
|
79
|
+
const now = Date.now();
|
|
80
|
+
observeRunningSubagent(running, now);
|
|
81
|
+
const interruption = await requestSubagentInterrupt(running, interruptPaneKey);
|
|
82
|
+
if ("error" in interruption) {
|
|
83
|
+
return {
|
|
84
|
+
content: [{ type: "text", text: interruption.error }],
|
|
85
|
+
details: {
|
|
86
|
+
error: interruption.error,
|
|
87
|
+
id: running.id,
|
|
88
|
+
name: running.name,
|
|
89
|
+
},
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
running.lifecycle = markInterruptRequested(running.lifecycle, now);
|
|
93
|
+
updateWidget();
|
|
94
|
+
return {
|
|
95
|
+
content: [
|
|
96
|
+
{
|
|
97
|
+
type: "text",
|
|
98
|
+
text: `Interrupt requested for subagent "${encodeHostValue(running.name)}".`,
|
|
99
|
+
},
|
|
100
|
+
],
|
|
101
|
+
details: {
|
|
102
|
+
id: running.id,
|
|
103
|
+
name: running.name,
|
|
104
|
+
status: "interrupt_requested",
|
|
105
|
+
},
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
async function handleSubagentCancel(params, session = runtime.session) {
|
|
109
|
+
const fail = (error, extra = {}) => ({
|
|
110
|
+
content: [{ type: "text", text: error }],
|
|
111
|
+
details: { error, ...extra },
|
|
112
|
+
});
|
|
113
|
+
const resolved = resolveInterruptTarget(params);
|
|
114
|
+
if ("error" in resolved) {
|
|
115
|
+
// No live row: a retired run keeps only its consumed control ID, and a run
|
|
116
|
+
// still in its initial launch has no row yet. Report the kernel's answer.
|
|
117
|
+
const id = params.id?.trim();
|
|
118
|
+
const report = id
|
|
119
|
+
? await session.cancel(id).catch(() => undefined)
|
|
120
|
+
: undefined;
|
|
121
|
+
if (!id || !report)
|
|
122
|
+
return fail(resolved.error);
|
|
123
|
+
updateWidget();
|
|
124
|
+
return {
|
|
125
|
+
content: [
|
|
126
|
+
{ type: "text", text: cancelStatusText(id, report, false) },
|
|
127
|
+
],
|
|
128
|
+
details: { id, status: report.status },
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
const running = resolved.running;
|
|
132
|
+
const target = { id: running.id, name: running.name };
|
|
133
|
+
const shownName = encodeHostValue(running.name);
|
|
134
|
+
if (running.persistent)
|
|
135
|
+
return fail(`Subagent "${shownName}" is a persistent specialist; subagent_cancel does not stop it. Use subagent_stop({ id: ${jsonArgument(running.id)} }) for the graceful v1 stop.`, target);
|
|
136
|
+
const control = session.getControlTaskId(running.id);
|
|
137
|
+
if (!control)
|
|
138
|
+
return fail(`Subagent "${shownName}" has no live owner in this session; nothing was cancelled.`, target);
|
|
139
|
+
let report;
|
|
140
|
+
try {
|
|
141
|
+
report = await session.cancel(control);
|
|
142
|
+
}
|
|
143
|
+
catch (error) {
|
|
144
|
+
return fail(encodeHostValue(error instanceof Error ? error.message : String(error), HOST_ERROR_CHARS), target);
|
|
145
|
+
}
|
|
146
|
+
finally {
|
|
147
|
+
updateWidget();
|
|
148
|
+
}
|
|
149
|
+
const details = { ...target, status: report.status };
|
|
150
|
+
if (report.requestedAt !== undefined)
|
|
151
|
+
details.requestedAt = report.requestedAt;
|
|
152
|
+
if (report.error)
|
|
153
|
+
details.error = report.error;
|
|
154
|
+
if (report.repeated)
|
|
155
|
+
details.repeated = true;
|
|
156
|
+
return {
|
|
157
|
+
content: [
|
|
158
|
+
{
|
|
159
|
+
type: "text",
|
|
160
|
+
text: cancelStatusText(running.name, report, !!running.worktree),
|
|
161
|
+
},
|
|
162
|
+
],
|
|
163
|
+
details,
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
return {
|
|
167
|
+
resolveInterruptTarget,
|
|
168
|
+
requestSubagentInterrupt,
|
|
169
|
+
handleSubagentInterrupt,
|
|
170
|
+
handleSubagentCancel,
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
//# sourceMappingURL=controls.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"controls.js","sourceRoot":"","sources":["../../../pi-extension/subagents/controls.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolResult } from \"@earendil-works/pi-coding-agent\";\nimport type {\n\tPiRunSession,\n\tCancelReport,\n} from \"../../maestro/runtime/index.ts\";\nimport { markInterruptRequested } from \"../../maestro/core/lifecycle.ts\";\nimport type { RunningSubagent, SubagentRuntime } from \"./state.ts\";\nimport type { Observation } from \"./observation.ts\";\nimport {\n\tencodeHostValue,\n\tHOST_ERROR_CHARS,\n\tjsonArgument,\n} from \"../../maestro/core/host-text.ts\";\n\nexport interface SubagentInterruptDetails {\n\terror?: string;\n\tid?: string;\n\tname?: string;\n\tstatus?: \"interrupt_requested\";\n}\n\nexport const SUBAGENT_CANCEL_DESCRIPTION =\n\t\"Cancel a running non-persistent subagent, including an interrupted one. \" +\n\t\"The host stops its process and delivers exactly one cancelled result, with no model fallback, retry, or recovery. Do not poll for it. \" +\n\t\"A legacy pane closes; Core confirms exit and removes its terminal record after delivery. \" +\n\t\"A worktree child keeps the workspace, checkout, commits, and manifest. \" +\n\t\"Returns confirmed, requested (launch still in flight), unconfirmed (still running; call again), or already-terminal. \" +\n\t\"Persistent specialists are rejected; use subagent_stop.\";\n\nexport const SUBAGENT_CANCEL_SNIPPET =\n\t\"Cancel a running non-persistent subagent; one cancelled result arrives later\";\n\nexport interface SubagentCancelDetails {\n\terror?: string;\n\tid?: string;\n\tname?: string;\n\tstatus?: CancelReport[\"status\"];\n\trequestedAt?: number;\n\trepeated?: boolean;\n}\n\nfunction cancelStatusText(\n\tdisplayName: string,\n\treport: CancelReport,\n\tworktree: boolean,\n): string {\n\tconst name = encodeHostValue(displayName);\n\tconst noRetry = \"No model fallback, retry, or recovery will start.\";\n\tswitch (report.status) {\n\t\tcase \"confirmed\":\n\t\t\treturn worktree\n\t\t\t\t? `Cancelled subagent \"${name}\": its Pi process exit is confirmed; the worktree workspace, checkout, commits, and manifest are retained. ${noRetry} One cancelled result will be delivered automatically.`\n\t\t\t\t: `Cancelled subagent \"${name}\": its owned process exit is confirmed. ${noRetry} One cancelled result will be delivered automatically.`;\n\t\tcase \"requested\":\n\t\t\treturn `Cancel recorded for subagent \"${name}\"; its in-flight launch is terminated as soon as it is acquired. ${noRetry} One cancelled result will be delivered after termination is confirmed.`;\n\t\tcase \"unconfirmed\":\n\t\t\treturn `Cancel recorded for subagent \"${name}\", but termination is unconfirmed: ${encodeHostValue(report.error ?? \"unknown error\", HOST_ERROR_CHARS)}. The run stays live and owned. ${noRetry} Call subagent_cancel again to retry termination.`;\n\t\tcase \"already-terminal\":\n\t\t\treturn `Subagent \"${name}\" already reached a terminal result; nothing was cancelled.`;\n\t}\n}\n\ninterface ControlDeps {\n\truntime: SubagentRuntime;\n\tupdateWidget: () => void;\n\tobserveRunningSubagent: Observation[\"observeRunningSubagent\"];\n}\n\nexport type Controls = ReturnType<typeof createControls>;\n\n/** Interrupt and cancel controls bound to one extension instance. */\nexport function createControls({\n\truntime,\n\tupdateWidget,\n\tobserveRunningSubagent,\n}: ControlDeps) {\n\tconst runningSubagents = runtime.runningSubagents;\n\n\tfunction resolveInterruptTarget(params: {\n\t\tid?: string;\n\t\tname?: string;\n\t}): { running: RunningSubagent } | { error: string } {\n\t\tconst requestedId = params.id?.trim();\n\t\tif (requestedId) {\n\t\t\tconst running = runningSubagents.get(requestedId);\n\t\t\treturn running\n\t\t\t\t? { running }\n\t\t\t\t: {\n\t\t\t\t\t\terror: `No running subagent with id \"${encodeHostValue(requestedId)}\".`,\n\t\t\t\t\t};\n\t\t}\n\n\t\tconst requestedName = params.name?.trim();\n\t\tif (!requestedName) {\n\t\t\treturn { error: \"Provide a running subagent id or exact display name.\" };\n\t\t}\n\n\t\tconst matches = Array.from(runningSubagents.values()).filter(\n\t\t\t(running) => running.name === requestedName,\n\t\t);\n\t\tif (matches.length === 1) return { running: matches[0] };\n\t\tif (matches.length === 0) {\n\t\t\treturn {\n\t\t\t\terror: `No running subagent named \"${encodeHostValue(requestedName)}\".`,\n\t\t\t};\n\t\t}\n\n\t\tconst candidates = matches\n\t\t\t.map(\n\t\t\t\t(running) =>\n\t\t\t\t\t`${encodeHostValue(running.name)} [${encodeHostValue(running.id)}]`,\n\t\t\t)\n\t\t\t.join(\", \");\n\t\treturn {\n\t\t\terror: `Ambiguous subagent name \"${encodeHostValue(requestedName)}\". Matches: ${candidates}`,\n\t\t};\n\t}\n\n\tasync function requestSubagentInterrupt(\n\t\trunning: RunningSubagent,\n\t\tinterruptPaneKey: (surface: string) => void | Promise<void> = () =>\n\t\t\truntime.session!.interrupt(\n\t\t\t\truntime.session!.getControlTaskId(running.id)!,\n\t\t\t),\n\t): Promise<{ ok: true } | { error: string }> {\n\t\ttry {\n\t\t\tawait interruptPaneKey(running.surface);\n\t\t\treturn { ok: true };\n\t\t} catch (error: any) {\n\t\t\treturn {\n\t\t\t\terror:\n\t\t\t\t\t`Failed to send Escape to subagent \"${encodeHostValue(running.name)}\" via herdr: ` +\n\t\t\t\t\tencodeHostValue(error?.message ?? String(error), HOST_ERROR_CHARS),\n\t\t\t};\n\t\t}\n\t}\n\n\tasync function handleSubagentInterrupt(\n\t\tparams: { id?: string; name?: string },\n\t\tinterruptPaneKey?: (surface: string) => void | Promise<void>,\n\t): Promise<AgentToolResult<SubagentInterruptDetails>> {\n\t\tconst resolved = resolveInterruptTarget(params);\n\t\tif (\"error\" in resolved) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\" as const, text: resolved.error }],\n\t\t\t\tdetails: { error: resolved.error },\n\t\t\t};\n\t\t}\n\n\t\tconst running = resolved.running;\n\t\tconst now = Date.now();\n\t\tobserveRunningSubagent(running, now);\n\n\t\tconst interruption = await requestSubagentInterrupt(\n\t\t\trunning,\n\t\t\tinterruptPaneKey,\n\t\t);\n\t\tif (\"error\" in interruption) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\" as const, text: interruption.error }],\n\t\t\t\tdetails: {\n\t\t\t\t\terror: interruption.error,\n\t\t\t\t\tid: running.id,\n\t\t\t\t\tname: running.name,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\trunning.lifecycle = markInterruptRequested(running.lifecycle, now);\n\t\tupdateWidget();\n\n\t\treturn {\n\t\t\tcontent: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\ttext: `Interrupt requested for subagent \"${encodeHostValue(running.name)}\".`,\n\t\t\t\t},\n\t\t\t],\n\t\t\tdetails: {\n\t\t\t\tid: running.id,\n\t\t\t\tname: running.name,\n\t\t\t\tstatus: \"interrupt_requested\",\n\t\t\t},\n\t\t};\n\t}\n\n\tasync function handleSubagentCancel(\n\t\tparams: { id?: string; name?: string },\n\t\tsession: Pick<\n\t\t\tPiRunSession,\n\t\t\t\"cancel\" | \"getControlTaskId\"\n\t\t> = runtime.session!,\n\t): Promise<AgentToolResult<SubagentCancelDetails>> {\n\t\tconst fail = (error: string, extra: SubagentCancelDetails = {}) => ({\n\t\t\tcontent: [{ type: \"text\" as const, text: error }],\n\t\t\tdetails: { error, ...extra },\n\t\t});\n\t\tconst resolved = resolveInterruptTarget(params);\n\t\tif (\"error\" in resolved) {\n\t\t\t// No live row: a retired run keeps only its consumed control ID, and a run\n\t\t\t// still in its initial launch has no row yet. Report the kernel's answer.\n\t\t\tconst id = params.id?.trim();\n\t\t\tconst report = id\n\t\t\t\t? await session.cancel(id).catch(() => undefined)\n\t\t\t\t: undefined;\n\t\t\tif (!id || !report) return fail(resolved.error);\n\t\t\tupdateWidget();\n\t\t\treturn {\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: \"text\" as const, text: cancelStatusText(id, report, false) },\n\t\t\t\t],\n\t\t\t\tdetails: { id, status: report.status },\n\t\t\t};\n\t\t}\n\t\tconst running = resolved.running;\n\t\tconst target = { id: running.id, name: running.name };\n\t\tconst shownName = encodeHostValue(running.name);\n\t\tif (running.persistent)\n\t\t\treturn fail(\n\t\t\t\t`Subagent \"${shownName}\" is a persistent specialist; subagent_cancel does not stop it. Use subagent_stop({ id: ${jsonArgument(running.id)} }) for the graceful v1 stop.`,\n\t\t\t\ttarget,\n\t\t\t);\n\t\tconst control = session.getControlTaskId(running.id);\n\t\tif (!control)\n\t\t\treturn fail(\n\t\t\t\t`Subagent \"${shownName}\" has no live owner in this session; nothing was cancelled.`,\n\t\t\t\ttarget,\n\t\t\t);\n\t\tlet report: CancelReport;\n\t\ttry {\n\t\t\treport = await session.cancel(control);\n\t\t} catch (error) {\n\t\t\treturn fail(\n\t\t\t\tencodeHostValue(\n\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\tHOST_ERROR_CHARS,\n\t\t\t\t),\n\t\t\t\ttarget,\n\t\t\t);\n\t\t} finally {\n\t\t\tupdateWidget();\n\t\t}\n\t\tconst details: SubagentCancelDetails = { ...target, status: report.status };\n\t\tif (report.requestedAt !== undefined)\n\t\t\tdetails.requestedAt = report.requestedAt;\n\t\tif (report.error) details.error = report.error;\n\t\tif (report.repeated) details.repeated = true;\n\t\treturn {\n\t\t\tcontent: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\ttext: cancelStatusText(running.name, report, !!running.worktree),\n\t\t\t\t},\n\t\t\t],\n\t\t\tdetails,\n\t\t};\n\t}\n\n\treturn {\n\t\tresolveInterruptTarget,\n\t\trequestSubagentInterrupt,\n\t\thandleSubagentInterrupt,\n\t\thandleSubagentCancel,\n\t};\n}\n"]}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { ExtensionAPI, ToolInfo } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
/**
|
|
3
|
+
* Routine host tools register with this exposure. Pi keeps their schemas and
|
|
4
|
+
* prompt guidelines out of requests until its built-in `tool_search` loads them.
|
|
5
|
+
*/
|
|
6
|
+
export declare const ROUTINE_TOOL_EXPOSURE: "deferred";
|
|
7
|
+
/** The tool metadata {@link isNativeToolSearch} reads. */
|
|
8
|
+
export type ToolSearchCandidate = Pick<ToolInfo, "name" | "exposure"> & {
|
|
9
|
+
sourceInfo?: Partial<ToolInfo["sourceInfo"]>;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Whether a tool is Pi's built-in `tool_search`. Judged by the public
|
|
13
|
+
* provenance Pi reports, so another extension's tool of the same name never
|
|
14
|
+
* counts, and no schema object is compared across package copies.
|
|
15
|
+
*/
|
|
16
|
+
export declare function isNativeToolSearch(tool: ToolSearchCandidate): boolean;
|
|
17
|
+
/** How {@link DeferredTools.ensureReachable} made the routine tools reachable. */
|
|
18
|
+
export type DeferredReach =
|
|
19
|
+
/** Pi's `tool_search` is active and loads the routine tools on demand. */
|
|
20
|
+
"search"
|
|
21
|
+
/** No usable native search, or the user turned it off: the permitted routine tools are active now. */
|
|
22
|
+
| "eager"
|
|
23
|
+
/** Pi kept none of this load's routine tools (allowlist, exclusion, or deny list). */
|
|
24
|
+
| "none";
|
|
25
|
+
export interface DeferredTools {
|
|
26
|
+
/** Registration API that records which deferred tools this load owns. */
|
|
27
|
+
api: ExtensionAPI;
|
|
28
|
+
/**
|
|
29
|
+
* Make this load's routine tools reachable once every extension has
|
|
30
|
+
* registered: activate Pi's `tool_search`, or, when it is missing, filtered
|
|
31
|
+
* out, turned off by `defaultTools`, or not Pi's own, activate the routine
|
|
32
|
+
* tools Pi kept. Other active and restored tools stay active; tools Pi
|
|
33
|
+
* filtered out stay unreachable.
|
|
34
|
+
*/
|
|
35
|
+
ensureReachable(): DeferredReach;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Track the deferred tools registered through the returned API. Ownership is
|
|
39
|
+
* the registered parameter schema object, which only this load holds, so a
|
|
40
|
+
* same-named tool from another extension is never activated.
|
|
41
|
+
*/
|
|
42
|
+
export declare function trackDeferredTools(pi: ExtensionAPI): DeferredTools;
|
|
43
|
+
//# sourceMappingURL=deferred-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deferred-tools.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/deferred-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,UAAmB,CAAC;AAMzD,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAOrE;AAUD,kFAAkF;AAClF,MAAM,MAAM,aAAa;AACxB,0EAA0E;AACxE,QAAQ;AACV,sGAAsG;GACpG,OAAO;AACT,sFAAsF;GACpF,MAAM,CAAC;AAEV,MAAM,WAAW,aAAa;IAC7B,yEAAyE;IACzE,GAAG,EAAE,YAAY,CAAC;IAClB;;;;;;OAMG;IACH,eAAe,IAAI,aAAa,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,aAAa,CA+BlE"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Routine host tools register with this exposure. Pi keeps their schemas and
|
|
3
|
+
* prompt guidelines out of requests until its built-in `tool_search` loads them.
|
|
4
|
+
*/
|
|
5
|
+
export const ROUTINE_TOOL_EXPOSURE = "deferred";
|
|
6
|
+
const TOOL_SEARCH_NAME = "tool_search";
|
|
7
|
+
/** The path Pi gives tools registered by its built-in tool-search extension. */
|
|
8
|
+
const TOOL_SEARCH_SOURCE_PATH = "builtin:tool-search";
|
|
9
|
+
/**
|
|
10
|
+
* Whether a tool is Pi's built-in `tool_search`. Judged by the public
|
|
11
|
+
* provenance Pi reports, so another extension's tool of the same name never
|
|
12
|
+
* counts, and no schema object is compared across package copies.
|
|
13
|
+
*/
|
|
14
|
+
export function isNativeToolSearch(tool) {
|
|
15
|
+
return (tool.name === TOOL_SEARCH_NAME &&
|
|
16
|
+
tool.sourceInfo?.source === "builtin" &&
|
|
17
|
+
tool.sourceInfo.path === TOOL_SEARCH_SOURCE_PATH &&
|
|
18
|
+
(tool.exposure === "model-only" || tool.exposure === "direct"));
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Whether the user's `defaultTools` setting removes `tool_search` with
|
|
22
|
+
* `-tool_search`. A setting that never names it leaves the search to the host.
|
|
23
|
+
*/
|
|
24
|
+
function isSearchTurnedOff(pi) {
|
|
25
|
+
return (pi.getSettings().defaultTools ?? []).includes(`-${TOOL_SEARCH_NAME}`);
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Track the deferred tools registered through the returned API. Ownership is
|
|
29
|
+
* the registered parameter schema object, which only this load holds, so a
|
|
30
|
+
* same-named tool from another extension is never activated.
|
|
31
|
+
*/
|
|
32
|
+
export function trackDeferredTools(pi) {
|
|
33
|
+
const owned = new Map();
|
|
34
|
+
const registerTool = (tool) => {
|
|
35
|
+
if (tool.exposure === ROUTINE_TOOL_EXPOSURE)
|
|
36
|
+
owned.set(tool.name, tool.parameters);
|
|
37
|
+
pi.registerTool(tool);
|
|
38
|
+
};
|
|
39
|
+
// SAFETY: the prototype is the real API, so every other member resolves to
|
|
40
|
+
// it unchanged; only registerTool is replaced.
|
|
41
|
+
const api = Object.assign(Object.create(pi), { registerTool });
|
|
42
|
+
return {
|
|
43
|
+
api,
|
|
44
|
+
ensureReachable() {
|
|
45
|
+
const tools = pi.getAllTools();
|
|
46
|
+
const routine = tools
|
|
47
|
+
.filter((tool) => owned.get(tool.name) === tool.parameters)
|
|
48
|
+
.map((tool) => tool.name);
|
|
49
|
+
if (routine.length === 0)
|
|
50
|
+
return "none";
|
|
51
|
+
const search = tools.find(isNativeToolSearch);
|
|
52
|
+
if (search && !isSearchTurnedOff(pi)) {
|
|
53
|
+
const active = pi.getActiveTools();
|
|
54
|
+
if (!active.includes(search.name))
|
|
55
|
+
pi.setActiveTools([...active, search.name]);
|
|
56
|
+
if (pi.getActiveTools().includes(search.name))
|
|
57
|
+
return "search";
|
|
58
|
+
}
|
|
59
|
+
const active = pi.getActiveTools();
|
|
60
|
+
const missing = routine.filter((name) => !active.includes(name));
|
|
61
|
+
if (missing.length > 0)
|
|
62
|
+
pi.setActiveTools([...active, ...missing]);
|
|
63
|
+
return "eager";
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=deferred-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deferred-tools.js","sourceRoot":"","sources":["../../../pi-extension/subagents/deferred-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, ToolInfo } from \"@earendil-works/pi-coding-agent\";\n\n/**\n * Routine host tools register with this exposure. Pi keeps their schemas and\n * prompt guidelines out of requests until its built-in `tool_search` loads them.\n */\nexport const ROUTINE_TOOL_EXPOSURE = \"deferred\" as const;\n\nconst TOOL_SEARCH_NAME = \"tool_search\";\n/** The path Pi gives tools registered by its built-in tool-search extension. */\nconst TOOL_SEARCH_SOURCE_PATH = \"builtin:tool-search\";\n\n/** The tool metadata {@link isNativeToolSearch} reads. */\nexport type ToolSearchCandidate = Pick<ToolInfo, \"name\" | \"exposure\"> & {\n\tsourceInfo?: Partial<ToolInfo[\"sourceInfo\"]>;\n};\n\n/**\n * Whether a tool is Pi's built-in `tool_search`. Judged by the public\n * provenance Pi reports, so another extension's tool of the same name never\n * counts, and no schema object is compared across package copies.\n */\nexport function isNativeToolSearch(tool: ToolSearchCandidate): boolean {\n\treturn (\n\t\ttool.name === TOOL_SEARCH_NAME &&\n\t\ttool.sourceInfo?.source === \"builtin\" &&\n\t\ttool.sourceInfo.path === TOOL_SEARCH_SOURCE_PATH &&\n\t\t(tool.exposure === \"model-only\" || tool.exposure === \"direct\")\n\t);\n}\n\n/**\n * Whether the user's `defaultTools` setting removes `tool_search` with\n * `-tool_search`. A setting that never names it leaves the search to the host.\n */\nfunction isSearchTurnedOff(pi: ExtensionAPI): boolean {\n\treturn (pi.getSettings().defaultTools ?? []).includes(`-${TOOL_SEARCH_NAME}`);\n}\n\n/** How {@link DeferredTools.ensureReachable} made the routine tools reachable. */\nexport type DeferredReach =\n\t/** Pi's `tool_search` is active and loads the routine tools on demand. */\n\t| \"search\"\n\t/** No usable native search, or the user turned it off: the permitted routine tools are active now. */\n\t| \"eager\"\n\t/** Pi kept none of this load's routine tools (allowlist, exclusion, or deny list). */\n\t| \"none\";\n\nexport interface DeferredTools {\n\t/** Registration API that records which deferred tools this load owns. */\n\tapi: ExtensionAPI;\n\t/**\n\t * Make this load's routine tools reachable once every extension has\n\t * registered: activate Pi's `tool_search`, or, when it is missing, filtered\n\t * out, turned off by `defaultTools`, or not Pi's own, activate the routine\n\t * tools Pi kept. Other active and restored tools stay active; tools Pi\n\t * filtered out stay unreachable.\n\t */\n\tensureReachable(): DeferredReach;\n}\n\n/**\n * Track the deferred tools registered through the returned API. Ownership is\n * the registered parameter schema object, which only this load holds, so a\n * same-named tool from another extension is never activated.\n */\nexport function trackDeferredTools(pi: ExtensionAPI): DeferredTools {\n\tconst owned = new Map<string, unknown>();\n\tconst registerTool: ExtensionAPI[\"registerTool\"] = (tool) => {\n\t\tif (tool.exposure === ROUTINE_TOOL_EXPOSURE)\n\t\t\towned.set(tool.name, tool.parameters);\n\t\tpi.registerTool(tool);\n\t};\n\t// SAFETY: the prototype is the real API, so every other member resolves to\n\t// it unchanged; only registerTool is replaced.\n\tconst api: ExtensionAPI = Object.assign(Object.create(pi), { registerTool });\n\treturn {\n\t\tapi,\n\t\tensureReachable() {\n\t\t\tconst tools = pi.getAllTools();\n\t\t\tconst routine = tools\n\t\t\t\t.filter((tool) => owned.get(tool.name) === tool.parameters)\n\t\t\t\t.map((tool) => tool.name);\n\t\t\tif (routine.length === 0) return \"none\";\n\t\t\tconst search = tools.find(isNativeToolSearch);\n\t\t\tif (search && !isSearchTurnedOff(pi)) {\n\t\t\t\tconst active = pi.getActiveTools();\n\t\t\t\tif (!active.includes(search.name))\n\t\t\t\t\tpi.setActiveTools([...active, search.name]);\n\t\t\t\tif (pi.getActiveTools().includes(search.name)) return \"search\";\n\t\t\t}\n\t\t\tconst active = pi.getActiveTools();\n\t\t\tconst missing = routine.filter((name) => !active.includes(name));\n\t\t\tif (missing.length > 0) pi.setActiveTools([...active, ...missing]);\n\t\t\treturn \"eager\";\n\t\t},\n\t};\n}\n"]}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
import type { Task } from "../../maestro/core/types.ts";
|
|
3
|
+
import type { PiRunRecord, PiCompletedMetadata, PiPersistentIO, PiSettlementIO, PiPersistentEvent, PiLedgerEntry } from "../../maestro/runtime/index.ts";
|
|
4
|
+
import type { WorktreeHandoff } from "../../maestro/core/worktree.ts";
|
|
5
|
+
import { type RunningSubagent, type SubagentRuntime } from "./state.ts";
|
|
6
|
+
import { type PersistentControls } from "./persistent.ts";
|
|
7
|
+
interface DeliveryDeps {
|
|
8
|
+
runtime: SubagentRuntime;
|
|
9
|
+
updateWidget: () => void;
|
|
10
|
+
startPersistentStopTimeout: PersistentControls["startPersistentStopTimeout"];
|
|
11
|
+
/** Parent clock for notice spacing; tests inject one. */
|
|
12
|
+
now?: () => number;
|
|
13
|
+
}
|
|
14
|
+
/** Parent delivery of child results, bound to one extension instance. */
|
|
15
|
+
export declare function createDelivery({ runtime, updateWidget, startPersistentStopTimeout, now, }: DeliveryDeps): {
|
|
16
|
+
deliverPersistentTaskEvent: (running: RunningSubagent, event: PiPersistentEvent, api: Pick<ExtensionAPI, "sendMessage">, io: PiPersistentIO, ledgerSnapshot?: PiLedgerEntry[]) => void;
|
|
17
|
+
drainPersistentTaskEvents: (running: RunningSubagent, api: Pick<ExtensionAPI, "sendMessage">, io: PiPersistentIO) => void;
|
|
18
|
+
notifyPersistentCrash: (running: RunningSubagent, api: Pick<ExtensionAPI, "sendMessage">, io: PiPersistentIO, worktree?: WorktreeHandoff) => void;
|
|
19
|
+
deliverPiCompletion: (record: PiRunRecord, result: PiCompletedMetadata, task: Task, io: PiSettlementIO) => "delivered" | "suppressed" | Promise<"delivered" | "suppressed">;
|
|
20
|
+
};
|
|
21
|
+
export {};
|
|
22
|
+
//# sourceMappingURL=delivery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../pi-extension/subagents/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,eAAe,EAGpB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAIN,KAAK,kBAAkB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,UAAU,YAAY;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,0BAA0B,EAAE,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;IAC7E,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AASD,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,EAC9B,OAAO,EACP,YAAY,EACZ,0BAA0B,EAC1B,GAAc,GACd,EAAE,YAAY;0CAuHJ,eAAe,SACjB,iBAAiB,OACnB,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,MAClC,cAAc,mBACD,aAAa,EAAE,KAC9B,IAAI;yCA8GG,eAAe,OACnB,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,MAClC,cAAc,KAChB,IAAI;qCAkBG,eAAe,OACnB,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,MAClC,cAAc,aACP,eAAe,KACxB,IAAI;kCAuBE,WAAW,UACX,mBAAmB,QACrB,IAAI,MACN,cAAc,KAChB,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,YAAY,CAAC;EAmKnE"}
|