@apralabs/apra-fleet 0.3.5 → 0.4.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 +245 -257
- package/dist/agents/backlog-groomer.md +287 -0
- package/dist/agents/deployer.md +52 -11
- package/dist/agents/doer.md +32 -7
- package/dist/agents/integ-test-runner.md +151 -61
- package/dist/agents/plan-reviewer.md +74 -17
- package/dist/agents/planner.md +94 -14
- package/dist/agents/regression-test-runner.md +216 -0
- package/dist/agents/reviewer.md +21 -6
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +4 -0
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +44 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +604 -108
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/secret.js +8 -2
- package/dist/cli/secret.js.map +1 -1
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +109 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +179 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +13 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +62 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +10 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +21 -1
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +9 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +127 -14
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +6 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +248 -9
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +7 -0
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +8 -1
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/gemini.d.ts +3 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +11 -1
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +51 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +103 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +4 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +49 -0
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +79 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +10 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +12 -5
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +1 -0
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +56 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +111 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +8 -1
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +39 -7
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +136 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +55 -5
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +139 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +8 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/compose-permissions.d.ts +12 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +55 -4
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +11 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +22 -5
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +72 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +962 -71
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +8 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +17 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +144 -5
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +44 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +8 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +11 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +15 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +450 -87
- package/package.json +35 -7
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +396 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +857 -0
- package/packages/apra-fleet-se/bin/serve.mjs +383 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
- package/packages/apra-fleet-se/package.json +28 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/permissions.md +50 -0
- package/skills/fleet/profiles/base-dev.json +1 -0
- package/skills/fleet/profiles/base-reviewer.json +1 -0
- package/skills/fleet/profiles/node.json +2 -2
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
|
@@ -0,0 +1,371 @@
|
|
|
1
|
+
import http from 'node:http';
|
|
2
|
+
import crypto from 'node:crypto';
|
|
3
|
+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
4
|
+
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
|
|
5
|
+
import { fleetEvents } from './event-bus.js';
|
|
6
|
+
import { getOrCreateKey } from './jwt.js';
|
|
7
|
+
import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
|
|
8
|
+
import { sessionRegistry } from './session-registry.js';
|
|
9
|
+
import { getAgent, findAgentByName } from './registry.js';
|
|
10
|
+
import { DEFAULT_PORT, DEFAULT_HOST } from '../paths.js';
|
|
11
|
+
import { serverVersion } from '../version.js';
|
|
12
|
+
import { logLine } from '../utils/log-helpers.js';
|
|
13
|
+
function parseBody(req) {
|
|
14
|
+
return new Promise((resolve, reject) => {
|
|
15
|
+
const chunks = [];
|
|
16
|
+
req.on('data', (chunk) => chunks.push(chunk));
|
|
17
|
+
req.on('end', () => {
|
|
18
|
+
try {
|
|
19
|
+
const text = Buffer.concat(chunks).toString('utf8');
|
|
20
|
+
resolve(text ? JSON.parse(text) : undefined);
|
|
21
|
+
}
|
|
22
|
+
catch (err) {
|
|
23
|
+
reject(err);
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
req.on('error', reject);
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
function listenOnPort(server, port, host) {
|
|
30
|
+
return new Promise((resolve, reject) => {
|
|
31
|
+
server.listen(port, host, () => {
|
|
32
|
+
const addr = server.address();
|
|
33
|
+
resolve(addr.port);
|
|
34
|
+
});
|
|
35
|
+
server.once('error', reject);
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
function isInitializeRequest(body) {
|
|
39
|
+
if (!body)
|
|
40
|
+
return false;
|
|
41
|
+
if (Array.isArray(body)) {
|
|
42
|
+
return body.some((msg) => msg.method === 'initialize');
|
|
43
|
+
}
|
|
44
|
+
return body.method === 'initialize';
|
|
45
|
+
}
|
|
46
|
+
function extractBearer(req) {
|
|
47
|
+
const auth = req.headers.authorization;
|
|
48
|
+
if (!auth?.startsWith('Bearer '))
|
|
49
|
+
return null;
|
|
50
|
+
return auth.slice(7);
|
|
51
|
+
}
|
|
52
|
+
export async function createHttpTransport(options) {
|
|
53
|
+
const { registerTools, preferredPort } = options;
|
|
54
|
+
const sessions = new Map();
|
|
55
|
+
const startedAt = Date.now();
|
|
56
|
+
// LOW-1: Track event listener references for cleanup in close()
|
|
57
|
+
const eventCleanups = [];
|
|
58
|
+
async function handleSessionRequest(req, res) {
|
|
59
|
+
const sessionId = req.headers['mcp-session-id'];
|
|
60
|
+
if (!sessionId) {
|
|
61
|
+
res.writeHead(400);
|
|
62
|
+
res.end('Missing mcp-session-id header');
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const session = sessions.get(sessionId);
|
|
66
|
+
if (!session) {
|
|
67
|
+
res.writeHead(404);
|
|
68
|
+
res.end('Session not found');
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
await session.transport.handleRequest(req, res);
|
|
72
|
+
}
|
|
73
|
+
const httpServer = http.createServer(async (req, res) => {
|
|
74
|
+
const url = req.url ?? '/';
|
|
75
|
+
if (url === '/health' && req.method === 'GET') {
|
|
76
|
+
const body = JSON.stringify({
|
|
77
|
+
status: 'ok',
|
|
78
|
+
version: serverVersion,
|
|
79
|
+
pid: process.pid,
|
|
80
|
+
uptime: Math.floor((Date.now() - startedAt) / 1000),
|
|
81
|
+
sessions: sessions.size,
|
|
82
|
+
});
|
|
83
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
84
|
+
res.end(body);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (url === '/shutdown' && req.method === 'POST') {
|
|
88
|
+
// Admin-only endpoint: require the local signing key (~/.apra-fleet/fleet.key,
|
|
89
|
+
// mode 0o600) as a bearer token. This is not a member JWT -- it's proof the
|
|
90
|
+
// caller can read a file only the same OS user can read, matching this
|
|
91
|
+
// server's existing 127.0.0.1-only trust boundary. See apra-fleet-2xs.11.
|
|
92
|
+
const rawToken = extractBearer(req);
|
|
93
|
+
if (rawToken === null || rawToken !== getOrCreateKey()) {
|
|
94
|
+
logLine('session', 'unauthorized /shutdown attempt rejected');
|
|
95
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
96
|
+
res.end(JSON.stringify({ error: 'unauthorized' }));
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
const body = JSON.stringify({ status: 'shutting-down' });
|
|
100
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
101
|
+
res.end(body);
|
|
102
|
+
setTimeout(() => {
|
|
103
|
+
process.emit('SIGINT');
|
|
104
|
+
}, 100);
|
|
105
|
+
return;
|
|
106
|
+
}
|
|
107
|
+
if (url !== '/mcp' && !url.startsWith('/mcp?')) {
|
|
108
|
+
res.writeHead(404);
|
|
109
|
+
res.end();
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
if (req.method === 'POST') {
|
|
113
|
+
// JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
|
|
114
|
+
const rawToken = extractBearer(req);
|
|
115
|
+
const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
|
|
116
|
+
const memberParam = parsedUrl.searchParams.get('member');
|
|
117
|
+
let postClaims = null;
|
|
118
|
+
if (rawToken !== null) {
|
|
119
|
+
postClaims = getTokenIssuer().verify(rawToken);
|
|
120
|
+
if (!postClaims) {
|
|
121
|
+
logLine('session', `jwt verify failed for member_param=${memberParam ?? 'none'} url=${req.url}`);
|
|
122
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
123
|
+
res.end(JSON.stringify({ error: 'invalid token' }));
|
|
124
|
+
return;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
if (rawToken === null && memberParam !== null) {
|
|
128
|
+
logLine('session', 'member identity from URL param: ' + memberParam);
|
|
129
|
+
}
|
|
130
|
+
let parsedBody;
|
|
131
|
+
try {
|
|
132
|
+
parsedBody = await parseBody(req);
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
res.writeHead(400);
|
|
136
|
+
res.end('Bad request body');
|
|
137
|
+
return;
|
|
138
|
+
}
|
|
139
|
+
if (isInitializeRequest(parsedBody)) {
|
|
140
|
+
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
|
|
141
|
+
const body = parsedBody;
|
|
142
|
+
const clientInfo = body?.params?.clientInfo ?? {};
|
|
143
|
+
const clientCaps = body?.params?.capabilities ?? {};
|
|
144
|
+
const capKeys = Object.keys(clientCaps).join(',');
|
|
145
|
+
// apra-fleet-eft.74.1: the explicit interactive opt-in handshake. Only a
|
|
146
|
+
// client that declares the provider-branded `claude/channel` capability
|
|
147
|
+
// at initialize can receive the `notifications/claude/channel`
|
|
148
|
+
// server-push that execute_prompt's interactive routing depends on. A
|
|
149
|
+
// plain subprocess connect-back (a Doer's tool-access MCP session) still
|
|
150
|
+
// presents a valid member JWT and registers a live `server` below, but
|
|
151
|
+
// it does NOT declare this capability -- so it must never be flagged
|
|
152
|
+
// interactive-routable. Mirrors the capability the server itself
|
|
153
|
+
// advertises (experimental['claude/channel']).
|
|
154
|
+
const channelCapable = !!clientCaps
|
|
155
|
+
?.experimental?.['claude/channel'];
|
|
156
|
+
// Identity keying is unified on the member UUID. The URL ?member= param
|
|
157
|
+
// (unauthenticated local fallback) historically carried the friendly
|
|
158
|
+
// name; new URLs carry the UUID, and legacy friendly names are resolved
|
|
159
|
+
// to the UUID via the agent registry here.
|
|
160
|
+
let fallbackMemberId = null;
|
|
161
|
+
let fallbackWorkFolder = '';
|
|
162
|
+
if (postClaims === null && memberParam !== null) {
|
|
163
|
+
const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
|
|
164
|
+
fallbackMemberId = agent?.id ?? memberParam;
|
|
165
|
+
fallbackWorkFolder = agent?.workFolder ?? '';
|
|
166
|
+
if (agent && agent.id !== memberParam) {
|
|
167
|
+
logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
// Unauthenticated sessions (PM/tools, URL-param fallback) can only come
|
|
171
|
+
// from this machine (server binds 127.0.0.1), so they belong to the
|
|
172
|
+
// local workspace. Authenticated sessions use the JWT's workspace_id.
|
|
173
|
+
const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
|
|
174
|
+
const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
|
|
175
|
+
const sessionTransport = new StreamableHTTPServerTransport({
|
|
176
|
+
sessionIdGenerator: () => crypto.randomUUID(),
|
|
177
|
+
onsessioninitialized: (sid) => {
|
|
178
|
+
sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId });
|
|
179
|
+
const hasMember = !!(postClaims || fallbackMemberId);
|
|
180
|
+
logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
|
|
181
|
+
// Register interactive member session when JWT claims are present.
|
|
182
|
+
//
|
|
183
|
+
// apra-fleet-eft.28.5: carry forward the launch-time pid captured
|
|
184
|
+
// by register_member (which registered `server: null, pid: <proc>`
|
|
185
|
+
// before this connect-back). Without this, the connect-back
|
|
186
|
+
// registration overwrote that entry with pid=undefined, so the
|
|
187
|
+
// execute_prompt interactive liveness check (eft.28.1) had no PID to
|
|
188
|
+
// test and a dead-but-connected session hung the dispatch for the
|
|
189
|
+
// full timeout_s -- the exact real-fleet repro in eft.28. Preserving
|
|
190
|
+
// the pid lets the liveness check detect the dead backing process
|
|
191
|
+
// and re-dispatch fresh instead of blocking.
|
|
192
|
+
if (postClaims) {
|
|
193
|
+
// apra-fleet-eft.50.1: fall back to the durable launch-pid anchor
|
|
194
|
+
// when the live SessionState was already unregistered before this
|
|
195
|
+
// connect-back (so get()?.pid is undefined). Without this last
|
|
196
|
+
// fallback a reconnect on a dispatch RETRY re-registered with
|
|
197
|
+
// pid=undefined, blinding the interactive liveness check on
|
|
198
|
+
// attempt 2+ and reproducing eft.28's silent hang.
|
|
199
|
+
const priorPid = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id)?.pid
|
|
200
|
+
?? sessionRegistry.lastKnownPid(postClaims.workspace_id, postClaims.member_id);
|
|
201
|
+
sessionRegistry.register({
|
|
202
|
+
...postClaims,
|
|
203
|
+
server: sessionServer,
|
|
204
|
+
sessionId: sid,
|
|
205
|
+
status: 'online',
|
|
206
|
+
pid: postClaims.pid ?? priorPid,
|
|
207
|
+
channelCapable,
|
|
208
|
+
});
|
|
209
|
+
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
|
|
210
|
+
}
|
|
211
|
+
else if (fallbackMemberId) {
|
|
212
|
+
// apra-fleet-eft.50.1: same durable launch-pid fallback as the
|
|
213
|
+
// JWT branch above, so a URL-param reconnect on a retry keeps a
|
|
214
|
+
// pid for the interactive liveness check to test.
|
|
215
|
+
const priorPid = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId)?.pid
|
|
216
|
+
?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
|
|
217
|
+
sessionRegistry.register({
|
|
218
|
+
member_id: fallbackMemberId,
|
|
219
|
+
workspace_id: sessionWorkspaceId,
|
|
220
|
+
role: 'doer',
|
|
221
|
+
work_folder: fallbackWorkFolder,
|
|
222
|
+
server: sessionServer,
|
|
223
|
+
sessionId: sid,
|
|
224
|
+
status: 'online',
|
|
225
|
+
pid: priorPid,
|
|
226
|
+
channelCapable,
|
|
227
|
+
});
|
|
228
|
+
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
|
|
229
|
+
}
|
|
230
|
+
},
|
|
231
|
+
onsessionclosed: (sid) => {
|
|
232
|
+
logLine('session', `closed sid=${sid}`);
|
|
233
|
+
// LOW-2: Close the McpServer when its session closes
|
|
234
|
+
const s = sessions.get(sid);
|
|
235
|
+
if (s) {
|
|
236
|
+
s.server.server?.close().catch(() => { });
|
|
237
|
+
}
|
|
238
|
+
sessions.delete(sid);
|
|
239
|
+
// Unregister interactive member session -- but only if the registry
|
|
240
|
+
// entry still points at THIS session. If the member reconnected
|
|
241
|
+
// (new sid) before this stale session's close event fired, the
|
|
242
|
+
// registry now holds the NEW session's sessionId and must not be
|
|
243
|
+
// clobbered by the old one closing late (apra-fleet-2xs.10).
|
|
244
|
+
if (postClaims) {
|
|
245
|
+
const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
|
|
246
|
+
if (current?.sessionId === sid) {
|
|
247
|
+
sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
|
|
248
|
+
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
|
|
249
|
+
}
|
|
250
|
+
else {
|
|
251
|
+
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
else if (fallbackMemberId) {
|
|
255
|
+
const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
256
|
+
if (current?.sessionId === sid) {
|
|
257
|
+
sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
|
|
258
|
+
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
|
|
259
|
+
}
|
|
260
|
+
else {
|
|
261
|
+
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
},
|
|
265
|
+
});
|
|
266
|
+
await registerTools(sessionServer);
|
|
267
|
+
await sessionServer.connect(sessionTransport);
|
|
268
|
+
await sessionTransport.handleRequest(req, res, parsedBody);
|
|
269
|
+
return;
|
|
270
|
+
}
|
|
271
|
+
const sessionId = req.headers['mcp-session-id'];
|
|
272
|
+
if (!sessionId) {
|
|
273
|
+
res.writeHead(400);
|
|
274
|
+
res.end('Missing mcp-session-id header');
|
|
275
|
+
return;
|
|
276
|
+
}
|
|
277
|
+
const session = sessions.get(sessionId);
|
|
278
|
+
if (!session) {
|
|
279
|
+
res.writeHead(404);
|
|
280
|
+
res.end('Session not found');
|
|
281
|
+
return;
|
|
282
|
+
}
|
|
283
|
+
await session.transport.handleRequest(req, res, parsedBody);
|
|
284
|
+
return;
|
|
285
|
+
}
|
|
286
|
+
// GET and DELETE: look up session and delegate
|
|
287
|
+
if (req.method === 'GET' || req.method === 'DELETE') {
|
|
288
|
+
await handleSessionRequest(req, res);
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
res.writeHead(405);
|
|
292
|
+
res.end('Method not allowed');
|
|
293
|
+
});
|
|
294
|
+
// Subscribe to fleet events and broadcast to connected sessions in the SAME
|
|
295
|
+
// workspace only. All events on this bus originate from the local
|
|
296
|
+
// orchestrator, i.e. from the local workspace -- a session authenticated
|
|
297
|
+
// with a foreign workspace_id must never see them.
|
|
298
|
+
const fleetEventTypes = [
|
|
299
|
+
'credential:stored',
|
|
300
|
+
'task:completed',
|
|
301
|
+
'member:status-changed',
|
|
302
|
+
'stall:detected',
|
|
303
|
+
];
|
|
304
|
+
for (const eventType of fleetEventTypes) {
|
|
305
|
+
const handler = (payload) => {
|
|
306
|
+
const data = { event: eventType, ...payload };
|
|
307
|
+
const eventWorkspaceId = localWorkspaceId();
|
|
308
|
+
for (const [, session] of sessions) {
|
|
309
|
+
if (session.workspaceId !== eventWorkspaceId)
|
|
310
|
+
continue;
|
|
311
|
+
session.server.sendLoggingMessage({
|
|
312
|
+
level: 'info',
|
|
313
|
+
logger: 'apra-fleet-events',
|
|
314
|
+
data,
|
|
315
|
+
}).catch(() => { });
|
|
316
|
+
}
|
|
317
|
+
};
|
|
318
|
+
fleetEvents.on(eventType, handler);
|
|
319
|
+
// LOW-1: Store cleanup so close() can unsubscribe
|
|
320
|
+
eventCleanups.push(() => fleetEvents.off(eventType, handler));
|
|
321
|
+
}
|
|
322
|
+
// Start listening: try preferred port, fall back to OS-assigned port.
|
|
323
|
+
// Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
|
|
324
|
+
// apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
|
|
325
|
+
// logged opt-in: several unauthenticated code paths in this file (the
|
|
326
|
+
// ?member= URL-param fallback, /shutdown's admin-key check) were
|
|
327
|
+
// written assuming only same-machine callers can reach this server.
|
|
328
|
+
const targetPort = preferredPort ?? DEFAULT_PORT;
|
|
329
|
+
const bindHost = DEFAULT_HOST;
|
|
330
|
+
if (bindHost !== '127.0.0.1') {
|
|
331
|
+
logLine('session', `WARNING: binding to ${bindHost} (not loopback-only) -- unauthenticated requests (the ?member= URL-param fallback, /shutdown) are now reachable from any host that can route to this address, not just this machine. Set APRA_FLEET_HOST=127.0.0.1 (or unset it) to restore the loopback-only default.`);
|
|
332
|
+
}
|
|
333
|
+
let port;
|
|
334
|
+
try {
|
|
335
|
+
port = await listenOnPort(httpServer, targetPort, bindHost);
|
|
336
|
+
}
|
|
337
|
+
catch (err) {
|
|
338
|
+
if (err.code === 'EADDRINUSE') {
|
|
339
|
+
port = await listenOnPort(httpServer, 0, bindHost);
|
|
340
|
+
}
|
|
341
|
+
else {
|
|
342
|
+
throw err;
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
// Same-machine callers (register_member's own local MCP connection) always
|
|
346
|
+
// use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
|
|
347
|
+
// still accepts loopback connections. This is not "the LAN address";
|
|
348
|
+
// fnz.4's enrollment flow is responsible for advertising a reachable
|
|
349
|
+
// LAN/host address to the JOINING machine separately.
|
|
350
|
+
const url = `http://127.0.0.1:${port}/mcp`;
|
|
351
|
+
return {
|
|
352
|
+
httpServer,
|
|
353
|
+
port,
|
|
354
|
+
url,
|
|
355
|
+
sessions,
|
|
356
|
+
close() {
|
|
357
|
+
// LOW-1: Unsubscribe all fleet event listeners
|
|
358
|
+
for (const cleanup of eventCleanups)
|
|
359
|
+
cleanup();
|
|
360
|
+
// LOW-2: Close all active session McpServers before shutting down
|
|
361
|
+
for (const [, session] of sessions) {
|
|
362
|
+
session.server.server?.close().catch(() => { });
|
|
363
|
+
}
|
|
364
|
+
sessions.clear();
|
|
365
|
+
return new Promise((resolve, reject) => {
|
|
366
|
+
httpServer.close((err) => (err ? reject(err) : resolve()));
|
|
367
|
+
});
|
|
368
|
+
},
|
|
369
|
+
};
|
|
370
|
+
}
|
|
371
|
+
//# sourceMappingURL=http-transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-transport.js","sourceRoot":"","sources":["../../src/services/http-transport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
export interface MemberSnapshotEntry {
|
|
2
|
+
memberId: string;
|
|
3
|
+
status: string;
|
|
4
|
+
}
|
|
5
|
+
/**
|
|
6
|
+
* Shape actually delivered over the SSE stream: the raw relay_queue row
|
|
7
|
+
* (src/hub-service/relay-queue.ts's RelayEnvelope), NOT the nested
|
|
8
|
+
* from/to envelope shape used on SUBMISSION (POST /ws/:id/envelopes). The
|
|
9
|
+
* hub stores and forwards a flat row -- target_member_id and
|
|
10
|
+
* origin_member_id, not a nested `to`/`from` object -- so this type (and
|
|
11
|
+
* every reader of it) must match that flat shape, not the wire-protocol
|
|
12
|
+
* doc's submission-side JSON example.
|
|
13
|
+
*/
|
|
14
|
+
export interface InboundRelayEnvelope {
|
|
15
|
+
envelope_id: string;
|
|
16
|
+
kind: string;
|
|
17
|
+
payload: unknown;
|
|
18
|
+
correlation_id?: string | null;
|
|
19
|
+
target_member_id: string;
|
|
20
|
+
origin_member_id?: string | null;
|
|
21
|
+
}
|
|
22
|
+
export interface HubClientDeps {
|
|
23
|
+
fetch: typeof fetch;
|
|
24
|
+
now(): number;
|
|
25
|
+
setTimeout(fn: () => void, ms: number): unknown;
|
|
26
|
+
clearTimeout(handle: unknown): void;
|
|
27
|
+
random(): number;
|
|
28
|
+
hubUrl: string;
|
|
29
|
+
machineId: string;
|
|
30
|
+
workspaceId: string;
|
|
31
|
+
jwt: string;
|
|
32
|
+
getMemberSnapshot(): MemberSnapshotEntry[];
|
|
33
|
+
onEnvelope(envelope: InboundRelayEnvelope): void | Promise<void>;
|
|
34
|
+
onLog?(message: string): void;
|
|
35
|
+
}
|
|
36
|
+
/** Exponential backoff with full jitter, base 1s / cap 60s
|
|
37
|
+
* (docs/hub-spoke-wire-protocol.md section 2). `attempt` is 0-indexed
|
|
38
|
+
* consecutive failed reconnect attempts since the last successfully
|
|
39
|
+
* processed heartbeat ack. */
|
|
40
|
+
export declare function computeBackoffMs(attempt: number, random: () => number, base?: number, cap?: number): number;
|
|
41
|
+
/**
|
|
42
|
+
* Short-lived seen-envelope_id cache (wire-protocol.md section 5): tier 2
|
|
43
|
+
* must no-op a duplicate at-least-once redelivery rather than re-executing
|
|
44
|
+
* an already-completed request.
|
|
45
|
+
*/
|
|
46
|
+
export declare class SeenEnvelopeCache {
|
|
47
|
+
private ttlMs;
|
|
48
|
+
private now;
|
|
49
|
+
private seen;
|
|
50
|
+
constructor(ttlMs: number, now: () => number);
|
|
51
|
+
hasSeen(envelopeId: string): boolean;
|
|
52
|
+
markSeen(envelopeId: string): void;
|
|
53
|
+
private evict;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Incremental SSE `data:`-frame parser. Frames are separated by a blank
|
|
57
|
+
* line per the SSE spec; a frame with no `data:` line (e.g. a bare
|
|
58
|
+
* keep-alive comment) yields nothing. Malformed JSON in a data frame is
|
|
59
|
+
* skipped, not thrown -- a single corrupt frame must not kill the stream.
|
|
60
|
+
*/
|
|
61
|
+
export declare class SseFrameParser {
|
|
62
|
+
private buffer;
|
|
63
|
+
push(chunk: string): unknown[];
|
|
64
|
+
}
|
|
65
|
+
export interface HubClientHandle {
|
|
66
|
+
stop(): void;
|
|
67
|
+
}
|
|
68
|
+
export declare function createHubClient(deps: HubClientDeps): HubClientHandle;
|
|
69
|
+
//# sourceMappingURL=hub-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hub-client.d.ts","sourceRoot":"","sources":["../../src/services/hub-client.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,MAAM,IAAI,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;IAC3C,UAAU,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAOD;;;+BAG+B;AAC/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,IAAI,SAAkB,EAAE,GAAG,SAAiB,GAAG,MAAM,CAG5H;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,GAAG;IAF9C,OAAO,CAAC,IAAI,CAA6B;gBAErB,KAAK,EAAE,MAAM,EAAU,GAAG,EAAE,MAAM,MAAM;IAE5D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,KAAK;CAMd;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;CAiB/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAsIpE"}
|