@apralabs/apra-fleet 0.4.3 → 0.4.5
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 +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -5,11 +5,55 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
|
|
|
5
5
|
import { fleetEvents } from './event-bus.js';
|
|
6
6
|
import { getOrCreateKey } from './jwt.js';
|
|
7
7
|
import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
|
|
8
|
-
import { sessionRegistry } from './session-registry.js';
|
|
8
|
+
import { sessionRegistry, ORCHESTRATOR_SESSION_ID } from './session-registry.js';
|
|
9
|
+
import { FULL_TOOL_SCOPE, memberToolScope } from './tool-scope.js';
|
|
9
10
|
import { getAgent, findAgentByName } from './registry.js';
|
|
10
|
-
import {
|
|
11
|
+
import { DEFAULT_HOST, resolveServerPort } from '../paths.js';
|
|
11
12
|
import { serverVersion } from '../version.js';
|
|
12
|
-
import { logLine } from '../utils/log-helpers.js';
|
|
13
|
+
import { logLine, shortSid } from '../utils/log-helpers.js';
|
|
14
|
+
import { recordShutdown } from './server-lifecycle.js';
|
|
15
|
+
import { getOrCreateMemberAccessSecret, memberAccessSecretMatches, memberAccessSecretPath, readMemberAccessSecret, MEMBER_SECRET_HEADER } from './member-access-secret.js';
|
|
16
|
+
/** Idle bound after which a session with no open request is evicted. */
|
|
17
|
+
export const DEFAULT_SESSION_IDLE_MS = 30 * 60 * 1000;
|
|
18
|
+
const DEFAULT_IDLE_SWEEP_INTERVAL_MS = 60 * 1000;
|
|
19
|
+
/** Open-session count that triggers a one-time WARNING log line. */
|
|
20
|
+
export const DEFAULT_SESSION_COUNT_WARN = 500;
|
|
21
|
+
function positiveIntFromEnv(name, fallback) {
|
|
22
|
+
const raw = process.env[name];
|
|
23
|
+
if (raw === undefined || raw === '')
|
|
24
|
+
return fallback;
|
|
25
|
+
const n = Number(raw);
|
|
26
|
+
if (Number.isFinite(n) && n > 0)
|
|
27
|
+
return Math.floor(n);
|
|
28
|
+
logLine('session', `WARNING: ignoring ${name}=${JSON.stringify(raw)} (not a positive number); using ${fallback}`);
|
|
29
|
+
return fallback;
|
|
30
|
+
}
|
|
31
|
+
/** Why `caller` may not address a session owned by `owner`, or null when it may. */
|
|
32
|
+
export function sessionOwnerMismatch(owner, caller) {
|
|
33
|
+
if (owner.kind === 'jwt') {
|
|
34
|
+
if (caller.kind !== 'jwt')
|
|
35
|
+
return 'session was opened with a member JWT; the caller presented the access secret';
|
|
36
|
+
if (caller.memberId !== owner.memberId || caller.workspaceId !== owner.workspaceId) {
|
|
37
|
+
return 'session was opened by a different member JWT';
|
|
38
|
+
}
|
|
39
|
+
return null;
|
|
40
|
+
}
|
|
41
|
+
if (caller.kind !== 'secret')
|
|
42
|
+
return 'session was opened with the access secret; the caller presented a member JWT';
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
/** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
|
|
46
|
+
export class PortInUseError extends Error {
|
|
47
|
+
port;
|
|
48
|
+
host;
|
|
49
|
+
code = 'EADDRINUSE';
|
|
50
|
+
constructor(port, host) {
|
|
51
|
+
super(`port ${port} on ${host} is already in use`);
|
|
52
|
+
this.port = port;
|
|
53
|
+
this.host = host;
|
|
54
|
+
this.name = 'PortInUseError';
|
|
55
|
+
}
|
|
56
|
+
}
|
|
13
57
|
function parseBody(req) {
|
|
14
58
|
return new Promise((resolve, reject) => {
|
|
15
59
|
const chunks = [];
|
|
@@ -99,9 +143,70 @@ function extractBearer(req) {
|
|
|
99
143
|
export async function createHttpTransport(options) {
|
|
100
144
|
const { registerTools, preferredPort } = options;
|
|
101
145
|
const sessions = new Map();
|
|
146
|
+
const now = options.now ?? Date.now;
|
|
147
|
+
const sessionIdleMs = options.sessionIdleMs ?? positiveIntFromEnv('APRA_FLEET_SESSION_IDLE_MS', DEFAULT_SESSION_IDLE_MS);
|
|
148
|
+
const sessionCountWarn = options.sessionCountWarn ?? positiveIntFromEnv('APRA_FLEET_SESSION_COUNT_WARN', DEFAULT_SESSION_COUNT_WARN);
|
|
149
|
+
let sessionsEvicted = 0;
|
|
150
|
+
let sessionCountWarned = false;
|
|
151
|
+
// Every install has its member access secret from the first server start
|
|
152
|
+
// (install creates it too): a `?member=` request must present it.
|
|
153
|
+
const memberSecretPath = options.memberSecretPath ?? memberAccessSecretPath();
|
|
154
|
+
getOrCreateMemberAccessSecret(memberSecretPath);
|
|
102
155
|
const startedAt = Date.now();
|
|
156
|
+
// Open channel-capable FULL-scope sessions (the operator's own orchestrating
|
|
157
|
+
// sessions), oldest first. The newest holds ORCHESTRATOR_SESSION_ID in the
|
|
158
|
+
// session registry; when it closes, the id moves to the newest still open.
|
|
159
|
+
const orchestratorSessions = [];
|
|
160
|
+
function registerOrchestrator(entry) {
|
|
161
|
+
sessionRegistry.register({
|
|
162
|
+
member_id: ORCHESTRATOR_SESSION_ID,
|
|
163
|
+
workspace_id: entry.workspaceId,
|
|
164
|
+
role: 'orchestrator',
|
|
165
|
+
work_folder: '',
|
|
166
|
+
server: entry.server,
|
|
167
|
+
sessionId: entry.sid,
|
|
168
|
+
status: 'online',
|
|
169
|
+
channelCapable: true,
|
|
170
|
+
});
|
|
171
|
+
logLine('session', `registered orchestrator session as member_id=${ORCHESTRATOR_SESSION_ID} workspace_id=${entry.workspaceId} sid=${shortSid(entry.sid)}`);
|
|
172
|
+
}
|
|
103
173
|
// LOW-1: Track event listener references for cleanup in close()
|
|
104
174
|
const eventCleanups = [];
|
|
175
|
+
/** Counts `res` as an open request on `session` until its response closes. */
|
|
176
|
+
function trackRequest(session, res) {
|
|
177
|
+
session.openRequests += 1;
|
|
178
|
+
session.lastActivity = now();
|
|
179
|
+
res.once('close', () => {
|
|
180
|
+
session.openRequests = Math.max(0, session.openRequests - 1);
|
|
181
|
+
session.lastActivity = now();
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Evicts every session that has had no open request for longer than
|
|
186
|
+
* sessionIdleMs. Such a session belongs to a client that went away without
|
|
187
|
+
* an HTTP DELETE (a crash, or a transport stopped without close()): nothing
|
|
188
|
+
* can reach it again, and it would otherwise keep its McpServer forever.
|
|
189
|
+
* A client that comes back gets 404 and opens a new session, as the MCP
|
|
190
|
+
* spec requires.
|
|
191
|
+
*/
|
|
192
|
+
function sweepIdleSessions() {
|
|
193
|
+
const t = now();
|
|
194
|
+
let evicted = 0;
|
|
195
|
+
for (const [sid, s] of [...sessions]) {
|
|
196
|
+
if (s.openRequests > 0 || t - s.lastActivity <= sessionIdleMs)
|
|
197
|
+
continue;
|
|
198
|
+
logLine('session', `evicted idle sid=${shortSid(sid)} client=${s.client} idle_s=${Math.round((t - s.lastActivity) / 1000)} (no open request; the client never closed it)`);
|
|
199
|
+
s.release('idle');
|
|
200
|
+
s.transport.close().catch(() => { });
|
|
201
|
+
evicted += 1;
|
|
202
|
+
}
|
|
203
|
+
sessionsEvicted += evicted;
|
|
204
|
+
if (sessionCountWarned && sessions.size < sessionCountWarn)
|
|
205
|
+
sessionCountWarned = false;
|
|
206
|
+
return evicted;
|
|
207
|
+
}
|
|
208
|
+
const idleSweepTimer = setInterval(sweepIdleSessions, options.idleSweepIntervalMs ?? DEFAULT_IDLE_SWEEP_INTERVAL_MS);
|
|
209
|
+
idleSweepTimer.unref?.();
|
|
105
210
|
async function handleSessionRequest(req, res) {
|
|
106
211
|
const sessionId = req.headers['mcp-session-id'];
|
|
107
212
|
if (!sessionId) {
|
|
@@ -115,8 +220,42 @@ export async function createHttpTransport(options) {
|
|
|
115
220
|
res.end('Session not found');
|
|
116
221
|
return;
|
|
117
222
|
}
|
|
223
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
224
|
+
return;
|
|
225
|
+
trackRequest(session, res);
|
|
118
226
|
await session.transport.handleRequest(req, res);
|
|
119
227
|
}
|
|
228
|
+
/** The identity this request carries. Called only past the pre-route gate,
|
|
229
|
+
* so a bearer here has already verified (re-verified to read its claims). */
|
|
230
|
+
function callerIdentity(req) {
|
|
231
|
+
const bearer = extractBearer(req);
|
|
232
|
+
if (bearer !== null) {
|
|
233
|
+
const claims = getTokenIssuer().verify(bearer);
|
|
234
|
+
return claims ? { kind: 'jwt', memberId: claims.member_id, workspaceId: claims.workspace_id } : null;
|
|
235
|
+
}
|
|
236
|
+
const params = new URL(req.url ?? '/', 'http://localhost').searchParams;
|
|
237
|
+
return {
|
|
238
|
+
kind: 'secret',
|
|
239
|
+
member: params.get('member'),
|
|
240
|
+
engineOrigin: params.get('origin') === 'engine',
|
|
241
|
+
kbMaintainer: params.get('kb_maintainer') === '1',
|
|
242
|
+
};
|
|
243
|
+
}
|
|
244
|
+
/** 403 (and true) when the caller is not the identity that opened `session`;
|
|
245
|
+
* the session is left untouched and no session detail is returned. */
|
|
246
|
+
function refuseForeignCaller(req, res, sessionId, session) {
|
|
247
|
+
const caller = callerIdentity(req);
|
|
248
|
+
const why = caller ? sessionOwnerMismatch(session.owner, caller) : 'caller identity could not be verified';
|
|
249
|
+
if (why === null)
|
|
250
|
+
return false;
|
|
251
|
+
logLine('session', `rejected ${req.method} on sid=${shortSid(sessionId)}: caller=${caller?.kind ?? 'unverified'} owner=${session.owner.kind} (${why})`);
|
|
252
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
253
|
+
res.end(JSON.stringify({
|
|
254
|
+
error: 'session identity mismatch',
|
|
255
|
+
detail: `This MCP session belongs to a different caller identity (${why}). A session can be used only with the credential that opened it; open a new session instead.`,
|
|
256
|
+
}));
|
|
257
|
+
return true;
|
|
258
|
+
}
|
|
120
259
|
const httpServer = http.createServer(async (req, res) => {
|
|
121
260
|
const url = req.url ?? '/';
|
|
122
261
|
if (url === '/health' && req.method === 'GET') {
|
|
@@ -126,6 +265,8 @@ export async function createHttpTransport(options) {
|
|
|
126
265
|
pid: process.pid,
|
|
127
266
|
uptime: Math.floor((Date.now() - startedAt) / 1000),
|
|
128
267
|
sessions: sessions.size,
|
|
268
|
+
sessionsEvicted,
|
|
269
|
+
sessionIdleMs,
|
|
129
270
|
});
|
|
130
271
|
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
131
272
|
res.end(body);
|
|
@@ -144,6 +285,8 @@ export async function createHttpTransport(options) {
|
|
|
144
285
|
return;
|
|
145
286
|
}
|
|
146
287
|
const body = JSON.stringify({ status: 'shutting-down' });
|
|
288
|
+
// GitHub #585: name the real cause before re-entering the SIGINT path.
|
|
289
|
+
recordShutdown('http_shutdown');
|
|
147
290
|
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
148
291
|
res.end(body);
|
|
149
292
|
setTimeout(() => {
|
|
@@ -156,11 +299,59 @@ export async function createHttpTransport(options) {
|
|
|
156
299
|
res.end();
|
|
157
300
|
return;
|
|
158
301
|
}
|
|
302
|
+
// Every /mcp request without a member JWT must present this install's
|
|
303
|
+
// member access secret (an owner-only file in its data dir). The server
|
|
304
|
+
// binds loopback, where every local user can connect; the secret is what
|
|
305
|
+
// keeps another user's session -- or one configured for another install --
|
|
306
|
+
// out. That covers the ?member= route (a session acting as that member)
|
|
307
|
+
// AND the no-member route (a FULL-scope session, which includes command
|
|
308
|
+
// execution on this install's local members). Read per request so a
|
|
309
|
+
// replaced secret takes effect at once; a missing one refuses (never fails
|
|
310
|
+
// open). A member JWT (Authorization: Bearer) is its own credential, but
|
|
311
|
+
// only a VERIFIED one replaces the secret: any bearer that fails JWT
|
|
312
|
+
// verification is refused here for every method, so `Bearer x` cannot
|
|
313
|
+
// carry a GET (SSE stream) or DELETE (session teardown) past this gate.
|
|
314
|
+
{
|
|
315
|
+
const memberRouteParam = new URL(url, 'http://localhost').searchParams.get('member');
|
|
316
|
+
const gateBearer = extractBearer(req);
|
|
317
|
+
if (gateBearer !== null) {
|
|
318
|
+
if (!getTokenIssuer().verify(gateBearer)) {
|
|
319
|
+
logLine('session', `rejected ${req.method}: jwt verify failed member_param=${memberRouteParam ?? 'none'}`);
|
|
320
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
321
|
+
res.end(JSON.stringify({ error: 'invalid token' }));
|
|
322
|
+
return;
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
else {
|
|
326
|
+
const expected = readMemberAccessSecret(memberSecretPath);
|
|
327
|
+
if (!memberAccessSecretMatches(req.headers[MEMBER_SECRET_HEADER.toLowerCase()], expected)) {
|
|
328
|
+
const why = req.headers[MEMBER_SECRET_HEADER.toLowerCase()] === undefined ? 'missing' : 'wrong';
|
|
329
|
+
const route = memberRouteParam !== null ? 'member route' : 'full-scope route';
|
|
330
|
+
logLine('session', `rejected ${req.method} on ${route}: access secret ${why} member_param=${memberRouteParam ?? 'none'}`);
|
|
331
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
332
|
+
res.end(JSON.stringify({
|
|
333
|
+
error: memberRouteParam !== null ? 'member secret required' : 'access secret required',
|
|
334
|
+
detail: `An /mcp session must present this apra-fleet install's access secret in the ${MEMBER_SECRET_HEADER} header (the secret was ${why}). It is in member-access.key in the install's data dir, readable only by the install's user; a session configured for another install or another user is refused. Re-run 'apra-fleet install' to rewrite this machine's user-scope MCP registration (a project-scope .mcp.json cannot carry the secret: remove its apra-fleet URL entry or add the header from member-access.key in a git-ignored local config)${memberRouteParam !== null ? ', or compose_permissions / update_member with fleet_install "auto" to rewrite the member MCP config' : ''}.`,
|
|
335
|
+
}));
|
|
336
|
+
return;
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
}
|
|
159
340
|
if (req.method === 'POST') {
|
|
160
341
|
// JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
|
|
161
342
|
const rawToken = extractBearer(req);
|
|
162
343
|
const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
|
|
163
344
|
const memberParam = parsedUrl.searchParams.get('member');
|
|
345
|
+
// origin=engine: set ONLY by the engine's own member-session paths
|
|
346
|
+
// (client connectFleetMember with { origin: 'engine' }, used by memberCall
|
|
347
|
+
// and the `apra-fleet call` verb). Recorded on the session's tool scope so
|
|
348
|
+
// its kb_/code_ calls are not counted against the member.
|
|
349
|
+
const engineOrigin = parsedUrl.searchParams.get('origin') === 'engine';
|
|
350
|
+
// kb_maintainer=1: the engine's kb_maintainer grant (client
|
|
351
|
+
// connectFleetMember with { origin: 'engine', kbMaintainer: true }, used
|
|
352
|
+
// by memberCall for the member it chose as a repository's kb_maintainer).
|
|
353
|
+
// Honoured only with origin=engine; see memberToolScope.
|
|
354
|
+
const kbMaintainerParam = parsedUrl.searchParams.get('kb_maintainer') === '1';
|
|
164
355
|
let postClaims = null;
|
|
165
356
|
if (rawToken !== null) {
|
|
166
357
|
postClaims = getTokenIssuer().verify(rawToken);
|
|
@@ -184,7 +375,10 @@ export async function createHttpTransport(options) {
|
|
|
184
375
|
return;
|
|
185
376
|
}
|
|
186
377
|
if (isInitializeRequest(parsedBody)) {
|
|
187
|
-
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
|
|
378
|
+
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'} engine_origin=${engineOrigin} kb_maintainer=${kbMaintainerParam}`);
|
|
379
|
+
if (kbMaintainerParam && !engineOrigin) {
|
|
380
|
+
logLine('session', 'kb_maintainer=1 without origin=engine ignored: the grant is engine-only');
|
|
381
|
+
}
|
|
188
382
|
const body = parsedBody;
|
|
189
383
|
const clientInfo = body?.params?.clientInfo ?? {};
|
|
190
384
|
const clientCaps = body?.params?.capabilities ?? {};
|
|
@@ -204,13 +398,23 @@ export async function createHttpTransport(options) {
|
|
|
204
398
|
// (unauthenticated local fallback) historically carried the friendly
|
|
205
399
|
// name; new URLs carry the UUID, and legacy friendly names are resolved
|
|
206
400
|
// to the UUID via the agent registry here.
|
|
401
|
+
//
|
|
402
|
+
// The param must name a REGISTERED member: an id that resolves through
|
|
403
|
+
// neither getAgent nor findAgentByName is refused with 403 rather than
|
|
404
|
+
// conjuring a member identity (and a member session) from a raw string.
|
|
207
405
|
let fallbackMemberId = null;
|
|
208
406
|
let fallbackWorkFolder = '';
|
|
209
407
|
if (postClaims === null && memberParam !== null) {
|
|
210
408
|
const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
409
|
+
if (!agent) {
|
|
410
|
+
logLine('session', `rejected initialize: unknown member_param=${memberParam}`);
|
|
411
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
412
|
+
res.end(JSON.stringify({ error: 'unknown member' }));
|
|
413
|
+
return;
|
|
414
|
+
}
|
|
415
|
+
fallbackMemberId = agent.id;
|
|
416
|
+
fallbackWorkFolder = agent.workFolder ?? '';
|
|
417
|
+
if (agent.id !== memberParam) {
|
|
214
418
|
logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
|
|
215
419
|
}
|
|
216
420
|
}
|
|
@@ -218,13 +422,96 @@ export async function createHttpTransport(options) {
|
|
|
218
422
|
// from this machine (server binds 127.0.0.1), so they belong to the
|
|
219
423
|
// local workspace. Authenticated sessions use the JWT's workspace_id.
|
|
220
424
|
const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
|
|
425
|
+
// Tool scope from the identity resolved above. A valid member JWT (a
|
|
426
|
+
// doer subprocess connect-back or an interactive member) or a
|
|
427
|
+
// registered ?member= makes this a MEMBER session: the base member
|
|
428
|
+
// allowlist, plus the channel tools (respond_to_message) only when the
|
|
429
|
+
// client declared claude/channel. No member identity at all is the
|
|
430
|
+
// local orchestrator/PM/tool session and keeps the FULL set.
|
|
431
|
+
const sessionMemberId = postClaims?.member_id ?? fallbackMemberId;
|
|
432
|
+
const toolScope = sessionMemberId
|
|
433
|
+
? memberToolScope(sessionMemberId, channelCapable, engineOrigin, kbMaintainerParam)
|
|
434
|
+
: FULL_TOOL_SCOPE;
|
|
435
|
+
const sessionOwner = postClaims
|
|
436
|
+
? { kind: 'jwt', memberId: postClaims.member_id, workspaceId: postClaims.workspace_id }
|
|
437
|
+
: { kind: 'secret', member: fallbackMemberId, engineOrigin, kbMaintainer: kbMaintainerParam };
|
|
221
438
|
const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
|
|
439
|
+
// Everything this session holds, released exactly once: by an HTTP
|
|
440
|
+
// DELETE (onsessionclosed) or by idle eviction (sweepIdleSessions).
|
|
441
|
+
let released = false;
|
|
442
|
+
const releaseSession = (sid, reason) => {
|
|
443
|
+
if (released)
|
|
444
|
+
return;
|
|
445
|
+
released = true;
|
|
446
|
+
if (reason === 'closed')
|
|
447
|
+
logLine('session', `closed sid=${shortSid(sid)}`);
|
|
448
|
+
// LOW-2: Close the McpServer when its session closes
|
|
449
|
+
sessionServer.server?.close().catch(() => { });
|
|
450
|
+
sessions.delete(sid);
|
|
451
|
+
// Unregister interactive member session -- but only if the registry
|
|
452
|
+
// entry still points at THIS session. If the member reconnected
|
|
453
|
+
// (new sid) before this stale session's close event fired, the
|
|
454
|
+
// registry now holds the NEW session's sessionId and must not be
|
|
455
|
+
// clobbered by the old one closing late (apra-fleet-2xs.10).
|
|
456
|
+
if (postClaims) {
|
|
457
|
+
const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
|
|
458
|
+
if (current?.sessionId === sid) {
|
|
459
|
+
sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
|
|
460
|
+
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${shortSid(sid)}`);
|
|
461
|
+
}
|
|
462
|
+
else {
|
|
463
|
+
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
else if (fallbackMemberId && channelCapable) {
|
|
467
|
+
// A tool-only ?member= session never registered (see
|
|
468
|
+
// onsessioninitialized), so it never unregisters either.
|
|
469
|
+
const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
470
|
+
if (current?.sessionId === sid) {
|
|
471
|
+
sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
|
|
472
|
+
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${shortSid(sid)}`);
|
|
473
|
+
}
|
|
474
|
+
else {
|
|
475
|
+
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
else if (channelCapable) {
|
|
479
|
+
const idx = orchestratorSessions.findIndex((o) => o.sid === sid);
|
|
480
|
+
if (idx !== -1)
|
|
481
|
+
orchestratorSessions.splice(idx, 1);
|
|
482
|
+
const current = sessionRegistry.get(sessionWorkspaceId, ORCHESTRATOR_SESSION_ID);
|
|
483
|
+
if (current?.sessionId === sid) {
|
|
484
|
+
// Hand the id to the newest orchestrating session still open
|
|
485
|
+
// in this workspace, else drop it.
|
|
486
|
+
const next = [...orchestratorSessions].reverse().find((o) => o.workspaceId === sessionWorkspaceId);
|
|
487
|
+
if (next)
|
|
488
|
+
registerOrchestrator(next);
|
|
489
|
+
else {
|
|
490
|
+
sessionRegistry.unregister(sessionWorkspaceId, ORCHESTRATOR_SESSION_ID);
|
|
491
|
+
logLine('session', `unregistered orchestrator session sid=${shortSid(sid)}`);
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
}
|
|
495
|
+
};
|
|
222
496
|
const sessionTransport = new StreamableHTTPServerTransport({
|
|
223
497
|
sessionIdGenerator: () => crypto.randomUUID(),
|
|
224
498
|
onsessioninitialized: (sid) => {
|
|
225
|
-
sessions.set(sid, {
|
|
499
|
+
sessions.set(sid, {
|
|
500
|
+
server: sessionServer,
|
|
501
|
+
transport: sessionTransport,
|
|
502
|
+
workspaceId: sessionWorkspaceId,
|
|
503
|
+
owner: sessionOwner,
|
|
504
|
+
client: `${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'}`,
|
|
505
|
+
lastActivity: now(),
|
|
506
|
+
openRequests: 0,
|
|
507
|
+
release: (reason) => releaseSession(sid, reason),
|
|
508
|
+
});
|
|
509
|
+
if (!sessionCountWarned && sessions.size >= sessionCountWarn) {
|
|
510
|
+
sessionCountWarned = true;
|
|
511
|
+
logLine('session', `WARNING: ${sessions.size} open MCP sessions (threshold ${sessionCountWarn}). A client is likely opening sessions without closing them (HTTP DELETE); sessions idle over ${Math.round(sessionIdleMs / 1000)}s are evicted. GET /health shows sessions and sessionsEvicted.`);
|
|
512
|
+
}
|
|
226
513
|
const hasMember = !!(postClaims || fallbackMemberId);
|
|
227
|
-
logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
|
|
514
|
+
logLine('session', `new sid=${shortSid(sid)} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember} scope=${toolScope.kind}`);
|
|
228
515
|
// Register interactive member session when JWT claims are present.
|
|
229
516
|
//
|
|
230
517
|
// apra-fleet-eft.28.5: carry forward the launch-time pid captured
|
|
@@ -253,13 +540,28 @@ export async function createHttpTransport(options) {
|
|
|
253
540
|
pid: postClaims.pid ?? priorPid,
|
|
254
541
|
channelCapable,
|
|
255
542
|
});
|
|
256
|
-
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
|
|
543
|
+
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
257
544
|
}
|
|
258
545
|
else if (fallbackMemberId) {
|
|
259
546
|
// apra-fleet-eft.50.1: same durable launch-pid fallback as the
|
|
260
547
|
// JWT branch above, so a URL-param reconnect on a retry keeps a
|
|
261
548
|
// pid for the interactive liveness check to test.
|
|
262
|
-
|
|
549
|
+
if (!channelCapable) {
|
|
550
|
+
// A tool-only member session (apra-fleet call, memberCall, a
|
|
551
|
+
// non-interactive agent's per-folder MCP entry) never touches
|
|
552
|
+
// the session registry. The registry entry is the member's
|
|
553
|
+
// interactive routing target: send_message pushes channel
|
|
554
|
+
// notifications to its server, and execute_prompt reads its
|
|
555
|
+
// launch-time pid. Registering here would replace a launch
|
|
556
|
+
// placeholder (server:null, pid set) or a missing entry with a
|
|
557
|
+
// session that cannot receive those pushes; onsessionclosed
|
|
558
|
+
// skips it for the same reason.
|
|
559
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
560
|
+
logLine('session', `tool-only member session member_id=${fallbackMemberId} sid=${shortSid(sid)} not registered (registry entry ${existing ? 'sid=' + shortSid(existing.sessionId) : 'absent'} left as is)`);
|
|
561
|
+
return;
|
|
562
|
+
}
|
|
563
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
564
|
+
const priorPid = existing?.pid
|
|
263
565
|
?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
|
|
264
566
|
sessionRegistry.register({
|
|
265
567
|
member_id: fallbackMemberId,
|
|
@@ -272,45 +574,21 @@ export async function createHttpTransport(options) {
|
|
|
272
574
|
pid: priorPid,
|
|
273
575
|
channelCapable,
|
|
274
576
|
});
|
|
275
|
-
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
|
|
276
|
-
}
|
|
277
|
-
},
|
|
278
|
-
onsessionclosed: (sid) => {
|
|
279
|
-
logLine('session', `closed sid=${sid}`);
|
|
280
|
-
// LOW-2: Close the McpServer when its session closes
|
|
281
|
-
const s = sessions.get(sid);
|
|
282
|
-
if (s) {
|
|
283
|
-
s.server.server?.close().catch(() => { });
|
|
577
|
+
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
284
578
|
}
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
if (current?.sessionId === sid) {
|
|
294
|
-
sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
|
|
295
|
-
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
|
|
296
|
-
}
|
|
297
|
-
else {
|
|
298
|
-
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
|
|
299
|
-
}
|
|
300
|
-
}
|
|
301
|
-
else if (fallbackMemberId) {
|
|
302
|
-
const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
303
|
-
if (current?.sessionId === sid) {
|
|
304
|
-
sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
|
|
305
|
-
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
|
|
306
|
-
}
|
|
307
|
-
else {
|
|
308
|
-
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId ?? 'none'})`);
|
|
309
|
-
}
|
|
579
|
+
else if (channelCapable) {
|
|
580
|
+
// No member identity + claude/channel declared: the operator's
|
|
581
|
+
// own orchestrating session. Make it addressable by send_message
|
|
582
|
+
// under the stable ORCHESTRATOR_SESSION_ID (newest wins), so a
|
|
583
|
+
// sprint's needs-decision message can reach it.
|
|
584
|
+
const entry = { sid, workspaceId: sessionWorkspaceId, server: sessionServer };
|
|
585
|
+
orchestratorSessions.push(entry);
|
|
586
|
+
registerOrchestrator(entry);
|
|
310
587
|
}
|
|
311
588
|
},
|
|
589
|
+
onsessionclosed: (sid) => releaseSession(sid, 'closed'),
|
|
312
590
|
});
|
|
313
|
-
await registerTools(sessionServer);
|
|
591
|
+
await registerTools(sessionServer, toolScope);
|
|
314
592
|
await sessionServer.connect(sessionTransport);
|
|
315
593
|
await sessionTransport.handleRequest(req, res, parsedBody);
|
|
316
594
|
return;
|
|
@@ -327,6 +605,9 @@ export async function createHttpTransport(options) {
|
|
|
327
605
|
res.end('Session not found');
|
|
328
606
|
return;
|
|
329
607
|
}
|
|
608
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
609
|
+
return;
|
|
610
|
+
trackRequest(session, res);
|
|
330
611
|
await session.transport.handleRequest(req, res, parsedBody);
|
|
331
612
|
return;
|
|
332
613
|
}
|
|
@@ -366,28 +647,33 @@ export async function createHttpTransport(options) {
|
|
|
366
647
|
// LOW-1: Store cleanup so close() can unsubscribe
|
|
367
648
|
eventCleanups.push(() => fleetEvents.off(eventType, handler));
|
|
368
649
|
}
|
|
369
|
-
// Start listening
|
|
650
|
+
// Start listening on the preferred port (no fallback, see below).
|
|
370
651
|
// Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
|
|
371
652
|
// apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
|
|
372
653
|
// logged opt-in: several unauthenticated code paths in this file (the
|
|
373
654
|
// ?member= URL-param fallback, /shutdown's admin-key check) were
|
|
374
655
|
// written assuming only same-machine callers can reach this server.
|
|
375
|
-
const targetPort = preferredPort ??
|
|
656
|
+
const targetPort = preferredPort ?? resolveServerPort();
|
|
376
657
|
const bindHost = DEFAULT_HOST;
|
|
377
658
|
if (bindHost !== '127.0.0.1') {
|
|
378
659
|
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.`);
|
|
379
660
|
}
|
|
661
|
+
// A busy configured port is a hard error (GitHub #584): there is no
|
|
662
|
+
// fallback to an OS-assigned port, because every configured MCP client only
|
|
663
|
+
// knows the configured port -- a silently re-homed server is unreachable and
|
|
664
|
+
// splits the fleet in two on one data dir. An explicit port 0 (callers that
|
|
665
|
+
// ask for an ephemeral port) is unaffected.
|
|
380
666
|
let port;
|
|
381
667
|
try {
|
|
382
668
|
port = await listenOnPort(httpServer, targetPort, bindHost);
|
|
383
669
|
}
|
|
384
670
|
catch (err) {
|
|
671
|
+
for (const cleanup of eventCleanups)
|
|
672
|
+
cleanup();
|
|
385
673
|
if (err.code === 'EADDRINUSE') {
|
|
386
|
-
|
|
387
|
-
}
|
|
388
|
-
else {
|
|
389
|
-
throw err;
|
|
674
|
+
throw new PortInUseError(targetPort, bindHost);
|
|
390
675
|
}
|
|
676
|
+
throw err;
|
|
391
677
|
}
|
|
392
678
|
// Same-machine callers (register_member's own local MCP connection) always
|
|
393
679
|
// use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
|
|
@@ -400,7 +686,9 @@ export async function createHttpTransport(options) {
|
|
|
400
686
|
port,
|
|
401
687
|
url,
|
|
402
688
|
sessions,
|
|
689
|
+
sweepIdleSessions,
|
|
403
690
|
close() {
|
|
691
|
+
clearInterval(idleSweepTimer);
|
|
404
692
|
// LOW-1: Unsubscribe all fleet event listeners
|
|
405
693
|
for (const cleanup of eventCleanups)
|
|
406
694
|
cleanup();
|
|
@@ -409,6 +697,13 @@ export async function createHttpTransport(options) {
|
|
|
409
697
|
session.server.server?.close().catch(() => { });
|
|
410
698
|
}
|
|
411
699
|
sessions.clear();
|
|
700
|
+
// Drop an orchestrator registry entry that points at one of this
|
|
701
|
+
// transport's sessions: its server is closed and can never answer.
|
|
702
|
+
for (const o of orchestratorSessions.splice(0)) {
|
|
703
|
+
if (sessionRegistry.get(o.workspaceId, ORCHESTRATOR_SESSION_ID)?.sessionId === o.sid) {
|
|
704
|
+
sessionRegistry.unregister(o.workspaceId, ORCHESTRATOR_SESSION_ID);
|
|
705
|
+
}
|
|
706
|
+
}
|
|
412
707
|
return new Promise((resolve, reject) => {
|
|
413
708
|
httpServer.close((err) => (err ? reject(err) : resolve()));
|
|
414
709
|
});
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
export type KbToolProfileName = 'full' | 'developer' | 'custom';
|
|
2
|
+
export declare const KB_TOOL_PROFILE_NAMES: readonly KbToolProfileName[];
|
|
3
|
+
/** The resolved install-wide profile. `tools` is set only for custom. */
|
|
4
|
+
export type KbToolProfile = {
|
|
5
|
+
name: 'full';
|
|
6
|
+
} | {
|
|
7
|
+
name: 'developer';
|
|
8
|
+
} | {
|
|
9
|
+
name: 'custom';
|
|
10
|
+
tools: readonly string[];
|
|
11
|
+
};
|
|
12
|
+
export declare const FULL_KB_TOOL_PROFILE: KbToolProfile;
|
|
13
|
+
/** The kb_* tools the developer profile serves. */
|
|
14
|
+
export declare const DEVELOPER_KB_TOOLS: readonly string[];
|
|
15
|
+
/** Every registered kb_* tool name (the only names a custom list may hold). */
|
|
16
|
+
export declare function registeredKbToolNames(): string[];
|
|
17
|
+
export declare function isKbToolName(name: string): boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Validate a custom tool list: non-empty, and every entry a registered kb_*
|
|
20
|
+
* tool name. Throws an Error naming the unknown entries and the valid ones.
|
|
21
|
+
* Returns the list de-duplicated, in the caller's order.
|
|
22
|
+
*/
|
|
23
|
+
export declare function validateCustomKbTools(tools: readonly unknown[]): string[];
|
|
24
|
+
/**
|
|
25
|
+
* Build a profile from its name and (for custom) its list, validating both.
|
|
26
|
+
* Throws a clear Error on an unknown profile name or an invalid custom list.
|
|
27
|
+
*/
|
|
28
|
+
export declare function makeKbToolProfile(name: unknown, tools?: readonly unknown[]): KbToolProfile;
|
|
29
|
+
/**
|
|
30
|
+
* True when `name` may be registered on a FULL session under `profile`.
|
|
31
|
+
* Non-kb tools are always allowed.
|
|
32
|
+
*/
|
|
33
|
+
export declare function kbToolAllowedByProfile(name: string, profile: KbToolProfile): boolean;
|
|
34
|
+
/** One-line human description, e.g. for the CLI. */
|
|
35
|
+
export declare function describeKbToolProfile(profile: KbToolProfile): string;
|
|
36
|
+
//# sourceMappingURL=kb-tool-profile.d.ts.map
|