@nubl/maestro 0.0.1 → 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 +55 -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 @@
|
|
|
1
|
+
{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../maestro/core/accept.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The accept check (delegation outcome contract v0.1): a caller-supplied shell\n * command the child runs before it finishes and the parent re-runs to decide\n * a verdict from a closed set. The host enforces this mechanism; which command\n * to run is the caller's or its pack's policy (ADR-0013, ADR-0017).\n *\n * This module is pure: spec validation, the verdict model, its one-line\n * description, and the outcome-ledger line. Running a command lives in\n * `adapters/pi/accept-runner.ts`.\n */\nimport { posix, win32 } from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { isFiniteNumber, isRecord, isString } from \"./config/type-guards.ts\";\n\n/** The closed verdict set. A sixth value is a contract change. */\nexport const ACCEPT_VERDICTS = [\n\t\"accepted\",\n\t\"rejected\",\n\t\"error\",\n\t\"skipped\",\n\t\"none\",\n] as const;\nexport type AcceptVerdict = (typeof ACCEPT_VERDICTS)[number];\n\nexport const ACCEPT_DEFAULT_MAX_RETRIES = 1;\nexport const ACCEPT_MAX_RETRIES = 5;\nexport const ACCEPT_DEFAULT_TIMEOUT_SEC = 600;\nexport const ACCEPT_MAX_TIMEOUT_SEC = 3600;\n/** SIGTERM to the check's process group, then SIGKILL after this grace. */\nexport const ACCEPT_KILL_GRACE_MS = 5_000;\n/** The shorter SIGKILL grace when the check's owner shuts down. */\nexport const ACCEPT_SHUTDOWN_GRACE_MS = 1_000;\n/** Combined output kept while a check runs. */\nexport const ACCEPT_CAPTURE_CHARS = 64 * 1024;\n/** Failing output the child receives as its retry message. */\nexport const ACCEPT_CHILD_OUTPUT_CHARS = 4_000;\n/** Raw parent re-check output kept in structured details. */\nexport const ACCEPT_DETAILS_OUTPUT_CHARS = 4_000;\n/** Parent re-check output shown, encoded, in the delivery. */\nexport const ACCEPT_PARENT_OUTPUT_CHARS = 1_500;\n/** The child reads its spec from this JSON file; the command never sits in env. */\nexport const ACCEPT_FILE_ENV = \"PI_SUBAGENT_ACCEPT_FILE\";\n/** Custom message type of the child's retry message. */\nexport const ACCEPT_RETRY_MESSAGE_TYPE = \"subagent-accept-check\";\n\n/** The `accept` tool parameter as the caller sends it. */\nexport interface AcceptRequest {\n\trun: string;\n\tmaxRetries?: number;\n\ttimeoutSec?: number;\n\tpaths?: string[];\n}\n\n/** A validated check with defaults applied. */\nexport interface AcceptSpec {\n\trun: string;\n\tmaxRetries: number;\n\ttimeoutSec: number;\n\t/** Repo-relative check files; changes the child made to them are reported. */\n\tpaths: string[];\n}\n\n/** What the child's own check loop recorded in its `.exit` sidecar. */\nexport interface ChildAcceptReport {\n\ttries: number;\n\tchildVerdict: \"passed\" | \"failed\";\n\tlastExitCode?: number;\n\ttimedOut: boolean;\n}\n\n/** How one run of the check command ended. */\nexport type AcceptCommandResult =\n\t| { kind: \"exit\"; exitCode: number; output: string }\n\t| { kind: \"timeout\"; output: string }\n\t| { kind: \"signal\"; signal: string; output: string }\n\t| { kind: \"cwd-missing\"; output: string }\n\t| { kind: \"spawn-error\"; error: string; output: string }\n\t| { kind: \"aborted\"; output: string };\n\n/** The verdict a delivery carries, with its structured evidence. */\nexport interface AcceptOutcome {\n\tverdict: AcceptVerdict;\n\t/** Why the verdict is `skipped` or `error`, as closed host text. */\n\treason?: string;\n\t/** Child check runs, from its sidecar; absent when unknown. */\n\ttries?: number;\n\tchildVerdict?: ChildAcceptReport[\"childVerdict\"];\n\t/** Exit code of the parent's re-check. */\n\texitCode?: number;\n\ttimeoutSec?: number;\n\t/** `sha256:<hex>` of the command; never the command itself. */\n\tcheckHash?: string;\n\t/** Where the parent re-check ran. */\n\tcwd?: string;\n\t/** The re-check ran in a checkout other writers may share. */\n\tsharedCheckout?: boolean;\n\t/** Check files under `paths` that the child changed; the verdict is unchanged. */\n\tchangedCheckFiles?: string[];\n\t/** Raw tail of the parent re-check output, for `rejected` and `error` only. */\n\toutput?: string;\n}\n\nfunction invalid(message: string): never {\n\tthrow new Error(`Invalid accept check: ${message}`);\n}\n\nfunction boundedInteger(\n\tvalue: number | undefined,\n\tname: string,\n\tmin: number,\n\tmax: number,\n\tfallback: number,\n): number {\n\tif (value === undefined) return fallback;\n\tif (\n\t\t!isFiniteNumber(value) ||\n\t\t!Number.isInteger(value) ||\n\t\tvalue < min ||\n\t\tvalue > max\n\t)\n\t\tinvalid(`${name} must be an integer from ${min} to ${max}`);\n\treturn value;\n}\n\nfunction normalizeCheckPath(path: string): string {\n\tif (!isString(path) || !path.trim()) invalid(\"paths must be non-empty\");\n\tconst raw = path.trim();\n\tif (\n\t\tposix.isAbsolute(raw) ||\n\t\twin32.isAbsolute(raw) ||\n\t\traw.split(\"/\").some((segment) => segment === \"..\")\n\t)\n\t\tinvalid(`paths must be repo-relative without \"..\": ${path}`);\n\t// \".\" and \"./\" select the whole checkout.\n\treturn posix.normalize(raw).replace(/\\/+$/, \"\") || \".\";\n}\n\n/**\n * Validate an `accept` request and apply its defaults. The tool schema\n * already checked its shape; this re-checks bounds for non-schema callers.\n */\nexport function normalizeAcceptSpec(request: AcceptRequest): AcceptSpec {\n\tif (!isRecord(request)) invalid(\"accept must be an object\");\n\tconst unsupported = Object.keys(request).filter(\n\t\t(key) => ![\"run\", \"maxRetries\", \"timeoutSec\", \"paths\"].includes(key),\n\t);\n\tif (unsupported.length)\n\t\tinvalid(`unsupported key(s): ${unsupported.join(\", \")}`);\n\tconst { run, paths } = request;\n\tif (!isString(run) || !run.trim()) invalid(\"run must be a non-empty command\");\n\tif (paths !== undefined && !Array.isArray(paths))\n\t\tinvalid(\"paths must be an array of repo-relative paths\");\n\treturn {\n\t\trun,\n\t\tmaxRetries: boundedInteger(\n\t\t\trequest.maxRetries,\n\t\t\t\"maxRetries\",\n\t\t\t0,\n\t\t\tACCEPT_MAX_RETRIES,\n\t\t\tACCEPT_DEFAULT_MAX_RETRIES,\n\t\t),\n\t\ttimeoutSec: boundedInteger(\n\t\t\trequest.timeoutSec,\n\t\t\t\"timeoutSec\",\n\t\t\t1,\n\t\t\tACCEPT_MAX_TIMEOUT_SEC,\n\t\t\tACCEPT_DEFAULT_TIMEOUT_SEC,\n\t\t),\n\t\tpaths: [...new Set((paths ?? []).map(normalizeCheckPath))],\n\t};\n}\n\n/**\n * v1 supports only auto-exit, non-persistent children: an interactive child\n * closes through `subagent_done`, and a persistent specialist settles per task.\n */\nexport function acceptLaunchRefusal(behavior: {\n\tpersistent: boolean;\n\tautoExit: boolean;\n}): string | undefined {\n\tif (behavior.persistent)\n\t\treturn \"accept is not supported for persistent specialists; a check would apply per task, not per run.\";\n\tif (!behavior.autoExit)\n\t\treturn \"accept requires an auto-exit child; interactive children close through subagent_done, which runs no check.\";\n\treturn undefined;\n}\n\n/** Parse the child's sidecar report; anything malformed is treated as unknown. */\nexport function parseChildAcceptReport(\n\t// Raw JSON from the child-written sidecar, typed `any` at the boundary.\n\traw: any,\n): ChildAcceptReport | undefined {\n\tif (!isRecord(raw)) return undefined;\n\tconst { tries, childVerdict, lastExitCode, timedOut } = raw;\n\tif (\n\t\t!isFiniteNumber(tries) ||\n\t\t!Number.isInteger(tries) ||\n\t\ttries < 1 ||\n\t\t(childVerdict !== \"passed\" && childVerdict !== \"failed\")\n\t)\n\t\treturn undefined;\n\tconst report: ChildAcceptReport = {\n\t\ttries,\n\t\tchildVerdict,\n\t\ttimedOut: timedOut === true,\n\t};\n\tif (isFiniteNumber(lastExitCode) && Number.isInteger(lastExitCode))\n\t\treport.lastExitCode = lastExitCode;\n\treturn report;\n}\n\nexport function acceptCheckHash(run: string): string {\n\treturn `sha256:${createHash(\"sha256\").update(run).digest(\"hex\")}`;\n}\n\n/** Changed files equal to, or under, a check path. */\nexport function changedCheckFiles(\n\tpaths: readonly string[],\n\tfiles: readonly string[],\n): string[] {\n\tif (!paths.length) return [];\n\treturn [...new Set(files)].filter((file) => {\n\t\tconst normalized = posix.normalize(file);\n\t\treturn paths.some(\n\t\t\t(path) =>\n\t\t\t\tpath === \".\" ||\n\t\t\t\tnormalized === path ||\n\t\t\t\tnormalized.startsWith(`${path}/`),\n\t\t);\n\t});\n}\n\n/** Keep the last `count` characters. */\nexport function outputTail(output: string, count: number): string {\n\treturn output.length <= count ? output : output.slice(-count);\n}\n\n/**\n * The parent re-check decides the verdict; the child's report is evidence.\n * `aborted` means an operator cancel stopped the re-check (settled default).\n */\nexport function verdictFromCommand(\n\tresult: AcceptCommandResult,\n\tspec: AcceptSpec,\n\tchild: ChildAcceptReport | undefined,\n): AcceptOutcome {\n\tconst outcome: AcceptOutcome = {\n\t\tverdict: \"error\",\n\t\tcheckHash: acceptCheckHash(spec.run),\n\t\ttimeoutSec: spec.timeoutSec,\n\t};\n\tif (child) {\n\t\toutcome.tries = child.tries;\n\t\toutcome.childVerdict = child.childVerdict;\n\t}\n\tconst tail = outputTail(result.output, ACCEPT_DETAILS_OUTPUT_CHARS);\n\tswitch (result.kind) {\n\t\tcase \"exit\":\n\t\t\toutcome.exitCode = result.exitCode;\n\t\t\toutcome.verdict = result.exitCode === 0 ? \"accepted\" : \"rejected\";\n\t\t\tbreak;\n\t\tcase \"aborted\":\n\t\t\toutcome.verdict = \"skipped\";\n\t\t\toutcome.reason = \"cancelled\";\n\t\t\tbreak;\n\t\tcase \"timeout\":\n\t\t\toutcome.reason = `timed out after ${spec.timeoutSec}s`;\n\t\t\tbreak;\n\t\tcase \"signal\":\n\t\t\toutcome.reason = `killed by signal ${result.signal}`;\n\t\t\tbreak;\n\t\tcase \"cwd-missing\":\n\t\t\toutcome.reason = \"check directory is missing\";\n\t\t\tbreak;\n\t\tcase \"spawn-error\":\n\t\t\toutcome.reason = `could not start: ${result.error}`;\n\t\t\tbreak;\n\t}\n\tif ((outcome.verdict === \"rejected\" || outcome.verdict === \"error\") && tail)\n\t\toutcome.output = tail;\n\treturn outcome;\n}\n\n/** A requested check whose run did not complete naturally is skipped. */\nexport function skippedOutcome(\n\tspec: AcceptSpec,\n\treason: string,\n): AcceptOutcome {\n\treturn {\n\t\tverdict: \"skipped\",\n\t\treason,\n\t\tcheckHash: acceptCheckHash(spec.run),\n\t\ttimeoutSec: spec.timeoutSec,\n\t};\n}\n\nfunction tries(count: number): string {\n\treturn `${count} ${count === 1 ? \"try\" : \"tries\"}`;\n}\n\n/** The verdict and its detail after `Check: `, for example `accepted (2 tries)`. */\nexport function describeAcceptVerdict(\n\toutcome: AcceptOutcome | undefined,\n): string {\n\tif (!outcome || outcome.verdict === \"none\") return \"none\";\n\tswitch (outcome.verdict) {\n\t\tcase \"accepted\":\n\t\t\tif (outcome.childVerdict === \"failed\" && outcome.tries !== undefined)\n\t\t\t\treturn `accepted (child reported a failure after ${tries(outcome.tries)}; parent re-check passed)`;\n\t\t\treturn outcome.tries === undefined\n\t\t\t\t? \"accepted\"\n\t\t\t\t: `accepted (${tries(outcome.tries)})`;\n\t\tcase \"rejected\":\n\t\t\tif (outcome.childVerdict === \"passed\")\n\t\t\t\treturn `rejected (child reported a pass; parent re-check exit ${outcome.exitCode})`;\n\t\t\treturn outcome.tries === undefined\n\t\t\t\t? `rejected (exit ${outcome.exitCode})`\n\t\t\t\t: `rejected after ${tries(outcome.tries)} (exit ${outcome.exitCode})`;\n\t\tdefault:\n\t\t\treturn outcome.reason\n\t\t\t\t? `${outcome.verdict} (${outcome.reason})`\n\t\t\t\t: outcome.verdict;\n\t}\n}\n\n/** One outcome-ledger line: never task text, check output, env, or the command. */\nexport interface OutcomeLedgerLine {\n\tv: 1;\n\tat: string;\n\trunId: string;\n\tattempt: number;\n\trole?: string;\n\trequestedModel?: string;\n\tcategory?: string;\n\tmodel?: string;\n\tthinking?: string;\n\telapsedSec: number;\n\toutcome: \"completed\" | \"failed\" | \"help\" | \"cancelled\";\n\tcheckTries?: number;\n\tverdict: AcceptVerdict;\n\tcheckHash?: string;\n}\n\nexport const OUTCOME_LEDGER_FILE = \"outcomes.jsonl\";\n\nexport function buildOutcomeLedgerLine(input: {\n\tat: number;\n\trunId: string;\n\tattempt: number;\n\trole?: string;\n\trequestedModel?: string;\n\tmodel?: string;\n\tthinking?: string;\n\telapsedSec: number;\n\toutcome: OutcomeLedgerLine[\"outcome\"];\n\taccept?: AcceptOutcome;\n}): OutcomeLedgerLine {\n\tconst line: OutcomeLedgerLine = {\n\t\tv: 1,\n\t\tat: new Date(input.at).toISOString(),\n\t\trunId: input.runId,\n\t\tattempt: input.attempt,\n\t\telapsedSec: input.elapsedSec,\n\t\toutcome: input.outcome,\n\t\tverdict: input.accept?.verdict ?? \"none\",\n\t};\n\tif (input.role) line.role = input.role;\n\tif (input.requestedModel) {\n\t\tline.requestedModel = input.requestedModel;\n\t\tconst category = /^task:(.+)$/i.exec(input.requestedModel.trim())?.[1];\n\t\tif (category) line.category = category.trim().toLowerCase();\n\t}\n\tif (input.model) line.model = input.model;\n\tif (input.thinking) line.thinking = input.thinking;\n\tif (input.accept?.tries !== undefined) line.checkTries = input.accept.tries;\n\tif (input.accept?.checkHash) line.checkHash = input.accept.checkHash;\n\treturn line;\n}\n"]}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ActivityReadResult, SubagentActivityScope, SubagentActivityState } from "./types.ts";
|
|
2
|
+
export declare function isSubagentActivityScope(value: any): value is SubagentActivityScope;
|
|
3
|
+
export declare function projectActivity(state: SubagentActivityState | undefined): ActivityReadResult;
|
|
4
|
+
//# sourceMappingURL=activity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../maestro/core/activity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,GAAG,GACR,KAAK,IAAI,qBAAqB,CAEhC;AAGD,wBAAgB,eAAe,CAC9B,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACtC,kBAAkB,CAIpB"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { isString } from "./config/type-guards.js";
|
|
2
|
+
const KNOWN_SCOPES = new Set([
|
|
3
|
+
"agent",
|
|
4
|
+
"turn",
|
|
5
|
+
"provider",
|
|
6
|
+
"streaming",
|
|
7
|
+
"tool",
|
|
8
|
+
]);
|
|
9
|
+
export function isSubagentActivityScope(value) {
|
|
10
|
+
return isString(value) && KNOWN_SCOPES.has(value);
|
|
11
|
+
}
|
|
12
|
+
// pi-herdr-agents extension
|
|
13
|
+
export function projectActivity(state) {
|
|
14
|
+
return state === undefined
|
|
15
|
+
? { ok: false, reason: "missing" }
|
|
16
|
+
: { ok: true, activity: state };
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=activity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../maestro/core/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAOnD,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAwB;IACxE,OAAO;IACP,MAAM;IACN,UAAU;IACV,WAAW;IACX,MAAM;CACN,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CACtC,KAAU;IAEV,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,eAAe,CAC9B,KAAwC;IAExC,OAAO,KAAK,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;QAClC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC","sourcesContent":["import { isString } from \"./config/type-guards.ts\";\nimport type {\n\tActivityReadResult,\n\tSubagentActivityScope,\n\tSubagentActivityState,\n} from \"./types.ts\";\n\nconst KNOWN_SCOPES: ReadonlySet<string> = new Set<SubagentActivityScope>([\n\t\"agent\",\n\t\"turn\",\n\t\"provider\",\n\t\"streaming\",\n\t\"tool\",\n]);\n\nexport function isSubagentActivityScope(\n\tvalue: any,\n): value is SubagentActivityScope {\n\treturn isString(value) && KNOWN_SCOPES.has(value);\n}\n\n// pi-herdr-agents extension\nexport function projectActivity(\n\tstate: SubagentActivityState | undefined,\n): ActivityReadResult {\n\treturn state === undefined\n\t\t? { ok: false, reason: \"missing\" }\n\t\t: { ok: true, activity: state };\n}\n"]}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Event-bus channel a child asks before it asks itself whether its task is
|
|
3
|
+
* done. A listener that knows the child is still waiting on work of its own,
|
|
4
|
+
* such as running subagents, sets `busy` synchronously.
|
|
5
|
+
*/
|
|
6
|
+
export declare const CHILD_BUSY_CHANNEL = "pi-herdr-agents:child-busy";
|
|
7
|
+
export interface ChildBusyProbe {
|
|
8
|
+
busy: boolean;
|
|
9
|
+
}
|
|
10
|
+
export interface ChildBusyEvents {
|
|
11
|
+
emit(channel: string, probe: ChildBusyProbe): void;
|
|
12
|
+
}
|
|
13
|
+
export declare function isChildBusy(events: ChildBusyEvents | undefined): boolean;
|
|
14
|
+
//# sourceMappingURL=child-busy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"child-busy.d.ts","sourceRoot":"","sources":["../../../maestro/core/child-busy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACnD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAKxE"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Event-bus channel a child asks before it asks itself whether its task is
|
|
3
|
+
* done. A listener that knows the child is still waiting on work of its own,
|
|
4
|
+
* such as running subagents, sets `busy` synchronously.
|
|
5
|
+
*/
|
|
6
|
+
export const CHILD_BUSY_CHANNEL = "pi-herdr-agents:child-busy";
|
|
7
|
+
export function isChildBusy(events) {
|
|
8
|
+
if (!events)
|
|
9
|
+
return false;
|
|
10
|
+
const probe = { busy: false };
|
|
11
|
+
events.emit(CHILD_BUSY_CHANNEL, probe);
|
|
12
|
+
return probe.busy;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=child-busy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"child-busy.js","sourceRoot":"","sources":["../../../maestro/core/child-busy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAU/D,MAAM,UAAU,WAAW,CAAC,MAAmC;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Event-bus channel a child asks before it asks itself whether its task is\n * done. A listener that knows the child is still waiting on work of its own,\n * such as running subagents, sets `busy` synchronously.\n */\nexport const CHILD_BUSY_CHANNEL = \"pi-herdr-agents:child-busy\";\n\nexport interface ChildBusyProbe {\n\tbusy: boolean;\n}\n\nexport interface ChildBusyEvents {\n\temit(channel: string, probe: ChildBusyProbe): void;\n}\n\nexport function isChildBusy(events: ChildBusyEvents | undefined): boolean {\n\tif (!events) return false;\n\tconst probe: ChildBusyProbe = { busy: false };\n\tevents.emit(CHILD_BUSY_CHANNEL, probe);\n\treturn probe.busy;\n}\n"]}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** Settings for the guidelines the host injects into the parent's system prompt. */
|
|
2
|
+
export interface GuidelinesConfig {
|
|
3
|
+
/** Ask the parent to print a roster table after the final launch. */
|
|
4
|
+
launchRoster: boolean;
|
|
5
|
+
}
|
|
6
|
+
export declare function parseGuidelinesConfig(rawConfig: any, source?: string): GuidelinesConfig;
|
|
7
|
+
export declare function loadGuidelinesConfig(configDir: string, examplePath: string): GuidelinesConfig;
|
|
8
|
+
//# sourceMappingURL=guidelines-config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guidelines-config.d.ts","sourceRoot":"","sources":["../../../../maestro/core/config/guidelines-config.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAChC,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,GAAG,EACd,MAAM,SAAgB,GACpB,gBAAgB,CAsBlB;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,gBAAgB,CAgClB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { isBoolean, isRecord } from "./type-guards.js";
|
|
4
|
+
function invalid(source, message) {
|
|
5
|
+
throw new Error(`Invalid subagent guidelines config in ${source}: ${message}`);
|
|
6
|
+
}
|
|
7
|
+
export function parseGuidelinesConfig(rawConfig, source = "config.json") {
|
|
8
|
+
if (!isRecord(rawConfig))
|
|
9
|
+
invalid(source, "root must be an object");
|
|
10
|
+
if (!Object.hasOwn(rawConfig, "guidelines"))
|
|
11
|
+
return { launchRoster: true };
|
|
12
|
+
if (!isRecord(rawConfig.guidelines)) {
|
|
13
|
+
invalid(source, "guidelines must be an object");
|
|
14
|
+
}
|
|
15
|
+
const unsupported = Object.keys(rawConfig.guidelines).filter((key) => key !== "launchRoster");
|
|
16
|
+
if (unsupported.length > 0) {
|
|
17
|
+
invalid(source, `guidelines has unsupported key(s): ${unsupported.join(", ")}`);
|
|
18
|
+
}
|
|
19
|
+
const launchRoster = Object.hasOwn(rawConfig.guidelines, "launchRoster")
|
|
20
|
+
? rawConfig.guidelines.launchRoster
|
|
21
|
+
: true;
|
|
22
|
+
if (!isBoolean(launchRoster)) {
|
|
23
|
+
invalid(source, "guidelines.launchRoster must be a boolean");
|
|
24
|
+
}
|
|
25
|
+
return { launchRoster };
|
|
26
|
+
}
|
|
27
|
+
export function loadGuidelinesConfig(configDir, examplePath) {
|
|
28
|
+
const configPath = join(configDir, "config.json");
|
|
29
|
+
let sourcePath = configPath;
|
|
30
|
+
let rawConfig;
|
|
31
|
+
try {
|
|
32
|
+
rawConfig = readFileSync(configPath, "utf8");
|
|
33
|
+
}
|
|
34
|
+
catch (error) {
|
|
35
|
+
// SAFETY: readFileSync only throws Node fs errors here, which carry code.
|
|
36
|
+
if (error.code !== "ENOENT")
|
|
37
|
+
throw error;
|
|
38
|
+
sourcePath = examplePath;
|
|
39
|
+
try {
|
|
40
|
+
rawConfig = readFileSync(examplePath, "utf8");
|
|
41
|
+
}
|
|
42
|
+
catch (exampleError) {
|
|
43
|
+
// SAFETY: readFileSync only throws Node fs errors here, which carry code.
|
|
44
|
+
if (exampleError.code === "ENOENT") {
|
|
45
|
+
throw new Error(`Missing subagent guidelines config. Expected ${configPath} or ${examplePath}.`);
|
|
46
|
+
}
|
|
47
|
+
throw exampleError;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
try {
|
|
51
|
+
return parseGuidelinesConfig(JSON.parse(rawConfig), sourcePath);
|
|
52
|
+
}
|
|
53
|
+
catch (error) {
|
|
54
|
+
if (error instanceof SyntaxError) {
|
|
55
|
+
throw new Error(`Invalid JSON in subagent config ${sourcePath}: ${error.message}`);
|
|
56
|
+
}
|
|
57
|
+
throw error;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=guidelines-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guidelines-config.js","sourceRoot":"","sources":["../../../../maestro/core/config/guidelines-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isBoolean, isRecord } from \"./type-guards.ts\";\n\n/** Settings for the guidelines the host injects into the parent's system prompt. */\nexport interface GuidelinesConfig {\n\t/** Ask the parent to print a roster table after the final launch. */\n\tlaunchRoster: boolean;\n}\n\nfunction invalid(source: string, message: string): never {\n\tthrow new Error(\n\t\t`Invalid subagent guidelines config in ${source}: ${message}`,\n\t);\n}\n\nexport function parseGuidelinesConfig(\n\trawConfig: any,\n\tsource = \"config.json\",\n): GuidelinesConfig {\n\tif (!isRecord(rawConfig)) invalid(source, \"root must be an object\");\n\tif (!Object.hasOwn(rawConfig, \"guidelines\")) return { launchRoster: true };\n\tif (!isRecord(rawConfig.guidelines)) {\n\t\tinvalid(source, \"guidelines must be an object\");\n\t}\n\tconst unsupported = Object.keys(rawConfig.guidelines).filter(\n\t\t(key) => key !== \"launchRoster\",\n\t);\n\tif (unsupported.length > 0) {\n\t\tinvalid(\n\t\t\tsource,\n\t\t\t`guidelines has unsupported key(s): ${unsupported.join(\", \")}`,\n\t\t);\n\t}\n\tconst launchRoster = Object.hasOwn(rawConfig.guidelines, \"launchRoster\")\n\t\t? rawConfig.guidelines.launchRoster\n\t\t: true;\n\tif (!isBoolean(launchRoster)) {\n\t\tinvalid(source, \"guidelines.launchRoster must be a boolean\");\n\t}\n\treturn { launchRoster };\n}\n\nexport function loadGuidelinesConfig(\n\tconfigDir: string,\n\texamplePath: string,\n): GuidelinesConfig {\n\tconst configPath = join(configDir, \"config.json\");\n\tlet sourcePath = configPath;\n\tlet rawConfig: string;\n\ttry {\n\t\trawConfig = readFileSync(configPath, \"utf8\");\n\t} catch (error) {\n\t\t// SAFETY: readFileSync only throws Node fs errors here, which carry code.\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t\tsourcePath = examplePath;\n\t\ttry {\n\t\t\trawConfig = readFileSync(examplePath, \"utf8\");\n\t\t} catch (exampleError) {\n\t\t\t// SAFETY: readFileSync only throws Node fs errors here, which carry code.\n\t\t\tif ((exampleError as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Missing subagent guidelines config. Expected ${configPath} or ${examplePath}.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow exampleError;\n\t\t}\n\t}\n\ttry {\n\t\treturn parseGuidelinesConfig(JSON.parse(rawConfig), sourcePath);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid JSON in subagent config ${sourcePath}: ${error.message}`,\n\t\t\t);\n\t\t}\n\t\tthrow error;\n\t}\n}\n"]}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export type HerdrBackend = "auto" | "legacy" | "core";
|
|
2
|
+
export declare function parseHerdrConfig(raw: any, source?: string): HerdrBackend;
|
|
3
|
+
export declare function loadHerdrConfig(configDir: string, examplePath: string): HerdrBackend;
|
|
4
|
+
export type HerdrBinding = {
|
|
5
|
+
backend: "legacy";
|
|
6
|
+
} | {
|
|
7
|
+
backend: "core";
|
|
8
|
+
socket: string;
|
|
9
|
+
parentTerminal: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function selectHerdrBinding(backend: HerdrBackend, env: NodeJS.ProcessEnv, platform?: NodeJS.Platform): HerdrBinding;
|
|
12
|
+
export declare function assertSameHerdrBinding(previous: HerdrBinding, next: HerdrBinding): void;
|
|
13
|
+
//# sourceMappingURL=herdr-config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"herdr-config.d.ts","sourceRoot":"","sources":["../../../../maestro/core/config/herdr-config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,EACR,MAAM,SAAgB,GACpB,YAAY,CAcd;AAED,wBAAgB,eAAe,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,YAAY,CAoBd;AAED,MAAM,MAAM,YAAY,GACrB;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,YAAY,CAkBd;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,YAAY,GAChB,IAAI,CAKN"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { isPlainObject } from "./type-guards.js";
|
|
4
|
+
import { HERDR_CORE_UNSUPPORTED_ON_WINDOWS } from "../platform-support.js";
|
|
5
|
+
export function parseHerdrConfig(raw, source = "config.json") {
|
|
6
|
+
const invalid = (detail) => {
|
|
7
|
+
throw new Error(`Invalid Herdr config in ${source}: ${detail}`);
|
|
8
|
+
};
|
|
9
|
+
if (!isPlainObject(raw))
|
|
10
|
+
return invalid("root must be an object");
|
|
11
|
+
if (!Object.hasOwn(raw, "herdr"))
|
|
12
|
+
return "auto";
|
|
13
|
+
if (!isPlainObject(raw.herdr))
|
|
14
|
+
return invalid("herdr must be an object");
|
|
15
|
+
if (Object.keys(raw.herdr).some((key) => key !== "backend"))
|
|
16
|
+
return invalid("herdr accepts only backend");
|
|
17
|
+
if (!Object.hasOwn(raw.herdr, "backend"))
|
|
18
|
+
return "auto";
|
|
19
|
+
const backend = raw.herdr.backend;
|
|
20
|
+
if (backend !== "auto" && backend !== "legacy" && backend !== "core")
|
|
21
|
+
return invalid('herdr.backend must be "auto", "legacy", or "core"');
|
|
22
|
+
return backend;
|
|
23
|
+
}
|
|
24
|
+
export function loadHerdrConfig(configDir, examplePath) {
|
|
25
|
+
const file = join(configDir, "config.json");
|
|
26
|
+
let text;
|
|
27
|
+
let source = file;
|
|
28
|
+
try {
|
|
29
|
+
text = readFileSync(file, "utf8");
|
|
30
|
+
}
|
|
31
|
+
catch (error) {
|
|
32
|
+
// SAFETY: Node filesystem failures expose an errno code.
|
|
33
|
+
if (error.code !== "ENOENT")
|
|
34
|
+
throw error;
|
|
35
|
+
source = examplePath;
|
|
36
|
+
text = readFileSync(source, "utf8");
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
return parseHerdrConfig(JSON.parse(text), source);
|
|
40
|
+
}
|
|
41
|
+
catch (error) {
|
|
42
|
+
throw new Error(`Cannot load Herdr config ${source}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
export function selectHerdrBinding(backend, env, platform = process.platform) {
|
|
46
|
+
if (backend === "legacy" || (backend === "auto" && !env.HC_TERMINAL_ID))
|
|
47
|
+
return { backend: "legacy" };
|
|
48
|
+
// Core would be selected. Like a malformed Core endpoint, auto in a Core
|
|
49
|
+
// terminal fails rather than falling back to legacy.
|
|
50
|
+
if (platform === "win32")
|
|
51
|
+
throw new Error(HERDR_CORE_UNSUPPORTED_ON_WINDOWS);
|
|
52
|
+
const parentTerminal = env.HC_TERMINAL_ID;
|
|
53
|
+
const socket = env.HC_TERMINAL_SOCKET || env.HC_SOCKET;
|
|
54
|
+
if (!parentTerminal ||
|
|
55
|
+
!/^t[0-9a-z]+$/.test(parentTerminal) ||
|
|
56
|
+
!socket ||
|
|
57
|
+
!socket.startsWith("/"))
|
|
58
|
+
throw new Error("Herdr Core requires a native HC_TERMINAL_ID and absolute HC_TERMINAL_SOCKET (or HC_SOCKET). Restart Pi in a local Core terminal.");
|
|
59
|
+
return { backend: "core", socket, parentTerminal };
|
|
60
|
+
}
|
|
61
|
+
export function assertSameHerdrBinding(previous, next) {
|
|
62
|
+
if (JSON.stringify(previous) !== JSON.stringify(next))
|
|
63
|
+
throw new Error("Herdr backend or endpoint changed; restart Pi before applying this binding.");
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=herdr-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"herdr-config.js","sourceRoot":"","sources":["../../../../maestro/core/config/herdr-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isPlainObject } from \"./type-guards.ts\";\nimport { HERDR_CORE_UNSUPPORTED_ON_WINDOWS } from \"../platform-support.ts\";\n\nexport type HerdrBackend = \"auto\" | \"legacy\" | \"core\";\n\nexport function parseHerdrConfig(\n\traw: any,\n\tsource = \"config.json\",\n): HerdrBackend {\n\tconst invalid = (detail: string): never => {\n\t\tthrow new Error(`Invalid Herdr config in ${source}: ${detail}`);\n\t};\n\tif (!isPlainObject(raw)) return invalid(\"root must be an object\");\n\tif (!Object.hasOwn(raw, \"herdr\")) return \"auto\";\n\tif (!isPlainObject(raw.herdr)) return invalid(\"herdr must be an object\");\n\tif (Object.keys(raw.herdr).some((key) => key !== \"backend\"))\n\t\treturn invalid(\"herdr accepts only backend\");\n\tif (!Object.hasOwn(raw.herdr, \"backend\")) return \"auto\";\n\tconst backend = raw.herdr.backend;\n\tif (backend !== \"auto\" && backend !== \"legacy\" && backend !== \"core\")\n\t\treturn invalid('herdr.backend must be \"auto\", \"legacy\", or \"core\"');\n\treturn backend;\n}\n\nexport function loadHerdrConfig(\n\tconfigDir: string,\n\texamplePath: string,\n): HerdrBackend {\n\tconst file = join(configDir, \"config.json\");\n\tlet text: string;\n\tlet source = file;\n\ttry {\n\t\ttext = readFileSync(file, \"utf8\");\n\t} catch (error) {\n\t\t// SAFETY: Node filesystem failures expose an errno code.\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t\tsource = examplePath;\n\t\ttext = readFileSync(source, \"utf8\");\n\t}\n\ttry {\n\t\treturn parseHerdrConfig(JSON.parse(text), source);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Cannot load Herdr config ${source}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\nexport type HerdrBinding =\n\t| { backend: \"legacy\" }\n\t| { backend: \"core\"; socket: string; parentTerminal: string };\n\nexport function selectHerdrBinding(\n\tbackend: HerdrBackend,\n\tenv: NodeJS.ProcessEnv,\n\tplatform: NodeJS.Platform = process.platform,\n): HerdrBinding {\n\tif (backend === \"legacy\" || (backend === \"auto\" && !env.HC_TERMINAL_ID))\n\t\treturn { backend: \"legacy\" };\n\t// Core would be selected. Like a malformed Core endpoint, auto in a Core\n\t// terminal fails rather than falling back to legacy.\n\tif (platform === \"win32\") throw new Error(HERDR_CORE_UNSUPPORTED_ON_WINDOWS);\n\tconst parentTerminal = env.HC_TERMINAL_ID;\n\tconst socket = env.HC_TERMINAL_SOCKET || env.HC_SOCKET;\n\tif (\n\t\t!parentTerminal ||\n\t\t!/^t[0-9a-z]+$/.test(parentTerminal) ||\n\t\t!socket ||\n\t\t!socket.startsWith(\"/\")\n\t)\n\t\tthrow new Error(\n\t\t\t\"Herdr Core requires a native HC_TERMINAL_ID and absolute HC_TERMINAL_SOCKET (or HC_SOCKET). Restart Pi in a local Core terminal.\",\n\t\t);\n\treturn { backend: \"core\", socket, parentTerminal };\n}\n\nexport function assertSameHerdrBinding(\n\tprevious: HerdrBinding,\n\tnext: HerdrBinding,\n): void {\n\tif (JSON.stringify(previous) !== JSON.stringify(next))\n\t\tthrow new Error(\n\t\t\t\"Herdr backend or endpoint changed; restart Pi before applying this binding.\",\n\t\t);\n}\n"]}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { type RankingBasis, type TaskCategory, type TaskPreferences, type TaskPreferencesMeta, type TaskThinkingPreferences } from "./task-model-types.ts";
|
|
2
|
+
export interface ModelConfig {
|
|
3
|
+
default?: string;
|
|
4
|
+
agents: Record<string, string>;
|
|
5
|
+
tasks?: TaskPreferences;
|
|
6
|
+
tasksThinking?: TaskThinkingPreferences;
|
|
7
|
+
tasksMeta?: TaskPreferencesMeta;
|
|
8
|
+
}
|
|
9
|
+
export declare function parseModelConfig(rawConfig: any, source?: string): ModelConfig;
|
|
10
|
+
export declare function resolveModelDefault(agentName: string | undefined, agentModel: string | undefined, config: ModelConfig): string | undefined;
|
|
11
|
+
export declare function loadModelConfig(configDir: string): ModelConfig;
|
|
12
|
+
export interface ModelConfigSnapshot {
|
|
13
|
+
config: ModelConfig;
|
|
14
|
+
/** Revision of the exact bytes `config` was parsed from. */
|
|
15
|
+
revision: string;
|
|
16
|
+
}
|
|
17
|
+
/** Parse the saved model settings and revision them from one read of the file. */
|
|
18
|
+
export declare function readModelConfigSnapshot(configDir: string): ModelConfigSnapshot;
|
|
19
|
+
/**
|
|
20
|
+
* Validate a writer call's optional ranking basis against its tasksMeta.method.
|
|
21
|
+
* Code checks shape and consistency only; it cannot prove a source was read.
|
|
22
|
+
*/
|
|
23
|
+
export declare function parseRankingBasis(value: any, method: TaskPreferencesMeta["method"]): RankingBasis;
|
|
24
|
+
export interface SavedTaskModelConfig {
|
|
25
|
+
configPath: string;
|
|
26
|
+
tasks: TaskPreferences;
|
|
27
|
+
tasksThinking?: TaskThinkingPreferences;
|
|
28
|
+
tasksMeta: TaskPreferencesMeta | undefined;
|
|
29
|
+
missingCategories: TaskCategory[];
|
|
30
|
+
/** Revision of the exact bytes this call published. */
|
|
31
|
+
configRevision: string;
|
|
32
|
+
}
|
|
33
|
+
/** Revision of an absent config file. */
|
|
34
|
+
export declare const MISSING_CONFIG_REVISION = "missing";
|
|
35
|
+
/** `sha256:<lowercase hex>` over the exact file bytes, never normalized JSON. */
|
|
36
|
+
export declare function computeConfigRevision(bytes: Uint8Array): string;
|
|
37
|
+
export declare function isConfigRevision(value: any): value is string;
|
|
38
|
+
/** Read the exact-byte revision of a config file, or `missing` when absent. */
|
|
39
|
+
export declare function readConfigRevision(configPath: string): string;
|
|
40
|
+
export type TaskModelConfigWriteErrorCode = "invalid-revision" | "stale-revision" | "busy";
|
|
41
|
+
export declare class TaskModelConfigWriteError extends Error {
|
|
42
|
+
readonly code: TaskModelConfigWriteErrorCode;
|
|
43
|
+
constructor(code: TaskModelConfigWriteErrorCode, message: string);
|
|
44
|
+
}
|
|
45
|
+
export interface WriteTaskModelConfigOptions {
|
|
46
|
+
/** Replaces category thinking when supplied; omitted preserves it for retained categories. */
|
|
47
|
+
tasksThinking?: TaskThinkingPreferences | null;
|
|
48
|
+
/** Exact precomputed replacement and real directory shown for approval. */
|
|
49
|
+
approvedWrite?: PreparedTaskModelWrite;
|
|
50
|
+
/**
|
|
51
|
+
* Exact-byte revision the caller proposed against. Omitted keeps the
|
|
52
|
+
* unconditional write; `missing` requires the file to be absent.
|
|
53
|
+
*/
|
|
54
|
+
expectedConfigRevision?: string;
|
|
55
|
+
fileOperations?: Pick<typeof import("node:fs"), "renameSync" | "writeFileSync">;
|
|
56
|
+
}
|
|
57
|
+
/** Normalize and validate a proposal without creating files or acquiring a lock. */
|
|
58
|
+
export declare function validateTaskModelProposal(configPath: string, tasks: TaskPreferences, tasksMeta: TaskPreferencesMeta, isAuthenticatedCandidate: (candidate: string) => boolean, options?: WriteTaskModelConfigOptions): ModelConfig;
|
|
59
|
+
/** Check the proposal's revision before approval and again under the write lock. */
|
|
60
|
+
export declare function assertTaskModelConfigRevision(configPath: string, expected: string | undefined, actual: string): void;
|
|
61
|
+
/** Legacy callers preserve thinking only for task categories they retain. */
|
|
62
|
+
export declare function resolveTaskThinkingPreferences(tasks: TaskPreferences | undefined, requested: TaskThinkingPreferences | undefined, previous: TaskThinkingPreferences | undefined): TaskThinkingPreferences | undefined;
|
|
63
|
+
export interface PreparedTaskModelWrite {
|
|
64
|
+
configPath: string;
|
|
65
|
+
realConfigPath: string;
|
|
66
|
+
realConfigDir: string;
|
|
67
|
+
configRevision: string;
|
|
68
|
+
before: ModelConfig;
|
|
69
|
+
after: ModelConfig;
|
|
70
|
+
output: string;
|
|
71
|
+
newFile: boolean;
|
|
72
|
+
topLevelKeys: string[];
|
|
73
|
+
}
|
|
74
|
+
/** Read and compute every byte before approval, including the minimal new-file seed. */
|
|
75
|
+
export declare function prepareTaskModelWrite(configPath: string, candidate: ModelConfig, expectedConfigRevision?: string): PreparedTaskModelWrite;
|
|
76
|
+
/** Best-effort re-read after an approved write throws; never infer that failure means no publication. */
|
|
77
|
+
export declare function describeTaskModelWriteFailure(approved: PreparedTaskModelWrite): string;
|
|
78
|
+
/**
|
|
79
|
+
* Atomically replace models.tasks, category thinking and models.tasksMeta in the durable user config.
|
|
80
|
+
* `_examplePath` is retained for positional compatibility only; missing files
|
|
81
|
+
* receive the minimal required status setting and proposed models, never an example seed.
|
|
82
|
+
*
|
|
83
|
+
* Cooperating calls use an exclusive sibling lock around snapshot validation
|
|
84
|
+
* and temporary-file publication. Non-cooperating processes can unlink it, so
|
|
85
|
+
* continued ownership is not guaranteed. It serializes cooperating writers only and
|
|
86
|
+
* cannot constrain editors or processes that ignore it. Contention and stale locks
|
|
87
|
+
* fail closed without waiting or breaking another owner's lock.
|
|
88
|
+
*/
|
|
89
|
+
export declare function writeTaskModelConfig(configPath: string, _examplePath: string, tasks: TaskPreferences, tasksMeta: TaskPreferencesMeta, isAuthenticatedCandidate: (candidate: string) => boolean, options?: WriteTaskModelConfigOptions): SavedTaskModelConfig;
|
|
90
|
+
/** Sibling advisory lock path shared by every cooperating config writer. */
|
|
91
|
+
export declare function getConfigWriteLockPath(configPath: string): string;
|
|
92
|
+
//# sourceMappingURL=model-config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model-config.d.ts","sourceRoot":"","sources":["../../../../maestro/core/config/model-config.ts"],"names":[],"mappings":"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"}
|