@apralabs/apra-fleet 0.4.2 → 0.4.4
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 +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- 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 +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- 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 +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- 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 +59 -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 +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- 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 +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- 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 +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- 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 +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -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 +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -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 +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- 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 +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -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 +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -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 +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -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/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -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 +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -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/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 +287 -40
- 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 +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- 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 +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- 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 +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -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 +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -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 +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -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 +108 -22
- 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 +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- 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/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- 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 +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- 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 +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- 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 +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -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 +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -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 +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -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 +474 -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 +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.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/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/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-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/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/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/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/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
|
@@ -64,13 +64,26 @@ export function mapAccessLevel(level) {
|
|
|
64
64
|
// POST /access_tokens call 422s. Scoped to 'issues' and 'full' since those
|
|
65
65
|
// are the community/collaboration-oriented levels; 'read'/'push'/'push+pr'/
|
|
66
66
|
// 'admin' stay code-access-only.
|
|
67
|
+
//
|
|
68
|
+
// 'workflows' is likewise a fine-grained GitHub App permission (distinct
|
|
69
|
+
// from 'actions') that gates pushing changes to .github/workflows/**.
|
|
70
|
+
// Requesting it here only succeeds once the App's own permission set
|
|
71
|
+
// includes Workflows and the installation has accepted that grant --
|
|
72
|
+
// same constraint as 'discussions' above. Granted on 'push', 'push+pr',
|
|
73
|
+
// 'admin' and 'full' (any level that can push commits), since without it
|
|
74
|
+
// GitHub rejects any push touching workflow files with "refusing to allow
|
|
75
|
+
// a GitHub App to create or update workflow ... without workflows
|
|
76
|
+
// permission", regardless of git_access level.
|
|
77
|
+
//
|
|
78
|
+
// 'actions' on 'push+pr' lets the agent re-run failed CI jobs
|
|
79
|
+
// (gh run rerun --failed) on its own PRs.
|
|
67
80
|
const levels = {
|
|
68
81
|
read: { contents: 'read', metadata: 'read' },
|
|
69
|
-
push: { contents: 'write', metadata: 'read' },
|
|
70
|
-
'push+pr': { contents: 'write', pull_requests: 'write', metadata: 'read' },
|
|
71
|
-
admin: { contents: 'write', administration: 'write', actions: 'write', metadata: 'read' },
|
|
82
|
+
push: { contents: 'write', metadata: 'read', workflows: 'write' },
|
|
83
|
+
'push+pr': { contents: 'write', pull_requests: 'write', metadata: 'read', workflows: 'write', actions: 'write' },
|
|
84
|
+
admin: { contents: 'write', administration: 'write', actions: 'write', metadata: 'read', workflows: 'write' },
|
|
72
85
|
issues: { issues: 'write', pull_requests: 'write', discussions: 'write', metadata: 'read' },
|
|
73
|
-
full: { contents: 'write', administration: 'write', issues: 'write', pull_requests: 'write', actions: 'write', discussions: 'write', metadata: 'read' },
|
|
86
|
+
full: { contents: 'write', administration: 'write', issues: 'write', pull_requests: 'write', actions: 'write', discussions: 'write', metadata: 'read', workflows: 'write' },
|
|
74
87
|
};
|
|
75
88
|
return levels[level] ?? levels.read;
|
|
76
89
|
}
|
|
@@ -99,6 +112,21 @@ export async function mintGitToken(appId, privateKey, installationId, repos, per
|
|
|
99
112
|
});
|
|
100
113
|
const data = await res.json();
|
|
101
114
|
if (!res.ok) {
|
|
115
|
+
// GitHub returns 422 (not 403) when the installation token request asks
|
|
116
|
+
// for a permission the App's own permission set doesn't grant -- e.g.
|
|
117
|
+
// "The permission 'workflows' is not granted to this installation" or
|
|
118
|
+
// the generic "The permissions requested are not granted to this
|
|
119
|
+
// installation.". Surface an actionable, operator-facing referral naming
|
|
120
|
+
// the requested permission(s) and the App/installation involved, instead
|
|
121
|
+
// of the raw API text -- and do NOT retry with a reduced permission set;
|
|
122
|
+
// silently dropping permissions would mask the misconfiguration.
|
|
123
|
+
if (res.status === 422 && typeof data?.message === 'string' && /permission/i.test(data.message)) {
|
|
124
|
+
const requested = Object.keys(permissions).join(', ');
|
|
125
|
+
throw new Error(`GitHub App ${appId} (installation ${installationId}) is not granted one or more of the requested ` +
|
|
126
|
+
`permissions [${requested}]: ${data.message} An org admin must grant these permissions under the ` +
|
|
127
|
+
`App's settings (GitHub -> Settings -> Developer settings -> GitHub Apps -> [this app] -> Permissions & events), ` +
|
|
128
|
+
`then accept the resulting installation permission-update request, before this operation can succeed.`);
|
|
129
|
+
}
|
|
102
130
|
throw new Error(`Token mint failed (${res.status}): ${data?.message ?? 'unknown error'}`);
|
|
103
131
|
}
|
|
104
132
|
return { token: data.token, expiresAt: data.expires_at };
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import http from 'node:http';
|
|
2
2
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
3
3
|
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
|
|
4
|
+
import { type ToolScope } from './tool-scope.js';
|
|
4
5
|
interface Session {
|
|
5
6
|
server: McpServer;
|
|
6
7
|
transport: StreamableHTTPServerTransport;
|
|
@@ -8,10 +9,57 @@ interface Session {
|
|
|
8
9
|
* else the local workspace (127.0.0.1-only trust boundary). Event broadcast
|
|
9
10
|
* is scoped by this -- events never cross a workspace wall. */
|
|
10
11
|
workspaceId: string;
|
|
12
|
+
/** Identity that opened this session (see SessionOwner). Every later
|
|
13
|
+
* GET/DELETE/POST on the session id must come from the same identity. */
|
|
14
|
+
owner: SessionOwner;
|
|
11
15
|
}
|
|
16
|
+
/**
|
|
17
|
+
* The identity a /mcp request carries, derived the same way at initialize and
|
|
18
|
+
* on every later request on that session:
|
|
19
|
+
* - `jwt`: a VERIFIED member JWT (Authorization: Bearer); bound by its
|
|
20
|
+
* member_id + workspace_id claims.
|
|
21
|
+
* - `secret`: no bearer, so the pre-route gate already required this
|
|
22
|
+
* install's access secret (X-Apra-Fleet-Member-Secret). `member` is the
|
|
23
|
+
* resolved ?member= id at initialize (null for a FULL-scope session).
|
|
24
|
+
*
|
|
25
|
+
* Binding rule (apra-fleet-b4g.138.6): a JWT caller may address only a
|
|
26
|
+
* session opened with a JWT for the same member and workspace; an access-secret
|
|
27
|
+
* caller may address only a session opened with the access secret. Within the
|
|
28
|
+
* secret kind any secret-opened session is addressable, whatever ?member= the
|
|
29
|
+
* opener used: the secret holder can open a FULL-scope session (a superset of
|
|
30
|
+
* every member session) at will, and ?member= is an unauthenticated label, so
|
|
31
|
+
* binding on it would add no security boundary while breaking clients whose
|
|
32
|
+
* later requests do not repeat the initialize URL's query string.
|
|
33
|
+
*/
|
|
34
|
+
export type SessionOwner = {
|
|
35
|
+
kind: 'jwt';
|
|
36
|
+
memberId: string;
|
|
37
|
+
workspaceId: string;
|
|
38
|
+
} | {
|
|
39
|
+
kind: 'secret';
|
|
40
|
+
member: string | null;
|
|
41
|
+
engineOrigin: boolean;
|
|
42
|
+
kbMaintainer: boolean;
|
|
43
|
+
};
|
|
44
|
+
/** Why `caller` may not address a session owned by `owner`, or null when it may. */
|
|
45
|
+
export declare function sessionOwnerMismatch(owner: SessionOwner, caller: SessionOwner): string | null;
|
|
12
46
|
export interface HttpTransportOptions {
|
|
13
|
-
|
|
47
|
+
/** Registers the tool surface for ONE session. `scope` is derived from the
|
|
48
|
+
* session's identity at initialize (see the initialize branch): MEMBER for
|
|
49
|
+
* a valid member JWT or a registered ?member=, FULL otherwise. An
|
|
50
|
+
* implementation that ignores it registers whatever it always did. */
|
|
51
|
+
registerTools: (server: McpServer, scope: ToolScope) => void | Promise<void>;
|
|
14
52
|
preferredPort?: number;
|
|
53
|
+
/** The member access secret file a `?member=` request is checked against
|
|
54
|
+
* (default: <data dir>/member-access.key; created when missing). */
|
|
55
|
+
memberSecretPath?: string;
|
|
56
|
+
}
|
|
57
|
+
/** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
|
|
58
|
+
export declare class PortInUseError extends Error {
|
|
59
|
+
readonly port: number;
|
|
60
|
+
readonly host: string;
|
|
61
|
+
readonly code = "EADDRINUSE";
|
|
62
|
+
constructor(port: number, host: string);
|
|
15
63
|
}
|
|
16
64
|
export interface HttpTransportHandle {
|
|
17
65
|
httpServer: http.Server;
|
|
@@ -20,6 +68,7 @@ export interface HttpTransportHandle {
|
|
|
20
68
|
sessions: Map<string, Session>;
|
|
21
69
|
close(): Promise<void>;
|
|
22
70
|
}
|
|
71
|
+
export declare function isFetchBlockedPort(port: number): boolean;
|
|
23
72
|
export declare function createHttpTransport(options: HttpTransportOptions): Promise<HttpTransportHandle>;
|
|
24
73
|
export {};
|
|
25
74
|
//# sourceMappingURL=http-transport.d.ts.map
|
|
@@ -6,10 +6,39 @@ import { fleetEvents } from './event-bus.js';
|
|
|
6
6
|
import { getOrCreateKey } from './jwt.js';
|
|
7
7
|
import { getTokenIssuer, localWorkspaceId } from './token-issuer.js';
|
|
8
8
|
import { sessionRegistry } 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
|
+
/** Why `caller` may not address a session owned by `owner`, or null when it may. */
|
|
17
|
+
export function sessionOwnerMismatch(owner, caller) {
|
|
18
|
+
if (owner.kind === 'jwt') {
|
|
19
|
+
if (caller.kind !== 'jwt')
|
|
20
|
+
return 'session was opened with a member JWT; the caller presented the access secret';
|
|
21
|
+
if (caller.memberId !== owner.memberId || caller.workspaceId !== owner.workspaceId) {
|
|
22
|
+
return 'session was opened by a different member JWT';
|
|
23
|
+
}
|
|
24
|
+
return null;
|
|
25
|
+
}
|
|
26
|
+
if (caller.kind !== 'secret')
|
|
27
|
+
return 'session was opened with the access secret; the caller presented a member JWT';
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
/** Thrown by createHttpTransport when the configured (non-zero) port is already bound. */
|
|
31
|
+
export class PortInUseError extends Error {
|
|
32
|
+
port;
|
|
33
|
+
host;
|
|
34
|
+
code = 'EADDRINUSE';
|
|
35
|
+
constructor(port, host) {
|
|
36
|
+
super(`port ${port} on ${host} is already in use`);
|
|
37
|
+
this.port = port;
|
|
38
|
+
this.host = host;
|
|
39
|
+
this.name = 'PortInUseError';
|
|
40
|
+
}
|
|
41
|
+
}
|
|
13
42
|
function parseBody(req) {
|
|
14
43
|
return new Promise((resolve, reject) => {
|
|
15
44
|
const chunks = [];
|
|
@@ -26,7 +55,33 @@ function parseBody(req) {
|
|
|
26
55
|
req.on('error', reject);
|
|
27
56
|
});
|
|
28
57
|
}
|
|
29
|
-
|
|
58
|
+
// The WHATWG fetch spec refuses to connect to a fixed list of ports
|
|
59
|
+
// associated with other protocols (SMTP, IRC, etc.) -- see
|
|
60
|
+
// https://fetch.spec.whatwg.org/#block-bad-port. Node's built-in `fetch`
|
|
61
|
+
// (undici) enforces this, so StreamableHTTPClientTransport's `fetch()` call
|
|
62
|
+
// throws "TypeError: fetch failed" / "Error: bad port" if our server ever
|
|
63
|
+
// happens to be listening on one of these. This is normally impossible for
|
|
64
|
+
// an OS-assigned ephemeral port, since the ephemeral range is well above
|
|
65
|
+
// this list's highest entry (10080) -- EXCEPT on a host whose TCP dynamic
|
|
66
|
+
// port range has been widened/lowered to start below it (e.g. the legacy
|
|
67
|
+
// Windows default of starting at 1024), where `server.listen(0, ...)` can
|
|
68
|
+
// occasionally hand back one of these exact ports under load (more sockets
|
|
69
|
+
// open -> more of the range gets cycled through). See
|
|
70
|
+
// node_modules/undici/lib/web/fetch/constants.js `badPorts` for the
|
|
71
|
+
// upstream list this mirrors.
|
|
72
|
+
const FETCH_BLOCKED_PORTS = new Set([
|
|
73
|
+
1, 7, 9, 11, 13, 15, 17, 19, 20, 21, 22, 23, 25, 37, 42, 43, 53, 69, 77, 79,
|
|
74
|
+
87, 95, 101, 102, 103, 104, 109, 110, 111, 113, 115, 117, 119, 123, 135, 137,
|
|
75
|
+
139, 143, 161, 179, 389, 427, 465, 512, 513, 514, 515, 526, 530, 531, 532,
|
|
76
|
+
540, 548, 554, 556, 563, 587, 601, 636, 989, 990, 993, 995, 1719, 1720, 1723,
|
|
77
|
+
2049, 3659, 4045, 4190, 5060, 5061, 6000, 6566, 6665, 6666, 6667, 6668, 6669,
|
|
78
|
+
6679, 6697, 10080,
|
|
79
|
+
]);
|
|
80
|
+
export function isFetchBlockedPort(port) {
|
|
81
|
+
return FETCH_BLOCKED_PORTS.has(port);
|
|
82
|
+
}
|
|
83
|
+
const MAX_BLOCKED_PORT_RETRIES = 20;
|
|
84
|
+
function listenOncePort(server, port, host) {
|
|
30
85
|
return new Promise((resolve, reject) => {
|
|
31
86
|
server.listen(port, host, () => {
|
|
32
87
|
const addr = server.address();
|
|
@@ -35,6 +90,27 @@ function listenOnPort(server, port, host) {
|
|
|
35
90
|
server.once('error', reject);
|
|
36
91
|
});
|
|
37
92
|
}
|
|
93
|
+
/**
|
|
94
|
+
* Like listenOncePort, but when the caller asked for an OS-assigned port
|
|
95
|
+
* (port === 0) and the OS handed back one of fetch's blocked ports, close
|
|
96
|
+
* and retry rather than handing a dead-on-arrival port to callers that will
|
|
97
|
+
* `fetch()` it (apra-fleet-my-beads-db-27m.17). A caller-specified fixed
|
|
98
|
+
* port is returned as-is even if blocked -- that's a caller configuration
|
|
99
|
+
* choice, not something we can route around by retrying.
|
|
100
|
+
*/
|
|
101
|
+
async function listenOnPort(server, port, host) {
|
|
102
|
+
if (port !== 0) {
|
|
103
|
+
return listenOncePort(server, port, host);
|
|
104
|
+
}
|
|
105
|
+
let bound = await listenOncePort(server, 0, host);
|
|
106
|
+
for (let attempt = 0; isFetchBlockedPort(bound) && attempt < MAX_BLOCKED_PORT_RETRIES; attempt++) {
|
|
107
|
+
await new Promise((resolve, reject) => {
|
|
108
|
+
server.close((err) => (err ? reject(err) : resolve()));
|
|
109
|
+
});
|
|
110
|
+
bound = await listenOncePort(server, 0, host);
|
|
111
|
+
}
|
|
112
|
+
return bound;
|
|
113
|
+
}
|
|
38
114
|
function isInitializeRequest(body) {
|
|
39
115
|
if (!body)
|
|
40
116
|
return false;
|
|
@@ -52,6 +128,10 @@ function extractBearer(req) {
|
|
|
52
128
|
export async function createHttpTransport(options) {
|
|
53
129
|
const { registerTools, preferredPort } = options;
|
|
54
130
|
const sessions = new Map();
|
|
131
|
+
// Every install has its member access secret from the first server start
|
|
132
|
+
// (install creates it too): a `?member=` request must present it.
|
|
133
|
+
const memberSecretPath = options.memberSecretPath ?? memberAccessSecretPath();
|
|
134
|
+
getOrCreateMemberAccessSecret(memberSecretPath);
|
|
55
135
|
const startedAt = Date.now();
|
|
56
136
|
// LOW-1: Track event listener references for cleanup in close()
|
|
57
137
|
const eventCleanups = [];
|
|
@@ -68,8 +148,41 @@ export async function createHttpTransport(options) {
|
|
|
68
148
|
res.end('Session not found');
|
|
69
149
|
return;
|
|
70
150
|
}
|
|
151
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
152
|
+
return;
|
|
71
153
|
await session.transport.handleRequest(req, res);
|
|
72
154
|
}
|
|
155
|
+
/** The identity this request carries. Called only past the pre-route gate,
|
|
156
|
+
* so a bearer here has already verified (re-verified to read its claims). */
|
|
157
|
+
function callerIdentity(req) {
|
|
158
|
+
const bearer = extractBearer(req);
|
|
159
|
+
if (bearer !== null) {
|
|
160
|
+
const claims = getTokenIssuer().verify(bearer);
|
|
161
|
+
return claims ? { kind: 'jwt', memberId: claims.member_id, workspaceId: claims.workspace_id } : null;
|
|
162
|
+
}
|
|
163
|
+
const params = new URL(req.url ?? '/', 'http://localhost').searchParams;
|
|
164
|
+
return {
|
|
165
|
+
kind: 'secret',
|
|
166
|
+
member: params.get('member'),
|
|
167
|
+
engineOrigin: params.get('origin') === 'engine',
|
|
168
|
+
kbMaintainer: params.get('kb_maintainer') === '1',
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
/** 403 (and true) when the caller is not the identity that opened `session`;
|
|
172
|
+
* the session is left untouched and no session detail is returned. */
|
|
173
|
+
function refuseForeignCaller(req, res, sessionId, session) {
|
|
174
|
+
const caller = callerIdentity(req);
|
|
175
|
+
const why = caller ? sessionOwnerMismatch(session.owner, caller) : 'caller identity could not be verified';
|
|
176
|
+
if (why === null)
|
|
177
|
+
return false;
|
|
178
|
+
logLine('session', `rejected ${req.method} on sid=${shortSid(sessionId)}: caller=${caller?.kind ?? 'unverified'} owner=${session.owner.kind} (${why})`);
|
|
179
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
180
|
+
res.end(JSON.stringify({
|
|
181
|
+
error: 'session identity mismatch',
|
|
182
|
+
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.`,
|
|
183
|
+
}));
|
|
184
|
+
return true;
|
|
185
|
+
}
|
|
73
186
|
const httpServer = http.createServer(async (req, res) => {
|
|
74
187
|
const url = req.url ?? '/';
|
|
75
188
|
if (url === '/health' && req.method === 'GET') {
|
|
@@ -97,6 +210,8 @@ export async function createHttpTransport(options) {
|
|
|
97
210
|
return;
|
|
98
211
|
}
|
|
99
212
|
const body = JSON.stringify({ status: 'shutting-down' });
|
|
213
|
+
// GitHub #585: name the real cause before re-entering the SIGINT path.
|
|
214
|
+
recordShutdown('http_shutdown');
|
|
100
215
|
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
101
216
|
res.end(body);
|
|
102
217
|
setTimeout(() => {
|
|
@@ -109,11 +224,59 @@ export async function createHttpTransport(options) {
|
|
|
109
224
|
res.end();
|
|
110
225
|
return;
|
|
111
226
|
}
|
|
227
|
+
// Every /mcp request without a member JWT must present this install's
|
|
228
|
+
// member access secret (an owner-only file in its data dir). The server
|
|
229
|
+
// binds loopback, where every local user can connect; the secret is what
|
|
230
|
+
// keeps another user's session -- or one configured for another install --
|
|
231
|
+
// out. That covers the ?member= route (a session acting as that member)
|
|
232
|
+
// AND the no-member route (a FULL-scope session, which includes command
|
|
233
|
+
// execution on this install's local members). Read per request so a
|
|
234
|
+
// replaced secret takes effect at once; a missing one refuses (never fails
|
|
235
|
+
// open). A member JWT (Authorization: Bearer) is its own credential, but
|
|
236
|
+
// only a VERIFIED one replaces the secret: any bearer that fails JWT
|
|
237
|
+
// verification is refused here for every method, so `Bearer x` cannot
|
|
238
|
+
// carry a GET (SSE stream) or DELETE (session teardown) past this gate.
|
|
239
|
+
{
|
|
240
|
+
const memberRouteParam = new URL(url, 'http://localhost').searchParams.get('member');
|
|
241
|
+
const gateBearer = extractBearer(req);
|
|
242
|
+
if (gateBearer !== null) {
|
|
243
|
+
if (!getTokenIssuer().verify(gateBearer)) {
|
|
244
|
+
logLine('session', `rejected ${req.method}: jwt verify failed member_param=${memberRouteParam ?? 'none'}`);
|
|
245
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
246
|
+
res.end(JSON.stringify({ error: 'invalid token' }));
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
else {
|
|
251
|
+
const expected = readMemberAccessSecret(memberSecretPath);
|
|
252
|
+
if (!memberAccessSecretMatches(req.headers[MEMBER_SECRET_HEADER.toLowerCase()], expected)) {
|
|
253
|
+
const why = req.headers[MEMBER_SECRET_HEADER.toLowerCase()] === undefined ? 'missing' : 'wrong';
|
|
254
|
+
const route = memberRouteParam !== null ? 'member route' : 'full-scope route';
|
|
255
|
+
logLine('session', `rejected ${req.method} on ${route}: access secret ${why} member_param=${memberRouteParam ?? 'none'}`);
|
|
256
|
+
res.writeHead(401, { 'Content-Type': 'application/json' });
|
|
257
|
+
res.end(JSON.stringify({
|
|
258
|
+
error: memberRouteParam !== null ? 'member secret required' : 'access secret required',
|
|
259
|
+
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' : ''}.`,
|
|
260
|
+
}));
|
|
261
|
+
return;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
}
|
|
112
265
|
if (req.method === 'POST') {
|
|
113
266
|
// JWT auth: verify Bearer token if present; unauthenticated (PM/tool) connections pass through
|
|
114
267
|
const rawToken = extractBearer(req);
|
|
115
268
|
const parsedUrl = new URL(req.url ?? '/', 'http://localhost');
|
|
116
269
|
const memberParam = parsedUrl.searchParams.get('member');
|
|
270
|
+
// origin=engine: set ONLY by the engine's own member-session paths
|
|
271
|
+
// (client connectFleetMember with { origin: 'engine' }, used by memberCall
|
|
272
|
+
// and the `apra-fleet call` verb). Recorded on the session's tool scope so
|
|
273
|
+
// its kb_/code_ calls are not counted against the member.
|
|
274
|
+
const engineOrigin = parsedUrl.searchParams.get('origin') === 'engine';
|
|
275
|
+
// kb_maintainer=1: the engine's kb_maintainer grant (client
|
|
276
|
+
// connectFleetMember with { origin: 'engine', kbMaintainer: true }, used
|
|
277
|
+
// by memberCall for the member it chose as a repository's kb_maintainer).
|
|
278
|
+
// Honoured only with origin=engine; see memberToolScope.
|
|
279
|
+
const kbMaintainerParam = parsedUrl.searchParams.get('kb_maintainer') === '1';
|
|
117
280
|
let postClaims = null;
|
|
118
281
|
if (rawToken !== null) {
|
|
119
282
|
postClaims = getTokenIssuer().verify(rawToken);
|
|
@@ -137,7 +300,10 @@ export async function createHttpTransport(options) {
|
|
|
137
300
|
return;
|
|
138
301
|
}
|
|
139
302
|
if (isInitializeRequest(parsedBody)) {
|
|
140
|
-
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'}`);
|
|
303
|
+
logLine('session', `initialize jwt=${rawToken !== null} jwt_valid=${postClaims !== null} member_param=${memberParam ?? 'none'} engine_origin=${engineOrigin} kb_maintainer=${kbMaintainerParam}`);
|
|
304
|
+
if (kbMaintainerParam && !engineOrigin) {
|
|
305
|
+
logLine('session', 'kb_maintainer=1 without origin=engine ignored: the grant is engine-only');
|
|
306
|
+
}
|
|
141
307
|
const body = parsedBody;
|
|
142
308
|
const clientInfo = body?.params?.clientInfo ?? {};
|
|
143
309
|
const clientCaps = body?.params?.capabilities ?? {};
|
|
@@ -157,13 +323,23 @@ export async function createHttpTransport(options) {
|
|
|
157
323
|
// (unauthenticated local fallback) historically carried the friendly
|
|
158
324
|
// name; new URLs carry the UUID, and legacy friendly names are resolved
|
|
159
325
|
// to the UUID via the agent registry here.
|
|
326
|
+
//
|
|
327
|
+
// The param must name a REGISTERED member: an id that resolves through
|
|
328
|
+
// neither getAgent nor findAgentByName is refused with 403 rather than
|
|
329
|
+
// conjuring a member identity (and a member session) from a raw string.
|
|
160
330
|
let fallbackMemberId = null;
|
|
161
331
|
let fallbackWorkFolder = '';
|
|
162
332
|
if (postClaims === null && memberParam !== null) {
|
|
163
333
|
const agent = getAgent(memberParam) ?? findAgentByName(memberParam);
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
334
|
+
if (!agent) {
|
|
335
|
+
logLine('session', `rejected initialize: unknown member_param=${memberParam}`);
|
|
336
|
+
res.writeHead(403, { 'Content-Type': 'application/json' });
|
|
337
|
+
res.end(JSON.stringify({ error: 'unknown member' }));
|
|
338
|
+
return;
|
|
339
|
+
}
|
|
340
|
+
fallbackMemberId = agent.id;
|
|
341
|
+
fallbackWorkFolder = agent.workFolder ?? '';
|
|
342
|
+
if (agent.id !== memberParam) {
|
|
167
343
|
logLine('session', `resolved URL member param '${memberParam}' to member_id=${agent.id}`);
|
|
168
344
|
}
|
|
169
345
|
}
|
|
@@ -171,13 +347,26 @@ export async function createHttpTransport(options) {
|
|
|
171
347
|
// from this machine (server binds 127.0.0.1), so they belong to the
|
|
172
348
|
// local workspace. Authenticated sessions use the JWT's workspace_id.
|
|
173
349
|
const sessionWorkspaceId = postClaims?.workspace_id ?? localWorkspaceId();
|
|
350
|
+
// Tool scope from the identity resolved above. A valid member JWT (a
|
|
351
|
+
// doer subprocess connect-back or an interactive member) or a
|
|
352
|
+
// registered ?member= makes this a MEMBER session: the base member
|
|
353
|
+
// allowlist, plus the channel tools (respond_to_message) only when the
|
|
354
|
+
// client declared claude/channel. No member identity at all is the
|
|
355
|
+
// local orchestrator/PM/tool session and keeps the FULL set.
|
|
356
|
+
const sessionMemberId = postClaims?.member_id ?? fallbackMemberId;
|
|
357
|
+
const toolScope = sessionMemberId
|
|
358
|
+
? memberToolScope(sessionMemberId, channelCapable, engineOrigin, kbMaintainerParam)
|
|
359
|
+
: FULL_TOOL_SCOPE;
|
|
360
|
+
const sessionOwner = postClaims
|
|
361
|
+
? { kind: 'jwt', memberId: postClaims.member_id, workspaceId: postClaims.workspace_id }
|
|
362
|
+
: { kind: 'secret', member: fallbackMemberId, engineOrigin, kbMaintainer: kbMaintainerParam };
|
|
174
363
|
const sessionServer = new McpServer({ name: `apra fleet server ${serverVersion}`, version: serverVersion }, { capabilities: { logging: {}, experimental: { 'claude/channel': {} } } });
|
|
175
364
|
const sessionTransport = new StreamableHTTPServerTransport({
|
|
176
365
|
sessionIdGenerator: () => crypto.randomUUID(),
|
|
177
366
|
onsessioninitialized: (sid) => {
|
|
178
|
-
sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId });
|
|
367
|
+
sessions.set(sid, { server: sessionServer, transport: sessionTransport, workspaceId: sessionWorkspaceId, owner: sessionOwner });
|
|
179
368
|
const hasMember = !!(postClaims || fallbackMemberId);
|
|
180
|
-
logLine('session', `new sid=${sid} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember}`);
|
|
369
|
+
logLine('session', `new sid=${shortSid(sid)} client=${clientInfo.name ?? 'unknown'}/${clientInfo.version ?? 'unknown'} caps=${capKeys || 'none'} member=${hasMember} scope=${toolScope.kind}`);
|
|
181
370
|
// Register interactive member session when JWT claims are present.
|
|
182
371
|
//
|
|
183
372
|
// apra-fleet-eft.28.5: carry forward the launch-time pid captured
|
|
@@ -206,13 +395,28 @@ export async function createHttpTransport(options) {
|
|
|
206
395
|
pid: postClaims.pid ?? priorPid,
|
|
207
396
|
channelCapable,
|
|
208
397
|
});
|
|
209
|
-
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${sid} channelCapable=${channelCapable}`);
|
|
398
|
+
logLine('session', `registered member member_id=${postClaims.member_id} workspace_id=${postClaims.workspace_id} via JWT sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
210
399
|
}
|
|
211
400
|
else if (fallbackMemberId) {
|
|
212
401
|
// apra-fleet-eft.50.1: same durable launch-pid fallback as the
|
|
213
402
|
// JWT branch above, so a URL-param reconnect on a retry keeps a
|
|
214
403
|
// pid for the interactive liveness check to test.
|
|
215
|
-
|
|
404
|
+
if (!channelCapable) {
|
|
405
|
+
// A tool-only member session (apra-fleet call, memberCall, a
|
|
406
|
+
// non-interactive agent's per-folder MCP entry) never touches
|
|
407
|
+
// the session registry. The registry entry is the member's
|
|
408
|
+
// interactive routing target: send_message pushes channel
|
|
409
|
+
// notifications to its server, and execute_prompt reads its
|
|
410
|
+
// launch-time pid. Registering here would replace a launch
|
|
411
|
+
// placeholder (server:null, pid set) or a missing entry with a
|
|
412
|
+
// session that cannot receive those pushes; onsessionclosed
|
|
413
|
+
// skips it for the same reason.
|
|
414
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
415
|
+
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)`);
|
|
416
|
+
return;
|
|
417
|
+
}
|
|
418
|
+
const existing = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
419
|
+
const priorPid = existing?.pid
|
|
216
420
|
?? sessionRegistry.lastKnownPid(sessionWorkspaceId, fallbackMemberId);
|
|
217
421
|
sessionRegistry.register({
|
|
218
422
|
member_id: fallbackMemberId,
|
|
@@ -225,11 +429,11 @@ export async function createHttpTransport(options) {
|
|
|
225
429
|
pid: priorPid,
|
|
226
430
|
channelCapable,
|
|
227
431
|
});
|
|
228
|
-
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${sid} channelCapable=${channelCapable}`);
|
|
432
|
+
logLine('session', `registered member member_id=${fallbackMemberId} workspace_id=${sessionWorkspaceId} via URL param sid=${shortSid(sid)} channelCapable=${channelCapable}`);
|
|
229
433
|
}
|
|
230
434
|
},
|
|
231
435
|
onsessionclosed: (sid) => {
|
|
232
|
-
logLine('session', `closed sid=${sid}`);
|
|
436
|
+
logLine('session', `closed sid=${shortSid(sid)}`);
|
|
233
437
|
// LOW-2: Close the McpServer when its session closes
|
|
234
438
|
const s = sessions.get(sid);
|
|
235
439
|
if (s) {
|
|
@@ -245,25 +449,27 @@ export async function createHttpTransport(options) {
|
|
|
245
449
|
const current = sessionRegistry.get(postClaims.workspace_id, postClaims.member_id);
|
|
246
450
|
if (current?.sessionId === sid) {
|
|
247
451
|
sessionRegistry.unregister(postClaims.workspace_id, postClaims.member_id);
|
|
248
|
-
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${sid}`);
|
|
452
|
+
logLine('session', `unregistered member member_id=${postClaims.member_id} sid=${shortSid(sid)}`);
|
|
249
453
|
}
|
|
250
454
|
else {
|
|
251
|
-
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${sid} (superseded by sid=${current?.sessionId
|
|
455
|
+
logLine('session', `skipped stale unregister member_id=${postClaims.member_id} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
252
456
|
}
|
|
253
457
|
}
|
|
254
|
-
else if (fallbackMemberId) {
|
|
458
|
+
else if (fallbackMemberId && channelCapable) {
|
|
459
|
+
// A tool-only ?member= session never registered (see
|
|
460
|
+
// onsessioninitialized), so it never unregisters either.
|
|
255
461
|
const current = sessionRegistry.get(sessionWorkspaceId, fallbackMemberId);
|
|
256
462
|
if (current?.sessionId === sid) {
|
|
257
463
|
sessionRegistry.unregister(sessionWorkspaceId, fallbackMemberId);
|
|
258
|
-
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${sid}`);
|
|
464
|
+
logLine('session', `unregistered member member_id=${fallbackMemberId} sid=${shortSid(sid)}`);
|
|
259
465
|
}
|
|
260
466
|
else {
|
|
261
|
-
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${sid} (superseded by sid=${current?.sessionId
|
|
467
|
+
logLine('session', `skipped stale unregister member_id=${fallbackMemberId} sid=${shortSid(sid)} (superseded by sid=${shortSid(current?.sessionId)})`);
|
|
262
468
|
}
|
|
263
469
|
}
|
|
264
470
|
},
|
|
265
471
|
});
|
|
266
|
-
await registerTools(sessionServer);
|
|
472
|
+
await registerTools(sessionServer, toolScope);
|
|
267
473
|
await sessionServer.connect(sessionTransport);
|
|
268
474
|
await sessionTransport.handleRequest(req, res, parsedBody);
|
|
269
475
|
return;
|
|
@@ -280,6 +486,8 @@ export async function createHttpTransport(options) {
|
|
|
280
486
|
res.end('Session not found');
|
|
281
487
|
return;
|
|
282
488
|
}
|
|
489
|
+
if (refuseForeignCaller(req, res, sessionId, session))
|
|
490
|
+
return;
|
|
283
491
|
await session.transport.handleRequest(req, res, parsedBody);
|
|
284
492
|
return;
|
|
285
493
|
}
|
|
@@ -319,28 +527,33 @@ export async function createHttpTransport(options) {
|
|
|
319
527
|
// LOW-1: Store cleanup so close() can unsubscribe
|
|
320
528
|
eventCleanups.push(() => fleetEvents.off(eventType, handler));
|
|
321
529
|
}
|
|
322
|
-
// Start listening
|
|
530
|
+
// Start listening on the preferred port (no fallback, see below).
|
|
323
531
|
// Bind host is configurable (APRA_FLEET_HOST, default 127.0.0.1) --
|
|
324
532
|
// apra-fleet-fnz.4/us9.6. Binding beyond loopback is an explicit,
|
|
325
533
|
// logged opt-in: several unauthenticated code paths in this file (the
|
|
326
534
|
// ?member= URL-param fallback, /shutdown's admin-key check) were
|
|
327
535
|
// written assuming only same-machine callers can reach this server.
|
|
328
|
-
const targetPort = preferredPort ??
|
|
536
|
+
const targetPort = preferredPort ?? resolveServerPort();
|
|
329
537
|
const bindHost = DEFAULT_HOST;
|
|
330
538
|
if (bindHost !== '127.0.0.1') {
|
|
331
539
|
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
540
|
}
|
|
541
|
+
// A busy configured port is a hard error (GitHub #584): there is no
|
|
542
|
+
// fallback to an OS-assigned port, because every configured MCP client only
|
|
543
|
+
// knows the configured port -- a silently re-homed server is unreachable and
|
|
544
|
+
// splits the fleet in two on one data dir. An explicit port 0 (callers that
|
|
545
|
+
// ask for an ephemeral port) is unaffected.
|
|
333
546
|
let port;
|
|
334
547
|
try {
|
|
335
548
|
port = await listenOnPort(httpServer, targetPort, bindHost);
|
|
336
549
|
}
|
|
337
550
|
catch (err) {
|
|
551
|
+
for (const cleanup of eventCleanups)
|
|
552
|
+
cleanup();
|
|
338
553
|
if (err.code === 'EADDRINUSE') {
|
|
339
|
-
|
|
340
|
-
}
|
|
341
|
-
else {
|
|
342
|
-
throw err;
|
|
554
|
+
throw new PortInUseError(targetPort, bindHost);
|
|
343
555
|
}
|
|
556
|
+
throw err;
|
|
344
557
|
}
|
|
345
558
|
// Same-machine callers (register_member's own local MCP connection) always
|
|
346
559
|
// use loopback -- valid regardless of bindHost, since binding to 0.0.0.0
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { FileHashResult } from './file-hash.js';
|
|
2
|
+
/**
|
|
3
|
+
* A cited/basis path must stay inside the exported repo: relative, with no
|
|
4
|
+
* '..' segment and no POSIX, drive-letter or UNC root. Anything else is never
|
|
5
|
+
* hashed and never qualifies (the bible only describes this tree).
|
|
6
|
+
*/
|
|
7
|
+
export declare function isRepoRelativePath(file: string): boolean;
|
|
8
|
+
/** The minimal entry shape the predicate reads. */
|
|
9
|
+
export interface BibleCandidate {
|
|
10
|
+
id: string;
|
|
11
|
+
confidence: string;
|
|
12
|
+
source_files: string[];
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* True when an entry qualifies for the project bible:
|
|
16
|
+
* - confidence is CONFIRMED (callers already exclude superseded/stale rows);
|
|
17
|
+
* - it cites at least one source file;
|
|
18
|
+
* - its stored basis is non-empty (null/empty/unparseable basis never matches);
|
|
19
|
+
* - every cited source file has a key in the basis;
|
|
20
|
+
* - every cited and basis path is repo-relative (isRepoRelativePath);
|
|
21
|
+
* - every basis hash equals that file's current hash (a missing file -- a
|
|
22
|
+
* null/absent current hash -- is a mismatch).
|
|
23
|
+
* Same comparison semantics as SqliteProvider.basisFullyMatches, plus the
|
|
24
|
+
* source_files coverage check.
|
|
25
|
+
*/
|
|
26
|
+
export declare function qualifiesForProjectBible(entry: BibleCandidate, basis: Record<string, string> | null | undefined, currentHashes: Record<string, Pick<FileHashResult, 'hash'> | null | undefined>): boolean;
|
|
27
|
+
/**
|
|
28
|
+
* Hash every basis file once (one batch, content at repoPath's HEAD commit)
|
|
29
|
+
* and return the entries that pass qualifiesForProjectBible, preserving input
|
|
30
|
+
* order. Throws KbHeadHashError when repoPath is not inside a git work tree.
|
|
31
|
+
*/
|
|
32
|
+
export declare function filterProjectBibleCandidates<T extends BibleCandidate>(entries: T[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<T[]>;
|
|
33
|
+
/** The minimal bible-entry shape the legacy backfill reads. */
|
|
34
|
+
export interface BibleFileEntry {
|
|
35
|
+
id: string;
|
|
36
|
+
source_files: string[];
|
|
37
|
+
source_file_hashes?: Record<string, string>;
|
|
38
|
+
}
|
|
39
|
+
/** True when a bible entry carries a non-empty source_file_hashes map. */
|
|
40
|
+
export declare function hasCarriedBasis(entry: BibleFileEntry): boolean;
|
|
41
|
+
/**
|
|
42
|
+
* The bible entries that gain a basis: for each entry in `bibleEntries` with
|
|
43
|
+
* no carried source_file_hashes whose id is in `kbEntries` (the writer KB's
|
|
44
|
+
* live entries) with the same source_files set and a stored basis passing
|
|
45
|
+
* qualifiesForProjectBible at repoPath's HEAD, the id mapped to that stored
|
|
46
|
+
* basis. Entries that do not qualify are simply absent from the result (the
|
|
47
|
+
* caller keeps them unchanged; nothing is ever dropped). Hashes the candidate
|
|
48
|
+
* basis files once; with no candidate nothing is hashed (so no git check).
|
|
49
|
+
* Throws KbHeadHashError when there are candidates and repoPath is not inside
|
|
50
|
+
* a git work tree.
|
|
51
|
+
*/
|
|
52
|
+
export declare function selectLegacyBibleBackfill<K extends BibleCandidate>(bibleEntries: BibleFileEntry[], kbEntries: K[], basisById: Map<string, Record<string, string> | null>, repoPath: string): Promise<Map<string, Record<string, string>>>;
|
|
53
|
+
//# sourceMappingURL=bible-basis-filter.d.ts.map
|