@nubl/maestro 0.0.1 → 0.1.1
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 -2
- 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,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Host-enforced delegation depth. A top-level parent session has depth 0 and
|
|
3
|
+
* every launch exports `PI_SUBAGENT_DEPTH=<parent depth + 1>` to its child.
|
|
4
|
+
* The raw environment string is parsed once, here, into a typed value.
|
|
5
|
+
*/
|
|
6
|
+
export declare const DELEGATION_DEPTH_ENV = "PI_SUBAGENT_DEPTH";
|
|
7
|
+
/** Parent 0, children 1, grandchildren 2, great-grandchildren 3. */
|
|
8
|
+
export declare const DEFAULT_MAX_DELEGATION_DEPTH = 3;
|
|
9
|
+
export type DelegationDepth = {
|
|
10
|
+
kind: "known";
|
|
11
|
+
depth: number;
|
|
12
|
+
} | {
|
|
13
|
+
kind: "unknown";
|
|
14
|
+
raw: string;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* An absent variable means a top-level session (depth 0). A present value must
|
|
18
|
+
* be a canonical non-negative decimal integer; anything else is unknown and is
|
|
19
|
+
* never treated as 0, so a corrupted value cannot reset the count.
|
|
20
|
+
*/
|
|
21
|
+
export declare function parseDelegationDepth(raw: string | undefined): DelegationDepth;
|
|
22
|
+
export type DelegationDecision = {
|
|
23
|
+
allowed: true;
|
|
24
|
+
childDepth: number;
|
|
25
|
+
} | {
|
|
26
|
+
allowed: false;
|
|
27
|
+
reason: "unknown-depth" | "max-depth";
|
|
28
|
+
message: string;
|
|
29
|
+
};
|
|
30
|
+
/** Decide whether a session at `parent` depth may launch one more child. */
|
|
31
|
+
export declare function decideDelegation(parent: DelegationDepth, maxDepth: number): DelegationDecision;
|
|
32
|
+
/**
|
|
33
|
+
* The depth to export from a session with this environment: one more for a
|
|
34
|
+
* child, the same for a handoff that continues this conversation. Throws on an
|
|
35
|
+
* unknown parent depth rather than guessing.
|
|
36
|
+
*/
|
|
37
|
+
export declare function childDelegationDepth(rawParentDepth: string | undefined, launch?: "child" | "handoff"): number;
|
|
38
|
+
//# sourceMappingURL=delegation-depth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delegation-depth.d.ts","sourceRoot":"","sources":["../../../maestro/core/delegation-depth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAO7E;AAED,MAAM,MAAM,kBAAkB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,GACd,kBAAkB,CAuBpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,MAAM,GAAE,OAAO,GAAG,SAAmB,GACnC,MAAM,CAQR"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Host-enforced delegation depth. A top-level parent session has depth 0 and
|
|
3
|
+
* every launch exports `PI_SUBAGENT_DEPTH=<parent depth + 1>` to its child.
|
|
4
|
+
* The raw environment string is parsed once, here, into a typed value.
|
|
5
|
+
*/
|
|
6
|
+
export const DELEGATION_DEPTH_ENV = "PI_SUBAGENT_DEPTH";
|
|
7
|
+
/** Parent 0, children 1, grandchildren 2, great-grandchildren 3. */
|
|
8
|
+
export const DEFAULT_MAX_DELEGATION_DEPTH = 3;
|
|
9
|
+
/**
|
|
10
|
+
* An absent variable means a top-level session (depth 0). A present value must
|
|
11
|
+
* be a canonical non-negative decimal integer; anything else is unknown and is
|
|
12
|
+
* never treated as 0, so a corrupted value cannot reset the count.
|
|
13
|
+
*/
|
|
14
|
+
export function parseDelegationDepth(raw) {
|
|
15
|
+
if (raw === undefined)
|
|
16
|
+
return { kind: "known", depth: 0 };
|
|
17
|
+
if (/^(0|[1-9]\d*)$/.test(raw)) {
|
|
18
|
+
const depth = Number(raw);
|
|
19
|
+
if (Number.isSafeInteger(depth))
|
|
20
|
+
return { kind: "known", depth };
|
|
21
|
+
}
|
|
22
|
+
return { kind: "unknown", raw };
|
|
23
|
+
}
|
|
24
|
+
/** Decide whether a session at `parent` depth may launch one more child. */
|
|
25
|
+
export function decideDelegation(parent, maxDepth) {
|
|
26
|
+
if (parent.kind === "unknown") {
|
|
27
|
+
return {
|
|
28
|
+
allowed: false,
|
|
29
|
+
reason: "unknown-depth",
|
|
30
|
+
message: `Delegation refused: ${DELEGATION_DEPTH_ENV}=${JSON.stringify(parent.raw)} is not a non-negative integer, ` +
|
|
31
|
+
"so this session's delegation depth is unknown and is treated as already at the limit. " +
|
|
32
|
+
`Unset ${DELEGATION_DEPTH_ENV} in the environment that started this session, or do the work directly.`,
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
const childDepth = parent.depth + 1;
|
|
36
|
+
if (childDepth > maxDepth) {
|
|
37
|
+
return {
|
|
38
|
+
allowed: false,
|
|
39
|
+
reason: "max-depth",
|
|
40
|
+
message: `Delegation refused: this session is at delegation depth ${parent.depth} and the maximum is ${maxDepth} ` +
|
|
41
|
+
`(spawning.maxDepth in config.json), so it cannot launch another child. ` +
|
|
42
|
+
"Complete the work directly, or ask the user to raise spawning.maxDepth.",
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
return { allowed: true, childDepth };
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* The depth to export from a session with this environment: one more for a
|
|
49
|
+
* child, the same for a handoff that continues this conversation. Throws on an
|
|
50
|
+
* unknown parent depth rather than guessing.
|
|
51
|
+
*/
|
|
52
|
+
export function childDelegationDepth(rawParentDepth, launch = "child") {
|
|
53
|
+
const parent = parseDelegationDepth(rawParentDepth);
|
|
54
|
+
if (parent.kind === "unknown") {
|
|
55
|
+
throw new Error(`Cannot launch a child: ${DELEGATION_DEPTH_ENV}=${JSON.stringify(parent.raw)} is not a non-negative integer.`);
|
|
56
|
+
}
|
|
57
|
+
return launch === "handoff" ? parent.depth : parent.depth + 1;
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=delegation-depth.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delegation-depth.js","sourceRoot":"","sources":["../../../maestro/core/delegation-depth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,oEAAoE;AACpE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAM9C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAuB;IAC3D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC1D,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACjC,CAAC;AAMD,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAC/B,MAAuB,EACvB,QAAgB;IAEhB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,eAAe;YACvB,OAAO,EACN,uBAAuB,oBAAoB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC;gBAC3G,wFAAwF;gBACxF,SAAS,oBAAoB,yEAAyE;SACvG,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACpC,IAAI,UAAU,GAAG,QAAQ,EAAE,CAAC;QAC3B,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,WAAW;YACnB,OAAO,EACN,2DAA2D,MAAM,CAAC,KAAK,uBAAuB,QAAQ,GAAG;gBACzG,yEAAyE;gBACzE,yEAAyE;SAC1E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,cAAkC,EAClC,SAA8B,OAAO;IAErC,MAAM,MAAM,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACd,0BAA0B,oBAAoB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAC7G,CAAC;IACH,CAAC;IACD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["/**\n * Host-enforced delegation depth. A top-level parent session has depth 0 and\n * every launch exports `PI_SUBAGENT_DEPTH=<parent depth + 1>` to its child.\n * The raw environment string is parsed once, here, into a typed value.\n */\n\nexport const DELEGATION_DEPTH_ENV = \"PI_SUBAGENT_DEPTH\";\n\n/** Parent 0, children 1, grandchildren 2, great-grandchildren 3. */\nexport const DEFAULT_MAX_DELEGATION_DEPTH = 3;\n\nexport type DelegationDepth =\n\t| { kind: \"known\"; depth: number }\n\t| { kind: \"unknown\"; raw: string };\n\n/**\n * An absent variable means a top-level session (depth 0). A present value must\n * be a canonical non-negative decimal integer; anything else is unknown and is\n * never treated as 0, so a corrupted value cannot reset the count.\n */\nexport function parseDelegationDepth(raw: string | undefined): DelegationDepth {\n\tif (raw === undefined) return { kind: \"known\", depth: 0 };\n\tif (/^(0|[1-9]\\d*)$/.test(raw)) {\n\t\tconst depth = Number(raw);\n\t\tif (Number.isSafeInteger(depth)) return { kind: \"known\", depth };\n\t}\n\treturn { kind: \"unknown\", raw };\n}\n\nexport type DelegationDecision =\n\t| { allowed: true; childDepth: number }\n\t| { allowed: false; reason: \"unknown-depth\" | \"max-depth\"; message: string };\n\n/** Decide whether a session at `parent` depth may launch one more child. */\nexport function decideDelegation(\n\tparent: DelegationDepth,\n\tmaxDepth: number,\n): DelegationDecision {\n\tif (parent.kind === \"unknown\") {\n\t\treturn {\n\t\t\tallowed: false,\n\t\t\treason: \"unknown-depth\",\n\t\t\tmessage:\n\t\t\t\t`Delegation refused: ${DELEGATION_DEPTH_ENV}=${JSON.stringify(parent.raw)} is not a non-negative integer, ` +\n\t\t\t\t\"so this session's delegation depth is unknown and is treated as already at the limit. \" +\n\t\t\t\t`Unset ${DELEGATION_DEPTH_ENV} in the environment that started this session, or do the work directly.`,\n\t\t};\n\t}\n\tconst childDepth = parent.depth + 1;\n\tif (childDepth > maxDepth) {\n\t\treturn {\n\t\t\tallowed: false,\n\t\t\treason: \"max-depth\",\n\t\t\tmessage:\n\t\t\t\t`Delegation refused: this session is at delegation depth ${parent.depth} and the maximum is ${maxDepth} ` +\n\t\t\t\t`(spawning.maxDepth in config.json), so it cannot launch another child. ` +\n\t\t\t\t\"Complete the work directly, or ask the user to raise spawning.maxDepth.\",\n\t\t};\n\t}\n\treturn { allowed: true, childDepth };\n}\n\n/**\n * The depth to export from a session with this environment: one more for a\n * child, the same for a handoff that continues this conversation. Throws on an\n * unknown parent depth rather than guessing.\n */\nexport function childDelegationDepth(\n\trawParentDepth: string | undefined,\n\tlaunch: \"child\" | \"handoff\" = \"child\",\n): number {\n\tconst parent = parseDelegationDepth(rawParentDepth);\n\tif (parent.kind === \"unknown\") {\n\t\tthrow new Error(\n\t\t\t`Cannot launch a child: ${DELEGATION_DEPTH_ENV}=${JSON.stringify(parent.raw)} is not a non-negative integer.`,\n\t\t);\n\t}\n\treturn launch === \"handoff\" ? parent.depth : parent.depth + 1;\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"git-environment.d.ts","sourceRoot":"","sources":["../../../maestro/core/git-environment.ts"],"names":[],"mappings":"AAkBA,yFAAyF;AACzF,wBAAgB,cAAc,CAC7B,MAAM,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CAAC,UAAU,CAWnB"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
const REPOSITORY_OVERRIDES = new Set([
|
|
2
|
+
"GIT_DIR",
|
|
3
|
+
"GIT_COMMON_DIR",
|
|
4
|
+
"GIT_WORK_TREE",
|
|
5
|
+
"GIT_IMPLICIT_WORK_TREE",
|
|
6
|
+
"GIT_INDEX_FILE",
|
|
7
|
+
"GIT_OBJECT_DIRECTORY",
|
|
8
|
+
"GIT_ALTERNATE_OBJECT_DIRECTORIES",
|
|
9
|
+
"GIT_PREFIX",
|
|
10
|
+
"GIT_SHALLOW_FILE",
|
|
11
|
+
"GIT_GRAFT_FILE",
|
|
12
|
+
"GIT_REPLACE_REF_BASE",
|
|
13
|
+
"GIT_NO_REPLACE_OBJECTS",
|
|
14
|
+
"GIT_CONFIG",
|
|
15
|
+
"GIT_CONFIG_PARAMETERS",
|
|
16
|
+
"GIT_CONFIG_COUNT",
|
|
17
|
+
]);
|
|
18
|
+
/** Keep user configuration while letting host Git commands select their own checkout. */
|
|
19
|
+
export function gitEnvironment(source = process.env) {
|
|
20
|
+
const env = { ...source };
|
|
21
|
+
for (const key of Object.keys(env)) {
|
|
22
|
+
if (REPOSITORY_OVERRIDES.has(key) ||
|
|
23
|
+
/^GIT_CONFIG_(?:KEY|VALUE)_\d+$/.test(key)) {
|
|
24
|
+
delete env[key];
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return env;
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=git-environment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"git-environment.js","sourceRoot":"","sources":["../../../maestro/core/git-environment.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACpC,SAAS;IACT,gBAAgB;IAChB,eAAe;IACf,wBAAwB;IACxB,gBAAgB;IAChB,sBAAsB;IACtB,kCAAkC;IAClC,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;IAChB,sBAAsB;IACtB,wBAAwB;IACxB,YAAY;IACZ,uBAAuB;IACvB,kBAAkB;CAClB,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAC7B,SAA4B,OAAO,CAAC,GAAG;IAEvC,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IACC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;YAC7B,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,EACzC,CAAC;YACF,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC","sourcesContent":["const REPOSITORY_OVERRIDES = new Set([\n\t\"GIT_DIR\",\n\t\"GIT_COMMON_DIR\",\n\t\"GIT_WORK_TREE\",\n\t\"GIT_IMPLICIT_WORK_TREE\",\n\t\"GIT_INDEX_FILE\",\n\t\"GIT_OBJECT_DIRECTORY\",\n\t\"GIT_ALTERNATE_OBJECT_DIRECTORIES\",\n\t\"GIT_PREFIX\",\n\t\"GIT_SHALLOW_FILE\",\n\t\"GIT_GRAFT_FILE\",\n\t\"GIT_REPLACE_REF_BASE\",\n\t\"GIT_NO_REPLACE_OBJECTS\",\n\t\"GIT_CONFIG\",\n\t\"GIT_CONFIG_PARAMETERS\",\n\t\"GIT_CONFIG_COUNT\",\n]);\n\n/** Keep user configuration while letting host Git commands select their own checkout. */\nexport function gitEnvironment(\n\tsource: NodeJS.ProcessEnv = process.env,\n): NodeJS.ProcessEnv {\n\tconst env = { ...source };\n\tfor (const key of Object.keys(env)) {\n\t\tif (\n\t\t\tREPOSITORY_OVERRIDES.has(key) ||\n\t\t\t/^GIT_CONFIG_(?:KEY|VALUE)_\\d+$/.test(key)\n\t\t) {\n\t\t\tdelete env[key];\n\t\t}\n\t}\n\treturn env;\n}\n"]}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The HarnessAdapter seam: the single interface every agent engine implements.
|
|
3
|
+
*
|
|
4
|
+
* This is the inversion the product is built on. Today the engines are Pi and
|
|
5
|
+
* (stubbed) Claude Code; tomorrow any agent CLI is "just" a subprocess with a
|
|
6
|
+
* prompt interface. The orchestration core never knows which one it drives.
|
|
7
|
+
*
|
|
8
|
+
* Dependency direction: adapters import @ephemeralabs/maestro-core (for types) and never
|
|
9
|
+
* the reverse. Adapters also never import @ephemeralabs/maestro-surfaces; when an agent
|
|
10
|
+
* should run inside a multiplexer pane, the CLI passes a core-defined
|
|
11
|
+
* SurfaceHandle in SpawnOptions.surface.
|
|
12
|
+
*/
|
|
13
|
+
import type { AgentHandle, AgentState, CompletionEvidence, Role, SurfaceHandle, Task, Worktree, WorktreeSpec } from "./types.ts";
|
|
14
|
+
export interface SpawnOptions {
|
|
15
|
+
/** Launch admission only, never proof of remote cancellation. */
|
|
16
|
+
acquisitionSignal?: AbortSignal;
|
|
17
|
+
name: string;
|
|
18
|
+
/** Full task text for the agent. */
|
|
19
|
+
task: string;
|
|
20
|
+
role: Role;
|
|
21
|
+
/** Directory the agent works in (worktree path when isolated). */
|
|
22
|
+
cwd: string;
|
|
23
|
+
sessionId: string;
|
|
24
|
+
worktree?: Worktree;
|
|
25
|
+
/** Unprovisioned launch request. Pi resolves base and writes the ownership manifest before resource acquisition. */
|
|
26
|
+
worktreeRequest?: WorktreeSpec;
|
|
27
|
+
interactive?: boolean;
|
|
28
|
+
timeoutMs?: number;
|
|
29
|
+
/** When set, run the agent's command through this multiplexer surface
|
|
30
|
+
* instead of spawning a direct subprocess. */
|
|
31
|
+
surface?: SurfaceHandle;
|
|
32
|
+
/** Extra environment for the agent process. */
|
|
33
|
+
env?: Record<string, string>;
|
|
34
|
+
runtime?: Task["runtime"];
|
|
35
|
+
session?: Task["session"];
|
|
36
|
+
behavior?: Task["behavior"];
|
|
37
|
+
tools?: string[];
|
|
38
|
+
systemPrompt?: string;
|
|
39
|
+
/** Validated accept check for the child's own loop and the parent re-check. */
|
|
40
|
+
accept?: Task["accept"];
|
|
41
|
+
}
|
|
42
|
+
export interface ResumeOptions {
|
|
43
|
+
acquisitionSignal?: AbortSignal;
|
|
44
|
+
name: string;
|
|
45
|
+
/** Harness session reference to resume; for Pi, the session file path. */
|
|
46
|
+
sessionId: string;
|
|
47
|
+
message?: string;
|
|
48
|
+
tools?: string[];
|
|
49
|
+
autoExit?: boolean;
|
|
50
|
+
surface?: SurfaceHandle;
|
|
51
|
+
env?: Record<string, string>;
|
|
52
|
+
}
|
|
53
|
+
export interface HarnessAdapter {
|
|
54
|
+
/** Stable adapter name, e.g. "pi". Recorded on AgentHandle.harness. */
|
|
55
|
+
readonly name: string;
|
|
56
|
+
/** False when the harness CLI is not installed. Never throws. */
|
|
57
|
+
isAvailable(): boolean;
|
|
58
|
+
/**
|
|
59
|
+
* Spawn one agent. Returns immediately; the agent runs in the background.
|
|
60
|
+
* Must be non-blocking: supervision happens through the probe/actions.
|
|
61
|
+
*/
|
|
62
|
+
spawn(opts: SpawnOptions): Promise<AgentHandle>;
|
|
63
|
+
/** Probe the agent's coarse state. Pure observation; never mutates. */
|
|
64
|
+
getState(handle: AgentHandle): Promise<AgentState>;
|
|
65
|
+
/** Ask the agent to stop its current turn (e.g. SIGINT). The session
|
|
66
|
+
* survives; the agent may continue on the next turn. */
|
|
67
|
+
interrupt(handle: AgentHandle): Promise<void>;
|
|
68
|
+
/** Terminate the agent process. Irreversible. */
|
|
69
|
+
kill(handle: AgentHandle): Promise<void>;
|
|
70
|
+
/** Feed follow-up text to a running agent. */
|
|
71
|
+
sendInput(handle: AgentHandle, text: string): Promise<void>;
|
|
72
|
+
/** Read recent output (tail). Used for result collection and the TUI. */
|
|
73
|
+
readOutput(handle: AgentHandle, lines?: number): Promise<string>;
|
|
74
|
+
/**
|
|
75
|
+
* Exit code of a finished agent. Optional: harnesses that cannot observe
|
|
76
|
+
* it (spool-based, remote sessions) omit this and every "done" still maps
|
|
77
|
+
* to "completed". When present and nonzero, the supervisor reports the run
|
|
78
|
+
* as "failed" instead of "completed".
|
|
79
|
+
*/
|
|
80
|
+
exitCode?(handle: AgentHandle): number | undefined;
|
|
81
|
+
resume(opts: ResumeOptions): Promise<AgentHandle>;
|
|
82
|
+
/**
|
|
83
|
+
* Resolve when the agent's run has ended, with the evidence the harness
|
|
84
|
+
* can observe. Driven by wake-ups and sidecar evidence, not polling.
|
|
85
|
+
* Rejects on abort.
|
|
86
|
+
*/
|
|
87
|
+
awaitCompletion(handle: AgentHandle, signal: AbortSignal): Promise<CompletionEvidence>;
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=harness-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness-adapter.d.ts","sourceRoot":"","sources":["../../../maestro/core/harness-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,IAAI,EACJ,aAAa,EACb,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC5B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,oHAAoH;IACpH,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;mDAC+C;IAC/C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1B,QAAQ,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAE5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAE/E,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,aAAa;IAC7B,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,WAAW,IAAI,OAAO,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnD;6DACyD;IACzD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,iDAAiD;IACjD,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8CAA8C;IAC9C,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,yEAAyE;IACzE,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAGnD,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAElD;;;;OAIG;IAEH,eAAe,CACd,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness-adapter.js","sourceRoot":"","sources":["../../../maestro/core/harness-adapter.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The HarnessAdapter seam: the single interface every agent engine implements.\n *\n * This is the inversion the product is built on. Today the engines are Pi and\n * (stubbed) Claude Code; tomorrow any agent CLI is \"just\" a subprocess with a\n * prompt interface. The orchestration core never knows which one it drives.\n *\n * Dependency direction: adapters import @ephemeralabs/maestro-core (for types) and never\n * the reverse. Adapters also never import @ephemeralabs/maestro-surfaces; when an agent\n * should run inside a multiplexer pane, the CLI passes a core-defined\n * SurfaceHandle in SpawnOptions.surface.\n */\nimport type {\n\tAgentHandle,\n\tAgentState,\n\tCompletionEvidence,\n\tRole,\n\tSurfaceHandle,\n\tTask,\n\tWorktree,\n\tWorktreeSpec,\n} from \"./types.ts\";\n\nexport interface SpawnOptions {\n\t/** Launch admission only, never proof of remote cancellation. */\n\tacquisitionSignal?: AbortSignal;\n\tname: string;\n\t/** Full task text for the agent. */\n\ttask: string;\n\trole: Role;\n\t/** Directory the agent works in (worktree path when isolated). */\n\tcwd: string;\n\tsessionId: string;\n\tworktree?: Worktree;\n\t// pi-herdr-agents extension\n\t/** Unprovisioned launch request. Pi resolves base and writes the ownership manifest before resource acquisition. */\n\tworktreeRequest?: WorktreeSpec;\n\tinteractive?: boolean;\n\ttimeoutMs?: number;\n\t/** When set, run the agent's command through this multiplexer surface\n\t * instead of spawning a direct subprocess. */\n\tsurface?: SurfaceHandle;\n\t/** Extra environment for the agent process. */\n\tenv?: Record<string, string>;\n\t// pi-herdr-agents extension: carried from Task, see 4.1\n\truntime?: Task[\"runtime\"];\n\t// pi-herdr-agents extension\n\tsession?: Task[\"session\"];\n\t// pi-herdr-agents extension\n\tbehavior?: Task[\"behavior\"];\n\t// pi-herdr-agents extension\n\ttools?: string[];\n\t// pi-herdr-agents extension\n\tsystemPrompt?: string;\n\t/** Validated accept check for the child's own loop and the parent re-check. */\n\t// pi-herdr-agents extension\n\taccept?: Task[\"accept\"];\n}\n\n// pi-herdr-agents extension\nexport interface ResumeOptions {\n\tacquisitionSignal?: AbortSignal;\n\tname: string;\n\t/** Harness session reference to resume; for Pi, the session file path. */\n\tsessionId: string;\n\tmessage?: string;\n\ttools?: string[];\n\tautoExit?: boolean;\n\tsurface?: SurfaceHandle;\n\tenv?: Record<string, string>;\n}\n\nexport interface HarnessAdapter {\n\t/** Stable adapter name, e.g. \"pi\". Recorded on AgentHandle.harness. */\n\treadonly name: string;\n\n\t/** False when the harness CLI is not installed. Never throws. */\n\tisAvailable(): boolean;\n\n\t/**\n\t * Spawn one agent. Returns immediately; the agent runs in the background.\n\t * Must be non-blocking: supervision happens through the probe/actions.\n\t */\n\tspawn(opts: SpawnOptions): Promise<AgentHandle>;\n\n\t/** Probe the agent's coarse state. Pure observation; never mutates. */\n\tgetState(handle: AgentHandle): Promise<AgentState>;\n\n\t/** Ask the agent to stop its current turn (e.g. SIGINT). The session\n\t * survives; the agent may continue on the next turn. */\n\tinterrupt(handle: AgentHandle): Promise<void>;\n\n\t/** Terminate the agent process. Irreversible. */\n\tkill(handle: AgentHandle): Promise<void>;\n\n\t/** Feed follow-up text to a running agent. */\n\tsendInput(handle: AgentHandle, text: string): Promise<void>;\n\n\t/** Read recent output (tail). Used for result collection and the TUI. */\n\treadOutput(handle: AgentHandle, lines?: number): Promise<string>;\n\n\t/**\n\t * Exit code of a finished agent. Optional: harnesses that cannot observe\n\t * it (spool-based, remote sessions) omit this and every \"done\" still maps\n\t * to \"completed\". When present and nonzero, the supervisor reports the run\n\t * as \"failed\" instead of \"completed\".\n\t */\n\texitCode?(handle: AgentHandle): number | undefined;\n\n\t// pi-herdr-agents extension\n\tresume(opts: ResumeOptions): Promise<AgentHandle>;\n\n\t/**\n\t * Resolve when the agent's run has ended, with the evidence the harness\n\t * can observe. Driven by wake-ups and sidecar evidence, not polling.\n\t * Rejects on abort.\n\t */\n\t// pi-herdr-agents extension\n\tawaitCompletion(\n\t\thandle: AgentHandle,\n\t\tsignal: AbortSignal,\n\t): Promise<CompletionEvidence>;\n}\n"]}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Host text for parent-facing sinks. Three policies, never mixed:
|
|
3
|
+
* - display values in a host line are encoded and bounded (`encodeHostValue`);
|
|
4
|
+
* - executable command arguments are serialized losslessly or omitted
|
|
5
|
+
* (`jsonArgument`, `shellArgument`), never encoded or abbreviated;
|
|
6
|
+
* - child text in a terminal view is split on every line separator and its
|
|
7
|
+
* controls are shown as escapes before any prefix (`displayLines`).
|
|
8
|
+
*/
|
|
9
|
+
/** A literal report delimiter in any case, opening or closing. */
|
|
10
|
+
export declare const REPORT_DELIMITER: RegExp;
|
|
11
|
+
/** Default bound for one variable value inside a host line. */
|
|
12
|
+
export declare const HOST_VALUE_CHARS = 200;
|
|
13
|
+
/** Bound for a path or a short diagnostic. */
|
|
14
|
+
export declare const HOST_PATH_CHARS = 1000;
|
|
15
|
+
/** Bound for an error relayed from a child or a tool. */
|
|
16
|
+
export declare const HOST_ERROR_CHARS = 4000;
|
|
17
|
+
/** Bound one value by replacing its middle with `marker`. */
|
|
18
|
+
export declare function abbreviateMiddle(value: string, maxChars: number, marker: string): string;
|
|
19
|
+
/**
|
|
20
|
+
* The encoding policy for any child-, transcript- or environment-influenced
|
|
21
|
+
* value shown in a host line: JSON string escaping (so `\n`, `"` and `\` stay
|
|
22
|
+
* visible as escapes), every other control, separator or bidi control as
|
|
23
|
+
* `\uXXXX`, report delimiters neutralized, and a bounded length. The result is
|
|
24
|
+
* always one line. Callers keep the original value in structured details.
|
|
25
|
+
*/
|
|
26
|
+
export declare function encodeHostValue(value: string, maxChars?: number): string;
|
|
27
|
+
/** Host-authored text forced onto one line: controls become visible escapes. */
|
|
28
|
+
export declare function oneLine(text: string): string;
|
|
29
|
+
/**
|
|
30
|
+
* A lossless JSON string literal for an executable argument: `JSON.parse`
|
|
31
|
+
* returns `value` exactly. It is always one line and never contains a report
|
|
32
|
+
* delimiter, because separators, bidi controls and `<` are `\uXXXX` escapes.
|
|
33
|
+
*/
|
|
34
|
+
export declare function jsonArgument(value: string): string;
|
|
35
|
+
/**
|
|
36
|
+
* A shell word that a POSIX shell reads back as exactly `value`, or undefined
|
|
37
|
+
* when no one-line form is safe to show: a line break or other control, or a
|
|
38
|
+
* literal report delimiter, which shell quoting would keep verbatim and so
|
|
39
|
+
* forge a second envelope tag in the parent message.
|
|
40
|
+
*/
|
|
41
|
+
export declare function shellArgument(value: string): string | undefined;
|
|
42
|
+
/**
|
|
43
|
+
* Child text for a terminal view: one entry per displayed line, split on CR,
|
|
44
|
+
* LF, CRLF, NEL, VT, FF and U+2028/U+2029, with every remaining control
|
|
45
|
+
* (ESC, CSI, bidi controls) shown as `\uXXXX`. Tabs stay; the renderer
|
|
46
|
+
* expands them.
|
|
47
|
+
*/
|
|
48
|
+
export declare function displayLines(text: string): string[];
|
|
49
|
+
//# sourceMappingURL=host-text.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host-text.d.ts","sourceRoot":"","sources":["../../../maestro/core/host-text.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,QAA4B,CAAC;AAE1D,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,8CAA8C;AAC9C,eAAO,MAAM,eAAe,OAAQ,CAAC;AACrC,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAgCtC,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACZ,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAyB,GACjC,MAAM,CAMR;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import { shellQuote } from "./shell.js";
|
|
2
|
+
/**
|
|
3
|
+
* Host text for parent-facing sinks. Three policies, never mixed:
|
|
4
|
+
* - display values in a host line are encoded and bounded (`encodeHostValue`);
|
|
5
|
+
* - executable command arguments are serialized losslessly or omitted
|
|
6
|
+
* (`jsonArgument`, `shellArgument`), never encoded or abbreviated;
|
|
7
|
+
* - child text in a terminal view is split on every line separator and its
|
|
8
|
+
* controls are shown as escapes before any prefix (`displayLines`).
|
|
9
|
+
*/
|
|
10
|
+
/** A literal report delimiter in any case, opening or closing. */
|
|
11
|
+
export const REPORT_DELIMITER = /<(\/?subagent_report)/gi;
|
|
12
|
+
/** Default bound for one variable value inside a host line. */
|
|
13
|
+
export const HOST_VALUE_CHARS = 200;
|
|
14
|
+
/** Bound for a path or a short diagnostic. */
|
|
15
|
+
export const HOST_PATH_CHARS = 1_000;
|
|
16
|
+
/** Bound for an error relayed from a child or a tool. */
|
|
17
|
+
export const HOST_ERROR_CHARS = 4_000;
|
|
18
|
+
// Every C0/C1 control, Unicode line and paragraph separators, and every bidi
|
|
19
|
+
// control: anything that could start a new line or reorder what a reader sees.
|
|
20
|
+
const UNSAFE_HOST_CHAR = /[\p{Cc}\u2028\u2029\p{Bidi_Control}]/gu;
|
|
21
|
+
const UNSAFE_HOST_CHAR_TEST = /[\p{Cc}\u2028\u2029\p{Bidi_Control}]/u;
|
|
22
|
+
// JSON.stringify already escapes C0 controls, quotes and backslashes.
|
|
23
|
+
const UNSAFE_JSON_CHAR = /[\u007f-\u009f\u2028\u2029\p{Bidi_Control}<]/gu;
|
|
24
|
+
const DISPLAY_LINE_BREAK = /\r\n|[\n\r\v\f\u0085\u2028\u2029]/;
|
|
25
|
+
const DISPLAY_CONTROL = /[\p{Cc}\p{Bidi_Control}]/gu;
|
|
26
|
+
const SHELL_WORD = /^[A-Za-z0-9_@%+=:,./-]+$/;
|
|
27
|
+
// Non-global twin of REPORT_DELIMITER for a stateless test.
|
|
28
|
+
const REPORT_DELIMITER_TEST = /<\/?subagent_report/i;
|
|
29
|
+
function escapeChar(char) {
|
|
30
|
+
return `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`;
|
|
31
|
+
}
|
|
32
|
+
/** Keep at most `count` leading code units without splitting a surrogate pair. */
|
|
33
|
+
function sliceHead(value, count) {
|
|
34
|
+
const code = value.charCodeAt(count - 1);
|
|
35
|
+
return value.slice(0, code >= 0xd800 && code <= 0xdbff ? count - 1 : count);
|
|
36
|
+
}
|
|
37
|
+
/** Keep at most `count` trailing code units without splitting a surrogate pair. */
|
|
38
|
+
function sliceTail(value, count) {
|
|
39
|
+
if (count <= 0)
|
|
40
|
+
return "";
|
|
41
|
+
const start = value.length - count;
|
|
42
|
+
const code = value.charCodeAt(start);
|
|
43
|
+
return value.slice(code >= 0xdc00 && code <= 0xdfff ? start + 1 : start);
|
|
44
|
+
}
|
|
45
|
+
/** Bound one value by replacing its middle with `marker`. */
|
|
46
|
+
export function abbreviateMiddle(value, maxChars, marker) {
|
|
47
|
+
if (value.length <= maxChars)
|
|
48
|
+
return value;
|
|
49
|
+
const retainedChars = Math.max(0, maxChars - marker.length);
|
|
50
|
+
return (sliceHead(value, Math.ceil(retainedChars / 2)) +
|
|
51
|
+
marker +
|
|
52
|
+
sliceTail(value, Math.floor(retainedChars / 2)));
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* The encoding policy for any child-, transcript- or environment-influenced
|
|
56
|
+
* value shown in a host line: JSON string escaping (so `\n`, `"` and `\` stay
|
|
57
|
+
* visible as escapes), every other control, separator or bidi control as
|
|
58
|
+
* `\uXXXX`, report delimiters neutralized, and a bounded length. The result is
|
|
59
|
+
* always one line. Callers keep the original value in structured details.
|
|
60
|
+
*/
|
|
61
|
+
export function encodeHostValue(value, maxChars = HOST_VALUE_CHARS) {
|
|
62
|
+
const escaped = JSON.stringify(value)
|
|
63
|
+
.slice(1, -1)
|
|
64
|
+
.replace(UNSAFE_HOST_CHAR, escapeChar)
|
|
65
|
+
.replace(REPORT_DELIMITER, "<$1");
|
|
66
|
+
return abbreviateMiddle(escaped, maxChars, " [... abbreviated ...] ");
|
|
67
|
+
}
|
|
68
|
+
/** Host-authored text forced onto one line: controls become visible escapes. */
|
|
69
|
+
export function oneLine(text) {
|
|
70
|
+
return text.replace(UNSAFE_HOST_CHAR, escapeChar);
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* A lossless JSON string literal for an executable argument: `JSON.parse`
|
|
74
|
+
* returns `value` exactly. It is always one line and never contains a report
|
|
75
|
+
* delimiter, because separators, bidi controls and `<` are `\uXXXX` escapes.
|
|
76
|
+
*/
|
|
77
|
+
export function jsonArgument(value) {
|
|
78
|
+
return JSON.stringify(value).replace(UNSAFE_JSON_CHAR, escapeChar);
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* A shell word that a POSIX shell reads back as exactly `value`, or undefined
|
|
82
|
+
* when no one-line form is safe to show: a line break or other control, or a
|
|
83
|
+
* literal report delimiter, which shell quoting would keep verbatim and so
|
|
84
|
+
* forge a second envelope tag in the parent message.
|
|
85
|
+
*/
|
|
86
|
+
export function shellArgument(value) {
|
|
87
|
+
if (SHELL_WORD.test(value))
|
|
88
|
+
return value;
|
|
89
|
+
if (!value ||
|
|
90
|
+
UNSAFE_HOST_CHAR_TEST.test(value) ||
|
|
91
|
+
REPORT_DELIMITER_TEST.test(value))
|
|
92
|
+
return undefined;
|
|
93
|
+
return shellQuote(value);
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Child text for a terminal view: one entry per displayed line, split on CR,
|
|
97
|
+
* LF, CRLF, NEL, VT, FF and U+2028/U+2029, with every remaining control
|
|
98
|
+
* (ESC, CSI, bidi controls) shown as `\uXXXX`. Tabs stay; the renderer
|
|
99
|
+
* expands them.
|
|
100
|
+
*/
|
|
101
|
+
export function displayLines(text) {
|
|
102
|
+
return text
|
|
103
|
+
.split(DISPLAY_LINE_BREAK)
|
|
104
|
+
.map((line) => line.replace(DISPLAY_CONTROL, (char) => char === "\t" ? char : escapeChar(char)));
|
|
105
|
+
}
|
|
106
|
+
//# sourceMappingURL=host-text.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host-text.js","sourceRoot":"","sources":["../../../maestro/core/host-text.ts"],"names":[],"mappings":"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","sourcesContent":["import { shellQuote } from \"./shell.ts\";\n\n/**\n * Host text for parent-facing sinks. Three policies, never mixed:\n * - display values in a host line are encoded and bounded (`encodeHostValue`);\n * - executable command arguments are serialized losslessly or omitted\n * (`jsonArgument`, `shellArgument`), never encoded or abbreviated;\n * - child text in a terminal view is split on every line separator and its\n * controls are shown as escapes before any prefix (`displayLines`).\n */\n\n/** A literal report delimiter in any case, opening or closing. */\nexport const REPORT_DELIMITER = /<(\\/?subagent_report)/gi;\n\n/** Default bound for one variable value inside a host line. */\nexport const HOST_VALUE_CHARS = 200;\n/** Bound for a path or a short diagnostic. */\nexport const HOST_PATH_CHARS = 1_000;\n/** Bound for an error relayed from a child or a tool. */\nexport const HOST_ERROR_CHARS = 4_000;\n\n// Every C0/C1 control, Unicode line and paragraph separators, and every bidi\n// control: anything that could start a new line or reorder what a reader sees.\nconst UNSAFE_HOST_CHAR = /[\\p{Cc}\\u2028\\u2029\\p{Bidi_Control}]/gu;\nconst UNSAFE_HOST_CHAR_TEST = /[\\p{Cc}\\u2028\\u2029\\p{Bidi_Control}]/u;\n// JSON.stringify already escapes C0 controls, quotes and backslashes.\nconst UNSAFE_JSON_CHAR = /[\\u007f-\\u009f\\u2028\\u2029\\p{Bidi_Control}<]/gu;\nconst DISPLAY_LINE_BREAK = /\\r\\n|[\\n\\r\\v\\f\\u0085\\u2028\\u2029]/;\nconst DISPLAY_CONTROL = /[\\p{Cc}\\p{Bidi_Control}]/gu;\nconst SHELL_WORD = /^[A-Za-z0-9_@%+=:,./-]+$/;\n// Non-global twin of REPORT_DELIMITER for a stateless test.\nconst REPORT_DELIMITER_TEST = /<\\/?subagent_report/i;\n\nfunction escapeChar(char: string): string {\n\treturn `\\\\u${char.charCodeAt(0).toString(16).padStart(4, \"0\")}`;\n}\n\n/** Keep at most `count` leading code units without splitting a surrogate pair. */\nfunction sliceHead(value: string, count: number): string {\n\tconst code = value.charCodeAt(count - 1);\n\treturn value.slice(0, code >= 0xd800 && code <= 0xdbff ? count - 1 : count);\n}\n\n/** Keep at most `count` trailing code units without splitting a surrogate pair. */\nfunction sliceTail(value: string, count: number): string {\n\tif (count <= 0) return \"\";\n\tconst start = value.length - count;\n\tconst code = value.charCodeAt(start);\n\treturn value.slice(code >= 0xdc00 && code <= 0xdfff ? start + 1 : start);\n}\n\n/** Bound one value by replacing its middle with `marker`. */\nexport function abbreviateMiddle(\n\tvalue: string,\n\tmaxChars: number,\n\tmarker: string,\n): string {\n\tif (value.length <= maxChars) return value;\n\tconst retainedChars = Math.max(0, maxChars - marker.length);\n\treturn (\n\t\tsliceHead(value, Math.ceil(retainedChars / 2)) +\n\t\tmarker +\n\t\tsliceTail(value, Math.floor(retainedChars / 2))\n\t);\n}\n\n/**\n * The encoding policy for any child-, transcript- or environment-influenced\n * value shown in a host line: JSON string escaping (so `\\n`, `\"` and `\\` stay\n * visible as escapes), every other control, separator or bidi control as\n * `\\uXXXX`, report delimiters neutralized, and a bounded length. The result is\n * always one line. Callers keep the original value in structured details.\n */\nexport function encodeHostValue(\n\tvalue: string,\n\tmaxChars: number = HOST_VALUE_CHARS,\n): string {\n\tconst escaped = JSON.stringify(value)\n\t\t.slice(1, -1)\n\t\t.replace(UNSAFE_HOST_CHAR, escapeChar)\n\t\t.replace(REPORT_DELIMITER, \"<$1\");\n\treturn abbreviateMiddle(escaped, maxChars, \" [... abbreviated ...] \");\n}\n\n/** Host-authored text forced onto one line: controls become visible escapes. */\nexport function oneLine(text: string): string {\n\treturn text.replace(UNSAFE_HOST_CHAR, escapeChar);\n}\n\n/**\n * A lossless JSON string literal for an executable argument: `JSON.parse`\n * returns `value` exactly. It is always one line and never contains a report\n * delimiter, because separators, bidi controls and `<` are `\\uXXXX` escapes.\n */\nexport function jsonArgument(value: string): string {\n\treturn JSON.stringify(value).replace(UNSAFE_JSON_CHAR, escapeChar);\n}\n\n/**\n * A shell word that a POSIX shell reads back as exactly `value`, or undefined\n * when no one-line form is safe to show: a line break or other control, or a\n * literal report delimiter, which shell quoting would keep verbatim and so\n * forge a second envelope tag in the parent message.\n */\nexport function shellArgument(value: string): string | undefined {\n\tif (SHELL_WORD.test(value)) return value;\n\tif (\n\t\t!value ||\n\t\tUNSAFE_HOST_CHAR_TEST.test(value) ||\n\t\tREPORT_DELIMITER_TEST.test(value)\n\t)\n\t\treturn undefined;\n\treturn shellQuote(value);\n}\n\n/**\n * Child text for a terminal view: one entry per displayed line, split on CR,\n * LF, CRLF, NEL, VT, FF and U+2028/U+2029, with every remaining control\n * (ESC, CSI, bidi controls) shown as `\\uXXXX`. Tabs stay; the renderer\n * expands them.\n */\nexport function displayLines(text: string): string[] {\n\treturn text\n\t\t.split(DISPLAY_LINE_BREAK)\n\t\t.map((line) =>\n\t\t\tline.replace(DISPLAY_CONTROL, (char) =>\n\t\t\t\tchar === \"\\t\" ? char : escapeChar(char),\n\t\t\t),\n\t\t);\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../maestro/core/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,uBAAuB,CAAC;AAC3C,mBAAmB,YAAY,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../maestro/core/index.ts"],"names":[],"mappings":"","sourcesContent":["export type * from \"./harness-adapter.ts\";\nexport type * from \"./surface-provider.ts\";\nexport type * from \"./types.ts\";\n"]}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { ActivityReadResult, CompletionResult, CompletionDelivery, LifecycleProjection, PaneInspection, SubagentLifecycle } from "./types.ts";
|
|
2
|
+
export type { ActivityDetail, ActivityHealth, CompletionDelivery, LifecycleProjection, PaneInspection, PaneObservation, ProcessState, SubagentLifecycle, SurfaceAgentStatus as HerdrAgentStatus, TurnState, } from "./types.ts";
|
|
3
|
+
export declare function createLifecycle(startedAt: number): SubagentLifecycle;
|
|
4
|
+
export declare function observePaneInspection(lifecycle: SubagentLifecycle, inspection: PaneInspection, observedAt: number): SubagentLifecycle;
|
|
5
|
+
export declare function observeActivity(lifecycle: SubagentLifecycle, read: ActivityReadResult, observedAt: number): SubagentLifecycle;
|
|
6
|
+
export declare function markProcessRunning(lifecycle: SubagentLifecycle, confirmedAt: number): SubagentLifecycle;
|
|
7
|
+
export declare function markInterruptRequested(lifecycle: SubagentLifecycle, requestedAt: number): SubagentLifecycle;
|
|
8
|
+
export declare function markCompletionDetected(lifecycle: SubagentLifecycle, completion: CompletionResult, detectedAt: number): SubagentLifecycle;
|
|
9
|
+
export declare function markCompleted(lifecycle: SubagentLifecycle, completedAt: number): SubagentLifecycle;
|
|
10
|
+
export declare function markFailed(lifecycle: SubagentLifecycle, error: string, detectedAt: number, exitCode?: number): SubagentLifecycle;
|
|
11
|
+
export declare function markDelivery(lifecycle: SubagentLifecycle, delivery: CompletionDelivery): SubagentLifecycle;
|
|
12
|
+
export declare function projectLifecycle(lifecycle: SubagentLifecycle, now: number): LifecycleProjection;
|
|
13
|
+
export type LifecycleTransition = "stalled" | "recovered" | null;
|
|
14
|
+
export declare function lifecycleTransition(previous: LifecycleProjection["kind"] | undefined, next: LifecycleProjection["kind"]): LifecycleTransition;
|
|
15
|
+
export declare function formatLifecycleTransitionLine(displayName: string, projection: LifecycleProjection, transition: Exclude<LifecycleTransition, null>, now: number, startedAt: number, formatElapsed: (ms: number) => string): string;
|
|
16
|
+
//# sourceMappingURL=lifecycle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../maestro/core/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,gBAAgB,EAGhB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EAGd,iBAAiB,EAEjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACX,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,IAAI,gBAAgB,EACtC,SAAS,GACT,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAWpE;AAUD,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,MAAM,GAChB,iBAAiB,CA8GnB;AAED,wBAAgB,eAAe,CAC9B,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,GAChB,iBAAiB,CA8JnB;AAED,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,GACjB,iBAAiB,CAUnB;AAED,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,GACjB,iBAAiB,CAWnB;AAED,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,MAAM,GAChB,iBAAiB,CAYnB;AAED,wBAAgB,aAAa,CAC5B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,MAAM,GACjB,iBAAiB,CAanB;AAED,wBAAgB,UAAU,CACzB,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GACf,iBAAiB,CAgBnB;AAED,wBAAgB,YAAY,CAC3B,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,kBAAkB,GAC1B,iBAAiB,CAGnB;AAED,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,MAAM,GACT,mBAAmB,CAmDrB;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC;AAEjE,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,SAAS,EACjD,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAC/B,mBAAmB,CAcrB;AAED,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,EAC9C,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GACnC,MAAM,CA2BR"}
|