@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
package/dist/services/sftp.js
CHANGED
|
@@ -1,93 +1,254 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
2
|
import fs from 'node:fs';
|
|
3
|
-
import {
|
|
3
|
+
import { openPooledChannel } from './ssh.js';
|
|
4
4
|
import { resolveRemotePath } from '../utils/platform.js';
|
|
5
|
-
|
|
5
|
+
/**
|
|
6
|
+
* Inactivity budget for one SFTP operation (session open, mkdir, writeFile,
|
|
7
|
+
* fastPut, fastGet). INACTIVITY-based, not a wall-clock ceiling: fastPut and
|
|
8
|
+
* fastGet report every chunk through their `step` callback and each report
|
|
9
|
+
* re-arms the timer, so a large transfer that keeps making progress is never
|
|
10
|
+
* cut; one that stops moving for this long is. On expiry the SFTP session is
|
|
11
|
+
* ended (its channel closed, its pooled-connection lease released) and the
|
|
12
|
+
* transfer rejects with SftpTimeoutError naming the member, path and budget.
|
|
13
|
+
* Without it a transfer the far side never answers pins its channel -- one
|
|
14
|
+
* of the member sshd's MaxSessions -- for as long as the connection lives.
|
|
15
|
+
*/
|
|
16
|
+
export const SFTP_INACTIVITY_TIMEOUT_MS = 120_000;
|
|
17
|
+
export class SftpTimeoutError extends Error {
|
|
18
|
+
constructor(agent, op, target, timeoutMs) {
|
|
19
|
+
super(`SFTP ${op} on member "${agent.friendlyName}" (${agent.username}@${agent.host}:${agent.port}) ` +
|
|
20
|
+
`made no progress for ${timeoutMs}ms on ${target}; the SFTP session was closed. ` +
|
|
21
|
+
`The member may be unreachable or its sftp-server hung -- retry, or check the member.`);
|
|
22
|
+
this.name = 'SftpTimeoutError';
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Close any SFTP channel ssh2 left open after its "sftp" subsystem request
|
|
27
|
+
* was refused. ssh2 (1.17) opens the session channel, then on a refused
|
|
28
|
+
* subsystem request calls back with only an error -- the channel stays open
|
|
29
|
+
* on both ends and holds one of the member sshd's MaxSessions. ssh2's own
|
|
30
|
+
* exec() closes its channel on the equivalent failure; sftp() does not, and
|
|
31
|
+
* it never hands us the channel, so we find it in the client's channel table.
|
|
32
|
+
*
|
|
33
|
+
* Only an SFTP channel in exactly that state is closed: subsystem request
|
|
34
|
+
* already answered (no pending request callbacks) and the SFTP handshake
|
|
35
|
+
* never started (_init not yet replaced on the instance). A concurrent
|
|
36
|
+
* sftp() still waiting on its subsystem reply has a pending callback, and
|
|
37
|
+
* one past the subsystem stage has had _init replaced, so neither matches.
|
|
38
|
+
* Best-effort: the internals are read defensively and any surprise is ignored.
|
|
39
|
+
*/
|
|
40
|
+
function closeRefusedSftpChannels(client) {
|
|
41
|
+
try {
|
|
42
|
+
const channels = client
|
|
43
|
+
._chanMgr?._channels;
|
|
44
|
+
if (!channels)
|
|
45
|
+
return;
|
|
46
|
+
for (const ch of Object.values(channels)) {
|
|
47
|
+
if (!ch || typeof ch !== 'object' || ch.constructor?.name !== 'SFTP')
|
|
48
|
+
continue;
|
|
49
|
+
if (ch.outgoing?.state !== 'open')
|
|
50
|
+
continue;
|
|
51
|
+
if (!Array.isArray(ch._callbacks) || ch._callbacks.length !== 0)
|
|
52
|
+
continue;
|
|
53
|
+
if (Object.prototype.hasOwnProperty.call(ch, '_init'))
|
|
54
|
+
continue;
|
|
55
|
+
try {
|
|
56
|
+
ch.end();
|
|
57
|
+
}
|
|
58
|
+
catch { /* best-effort */ }
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
catch { /* best-effort */ }
|
|
62
|
+
}
|
|
63
|
+
/** Open an SFTP session on `client`; a refused subsystem request closes its channel. */
|
|
64
|
+
export function openSftp(client) {
|
|
6
65
|
return new Promise((resolve, reject) => {
|
|
7
66
|
client.sftp((err, sftp) => {
|
|
8
|
-
if (err)
|
|
67
|
+
if (err) {
|
|
68
|
+
closeRefusedSftpChannels(client);
|
|
9
69
|
reject(err);
|
|
70
|
+
}
|
|
10
71
|
else
|
|
11
72
|
resolve(sftp);
|
|
12
73
|
});
|
|
13
74
|
});
|
|
14
75
|
}
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
76
|
+
/**
|
|
77
|
+
* Run one transfer on its own SFTP session and ALWAYS end it afterwards --
|
|
78
|
+
* on success, error, abort and timeout. Each session is a channel (one
|
|
79
|
+
* sftp-server process) on the member's pooled SSH connection; one left open
|
|
80
|
+
* per transfer exhausts sshd's per-connection MaxSessions (default 10), after
|
|
81
|
+
* which every command on that member fails with "Channel open failure". An
|
|
82
|
+
* abort ends the session immediately, which fails any in-flight operation.
|
|
83
|
+
* Every operation, including opening the session, runs under
|
|
84
|
+
* SFTP_INACTIVITY_TIMEOUT_MS (see there); a timeout ends the session and the
|
|
85
|
+
* whole transfer rejects with SftpTimeoutError -- it is never folded into a
|
|
86
|
+
* per-file failure, because the session it would continue on is gone.
|
|
87
|
+
*/
|
|
88
|
+
async function withSftpSession(agent, abortSignal, fn, timeoutMs = SFTP_INACTIVITY_TIMEOUT_MS) {
|
|
89
|
+
if (abortSignal?.aborted)
|
|
90
|
+
throw new Error('Aborted by client');
|
|
91
|
+
const remoteRoot = agent.workFolder || '(home)';
|
|
92
|
+
const { channel: sftp, release } = await openPooledChannel(agent, (client) => new Promise((resolve, reject) => {
|
|
93
|
+
let timedOut = false;
|
|
94
|
+
const timer = setTimeout(() => {
|
|
95
|
+
timedOut = true;
|
|
96
|
+
reject(new SftpTimeoutError(agent, 'session open', remoteRoot, timeoutMs));
|
|
97
|
+
}, timeoutMs);
|
|
98
|
+
timer.unref();
|
|
99
|
+
openSftp(client).then((s) => {
|
|
100
|
+
clearTimeout(timer);
|
|
101
|
+
// Opened after we gave up: nobody will use it -- close it, do not leak it.
|
|
102
|
+
if (timedOut) {
|
|
103
|
+
try {
|
|
104
|
+
s.end();
|
|
105
|
+
}
|
|
106
|
+
catch { /* best-effort */ }
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
resolve(s);
|
|
110
|
+
}, (err) => { clearTimeout(timer); reject(err); });
|
|
111
|
+
}));
|
|
112
|
+
let closed = false;
|
|
113
|
+
let failure;
|
|
114
|
+
let failSession = () => { };
|
|
115
|
+
const failed = new Promise((_, reject) => { failSession = reject; });
|
|
116
|
+
failed.catch(() => { });
|
|
117
|
+
const close = () => {
|
|
118
|
+
if (closed)
|
|
119
|
+
return;
|
|
120
|
+
closed = true;
|
|
121
|
+
try {
|
|
122
|
+
sftp.end();
|
|
123
|
+
}
|
|
124
|
+
catch { /* best-effort */ }
|
|
125
|
+
release();
|
|
126
|
+
};
|
|
127
|
+
const fail = (err) => {
|
|
128
|
+
if (failure)
|
|
129
|
+
return;
|
|
130
|
+
failure = err;
|
|
131
|
+
close();
|
|
132
|
+
failSession(err);
|
|
133
|
+
};
|
|
134
|
+
const onAbort = () => fail(new Error('Aborted by client'));
|
|
135
|
+
abortSignal?.addEventListener('abort', onAbort, { once: true });
|
|
136
|
+
const session = {
|
|
137
|
+
sftp,
|
|
138
|
+
guard(op, target, start) {
|
|
139
|
+
if (failure)
|
|
140
|
+
return Promise.reject(failure);
|
|
141
|
+
if (closed)
|
|
142
|
+
return Promise.reject(new Error('SFTP session already closed'));
|
|
143
|
+
let timer;
|
|
144
|
+
const arm = () => {
|
|
145
|
+
if (timer)
|
|
146
|
+
clearTimeout(timer);
|
|
147
|
+
timer = setTimeout(() => fail(new SftpTimeoutError(agent, op, target, timeoutMs)), timeoutMs);
|
|
148
|
+
timer.unref();
|
|
149
|
+
};
|
|
150
|
+
arm();
|
|
151
|
+
return Promise.race([start(arm), failed]).finally(() => { if (timer)
|
|
152
|
+
clearTimeout(timer); });
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
try {
|
|
156
|
+
if (abortSignal?.aborted)
|
|
157
|
+
throw new Error('Aborted by client');
|
|
158
|
+
const result = await Promise.race([fn(session), failed]);
|
|
159
|
+
if (failure)
|
|
160
|
+
throw failure;
|
|
161
|
+
return result;
|
|
162
|
+
}
|
|
163
|
+
finally {
|
|
164
|
+
abortSignal?.removeEventListener('abort', onAbort);
|
|
165
|
+
close();
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
function sftpMkdir(s, remotePath) {
|
|
169
|
+
return s.guard('mkdir', remotePath, () => new Promise((resolve, reject) => {
|
|
170
|
+
s.sftp.mkdir(remotePath, (err) => {
|
|
18
171
|
if (err && err.code !== 4)
|
|
19
172
|
reject(err); // code 4 = already exists
|
|
20
173
|
else
|
|
21
174
|
resolve();
|
|
22
175
|
});
|
|
23
|
-
});
|
|
176
|
+
}));
|
|
24
177
|
}
|
|
25
|
-
|
|
178
|
+
/** True when the error ended the whole session (timeout/abort) rather than one operation. */
|
|
179
|
+
function isSessionFatal(err) {
|
|
180
|
+
return err instanceof SftpTimeoutError || (err instanceof Error && err.message === 'Aborted by client');
|
|
181
|
+
}
|
|
182
|
+
async function sftpMkdirRecursive(s, remotePath) {
|
|
26
183
|
const parts = remotePath.replace(/\\/g, '/').split('/').filter(Boolean);
|
|
27
184
|
let current = remotePath.startsWith('/') ? '/' : '';
|
|
28
185
|
for (const part of parts) {
|
|
29
186
|
current = current ? `${current}/${part}` : part;
|
|
30
187
|
try {
|
|
31
|
-
await sftpMkdir(
|
|
188
|
+
await sftpMkdir(s, current);
|
|
32
189
|
}
|
|
33
|
-
catch {
|
|
190
|
+
catch (err) {
|
|
191
|
+
if (isSessionFatal(err))
|
|
192
|
+
throw err;
|
|
34
193
|
// directory may already exist
|
|
35
194
|
}
|
|
36
195
|
}
|
|
37
196
|
}
|
|
38
|
-
function sftpWriteFile(
|
|
39
|
-
return new Promise((resolve, reject) => {
|
|
40
|
-
sftp.writeFile(remotePath, data, (err) => {
|
|
197
|
+
function sftpWriteFile(s, remotePath, data) {
|
|
198
|
+
return s.guard('write', remotePath, () => new Promise((resolve, reject) => {
|
|
199
|
+
s.sftp.writeFile(remotePath, data, (err) => {
|
|
41
200
|
if (err)
|
|
42
201
|
reject(err);
|
|
43
202
|
else
|
|
44
203
|
resolve();
|
|
45
204
|
});
|
|
46
|
-
});
|
|
205
|
+
}));
|
|
47
206
|
}
|
|
48
|
-
function sftpPut(
|
|
49
|
-
return new Promise((resolve, reject) => {
|
|
50
|
-
sftp.fastPut(localPath, remotePath, (err) => {
|
|
207
|
+
function sftpPut(s, localPath, remotePath) {
|
|
208
|
+
return s.guard('upload', remotePath, (progress) => new Promise((resolve, reject) => {
|
|
209
|
+
s.sftp.fastPut(localPath, remotePath, { step: () => progress() }, (err) => {
|
|
51
210
|
if (err)
|
|
52
211
|
reject(err);
|
|
53
212
|
else
|
|
54
213
|
resolve();
|
|
55
214
|
});
|
|
56
|
-
});
|
|
215
|
+
}));
|
|
57
216
|
}
|
|
58
|
-
function sftpGet(
|
|
59
|
-
return new Promise((resolve, reject) => {
|
|
60
|
-
sftp.fastGet(remotePath, localPath, (err) => {
|
|
217
|
+
function sftpGet(s, remotePath, localPath) {
|
|
218
|
+
return s.guard('download', remotePath, (progress) => new Promise((resolve, reject) => {
|
|
219
|
+
s.sftp.fastGet(remotePath, localPath, { step: () => progress() }, (err) => {
|
|
61
220
|
if (err)
|
|
62
221
|
reject(err);
|
|
63
222
|
else
|
|
64
223
|
resolve();
|
|
65
224
|
});
|
|
66
|
-
});
|
|
225
|
+
}));
|
|
67
226
|
}
|
|
68
227
|
export async function uploadViaSFTP(agent, localPaths, destinationPath, abortSignal) {
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
228
|
+
return withSftpSession(agent, abortSignal, async (s) => {
|
|
229
|
+
const remoteBase = destinationPath
|
|
230
|
+
? resolveRemotePath(agent.workFolder, destinationPath)
|
|
231
|
+
: agent.workFolder.replace(/\\/g, '/');
|
|
232
|
+
await sftpMkdirRecursive(s, remoteBase);
|
|
233
|
+
const success = [];
|
|
234
|
+
const failed = [];
|
|
235
|
+
for (const localPath of localPaths) {
|
|
236
|
+
if (abortSignal?.aborted)
|
|
237
|
+
throw new Error('Aborted by client');
|
|
238
|
+
const fileName = path.basename(localPath);
|
|
239
|
+
const remotePath = `${remoteBase}/${fileName}`;
|
|
240
|
+
try {
|
|
241
|
+
await sftpPut(s, localPath, remotePath);
|
|
242
|
+
success.push(fileName);
|
|
243
|
+
}
|
|
244
|
+
catch (err) {
|
|
245
|
+
if (isSessionFatal(err))
|
|
246
|
+
throw err;
|
|
247
|
+
failed.push({ path: fileName, error: err.message });
|
|
248
|
+
}
|
|
88
249
|
}
|
|
89
|
-
|
|
90
|
-
|
|
250
|
+
return { success, failed };
|
|
251
|
+
});
|
|
91
252
|
}
|
|
92
253
|
/**
|
|
93
254
|
* Write in-memory file contents directly to home-relative paths on the remote
|
|
@@ -95,44 +256,111 @@ export async function uploadViaSFTP(agent, localPaths, destinationPath, abortSig
|
|
|
95
256
|
* server relative to the connecting user's home directory.
|
|
96
257
|
*/
|
|
97
258
|
export async function uploadContentToHome(agent, files, baseDir) {
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
259
|
+
return withSftpSession(agent, undefined, async (s) => {
|
|
260
|
+
const base = baseDir.replace(/\\/g, '/').replace(/\/$/, '');
|
|
261
|
+
const success = [];
|
|
262
|
+
const failed = [];
|
|
263
|
+
for (const file of files) {
|
|
264
|
+
const remotePath = `${base}/${file.relPath}`;
|
|
265
|
+
try {
|
|
266
|
+
await sftpMkdirRecursive(s, path.posix.dirname(remotePath));
|
|
267
|
+
await sftpWriteFile(s, remotePath, Buffer.from(file.content, 'utf-8'));
|
|
268
|
+
success.push(file.relPath);
|
|
269
|
+
}
|
|
270
|
+
catch (err) {
|
|
271
|
+
if (isSessionFatal(err))
|
|
272
|
+
throw err;
|
|
273
|
+
failed.push({ path: file.relPath, error: err.message });
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
return { success, failed };
|
|
277
|
+
});
|
|
278
|
+
}
|
|
279
|
+
function sftpRealpath(s, p) {
|
|
280
|
+
return s.guard('realpath', p, () => new Promise((resolve, reject) => {
|
|
281
|
+
s.sftp.realpath(p, (err, abs) => {
|
|
282
|
+
if (err)
|
|
283
|
+
reject(err);
|
|
284
|
+
else
|
|
285
|
+
resolve(abs);
|
|
286
|
+
});
|
|
287
|
+
}));
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* SFTP reports a Windows (Win32-OpenSSH) path as "/C:/Users/x"; every member
|
|
291
|
+
* shell (PowerShell or Git Bash) wants "C:/Users/x". POSIX paths pass through.
|
|
292
|
+
*/
|
|
293
|
+
export function sftpPathToShellPath(p) {
|
|
294
|
+
return /^\/[A-Za-z]:/.test(p) ? p.slice(1) : p;
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Write a secret-bearing file into the connecting user's home directory over
|
|
298
|
+
* SFTP, so the value never appears in any command line on the member. The
|
|
299
|
+
* file is created owner-only (0600; Windows ignores the mode -- the user
|
|
300
|
+
* profile ACL is the boundary there). Returns the absolute path in the form
|
|
301
|
+
* the member's shell accepts, resolved by the SFTP server itself (never a
|
|
302
|
+
* guessed home directory).
|
|
303
|
+
*/
|
|
304
|
+
export async function writeSecretFileInHome(agent, fileName, content) {
|
|
305
|
+
if (!/^[A-Za-z0-9._-]+$/.test(fileName))
|
|
306
|
+
throw new Error(`Unsafe secret file name: ${fileName}`);
|
|
307
|
+
return withSftpSession(agent, undefined, async (s) => {
|
|
308
|
+
const home = (await sftpRealpath(s, '.')).replace(/\/+$/, '');
|
|
309
|
+
const remotePath = `${home}/${fileName}`;
|
|
310
|
+
// open (0600) -> fchmod -> write -> close: a server that ignores the
|
|
311
|
+
// open-time mode is still owner-only BEFORE any content lands. Windows
|
|
312
|
+
// servers ignore/reject the chmod -- not fatal there (profile ACL).
|
|
313
|
+
// Every step runs under the session's inactivity guard; the cleanup steps
|
|
314
|
+
// are best-effort (a timed-out session is already ended).
|
|
315
|
+
const data = Buffer.from(content, 'utf-8');
|
|
316
|
+
const handle = await s.guard('open', remotePath, () => new Promise((resolve, reject) => {
|
|
317
|
+
s.sftp.open(remotePath, 'w', { mode: 0o600 }, (err, h) => (err ? reject(err) : resolve(h)));
|
|
318
|
+
}));
|
|
319
|
+
let written = false;
|
|
105
320
|
try {
|
|
106
|
-
await
|
|
107
|
-
await
|
|
108
|
-
|
|
321
|
+
await s.guard('chmod', remotePath, () => new Promise((resolve) => { s.sftp.fchmod(handle, 0o600, () => resolve()); }));
|
|
322
|
+
await s.guard('write', remotePath, () => new Promise((resolve, reject) => {
|
|
323
|
+
s.sftp.write(handle, data, 0, data.length, 0, (err) => (err ? reject(err) : resolve()));
|
|
324
|
+
}));
|
|
325
|
+
written = true;
|
|
109
326
|
}
|
|
110
|
-
|
|
111
|
-
|
|
327
|
+
finally {
|
|
328
|
+
await s.guard('close', remotePath, () => new Promise((resolve) => { s.sftp.close(handle, () => resolve()); })).catch(() => { });
|
|
329
|
+
if (!written)
|
|
330
|
+
await s.guard('unlink', remotePath, () => new Promise((resolve) => { s.sftp.unlink(remotePath, () => resolve()); })).catch(() => { });
|
|
112
331
|
}
|
|
113
|
-
|
|
114
|
-
|
|
332
|
+
return sftpPathToShellPath(remotePath);
|
|
333
|
+
});
|
|
334
|
+
}
|
|
335
|
+
/** Best-effort removal of a file written by writeSecretFileInHome. */
|
|
336
|
+
export async function removeSecretFile(agent, shellPath) {
|
|
337
|
+
const sftpPath = /^[A-Za-z]:/.test(shellPath) ? `/${shellPath}` : shellPath;
|
|
338
|
+
await withSftpSession(agent, undefined, (s) => s.guard('unlink', sftpPath, () => new Promise((resolve) => {
|
|
339
|
+
s.sftp.unlink(sftpPath, () => resolve());
|
|
340
|
+
}))).catch(() => { });
|
|
115
341
|
}
|
|
116
342
|
export async function downloadViaSFTP(agent, remotePaths, localDestination, abortSignal) {
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
343
|
+
return withSftpSession(agent, abortSignal, async (s) => {
|
|
344
|
+
fs.mkdirSync(localDestination, { recursive: true });
|
|
345
|
+
const success = [];
|
|
346
|
+
const failed = [];
|
|
347
|
+
for (const remotePath of remotePaths) {
|
|
348
|
+
if (abortSignal?.aborted)
|
|
349
|
+
throw new Error('Aborted by client');
|
|
350
|
+
const resolvedRemote = resolveRemotePath(agent.workFolder, remotePath);
|
|
351
|
+
const fileName = path.posix.basename(resolvedRemote);
|
|
352
|
+
const localPath = path.join(localDestination, fileName);
|
|
353
|
+
try {
|
|
354
|
+
await sftpGet(s, resolvedRemote, localPath);
|
|
355
|
+
success.push(fileName);
|
|
356
|
+
}
|
|
357
|
+
catch (err) {
|
|
358
|
+
if (isSessionFatal(err))
|
|
359
|
+
throw err;
|
|
360
|
+
failed.push({ path: fileName, error: err.message });
|
|
361
|
+
}
|
|
131
362
|
}
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
return { success, failed };
|
|
363
|
+
return { success, failed };
|
|
364
|
+
});
|
|
137
365
|
}
|
|
138
366
|
//# sourceMappingURL=sftp.js.map
|
|
@@ -1,27 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Windows member shell probe (apra-fleet-7dir.1.3).
|
|
3
|
-
*
|
|
4
|
-
* Registration needs to know WHICH Windows shell a member's command strings
|
|
5
|
-
* should target -- Git-for-Windows bash, PowerShell 7, or Windows PowerShell
|
|
6
|
-
* 5.1 -- because the three are not interchangeable (PS7 vs PS5.1 module
|
|
7
|
-
* resolution differences are an already-known bug source here, and gitbash
|
|
8
|
-
* members want POSIX command strings entirely).
|
|
9
|
-
*
|
|
10
|
-
* Two hard-won constraints shape every probe below:
|
|
11
|
-
*
|
|
12
|
-
* 1. PowerShell reports false success on non-terminating errors, so an
|
|
13
|
-
* exit-code-only check is NOT evidence a candidate shell works. Every
|
|
14
|
-
* probe therefore asserts on a prefixed stdout marker as well as exit 0.
|
|
15
|
-
* 2. A `bash.exe` on PATH is not necessarily Git bash: Windows ships the WSL
|
|
16
|
-
* launcher under System32 (and WindowsApps) with the same binary name. It
|
|
17
|
-
* exits 0 and prints "Linux" for `uname -s`, so only the MINGW/MSYS/CYGWIN
|
|
18
|
-
* uname check disambiguates it. Verified on a real box: Git's bash prints
|
|
19
|
-
* "MINGW64_NT-10.0-19045", System32's prints "Linux".
|
|
20
|
-
*
|
|
21
|
-
* Every probe is issued through `powershell -EncodedCommand` (base64 UTF-16LE)
|
|
22
|
-
* so it survives regardless of whether the member's SSH default shell is
|
|
23
|
-
* cmd.exe or PowerShell -- no quoting of ours ever reaches an unknown parser.
|
|
24
|
-
*/
|
|
25
1
|
import type { MemberShell } from '../os/os-commands.js';
|
|
26
2
|
import type { RemoteOS } from '../utils/platform.js';
|
|
27
3
|
/** Result shape of a single probe command execution. */
|
|
@@ -1,3 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Windows member shell probe (apra-fleet-7dir.1.3).
|
|
3
|
+
*
|
|
4
|
+
* Registration needs to know WHICH Windows shell a member's command strings
|
|
5
|
+
* should target -- Git-for-Windows bash, PowerShell 7, or Windows PowerShell
|
|
6
|
+
* 5.1 -- because the three are not interchangeable (PS7 vs PS5.1 module
|
|
7
|
+
* resolution differences are an already-known bug source here, and gitbash
|
|
8
|
+
* members want POSIX command strings entirely).
|
|
9
|
+
*
|
|
10
|
+
* Two hard-won constraints shape every probe below:
|
|
11
|
+
*
|
|
12
|
+
* 1. PowerShell reports false success on non-terminating errors, so an
|
|
13
|
+
* exit-code-only check is NOT evidence a candidate shell works. Every
|
|
14
|
+
* probe therefore asserts on a prefixed stdout marker as well as exit 0.
|
|
15
|
+
* 2. A `bash.exe` on PATH is not necessarily Git bash: Windows ships the WSL
|
|
16
|
+
* launcher under System32 (and WindowsApps) with the same binary name. It
|
|
17
|
+
* exits 0 and prints "Linux" for `uname -s`, so only the MINGW/MSYS/CYGWIN
|
|
18
|
+
* uname check disambiguates it. Verified on a real box: Git's bash prints
|
|
19
|
+
* "MINGW64_NT-10.0-19045", System32's prints "Linux".
|
|
20
|
+
*
|
|
21
|
+
* Every probe is issued through `powershell -EncodedCommand` (base64 UTF-16LE)
|
|
22
|
+
* so it survives regardless of whether the member's SSH default shell is
|
|
23
|
+
* cmd.exe or PowerShell -- no quoting of ours ever reaches an unknown parser.
|
|
24
|
+
*/
|
|
25
|
+
import { escapePowerShellArgInner } from '../utils/shell-escape.js';
|
|
1
26
|
import { isWindowsPosixUname } from '../utils/platform.js';
|
|
2
27
|
import { wrapPowerShellEncoded } from '../os/windows.js';
|
|
3
28
|
import { GIT_BASH_MACHINE_CANDIDATES, GIT_BASH_USER_SUFFIX } from '../os/git-bash-candidates.js';
|
|
@@ -43,11 +68,11 @@ export function isWslLauncherPath(candidatePath) {
|
|
|
43
68
|
* process's own. */
|
|
44
69
|
export function buildGitBashDiscoveryCommand() {
|
|
45
70
|
const machineCandidates = GIT_BASH_MACHINE_CANDIDATES
|
|
46
|
-
.map((p) => `'${p
|
|
71
|
+
.map((p) => `'${escapePowerShellArgInner(p)}'`)
|
|
47
72
|
.join(',');
|
|
48
73
|
const ps = [
|
|
49
74
|
`$c = @(${machineCandidates})`,
|
|
50
|
-
`if ($env:LOCALAPPDATA) { $c += (Join-Path $env:LOCALAPPDATA '${GIT_BASH_USER_SUFFIX
|
|
75
|
+
`if ($env:LOCALAPPDATA) { $c += (Join-Path $env:LOCALAPPDATA '${escapePowerShellArgInner(GIT_BASH_USER_SUFFIX)}') }`,
|
|
51
76
|
`$c += @(Get-Command bash.exe -All -ErrorAction SilentlyContinue | ForEach-Object { $_.Source })`,
|
|
52
77
|
`$c | Where-Object { $_ -and (Test-Path -LiteralPath $_) } | Select-Object -Unique | ForEach-Object { Write-Output ('${BASH_CANDIDATE_MARKER}' + $_) }`,
|
|
53
78
|
].join('; ');
|
|
@@ -57,7 +82,7 @@ export function buildGitBashDiscoveryCommand() {
|
|
|
57
82
|
* it is. `&` is the call operator -- without it PowerShell would merely echo the
|
|
58
83
|
* quoted path back, exit 0, and look like a success. */
|
|
59
84
|
export function buildGitBashProbeCommand(bashPath) {
|
|
60
|
-
const quoted = bashPath
|
|
85
|
+
const quoted = escapePowerShellArgInner(bashPath);
|
|
61
86
|
return wrapPowerShellEncoded(`& '${quoted}' -lc 'uname -s'`);
|
|
62
87
|
}
|
|
63
88
|
/** Smoke command for PowerShell 7. Nested -EncodedCommand so neither our outer
|
|
@@ -1,17 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Singleton probe is tri-state (GitHub #584):
|
|
3
|
+
* - running: pid alive and /health answered 200.
|
|
4
|
+
* - unresponsive: pid alive and the recorded port still accepts TCP, but
|
|
5
|
+
* /health did not answer -- e.g. a server whose event loop is
|
|
6
|
+
* blocked. It is NOT dead: server.json is kept and launchers
|
|
7
|
+
* must refuse to start a second server on this data dir.
|
|
8
|
+
* - gone: no server.json, or its pid is dead, or the recorded port
|
|
9
|
+
* refuses TCP. Only this state unlinks server.json.
|
|
10
|
+
*/
|
|
11
|
+
export type InstanceState = 'running' | 'unresponsive' | 'gone';
|
|
1
12
|
export interface RunningInstance {
|
|
2
13
|
running: true;
|
|
14
|
+
state: 'running';
|
|
3
15
|
url: string;
|
|
4
16
|
pid: number;
|
|
5
17
|
/** Version reported by the running server's server.json, or undefined if it predates this field. */
|
|
6
18
|
version?: string;
|
|
7
19
|
}
|
|
8
|
-
export
|
|
20
|
+
export interface UnresponsiveInstance {
|
|
9
21
|
running: false;
|
|
10
|
-
|
|
22
|
+
state: 'unresponsive';
|
|
23
|
+
url: string;
|
|
24
|
+
pid: number;
|
|
25
|
+
port?: number;
|
|
26
|
+
version?: string;
|
|
27
|
+
}
|
|
28
|
+
export interface GoneInstance {
|
|
29
|
+
running: false;
|
|
30
|
+
state: 'gone';
|
|
31
|
+
/**
|
|
32
|
+
* Set when this probe found (and removed) a stale server.json -- a server
|
|
33
|
+
* that died without the clean shutdown that unlinks it (GitHub #585).
|
|
34
|
+
*/
|
|
35
|
+
previous?: PreviousServer;
|
|
36
|
+
}
|
|
37
|
+
/** What a stale server.json and its pid's log say about how that server ended. */
|
|
38
|
+
export interface PreviousServer {
|
|
39
|
+
pid: number;
|
|
40
|
+
startedAt?: string;
|
|
41
|
+
/** ts of the last line in logs/fleet-<pid>.log (or the file's mtime). */
|
|
42
|
+
lastLogAt?: string;
|
|
43
|
+
/** reason of the {"tag":"shutdown"} record in that log, if one was written. */
|
|
44
|
+
shutdownReason?: string;
|
|
45
|
+
}
|
|
46
|
+
export type InstanceCheckResult = RunningInstance | UnresponsiveInstance | GoneInstance;
|
|
11
47
|
export interface StartupLock {
|
|
12
48
|
acquired: boolean;
|
|
13
49
|
release: () => void;
|
|
14
50
|
}
|
|
51
|
+
export type TcpProbeResult = 'open' | 'refused' | 'timeout' | 'error';
|
|
52
|
+
/**
|
|
53
|
+
* Plain TCP connect probe. A server whose event loop is blocked still accepts
|
|
54
|
+
* connections (the kernel completes the handshake into the listen backlog),
|
|
55
|
+
* so 'open' means "something is listening", independent of whether it answers.
|
|
56
|
+
*/
|
|
57
|
+
export declare function probeTcpPort(port: number, host?: string, timeoutMs?: number): Promise<TcpProbeResult>;
|
|
58
|
+
/**
|
|
59
|
+
* True when <host>:<port> cannot be bound because it is already in use -- the
|
|
60
|
+
* exact failure the HTTP server would hit. A bind probe (not a connect probe):
|
|
61
|
+
* instant on every OS, where a refused connect takes ~2s on Windows.
|
|
62
|
+
*/
|
|
63
|
+
export declare function isPortInUse(port: number, host?: string): Promise<boolean>;
|
|
64
|
+
/** Inspect logs/fleet-<pid>.log for how a (dead) server ended. Never throws. */
|
|
65
|
+
export declare function inspectPreviousServer(pid: number, startedAt?: string): PreviousServer;
|
|
66
|
+
/**
|
|
67
|
+
* Operator-facing note about a previous server that left a stale server.json
|
|
68
|
+
* behind (a clean shutdown removes it), or null when there is nothing to say.
|
|
69
|
+
*/
|
|
70
|
+
export declare function describePreviousServer(prev: PreviousServer | undefined): string | null;
|
|
15
71
|
export declare function checkRunningInstance(): Promise<InstanceCheckResult>;
|
|
72
|
+
/** pid recorded in this data dir's server.json, if any (no liveness check, never deletes). */
|
|
73
|
+
export declare function readServerInfoPid(): number | undefined;
|
|
74
|
+
/** Operator-facing refusal for a live-but-unresponsive server. */
|
|
75
|
+
export declare function unresponsiveInstanceMessage(inst: UnresponsiveInstance): string;
|
|
76
|
+
/**
|
|
77
|
+
* Operator-facing error for a configured port that is already taken. The
|
|
78
|
+
* server never falls back to a random port: configured MCP clients only know
|
|
79
|
+
* the configured port, so a silent fallback produces an unreachable server.
|
|
80
|
+
*/
|
|
81
|
+
export declare function portInUseMessage(port: number, holderPid?: number): string;
|
|
16
82
|
export declare function claimStartupLock(): StartupLock;
|
|
17
83
|
//# sourceMappingURL=singleton.d.ts.map
|