@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
|
@@ -0,0 +1,710 @@
|
|
|
1
|
+
import type { Agent, FleetMcpStatus, LlmProvider, SSHExecResult } from '../types.js';
|
|
2
|
+
import type { TargetOS } from '../providers/provider.js';
|
|
3
|
+
import { getAgentShell } from '../utils/agent-helpers.js';
|
|
4
|
+
import { type StageSecretFileFn } from './member-access-secret.js';
|
|
5
|
+
type MemberShell = ReturnType<typeof getAgentShell>;
|
|
6
|
+
/** Emitted by the probe when the install path is not present/executable. */
|
|
7
|
+
export declare const NO_INSTALL_SENTINEL = "__APRA_FLEET_NO_INSTALL__";
|
|
8
|
+
/** Emitted by the probe when the path exists but running it failed. */
|
|
9
|
+
export declare const EXEC_FAILED_SENTINEL = "__APRA_FLEET_EXEC_FAILED__";
|
|
10
|
+
/** GitHub repo the tagged release assets are published to (.github/workflows/ci.yml). */
|
|
11
|
+
export declare const RELEASE_REPO = "Apra-Labs/apra-fleet";
|
|
12
|
+
/** Normalized CPU architecture names (Node's process.arch spelling). */
|
|
13
|
+
export type MemberArch = 'x64' | 'arm64' | string;
|
|
14
|
+
export interface MemberPlatform {
|
|
15
|
+
os: TargetOS;
|
|
16
|
+
arch: MemberArch;
|
|
17
|
+
}
|
|
18
|
+
/** Why a member could not be given an apra-fleet install. */
|
|
19
|
+
export type FleetInstallUnavailableReason =
|
|
20
|
+
/** The member's home directory could not be resolved, so no path can be built. */
|
|
21
|
+
'home-unresolved'
|
|
22
|
+
/** The member could not be probed (transport error, non-zero shell exit). */
|
|
23
|
+
| 'probe-failed'
|
|
24
|
+
/** The member's CPU architecture could not be determined. */
|
|
25
|
+
| 'arch-unknown'
|
|
26
|
+
/** Different OS/arch than the orchestrator and no release asset exists for it. */
|
|
27
|
+
| 'unsupported-platform'
|
|
28
|
+
/** Same platform, but this orchestrator is not a single-executable binary to
|
|
29
|
+
* copy, and no release asset could be fetched either. */
|
|
30
|
+
| 'no-install-source'
|
|
31
|
+
/** Downloading the release asset failed. */
|
|
32
|
+
| 'download-failed'
|
|
33
|
+
/** The release asset download did not finish within the bounded timeout. Recoverable: retry. */
|
|
34
|
+
| 'download-timeout'
|
|
35
|
+
/** The downloaded asset's SHA-256 does not match the published checksum; it was discarded. */
|
|
36
|
+
| 'checksum-mismatch'
|
|
37
|
+
/** No published checksum for the asset could be fetched, so it cannot be verified; it was discarded. */
|
|
38
|
+
| 'checksum-unavailable'
|
|
39
|
+
/** No published release (exact-build prerelease, or stable release whose
|
|
40
|
+
* BUILD_INFO names this build) carries an installer for the orchestrator's
|
|
41
|
+
* build. */
|
|
42
|
+
| 'no-matching-release'
|
|
43
|
+
/** The member apra-fleet install has no member-install marker (a full install, or a member install older than the
|
|
44
|
+
* marker): it was not installed over, its server (if running) was left running, and the member was not
|
|
45
|
+
* self-registered into it. */
|
|
46
|
+
| 'full-install-running'
|
|
47
|
+
/** Copying the installer onto the member failed. */
|
|
48
|
+
| 'transfer-failed'
|
|
49
|
+
/** The installer ran but exited non-zero. */
|
|
50
|
+
| 'install-failed'
|
|
51
|
+
/** After installing, the member still does not report a version >= the
|
|
52
|
+
* orchestrator's. */
|
|
53
|
+
| 'install-unverified'
|
|
54
|
+
/** The opt-in full-install replacement (fleet_install "replace-full") failed
|
|
55
|
+
* at a step that ran on the member; the detail names the step and, from the
|
|
56
|
+
* uninstall step on, the rollback commands. */
|
|
57
|
+
| 'replace-failed';
|
|
58
|
+
/** What the probe observed about the member's current install. */
|
|
59
|
+
export type MemberFleetProbe = {
|
|
60
|
+
kind: 'installed';
|
|
61
|
+
version: string;
|
|
62
|
+
binPath: string;
|
|
63
|
+
} | {
|
|
64
|
+
kind: 'missing';
|
|
65
|
+
binPath: string;
|
|
66
|
+
} | {
|
|
67
|
+
kind: 'broken';
|
|
68
|
+
binPath: string;
|
|
69
|
+
detail: string;
|
|
70
|
+
} | {
|
|
71
|
+
kind: 'probe-failed';
|
|
72
|
+
detail: string;
|
|
73
|
+
};
|
|
74
|
+
export type InstallSource = {
|
|
75
|
+
kind: 'orchestrator-executable';
|
|
76
|
+
localPath: string;
|
|
77
|
+
} | {
|
|
78
|
+
kind: 'release-asset';
|
|
79
|
+
assetName: string;
|
|
80
|
+
/** The first URL tried (candidates[0]). */
|
|
81
|
+
url: string;
|
|
82
|
+
/** Releases tried in order (stable first, BUILD_INFO-gated, then the
|
|
83
|
+
* exact-build prerelease) until one has a verified asset for this
|
|
84
|
+
* build; see releaseCandidatesFor and fetchReleaseInstaller. */
|
|
85
|
+
candidates: ReleaseCandidate[];
|
|
86
|
+
};
|
|
87
|
+
export type MemberFleetInstallResult = {
|
|
88
|
+
state: 'available';
|
|
89
|
+
/** Version the member reports after this call. */
|
|
90
|
+
version: string;
|
|
91
|
+
/** True when this call ran an install; false when the existing install
|
|
92
|
+
* was already up to date. */
|
|
93
|
+
installed: boolean;
|
|
94
|
+
source?: InstallSource['kind'];
|
|
95
|
+
binPath: string;
|
|
96
|
+
/** Set when this call replaced an unmarked (full) install with a member
|
|
97
|
+
* install (fleet_install "replace-full"). */
|
|
98
|
+
replaced?: ReplacedFullInstall;
|
|
99
|
+
/** Set when no release carried the exact build and the signed stable
|
|
100
|
+
* release of the same core was installed instead. */
|
|
101
|
+
sameCoreFallback?: SameCoreFallback;
|
|
102
|
+
} | {
|
|
103
|
+
state: 'unavailable';
|
|
104
|
+
reason: FleetInstallUnavailableReason;
|
|
105
|
+
detail?: string;
|
|
106
|
+
/** Version observed before any install attempt, if one was present. */
|
|
107
|
+
version?: string;
|
|
108
|
+
/** OS-correct manual install steps for the member (buildManualInstallSteps). */
|
|
109
|
+
manualSteps?: string;
|
|
110
|
+
};
|
|
111
|
+
/** Injected transports. Production defaults come from defaultMemberFleetInstallDeps(). */
|
|
112
|
+
export interface MemberFleetInstallDeps {
|
|
113
|
+
exec(agent: Agent, command: string, timeoutMs: number): Promise<SSHExecResult>;
|
|
114
|
+
/** Copy local files into an ABSOLUTE member directory (file basename kept). */
|
|
115
|
+
transfer(agent: Agent, localPaths: string[], destinationDir: string): Promise<{
|
|
116
|
+
success: string[];
|
|
117
|
+
failed: {
|
|
118
|
+
path: string;
|
|
119
|
+
error: string;
|
|
120
|
+
}[];
|
|
121
|
+
}>;
|
|
122
|
+
resolveHome(agent: Agent): Promise<string | null>;
|
|
123
|
+
orchestratorPlatform(): MemberPlatform;
|
|
124
|
+
/** Path of the orchestrator's own single-executable binary, or null when it
|
|
125
|
+
* does not run as one (npm/dev mode: there is nothing self-contained to copy). */
|
|
126
|
+
orchestratorExecutable(): string | null;
|
|
127
|
+
orchestratorVersion(): string;
|
|
128
|
+
/** Download `url` to a local temp file named `assetName`, verified against
|
|
129
|
+
* the release's SHA256SUMS; returns its path. With `expectBuild`, the
|
|
130
|
+
* release must also be that build (its BUILD_INFO). Throws on failure
|
|
131
|
+
* (a ReleaseDownloadError names the reason). */
|
|
132
|
+
downloadReleaseAsset(url: string, assetName: string, expectBuild?: string): Promise<string>;
|
|
133
|
+
/** Remove a local temp file created by downloadReleaseAsset. Best effort. */
|
|
134
|
+
removeLocal(localPath: string): void;
|
|
135
|
+
/** Clock for the full-install replacement's backup timestamp. Optional:
|
|
136
|
+
* absent means the real clock. */
|
|
137
|
+
now?(): Date;
|
|
138
|
+
}
|
|
139
|
+
/** Executable name apra-fleet installs itself as on the member's OS. */
|
|
140
|
+
export declare function binaryNameFor(targetOs: TargetOS): string;
|
|
141
|
+
/** Join path segments with the member's separator. A POSIX shell on Windows
|
|
142
|
+
* (gitbash) has a POSIX-style home (/c/Users/x) and takes '/'. */
|
|
143
|
+
export declare function memberJoin(targetOs: TargetOS, shell: MemberShell, ...parts: string[]): string;
|
|
144
|
+
/** Pick the POSIX or PowerShell form of a member-bound command. PowerShell is
|
|
145
|
+
* always delivered via -EncodedCommand so no intermediate shell re-tokenizes it. */
|
|
146
|
+
export declare function memberCommandFor(targetOs: TargetOS, shell: MemberShell, forms: {
|
|
147
|
+
posix: string;
|
|
148
|
+
powershell: string;
|
|
149
|
+
}): string;
|
|
150
|
+
/**
|
|
151
|
+
* The member-side version probe, built from an already-resolved absolute path.
|
|
152
|
+
*
|
|
153
|
+
* Both branches exit 0 and TAG their outcome in stdout, so a non-zero exit
|
|
154
|
+
* means "the shell/transport itself failed" and nothing else.
|
|
155
|
+
*
|
|
156
|
+
* POWERSHELL BRANCH -- DO NOT "SIMPLIFY" THE $LASTEXITCODE TEST OR THE TRAILING
|
|
157
|
+
* `exit 0` (ported from PR 543). PowerShell raises NO terminating error when a
|
|
158
|
+
* NATIVE executable exits non-zero, so a bare try/catch never reaches its catch
|
|
159
|
+
* for a present-but-broken install: the probe would return partial stdout (which
|
|
160
|
+
* may even look like a version) and wrapPowerShellEncoded would propagate the
|
|
161
|
+
* leftover $LASTEXITCODE as the exit code. The explicit $LASTEXITCODE branch
|
|
162
|
+
* reports such an install as EXEC_FAILED instead of reading its output as a
|
|
163
|
+
* version; the catch still covers a path that cannot be launched at all.
|
|
164
|
+
*/
|
|
165
|
+
export declare function buildFleetVersionProbe(binPath: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
166
|
+
/** The member's CPU architecture, as one raw token on stdout. */
|
|
167
|
+
export declare function buildArchProbe(targetOs: TargetOS, shell: MemberShell): string;
|
|
168
|
+
/** Normalize uname -m / PROCESSOR_ARCHITECTURE output to Node's process.arch names. */
|
|
169
|
+
export declare function normalizeArch(raw: string): MemberArch | null;
|
|
170
|
+
/** First `apra-fleet <version>` line in the probe output, or null. */
|
|
171
|
+
export declare function parseFleetVersion(stdout: string): string | null;
|
|
172
|
+
/** True when the member's version is older than the orchestrator's (semver
|
|
173
|
+
* core only; a dev build's _hash suffix is ignored). */
|
|
174
|
+
export declare function isOlderThan(memberVersion: string, orchestratorVersion: string): boolean;
|
|
175
|
+
/**
|
|
176
|
+
* Build-aware outdated check for the member install (exported for tests).
|
|
177
|
+
* Rule: a member core OLDER than the orchestrator's is always outdated; a
|
|
178
|
+
* NEWER core never is (never downgrade, whatever the suffixes). At the SAME
|
|
179
|
+
* core, a differing build suffix counts as outdated only when
|
|
180
|
+
* `canSupplyOrchestratorBuild` -- i.e. the source installs exactly the
|
|
181
|
+
* orchestrator's build: its own executable, or (suffixed orchestrator) a
|
|
182
|
+
* release whose BUILD_INFO names that build (sourceSuppliesBuild). A bare
|
|
183
|
+
* release orchestrator installs whatever build its stable tag has, so a
|
|
184
|
+
* same-core build difference there is "up to date" (else it would reinstall
|
|
185
|
+
* on every registration and report install-unverified). Mixed
|
|
186
|
+
* suffix/no-suffix at the same core follows the same rule; identical
|
|
187
|
+
* versions are never outdated.
|
|
188
|
+
* isNewer/parseVersion (shared with the CLI self-update check) are untouched.
|
|
189
|
+
*/
|
|
190
|
+
export declare function isMemberOutdated(memberVersion: string, orchestratorVersion: string, canSupplyOrchestratorBuild: boolean): boolean;
|
|
191
|
+
/** Release asset names published by .github/workflows/ci.yml, by platform. */
|
|
192
|
+
export declare const RELEASE_ASSETS: Record<string, string>;
|
|
193
|
+
export declare function releaseAssetNameFor(platform: MemberPlatform): string | null;
|
|
194
|
+
/** `v0.4.4_abc123` -> `v0.4.4`: the STABLE release tag of a build's core version. */
|
|
195
|
+
export declare function releaseTagFor(version: string): string;
|
|
196
|
+
/** `v0.4.4_abc123` -> `v0.4.4_abc123`: the exact-build prerelease tag CI
|
|
197
|
+
* publishes for builds of its prerelease branches (ci.yml job prerelease),
|
|
198
|
+
* or null for a bare release version, which has no build to match. */
|
|
199
|
+
export declare function prereleaseTagFor(version: string): string | null;
|
|
200
|
+
/** Anonymous download URL of `fileName` in the release tagged `tag`. */
|
|
201
|
+
export declare function releaseFileUrl(tag: string, fileName: string): string;
|
|
202
|
+
/** Human-browsable page of the release tagged `tag`. */
|
|
203
|
+
export declare function releasePageUrl(tag: string): string;
|
|
204
|
+
/** Where a build's installer may be published, in the order the installer
|
|
205
|
+
* tries them: the STABLE release of the core version first, accepted only
|
|
206
|
+
* when its BUILD_INFO names the same build (see buildInfoMatches) -- stable
|
|
207
|
+
* tag builds carry a build suffix too, and their commit also gets an
|
|
208
|
+
* unsigned prerelease when it is pushed to main, so a stable orchestrator
|
|
209
|
+
* must get the signed stable assets -- then the exact-build prerelease
|
|
210
|
+
* (dev/branch builds). The same-core stable fallback is not a candidate: it
|
|
211
|
+
* is a separate, opt-in last step in fetchReleaseInstaller. */
|
|
212
|
+
export interface ReleaseCandidate {
|
|
213
|
+
tag: string;
|
|
214
|
+
channel: 'prerelease' | 'stable';
|
|
215
|
+
}
|
|
216
|
+
export declare function releaseCandidatesFor(version: string): ReleaseCandidate[];
|
|
217
|
+
/** The URL the installer tries first for `version` (the stable release). */
|
|
218
|
+
export declare function releaseAssetUrl(version: string, assetName: string): string;
|
|
219
|
+
/**
|
|
220
|
+
* Choose where the member's install comes from (pure; exported for tests).
|
|
221
|
+
* same OS+arch and a copyable orchestrator executable -> that executable;
|
|
222
|
+
* otherwise a release asset for the member's platform;
|
|
223
|
+
* otherwise unavailable(<reason>).
|
|
224
|
+
*/
|
|
225
|
+
export declare function chooseInstallSource(member: MemberPlatform, orchestrator: MemberPlatform, orchestratorExecutable: string | null, orchestratorVersion: string): InstallSource | {
|
|
226
|
+
kind: 'unavailable';
|
|
227
|
+
reason: FleetInstallUnavailableReason;
|
|
228
|
+
detail: string;
|
|
229
|
+
};
|
|
230
|
+
/** The member-mode install command line arguments (exported for tests). */
|
|
231
|
+
export declare function memberInstallArgs(provider: LlmProvider): string[];
|
|
232
|
+
/** Command that makes the staged installer executable and runs it in member mode. */
|
|
233
|
+
export declare function buildInstallCommand(installerPath: string, provider: LlmProvider, targetOs: TargetOS, shell: MemberShell): string;
|
|
234
|
+
/** Bound on each release HTTP request (asset and checksum list). */
|
|
235
|
+
export declare const DOWNLOAD_TIMEOUT_MS = 120000;
|
|
236
|
+
/** Name of the checksum list published next to the release assets (ci.yml release job). */
|
|
237
|
+
export declare const CHECKSUM_ASSET = "SHA256SUMS";
|
|
238
|
+
/** Build marker published next to the release assets (ci.yml release and
|
|
239
|
+
* prerelease jobs): `version=<exact build version>` and `commit=<full sha>`
|
|
240
|
+
* lines, itself listed in SHA256SUMS. */
|
|
241
|
+
export declare const BUILD_INFO_ASSET = "BUILD_INFO";
|
|
242
|
+
/** Typed download failure reasons. `release-not-found` (the tag has no
|
|
243
|
+
* release: SHA256SUMS is HTTP 404) and `build-mismatch` (the release is not
|
|
244
|
+
* this build) only move on to the next candidate release; when every
|
|
245
|
+
* candidate ends that way the result is `no-matching-release`. */
|
|
246
|
+
export type ReleaseDownloadReason = 'download-failed' | 'download-timeout' | 'checksum-mismatch' | 'checksum-unavailable' | 'release-not-found' | 'build-mismatch' | 'no-matching-release';
|
|
247
|
+
/** A typed download failure; ensureOnce maps `reason` onto the fleetMcp status. */
|
|
248
|
+
export declare class ReleaseDownloadError extends Error {
|
|
249
|
+
readonly reason: ReleaseDownloadReason;
|
|
250
|
+
/** HTTP status of the failed request, when it got an answer. */
|
|
251
|
+
readonly status?: number | undefined;
|
|
252
|
+
constructor(reason: ReleaseDownloadReason, message: string,
|
|
253
|
+
/** HTTP status of the failed request, when it got an answer. */
|
|
254
|
+
status?: number | undefined);
|
|
255
|
+
}
|
|
256
|
+
/** Parse BUILD_INFO (`key=value` lines). */
|
|
257
|
+
export declare function parseBuildInfo(text: string): {
|
|
258
|
+
version?: string;
|
|
259
|
+
commit?: string;
|
|
260
|
+
};
|
|
261
|
+
/**
|
|
262
|
+
* Does a release's BUILD_INFO describe the build `expected` (the
|
|
263
|
+
* orchestrator's version)? A dev/branch build `v<x.y.z>_<sha6>` matches only
|
|
264
|
+
* the same version, or the same core built from a commit starting with that
|
|
265
|
+
* sha; a bare release version `v<x.y.z>` matches any build of that core.
|
|
266
|
+
*/
|
|
267
|
+
export declare function buildInfoMatches(info: {
|
|
268
|
+
version?: string;
|
|
269
|
+
commit?: string;
|
|
270
|
+
}, expected: string): boolean;
|
|
271
|
+
/** The expected hex digest for `assetName` in a `sha256sum`-format list, or null. */
|
|
272
|
+
export declare function parseSha256Sums(text: string, assetName: string): string | null;
|
|
273
|
+
export interface DownloadOpts {
|
|
274
|
+
fetchImpl?: typeof fetch;
|
|
275
|
+
timeoutMs?: number;
|
|
276
|
+
/** The build the release must be (the orchestrator's version). When set,
|
|
277
|
+
* the release is resolved, not assumed: SHA256SUMS HTTP 404 is
|
|
278
|
+
* `release-not-found`, and the release's BUILD_INFO (listed in SHA256SUMS
|
|
279
|
+
* and checksum-verified) must name this build, else `build-mismatch`. */
|
|
280
|
+
expectBuild?: string;
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* Download a release asset to a temp file, bounded by a timeout, and verify its
|
|
284
|
+
* SHA-256 against the release's published SHA256SUMS before returning the path.
|
|
285
|
+
* Fails closed: a missing checksum is `checksum-unavailable`, a differing one
|
|
286
|
+
* `checksum-mismatch`; nothing unverified is ever written to disk.
|
|
287
|
+
*/
|
|
288
|
+
export declare function downloadVerifiedAsset(url: string, assetName: string, opts?: DownloadOpts): Promise<string>;
|
|
289
|
+
/**
|
|
290
|
+
* Fetch the verified installer for the orchestrator's build from the first
|
|
291
|
+
* candidate release that has it: the stable release whose BUILD_INFO names
|
|
292
|
+
* this build, then the exact-build prerelease, then -- only with
|
|
293
|
+
* `allowSameCoreStable` (member has no apra-fleet or an older core) -- the
|
|
294
|
+
* signed stable release of the same core (never across cores). Only a
|
|
295
|
+
* missing release or one that is not this build moves on to the next
|
|
296
|
+
* candidate; any other failure (network, timeout, checksum) is reported as
|
|
297
|
+
* itself, never hidden behind the fallback. Anonymous URLs only.
|
|
298
|
+
*/
|
|
299
|
+
export declare function fetchReleaseInstaller(deps: Pick<MemberFleetInstallDeps, 'downloadReleaseAsset'>, source: Extract<InstallSource, {
|
|
300
|
+
kind: 'release-asset';
|
|
301
|
+
}>, orchestratorVersion: string, opts?: {
|
|
302
|
+
allowSameCoreStable?: boolean;
|
|
303
|
+
}): Promise<FetchedReleaseInstaller>;
|
|
304
|
+
/** The signed stable release installed in place of an unpublished exact build. */
|
|
305
|
+
export interface SameCoreFallback {
|
|
306
|
+
/** The stable tag installed, e.g. v0.4.4. */
|
|
307
|
+
tag: string;
|
|
308
|
+
/** The orchestrator build that has no published release. */
|
|
309
|
+
wantedBuild: string;
|
|
310
|
+
/** Why the exact build could not be fetched. */
|
|
311
|
+
why: string;
|
|
312
|
+
}
|
|
313
|
+
/** A fetched, verified installer and where it came from. */
|
|
314
|
+
export interface FetchedReleaseInstaller {
|
|
315
|
+
localPath: string;
|
|
316
|
+
url: string;
|
|
317
|
+
tag: string;
|
|
318
|
+
/** Set when no release carries the exact build and the signed stable
|
|
319
|
+
* release of the same core was used instead. */
|
|
320
|
+
sameCoreFallback?: {
|
|
321
|
+
wantedBuild: string;
|
|
322
|
+
why: string;
|
|
323
|
+
};
|
|
324
|
+
}
|
|
325
|
+
export declare function defaultMemberFleetInstallDeps(): MemberFleetInstallDeps;
|
|
326
|
+
/** Where the member's own apra-fleet lives: <home>/.apra-fleet/bin/<exe>. */
|
|
327
|
+
export declare function memberBinPath(home: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
328
|
+
/** Where installers are staged before running: <home>/.apra-fleet/staging. */
|
|
329
|
+
export declare function memberStagingDir(home: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
330
|
+
/** Probe a member's apra-fleet at `binPath`. Never throws. */
|
|
331
|
+
export declare function probeMemberFleetVersion(agent: Agent, binPath: string, deps: MemberFleetInstallDeps): Promise<MemberFleetProbe>;
|
|
332
|
+
/** Where the installer for the replacement ended up (or why it did not). */
|
|
333
|
+
export type ReplacementInstaller = {
|
|
334
|
+
staged: true;
|
|
335
|
+
path: string;
|
|
336
|
+
} | {
|
|
337
|
+
staged: false;
|
|
338
|
+
why: string;
|
|
339
|
+
target: string;
|
|
340
|
+
fetchCommand?: string;
|
|
341
|
+
};
|
|
342
|
+
/**
|
|
343
|
+
* The manual steps an OWNER runs on the member to replace an unmarked install
|
|
344
|
+
* (a full install, or a member install older than the marker) with a member
|
|
345
|
+
* install, which writes the marker. Every path is resolved here in JS from the
|
|
346
|
+
* probed home -- no ~ or $HOME -- and quoted for the member's shell. The fleet
|
|
347
|
+
* never runs these itself. Steps use the INSTALLED binary only for `uninstall`
|
|
348
|
+
* (present in old installs) and the freshly STAGED current installer for the
|
|
349
|
+
* install, so no flag the old binary predates is ever needed. ASCII, one line.
|
|
350
|
+
*/
|
|
351
|
+
export declare function buildFullInstallReplaceHint(opts: {
|
|
352
|
+
home: string;
|
|
353
|
+
targetOs: TargetOS;
|
|
354
|
+
shell: MemberShell;
|
|
355
|
+
provider: LlmProvider;
|
|
356
|
+
installer: ReplacementInstaller;
|
|
357
|
+
}): string;
|
|
358
|
+
/** The explicit fleet_install value that lets the fleet replace an unmarked
|
|
359
|
+
* (full) install with a member install. Never implied by "auto". */
|
|
360
|
+
export declare const REPLACE_FULL_INSTALL = "replace-full";
|
|
361
|
+
/** Tag the linux supervisor step prints when it moved a unit file into the backup. */
|
|
362
|
+
export declare const SUPERVISOR_MOVED_SENTINEL = "__APRA_FLEET_SUPERVISOR_MOVED__";
|
|
363
|
+
/** What a successful replacement removed and where the backup is. */
|
|
364
|
+
export interface ReplacedFullInstall {
|
|
365
|
+
/** The replaced install's version. */
|
|
366
|
+
previousVersion: string;
|
|
367
|
+
/** Human-readable items the replacement removed or moved. */
|
|
368
|
+
removed: string[];
|
|
369
|
+
/** Timestamped backup directory on the member (data/ and fleet.key). */
|
|
370
|
+
backupPath: string;
|
|
371
|
+
}
|
|
372
|
+
export type ReplaceStepName = 'backup' | 'uninstall' | 'supervisor' | 'move-data' | 'install';
|
|
373
|
+
export interface ReplaceFullInstallPlan {
|
|
374
|
+
backupDir: string;
|
|
375
|
+
dataAside: string;
|
|
376
|
+
/** Ordered member-bound commands (already wrapped for the member's shell). */
|
|
377
|
+
steps: Array<{
|
|
378
|
+
name: ReplaceStepName;
|
|
379
|
+
command: string;
|
|
380
|
+
}>;
|
|
381
|
+
/** Rollback commands, in order, per failed step (empty for a backup failure):
|
|
382
|
+
* data/ is left in place before step 4 completes, restored from dataAside
|
|
383
|
+
* after it, and the (possibly torn) backup copy is only a last resort. */
|
|
384
|
+
rollbackFor: Record<ReplaceStepName | 'verify', string[]>;
|
|
385
|
+
}
|
|
386
|
+
/** Path-safe UTC stamp (no ':'): 20261006T143000Z. */
|
|
387
|
+
export declare function replaceBackupStamp(d: Date): string;
|
|
388
|
+
/**
|
|
389
|
+
* The member-bound command sequence of the opt-in replacement (pure; exported
|
|
390
|
+
* for tests). Every path is resolved here from the probed home and quoted for
|
|
391
|
+
* the member's shell; PowerShell is wrapped via -EncodedCommand. Steps:
|
|
392
|
+
* backup -- copy data/ and fleet.key (outside data/) into a timestamped dir;
|
|
393
|
+
* uninstall -- the INSTALLED binary's own uninstall --force --yes;
|
|
394
|
+
* supervisor -- linux: stop/disable the fleet-supervisor user unit when its
|
|
395
|
+
* unit file exists, move the file into the backup, daemon-reload
|
|
396
|
+
* (uninstall leaves it running);
|
|
397
|
+
* move-data -- move data/ aside;
|
|
398
|
+
* install -- the staged CURRENT installer in member mode.
|
|
399
|
+
* Self-registration and the per-folder MCP entry follow in the probe.
|
|
400
|
+
*/
|
|
401
|
+
export declare function buildReplaceFullInstallPlan(opts: {
|
|
402
|
+
home: string;
|
|
403
|
+
targetOs: TargetOS;
|
|
404
|
+
shell: MemberShell;
|
|
405
|
+
provider: LlmProvider;
|
|
406
|
+
installerPath: string;
|
|
407
|
+
stamp: string;
|
|
408
|
+
}): ReplaceFullInstallPlan;
|
|
409
|
+
/** The member-install marker on the member: <home>/.apra-fleet/data/member-install.json
|
|
410
|
+
* (written by `install --member`, cleared by a full install; see
|
|
411
|
+
* src/cli/install-guard.ts writeMemberInstallMarker). Built in JS from the
|
|
412
|
+
* probed home. */
|
|
413
|
+
export declare function memberInstallMarkerPathFor(home: string, agent: Agent): string;
|
|
414
|
+
/** Outcome of the member-install marker probe: three-way, never a boolean. */
|
|
415
|
+
export type MemberMarkerProbe = {
|
|
416
|
+
kind: 'present';
|
|
417
|
+
} | {
|
|
418
|
+
kind: 'absent';
|
|
419
|
+
} | {
|
|
420
|
+
kind: 'probe-failed';
|
|
421
|
+
detail: string;
|
|
422
|
+
};
|
|
423
|
+
/**
|
|
424
|
+
* Probe whether the member's apra-fleet install carries the member-install
|
|
425
|
+
* marker, i.e. it is a member install the fleet may manage and self-register
|
|
426
|
+
* into.
|
|
427
|
+
*
|
|
428
|
+
* The marker is the SOLE fleet-ownership signal. An install without it is
|
|
429
|
+
* either a human full install or a member install made before the marker
|
|
430
|
+
* existed; nothing on the member tells the two apart (both may hold a LOCAL
|
|
431
|
+
* registry entry for this member's uuid, because builds before this rule
|
|
432
|
+
* self-registered into any install), so the fleet treats both as not its own:
|
|
433
|
+
* it never self-registers into them and never sends --force-stop-full-install.
|
|
434
|
+
*
|
|
435
|
+
* Three outcomes: present (exit 0), cleanly absent (`test -f` / Test-Path exit
|
|
436
|
+
* 1) and probe-failed (a timeout or transport error, or any other non-zero
|
|
437
|
+
* exit such as 126/127/255) with the reason. A probe failure is never read as
|
|
438
|
+
* "absent": a slow or flaky member is not an unowned one. Never throws.
|
|
439
|
+
*/
|
|
440
|
+
export declare function probeMemberInstallMarker(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<MemberMarkerProbe>;
|
|
441
|
+
/**
|
|
442
|
+
* Ensure a REMOTE member runs an apra-fleet at least as new as this
|
|
443
|
+
* orchestrator, installed in HTTP member mode. Never throws: every failure is a
|
|
444
|
+
* typed `unavailable(<reason>)` result so the caller's registration proceeds.
|
|
445
|
+
*/
|
|
446
|
+
export declare function ensureMemberFleetInstall(agent: Agent, deps?: MemberFleetInstallDeps, opts?: {
|
|
447
|
+
force?: boolean;
|
|
448
|
+
replaceFull?: boolean;
|
|
449
|
+
}): Promise<MemberFleetInstallResult>;
|
|
450
|
+
/**
|
|
451
|
+
* The exact steps an owner runs ON THE MEMBER to install this orchestrator's
|
|
452
|
+
* build by hand when the fleet could not (pure; exported for tests). Built in
|
|
453
|
+
* JS for the member's OS/shell from the probed home -- no ~, $HOME or other
|
|
454
|
+
* shell expansion -- with every path and URL quoted. The download is the
|
|
455
|
+
* anonymous release URL the fleet itself tried first (no GitHub account
|
|
456
|
+
* needed); the SHA-256 check uses the release's SHA256SUMS (sha256sum on
|
|
457
|
+
* linux and Git Bash, shasum -a 256 on macOS, Get-FileHash in PowerShell).
|
|
458
|
+
* ASCII; one step per line.
|
|
459
|
+
*/
|
|
460
|
+
export declare function buildManualInstallSteps(opts: {
|
|
461
|
+
home: string | null;
|
|
462
|
+
targetOs: TargetOS;
|
|
463
|
+
shell: MemberShell;
|
|
464
|
+
provider: LlmProvider;
|
|
465
|
+
arch: MemberArch | null;
|
|
466
|
+
orchestratorVersion: string;
|
|
467
|
+
reason: FleetInstallUnavailableReason;
|
|
468
|
+
}): string;
|
|
469
|
+
/**
|
|
470
|
+
* The prominent WARNING register_member / update_member print when a
|
|
471
|
+
* requested apra-fleet install/upgrade on the member did not happen, or null
|
|
472
|
+
* when there is nothing to warn about. Names (a) the consequence, (b) the
|
|
473
|
+
* exact reason and (c) the manual steps. The tool call itself succeeds. ASCII.
|
|
474
|
+
*/
|
|
475
|
+
export declare function fleetInstallWarning(memberName: string, status: FleetMcpStatus): string | null;
|
|
476
|
+
/** Machine-readable fleetMcp reasons beyond the install reasons above. */
|
|
477
|
+
export type FleetMcpUnavailableReason = FleetInstallUnavailableReason
|
|
478
|
+
/** The member's install predates `register-member --id`. */
|
|
479
|
+
| 'install-too-old'
|
|
480
|
+
/** The member's own install has the work folder registered under another id. */
|
|
481
|
+
| 'E-FOLDER-TAKEN'
|
|
482
|
+
/** register-member on the member's own install failed for another reason. */
|
|
483
|
+
| 'register-failed'
|
|
484
|
+
/** The per-folder apra-fleet MCP entry compose_permissions writes is absent
|
|
485
|
+
* or does not point at ?member=<uuid>. */
|
|
486
|
+
| 'mcp-entry-missing'
|
|
487
|
+
/** claude: the role files a `--agent <role>` dispatch loads have a tools
|
|
488
|
+
* allowlist without the member kb_* / code_* tools, so dispatched roles
|
|
489
|
+
* never see them even though the member session lists them. */
|
|
490
|
+
| 'role-agents-hide-member-tools'
|
|
491
|
+
/** agy has no per-project MCP config fleet can point at the member session. */
|
|
492
|
+
| 'no-per-project-mcp'
|
|
493
|
+
/** The member's LLM provider has no MCP entry fleet configures. */
|
|
494
|
+
| 'provider-unsupported'
|
|
495
|
+
/** A member config file compose must edit exists but could not be read; compose wrote nothing to it. */
|
|
496
|
+
| 'member-config-unreadable'
|
|
497
|
+
/** A member config file compose must edit is not strict JSON; compose wrote nothing to it. */
|
|
498
|
+
| 'member-config-unparseable'
|
|
499
|
+
/** The work folder's opencode.json is tracked by git; compose left it untouched. */
|
|
500
|
+
| 'opencode-config-tracked'
|
|
501
|
+
/** The work folder's opencode.json is not strict JSON (e.g. JSONC); compose left it untouched. */
|
|
502
|
+
| 'opencode-config-unparseable'
|
|
503
|
+
/** A MEMBER session could not be opened or its version call failed. */
|
|
504
|
+
| 'member-session-failed'
|
|
505
|
+
/** The MEMBER session answered but did not list kb_* and code_* tools. */
|
|
506
|
+
| 'member-tools-missing'
|
|
507
|
+
/** The member install's member access secret (which its server requires on
|
|
508
|
+
* a ?member= session) could not be read, or created when missing. */
|
|
509
|
+
| 'member-secret-unavailable';
|
|
510
|
+
/** Reasons the sprint init (not the server probe) records for providers it treats as unverified. */
|
|
511
|
+
export type FleetMcpProviderReason = 'no-per-tool-deny' | 'no-per-project-mcp';
|
|
512
|
+
/**
|
|
513
|
+
* One-line operator fix per fleetMcp reason. ASCII only, no newlines. Covers
|
|
514
|
+
* every FleetMcpUnavailableReason plus the provider-level reasons the sprint
|
|
515
|
+
* init records (opencode: no-per-tool-deny; agy: no-per-project-mcp).
|
|
516
|
+
*/
|
|
517
|
+
export declare const FLEET_MCP_FIX: Record<FleetMcpUnavailableReason | FleetMcpProviderReason, string>;
|
|
518
|
+
/**
|
|
519
|
+
* The one-line fix to show for a fleetMcp status, or null when the member's KB
|
|
520
|
+
* and code tools are usable (available and not flagged unverified).
|
|
521
|
+
*/
|
|
522
|
+
export declare function fleetMcpFixLine(status: {
|
|
523
|
+
state: string;
|
|
524
|
+
reason?: string;
|
|
525
|
+
unverified?: boolean;
|
|
526
|
+
installFailure?: {
|
|
527
|
+
reason: string;
|
|
528
|
+
};
|
|
529
|
+
} | null | undefined): string | null;
|
|
530
|
+
/** A MEMBER session's client surface (subset of the MCP client). */
|
|
531
|
+
export interface MemberSession {
|
|
532
|
+
mcpClient: {
|
|
533
|
+
callTool(name: string, args: unknown): Promise<unknown>;
|
|
534
|
+
listTools(): Promise<unknown>;
|
|
535
|
+
};
|
|
536
|
+
close?: () => Promise<void>;
|
|
537
|
+
transport?: {
|
|
538
|
+
stop?: () => void;
|
|
539
|
+
};
|
|
540
|
+
}
|
|
541
|
+
export interface MemberFleetMcpDeps extends MemberFleetInstallDeps {
|
|
542
|
+
/** Open a direct MEMBER session (?member=<uuid>) to THIS orchestrator's server (local members). */
|
|
543
|
+
connectLocalMember(memberId: string): Promise<MemberSession>;
|
|
544
|
+
now(): Date;
|
|
545
|
+
/** Persist the observation on the member registry entry. */
|
|
546
|
+
record(memberId: string, status: FleetMcpStatus): void;
|
|
547
|
+
/** Do the role files a `claude --agent <role>` dispatch loads grant the
|
|
548
|
+
* member kb_* / code_* tools? Heals what it can (local: rewrites bad role
|
|
549
|
+
* files; remote: re-provisions) and reports `healed` files. Optional:
|
|
550
|
+
* absent means not checked. */
|
|
551
|
+
roleAgents?(agent: Agent): Promise<{
|
|
552
|
+
ok: true;
|
|
553
|
+
healed?: string[];
|
|
554
|
+
} | {
|
|
555
|
+
ok: false;
|
|
556
|
+
detail: string;
|
|
557
|
+
}>;
|
|
558
|
+
/** Write the member's per-folder apra-fleet MCP entry (the compose_permissions
|
|
559
|
+
* writer). Optional: absent means the probe only checks the entry. `reason`
|
|
560
|
+
* is set when a member config could not be safely edited. */
|
|
561
|
+
writeMcpEntry?(agent: Agent): Promise<{
|
|
562
|
+
ok: true;
|
|
563
|
+
} | {
|
|
564
|
+
ok: false;
|
|
565
|
+
reason?: string;
|
|
566
|
+
detail: string;
|
|
567
|
+
}>;
|
|
568
|
+
/** Stage content in a fresh owner-only file on the member (the secret-file
|
|
569
|
+
* channel); used to create a missing member access secret there. Optional:
|
|
570
|
+
* absent means a missing secret cannot be created. */
|
|
571
|
+
stageSecretFile?: StageSecretFileFn;
|
|
572
|
+
/** Persist the member install's access secret (encrypted) on the registry entry. */
|
|
573
|
+
recordMemberSecret?(memberId: string, secret: string): void;
|
|
574
|
+
}
|
|
575
|
+
/** Test-only: replace the production transports used by register/update/remove_member and member_detail. Pass null to restore. */
|
|
576
|
+
export declare function __setMemberFleetMcpDeps(deps: MemberFleetMcpDeps | null): void;
|
|
577
|
+
/** The deps the tool handlers use (production transports unless a test injected fakes). */
|
|
578
|
+
export declare function getMemberFleetMcpDeps(): MemberFleetMcpDeps;
|
|
579
|
+
export declare function defaultMemberFleetMcpDeps(): MemberFleetMcpDeps;
|
|
580
|
+
/** `register-member` on the member's own install, as a LOCAL member under the
|
|
581
|
+
* orchestrator's id for it (exported for tests). */
|
|
582
|
+
export declare function buildSelfRegisterCommand(binPath: string, agent: Agent, targetOs: TargetOS, shell: MemberShell): string;
|
|
583
|
+
/** `remove-member` on the member's own install (exported for tests). */
|
|
584
|
+
export declare function buildSelfRemoveCommand(binPath: string, memberId: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
585
|
+
/** `call --member <uuid> version` (with a `{}` args file written first) or
|
|
586
|
+
* `call --member <uuid> --list-tools`, on the member (exported for tests). */
|
|
587
|
+
export declare function buildMemberCallCommand(binPath: string, memberId: string, what: 'version' | 'list-tools', argsPath: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
588
|
+
/**
|
|
589
|
+
* Cap on member-side error text recorded in fleetMcp.detail. Large enough that
|
|
590
|
+
* the leading ERROR line plus its cause (e.g. compose_permissions' full
|
|
591
|
+
* searched-path list) always survive; only a runaway output is truncated.
|
|
592
|
+
*/
|
|
593
|
+
export declare const MEMBER_ERROR_DETAIL_MAX = 4000;
|
|
594
|
+
/**
|
|
595
|
+
* The member-side error text to record in fleetMcp.detail. Keeps the HEAD of
|
|
596
|
+
* the output (the `ERROR: ...` line and its cause come first), never the tail:
|
|
597
|
+
* a tail slice drops the leading cause and leaves only the end of a long list.
|
|
598
|
+
*/
|
|
599
|
+
export declare function memberErrorDetail(out: string, max?: number): string;
|
|
600
|
+
/**
|
|
601
|
+
* The URL of the member's per-folder apra-fleet MCP entry written by
|
|
602
|
+
* compose_permissions, or null when there is none. claude:
|
|
603
|
+
* <config dir>/.claude.json projects[<folder>].mcpServers['apra-fleet'].url;
|
|
604
|
+
* opencode: <workFolder>/opencode.json mcp['apra-fleet'].url.
|
|
605
|
+
*/
|
|
606
|
+
export declare function readMemberMcpEntryUrl(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<string | null>;
|
|
607
|
+
/** Outcome of resolving the port a remote member's own install listens on. */
|
|
608
|
+
export type MemberPortResolution = {
|
|
609
|
+
kind: 'resolved';
|
|
610
|
+
port: number;
|
|
611
|
+
source: 'marker' | 'default';
|
|
612
|
+
note?: string;
|
|
613
|
+
} | {
|
|
614
|
+
kind: 'failed';
|
|
615
|
+
detail: string;
|
|
616
|
+
};
|
|
617
|
+
/**
|
|
618
|
+
* The port a REMOTE member's own apra-fleet install listens on, resolved on
|
|
619
|
+
* the member: the `port` its member-install marker
|
|
620
|
+
* (<home>/.apra-fleet/data/member-install.json) records. server.json in the
|
|
621
|
+
* same data dir is only advisory -- a no-op `apra-fleet start` never rewrites
|
|
622
|
+
* it, so it can describe an older instance -- and a disagreement is reported
|
|
623
|
+
* in `note` while the marker wins. A marker that records no port (an install
|
|
624
|
+
* from before port recording) resolves to the built-in default with a note
|
|
625
|
+
* saying so. Read commands carry resolved, quoted paths built here in JS (no
|
|
626
|
+
* shell variable expansion). Never throws.
|
|
627
|
+
*/
|
|
628
|
+
export declare function resolveMemberMcpPort(agent: Agent, home: string, deps: Pick<MemberFleetInstallDeps, 'exec'>): Promise<MemberPortResolution>;
|
|
629
|
+
/**
|
|
630
|
+
* Observe a member's apra-fleet MCP server and return its fleetMcp status.
|
|
631
|
+
* Never throws and never records -- see refreshMemberFleetMcp for that.
|
|
632
|
+
*
|
|
633
|
+
* - agy: unavailable(no-per-project-mcp), unverified; nothing is probed.
|
|
634
|
+
* - providers with no per-folder fleet entry: unavailable(provider-unsupported), unverified.
|
|
635
|
+
* - LOCAL members: no install and no per-folder entry (a claude dispatch gets
|
|
636
|
+
* the member config per session, --mcp-config). Verified by opening a
|
|
637
|
+
* MEMBER session for the uuid on this server through the client's own
|
|
638
|
+
* server resolution (registered member, version answers, kb_* / code_*
|
|
639
|
+
* listed) -- the same server and member identity the injected URL names,
|
|
640
|
+
* not a request to that literal URL or a run of the CLI with the file.
|
|
641
|
+
* - remote members: ensure the install (opts.install, default true; false
|
|
642
|
+
* only probes the version), register the member on its own install
|
|
643
|
+
* (`register-member --type local --id <uuid>`), check the per-folder MCP
|
|
644
|
+
* entry (not for claude: per-session config, the entry is only its
|
|
645
|
+
* fallback), then verify a MEMBER session through `apra-fleet call`.
|
|
646
|
+
* - claude, both: the role files `--agent <role>` loads must grant the member
|
|
647
|
+
* tools; roleAgents heals them (local rewrite, remote re-provision) first.
|
|
648
|
+
*/
|
|
649
|
+
export declare function probeMemberFleetMcp(agent: Agent, deps?: MemberFleetMcpDeps, opts?: ProbeOpts): Promise<FleetMcpStatus>;
|
|
650
|
+
/** Fix line recorded with a missing/broken bd on a member. ASCII, one line. */
|
|
651
|
+
export declare const BEADS_MISSING_FIX = "Run update_member {member_id, fleet_install: \"auto\"} so the member installer puts bd in <home>/.apra-fleet/bin (or install bd on the member so bd --version works), then member_detail with refresh:true.";
|
|
652
|
+
/** Suffix for a register/update fleetMcp result line: names a missing bd, else ''. */
|
|
653
|
+
export declare function beadsStatusNote(status: Pick<FleetMcpStatus, 'beads'>): string;
|
|
654
|
+
/** Where the member installer places bd when npm -g is not writable. */
|
|
655
|
+
export declare function memberBeadsPath(home: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
656
|
+
/**
|
|
657
|
+
* The member-side bd probe: bd on the member's PATH first, else the member
|
|
658
|
+
* install's <home>/.apra-fleet/bin copy -- the same order every fleet-built
|
|
659
|
+
* member command resolves it in (BIN_DIR is appended to PATH). Tagged like
|
|
660
|
+
* buildFleetVersionProbe: always exits 0, outcome in stdout.
|
|
661
|
+
*/
|
|
662
|
+
export declare function buildBeadsProbe(bdPath: string, targetOs: TargetOS, shell: MemberShell): string;
|
|
663
|
+
/**
|
|
664
|
+
* Probe bd on a remote member. Returns the `beads` field to record when bd is
|
|
665
|
+
* missing or broken there, or null when it works or the probe itself could
|
|
666
|
+
* not run (an unreachable member is reported by the fleetMcp status already).
|
|
667
|
+
* Never throws.
|
|
668
|
+
*/
|
|
669
|
+
export declare function probeMemberBeads(agent: Agent, deps: MemberFleetInstallDeps): Promise<NonNullable<FleetMcpStatus['beads']> | null>;
|
|
670
|
+
/** Probe options. `writeMcpEntry` (register_member / update_member with a
|
|
671
|
+
* fleet install) writes the per-folder MCP entry before it is checked;
|
|
672
|
+
* without it (member_detail refresh) the probe stays read-only. */
|
|
673
|
+
export interface ProbeOpts {
|
|
674
|
+
install?: boolean;
|
|
675
|
+
forceInstall?: boolean;
|
|
676
|
+
writeMcpEntry?: boolean;
|
|
677
|
+
/** fleet_install "replace-full": with `install`, replace an unmarked (full)
|
|
678
|
+
* install with a member install instead of refusing it. Never implied. */
|
|
679
|
+
replaceFull?: boolean;
|
|
680
|
+
}
|
|
681
|
+
/**
|
|
682
|
+
* Probe and RECORD the member's fleetMcp status on its registry entry. The
|
|
683
|
+
* record is an observation, overwritten on every call, so a re-probe after a
|
|
684
|
+
* manual fix flips unavailable -> available with no restart.
|
|
685
|
+
*/
|
|
686
|
+
export declare function refreshMemberFleetMcp(agent: Agent, deps?: MemberFleetMcpDeps, opts?: ProbeOpts): Promise<FleetMcpStatus>;
|
|
687
|
+
export type SelfRemoveResult = {
|
|
688
|
+
removed: boolean;
|
|
689
|
+
detail: string;
|
|
690
|
+
} | {
|
|
691
|
+
removed: false;
|
|
692
|
+
reason: 'home-unresolved' | 'install-too-old' | 'remove-failed' | 'probe-failed';
|
|
693
|
+
detail: string;
|
|
694
|
+
}
|
|
695
|
+
/** The member-side removal was deliberately not run: the install is not fleet-owned (marker absent) or ownership could not be established (marker probe failed). */
|
|
696
|
+
| {
|
|
697
|
+
removed: false;
|
|
698
|
+
skipped: true;
|
|
699
|
+
reason: 'not-fleet-owned' | 'probe-failed';
|
|
700
|
+
detail: string;
|
|
701
|
+
};
|
|
702
|
+
/**
|
|
703
|
+
* Remove the member's self-registration from its OWN install (remove_member's
|
|
704
|
+
* counterpart of the register step). Local members share this orchestrator's
|
|
705
|
+
* install, whose registry remove_member already edits, so nothing runs for
|
|
706
|
+
* them. A member with no install has nothing to remove. Never throws.
|
|
707
|
+
*/
|
|
708
|
+
export declare function removeMemberFromOwnInstall(agent: Agent, deps?: MemberFleetInstallDeps): Promise<SelfRemoveResult>;
|
|
709
|
+
export {};
|
|
710
|
+
//# sourceMappingURL=member-fleet-install.d.ts.map
|