@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export declare const SERVICE_NOTICE_PATH: string;
|
|
2
|
+
/** `shown`: the text was already printed to a console, so the next service verb does not repeat it. */
|
|
3
|
+
export declare function writeServiceNotice(text: string, file?: string, now?: Date, shown?: boolean): void;
|
|
4
|
+
/**
|
|
5
|
+
* Like writeServiceNotice, but never discards guidance that is still pending:
|
|
6
|
+
* when an unshown notice exists, `text` is appended to it (so the next verb
|
|
7
|
+
* prints both once). A `shown` text (already printed inline) is not added to a
|
|
8
|
+
* pending notice, since the user has seen it; a duplicate text is not repeated.
|
|
9
|
+
*/
|
|
10
|
+
export declare function appendServiceNotice(text: string, file?: string, now?: Date, shown?: boolean): void;
|
|
11
|
+
export declare function clearServiceNotice(file?: string): void;
|
|
12
|
+
/** Remove the pending notice only when its text contains `marker` (an obsolete refusal). */
|
|
13
|
+
export declare function clearServiceNoticeContaining(marker: string, file?: string): void;
|
|
14
|
+
/**
|
|
15
|
+
* The notice text if it has not been shown yet, marking it shown (the file
|
|
16
|
+
* stays until registration clears it). Null when there is nothing new.
|
|
17
|
+
*/
|
|
18
|
+
export declare function takePendingServiceNotice(file?: string, now?: Date): string | null;
|
|
19
|
+
/** Print a pending notice once, on stderr (stdout of service verbs may be parsed). */
|
|
20
|
+
export declare function showPendingServiceNotice(file?: string): void;
|
|
21
|
+
//# sourceMappingURL=service-notice.d.ts.map
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pending service notice: guidance install could not show to the user.
|
|
3
|
+
* `apra-fleet update` runs install detached with stdio ignored, so a message
|
|
4
|
+
* printed by service registration (e.g. a legacy Windows task that could not
|
|
5
|
+
* be replaced) never reaches anyone. Registration persists it here; the next
|
|
6
|
+
* service verb (status/start/stop/restart/update) prints it once, and
|
|
7
|
+
* registration clears it once the current service definition is in place.
|
|
8
|
+
*/
|
|
9
|
+
import fs from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { FLEET_DIR } from '../paths.js';
|
|
12
|
+
export const SERVICE_NOTICE_PATH = path.join(FLEET_DIR, 'service-notice.json');
|
|
13
|
+
/** `shown`: the text was already printed to a console, so the next service verb does not repeat it. */
|
|
14
|
+
export function writeServiceNotice(text, file = SERVICE_NOTICE_PATH, now = new Date(), shown = false) {
|
|
15
|
+
try {
|
|
16
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
17
|
+
const n = { createdAt: now.toISOString(), text, ...(shown ? { shownAt: now.toISOString() } : {}) };
|
|
18
|
+
fs.writeFileSync(file, JSON.stringify(n, null, 2));
|
|
19
|
+
}
|
|
20
|
+
catch { /* best-effort: never fail registration on the notice */ }
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Like writeServiceNotice, but never discards guidance that is still pending:
|
|
24
|
+
* when an unshown notice exists, `text` is appended to it (so the next verb
|
|
25
|
+
* prints both once). A `shown` text (already printed inline) is not added to a
|
|
26
|
+
* pending notice, since the user has seen it; a duplicate text is not repeated.
|
|
27
|
+
*/
|
|
28
|
+
export function appendServiceNotice(text, file = SERVICE_NOTICE_PATH, now = new Date(), shown = false) {
|
|
29
|
+
const existing = readNotice(file);
|
|
30
|
+
if (!existing || existing.shownAt) {
|
|
31
|
+
writeServiceNotice(text, file, now, shown);
|
|
32
|
+
return;
|
|
33
|
+
}
|
|
34
|
+
if (shown || existing.text.includes(text))
|
|
35
|
+
return;
|
|
36
|
+
try {
|
|
37
|
+
fs.writeFileSync(file, JSON.stringify({ ...existing, text: `${existing.text}\n${text}` }, null, 2));
|
|
38
|
+
}
|
|
39
|
+
catch { /* best-effort */ }
|
|
40
|
+
}
|
|
41
|
+
export function clearServiceNotice(file = SERVICE_NOTICE_PATH) {
|
|
42
|
+
try {
|
|
43
|
+
fs.unlinkSync(file);
|
|
44
|
+
}
|
|
45
|
+
catch { /* absent */ }
|
|
46
|
+
}
|
|
47
|
+
/** Remove the pending notice only when its text contains `marker` (an obsolete refusal). */
|
|
48
|
+
export function clearServiceNoticeContaining(marker, file = SERVICE_NOTICE_PATH) {
|
|
49
|
+
if (readNotice(file)?.text.includes(marker))
|
|
50
|
+
clearServiceNotice(file);
|
|
51
|
+
}
|
|
52
|
+
function readNotice(file) {
|
|
53
|
+
try {
|
|
54
|
+
const n = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
55
|
+
return typeof n?.text === 'string' && n.text ? n : null;
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* The notice text if it has not been shown yet, marking it shown (the file
|
|
63
|
+
* stays until registration clears it). Null when there is nothing new.
|
|
64
|
+
*/
|
|
65
|
+
export function takePendingServiceNotice(file = SERVICE_NOTICE_PATH, now = new Date()) {
|
|
66
|
+
const n = readNotice(file);
|
|
67
|
+
if (!n || n.shownAt)
|
|
68
|
+
return null;
|
|
69
|
+
try {
|
|
70
|
+
fs.writeFileSync(file, JSON.stringify({ ...n, shownAt: now.toISOString() }, null, 2));
|
|
71
|
+
}
|
|
72
|
+
catch { /* shown again next time */ }
|
|
73
|
+
return n.text;
|
|
74
|
+
}
|
|
75
|
+
/** Print a pending notice once, on stderr (stdout of service verbs may be parsed). */
|
|
76
|
+
export function showPendingServiceNotice(file = SERVICE_NOTICE_PATH) {
|
|
77
|
+
const text = takePendingServiceNotice(file);
|
|
78
|
+
if (text)
|
|
79
|
+
console.error(`Note from the last apra-fleet install:\n${text}\n`);
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=service-notice.js.map
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export declare const MAX_CONSECUTIVE_FAILURES = 3;
|
|
2
|
+
export declare const BACKOFF_MS: number;
|
|
3
|
+
export declare const SERVICE_START_STATE_PATH: string;
|
|
4
|
+
/**
|
|
5
|
+
* Skip this launch? Returns the one-line reason when skipping, else null.
|
|
6
|
+
*/
|
|
7
|
+
export declare function serviceStartBackoff(file?: string, now?: number): string | null;
|
|
8
|
+
/** Count this launch as a failure until clearServiceStartFailures() runs. */
|
|
9
|
+
export declare function recordServiceStartAttempt(file?: string, now?: number): void;
|
|
10
|
+
export declare function clearServiceStartFailures(file?: string): void;
|
|
11
|
+
export declare const SERVICE_NOTICE_STATE_PATH: string;
|
|
12
|
+
export declare const SERVICE_NOTICE_INTERVAL_MS: number;
|
|
13
|
+
/**
|
|
14
|
+
* Rate limit for routine service-launch notices ("already running", "stopped
|
|
15
|
+
* by user -- not starting"): the Windows task's revive trigger fires every 5
|
|
16
|
+
* minutes, which would otherwise append ~288 identical lines a day to the
|
|
17
|
+
* service log. True at most once per interval per kind.
|
|
18
|
+
*/
|
|
19
|
+
export declare function shouldLogServiceNotice(kind: string, file?: string, now?: number, intervalMs?: number): boolean;
|
|
20
|
+
//# sourceMappingURL=service-start-guard.d.ts.map
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Backoff for service-manager launches that keep failing (GitHub #585
|
|
3
|
+
* recovery). The Windows task has a repeating revive trigger, and every OS
|
|
4
|
+
* service launches at logon; a server that refuses (port held by another app,
|
|
5
|
+
* unresponsive holder -- exit 0 under the service marker, so no crash loop)
|
|
6
|
+
* or crashes at startup would otherwise retry every interval forever, each
|
|
7
|
+
* attempt a new fleet-<pid>.log.
|
|
8
|
+
*
|
|
9
|
+
* State lives in <data dir>/service-start-failures.json. Every service launch
|
|
10
|
+
* counts as a failure until it is listening; a successful start (or finding
|
|
11
|
+
* a healthy server already running) clears it. After MAX_CONSECUTIVE_FAILURES
|
|
12
|
+
* failures in a row, launches are skipped (one line to stdout, exit 0) until
|
|
13
|
+
* BACKOFF_MS has passed since the last attempt. An explicit user start
|
|
14
|
+
* (apra-fleet start/install) clears the state first, so it is never skipped.
|
|
15
|
+
*/
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import { FLEET_DIR } from '../paths.js';
|
|
19
|
+
export const MAX_CONSECUTIVE_FAILURES = 3;
|
|
20
|
+
export const BACKOFF_MS = 30 * 60 * 1000;
|
|
21
|
+
export const SERVICE_START_STATE_PATH = path.join(FLEET_DIR, 'service-start-failures.json');
|
|
22
|
+
function readState(file) {
|
|
23
|
+
try {
|
|
24
|
+
const s = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
25
|
+
if (typeof s?.consecutive === 'number' && typeof s?.lastAttemptAt === 'number')
|
|
26
|
+
return s;
|
|
27
|
+
}
|
|
28
|
+
catch { /* absent or corrupt */ }
|
|
29
|
+
return null;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Skip this launch? Returns the one-line reason when skipping, else null.
|
|
33
|
+
*/
|
|
34
|
+
export function serviceStartBackoff(file = SERVICE_START_STATE_PATH, now = Date.now()) {
|
|
35
|
+
const s = readState(file);
|
|
36
|
+
if (!s || s.consecutive < MAX_CONSECUTIVE_FAILURES)
|
|
37
|
+
return null;
|
|
38
|
+
const retryAt = s.lastAttemptAt + BACKOFF_MS;
|
|
39
|
+
if (now >= retryAt)
|
|
40
|
+
return null;
|
|
41
|
+
return `apra-fleet service launch skipped: the last ${s.consecutive} service starts failed or were refused `
|
|
42
|
+
+ `(see the logs in ${path.dirname(file)}); next automatic attempt after ${new Date(retryAt).toISOString()}. `
|
|
43
|
+
+ `'apra-fleet start' retries immediately.`;
|
|
44
|
+
}
|
|
45
|
+
/** Count this launch as a failure until clearServiceStartFailures() runs. */
|
|
46
|
+
export function recordServiceStartAttempt(file = SERVICE_START_STATE_PATH, now = Date.now()) {
|
|
47
|
+
const s = readState(file);
|
|
48
|
+
const next = { consecutive: (s?.consecutive ?? 0) + 1, lastAttemptAt: now };
|
|
49
|
+
try {
|
|
50
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
51
|
+
fs.writeFileSync(file, JSON.stringify(next));
|
|
52
|
+
}
|
|
53
|
+
catch { /* best-effort: never block a start on the guard */ }
|
|
54
|
+
}
|
|
55
|
+
export function clearServiceStartFailures(file = SERVICE_START_STATE_PATH) {
|
|
56
|
+
try {
|
|
57
|
+
fs.unlinkSync(file);
|
|
58
|
+
}
|
|
59
|
+
catch { /* absent */ }
|
|
60
|
+
}
|
|
61
|
+
export const SERVICE_NOTICE_STATE_PATH = path.join(FLEET_DIR, 'service-notices.json');
|
|
62
|
+
export const SERVICE_NOTICE_INTERVAL_MS = 60 * 60 * 1000;
|
|
63
|
+
/**
|
|
64
|
+
* Rate limit for routine service-launch notices ("already running", "stopped
|
|
65
|
+
* by user -- not starting"): the Windows task's revive trigger fires every 5
|
|
66
|
+
* minutes, which would otherwise append ~288 identical lines a day to the
|
|
67
|
+
* service log. True at most once per interval per kind.
|
|
68
|
+
*/
|
|
69
|
+
export function shouldLogServiceNotice(kind, file = SERVICE_NOTICE_STATE_PATH, now = Date.now(), intervalMs = SERVICE_NOTICE_INTERVAL_MS) {
|
|
70
|
+
let state = {};
|
|
71
|
+
try {
|
|
72
|
+
state = JSON.parse(fs.readFileSync(file, 'utf8')) ?? {};
|
|
73
|
+
}
|
|
74
|
+
catch { /* absent or corrupt */ }
|
|
75
|
+
const last = state[kind];
|
|
76
|
+
if (typeof last === 'number' && now - last < intervalMs)
|
|
77
|
+
return false;
|
|
78
|
+
state[kind] = now;
|
|
79
|
+
try {
|
|
80
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
81
|
+
fs.writeFileSync(file, JSON.stringify(state));
|
|
82
|
+
}
|
|
83
|
+
catch { /* best-effort */ }
|
|
84
|
+
return true;
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=service-start-guard.js.map
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** The last cumulative cost seen for a session, or undefined. */
|
|
2
|
+
export declare function lastSessionCost(sessionId: string | undefined): number | undefined;
|
|
3
|
+
/** Records the latest cumulative cost seen for a session. */
|
|
4
|
+
export declare function recordSessionCost(sessionId: string | undefined, cumulativeUsd: number): void;
|
|
5
|
+
/**
|
|
6
|
+
* The cost of ONE dispatch, from the cumulative figure its result reported.
|
|
7
|
+
*
|
|
8
|
+
* @param cumulativeUsd the result's cumulative session cost
|
|
9
|
+
* @param sessionId the session the result landed on
|
|
10
|
+
* @param continuedFrom the session whose saved total this invocation started
|
|
11
|
+
* from: the resumed session id for a resume, the source id for a fork,
|
|
12
|
+
* undefined for a fresh session (baseline 0)
|
|
13
|
+
* @returns the delta in USD, or undefined when the invocation continued a
|
|
14
|
+
* session whose earlier total this server never saw (the caller then falls
|
|
15
|
+
* back to pricing the token counts). The cumulative figure is recorded as
|
|
16
|
+
* the session's new baseline either way.
|
|
17
|
+
*/
|
|
18
|
+
export declare function dispatchCostFromCumulative(cumulativeUsd: number, sessionId: string | undefined, continuedFrom: string | undefined): number | undefined;
|
|
19
|
+
/** Test-only: drop the in-memory cache (the file is re-read on next use). */
|
|
20
|
+
export declare function _resetSessionCostCache(): void;
|
|
21
|
+
/** Test-only: keep the baselines in `p` instead of the shared data dir
|
|
22
|
+
* (null restores the default); also drops the in-memory cache. */
|
|
23
|
+
export declare function _setSessionCostFileForTest(p: string | null): void;
|
|
24
|
+
//# sourceMappingURL=session-cost.d.ts.map
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { FLEET_DIR } from '../paths.js';
|
|
4
|
+
/**
|
|
5
|
+
* Per-dispatch cost from a provider's CUMULATIVE session cost figure.
|
|
6
|
+
*
|
|
7
|
+
* Claude Code's result `total_cost_usd` is cumulative for the session, not
|
|
8
|
+
* per invocation. Its own field docs (CLI 2.1.291): "a resumed or forked
|
|
9
|
+
* session continues from the total its transcript saved, when it has one (so
|
|
10
|
+
* the first result already carries the earlier turns) ... and a mid-session
|
|
11
|
+
* /clear resets the running total." fleet dispatches resume the member's
|
|
12
|
+
* session routinely, so taking the figure as-is would charge every earlier
|
|
13
|
+
* turn again on each resume. The dispatch's own cost is the delta against the
|
|
14
|
+
* last figure this server saw for the session (or, for a fork, for its source
|
|
15
|
+
* session).
|
|
16
|
+
*
|
|
17
|
+
* The last-seen figures are persisted (a small JSON map under the fleet data
|
|
18
|
+
* dir, newest MAX_ENTRIES kept) so a server restart does not lose the
|
|
19
|
+
* baseline and charge a whole session's history to the next resume.
|
|
20
|
+
*/
|
|
21
|
+
const MAX_ENTRIES = 500;
|
|
22
|
+
const fileName = 'session-costs.json';
|
|
23
|
+
let cache = null;
|
|
24
|
+
let fileOverride = null;
|
|
25
|
+
function filePath() {
|
|
26
|
+
return fileOverride ?? path.join(FLEET_DIR, fileName);
|
|
27
|
+
}
|
|
28
|
+
function load() {
|
|
29
|
+
if (cache)
|
|
30
|
+
return cache;
|
|
31
|
+
cache = new Map();
|
|
32
|
+
try {
|
|
33
|
+
const raw = JSON.parse(fs.readFileSync(filePath(), 'utf-8'));
|
|
34
|
+
if (raw && typeof raw === 'object') {
|
|
35
|
+
for (const [k, v] of Object.entries(raw)) {
|
|
36
|
+
if (typeof v === 'number' && Number.isFinite(v) && v >= 0)
|
|
37
|
+
cache.set(k, v);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
catch { /* missing or unreadable: start empty */ }
|
|
42
|
+
return cache;
|
|
43
|
+
}
|
|
44
|
+
function save(map) {
|
|
45
|
+
try {
|
|
46
|
+
fs.mkdirSync(path.dirname(filePath()), { recursive: true });
|
|
47
|
+
fs.writeFileSync(filePath(), JSON.stringify(Object.fromEntries(map)) + '\n');
|
|
48
|
+
}
|
|
49
|
+
catch { /* best effort: an unwritable data dir only loses the baseline */ }
|
|
50
|
+
}
|
|
51
|
+
/** The last cumulative cost seen for a session, or undefined. */
|
|
52
|
+
export function lastSessionCost(sessionId) {
|
|
53
|
+
if (!sessionId)
|
|
54
|
+
return undefined;
|
|
55
|
+
return load().get(sessionId);
|
|
56
|
+
}
|
|
57
|
+
/** Records the latest cumulative cost seen for a session. */
|
|
58
|
+
export function recordSessionCost(sessionId, cumulativeUsd) {
|
|
59
|
+
if (!sessionId || !Number.isFinite(cumulativeUsd) || cumulativeUsd < 0)
|
|
60
|
+
return;
|
|
61
|
+
const map = load();
|
|
62
|
+
map.delete(sessionId); // re-insert so insertion order tracks recency
|
|
63
|
+
map.set(sessionId, cumulativeUsd);
|
|
64
|
+
while (map.size > MAX_ENTRIES) {
|
|
65
|
+
const oldest = map.keys().next().value;
|
|
66
|
+
map.delete(oldest);
|
|
67
|
+
}
|
|
68
|
+
save(map);
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* The cost of ONE dispatch, from the cumulative figure its result reported.
|
|
72
|
+
*
|
|
73
|
+
* @param cumulativeUsd the result's cumulative session cost
|
|
74
|
+
* @param sessionId the session the result landed on
|
|
75
|
+
* @param continuedFrom the session whose saved total this invocation started
|
|
76
|
+
* from: the resumed session id for a resume, the source id for a fork,
|
|
77
|
+
* undefined for a fresh session (baseline 0)
|
|
78
|
+
* @returns the delta in USD, or undefined when the invocation continued a
|
|
79
|
+
* session whose earlier total this server never saw (the caller then falls
|
|
80
|
+
* back to pricing the token counts). The cumulative figure is recorded as
|
|
81
|
+
* the session's new baseline either way.
|
|
82
|
+
*/
|
|
83
|
+
export function dispatchCostFromCumulative(cumulativeUsd, sessionId, continuedFrom) {
|
|
84
|
+
let base = 0;
|
|
85
|
+
if (continuedFrom)
|
|
86
|
+
base = lastSessionCost(continuedFrom);
|
|
87
|
+
recordSessionCost(sessionId, cumulativeUsd);
|
|
88
|
+
if (base === undefined)
|
|
89
|
+
return undefined;
|
|
90
|
+
// A figure below the baseline means the total restarted (no saved total in
|
|
91
|
+
// the transcript, or a /clear): the whole figure is this dispatch's.
|
|
92
|
+
const delta = cumulativeUsd >= base ? cumulativeUsd - base : cumulativeUsd;
|
|
93
|
+
return Math.round(delta * 1e10) / 1e10; // strip float noise from the subtraction
|
|
94
|
+
}
|
|
95
|
+
/** Test-only: drop the in-memory cache (the file is re-read on next use). */
|
|
96
|
+
export function _resetSessionCostCache() {
|
|
97
|
+
cache = null;
|
|
98
|
+
}
|
|
99
|
+
/** Test-only: keep the baselines in `p` instead of the shared data dir
|
|
100
|
+
* (null restores the default); also drops the in-memory cache. */
|
|
101
|
+
export function _setSessionCostFileForTest(p) {
|
|
102
|
+
fileOverride = p;
|
|
103
|
+
cache = null;
|
|
104
|
+
}
|
|
105
|
+
//# sourceMappingURL=session-cost.js.map
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import type { Agent } from '../types.js';
|
|
2
|
+
import { type MemberExecFn } from './member-config-io.js';
|
|
3
|
+
import { type StageSecretFileFn } from './member-access-secret.js';
|
|
4
|
+
/** Work-folder-relative name of a remote member's per-dispatch config file. */
|
|
5
|
+
export declare const REMOTE_SESSION_MCP_FILE = ".fleet-session-mcp.json";
|
|
6
|
+
/**
|
|
7
|
+
* Whether a dispatch to `agent` gets the per-session member config.
|
|
8
|
+
* - claude only (the flag is a Claude CLI flag);
|
|
9
|
+
* - local members: always -- they share this server -- except while the
|
|
10
|
+
* recorded fleetMcp says this server refused the member session;
|
|
11
|
+
* - remote members: only when the member's recorded fleetMcp says its own
|
|
12
|
+
* server answered a member session. Pointing a session at a server that is
|
|
13
|
+
* not there would replace a working user-scope entry with a dead one.
|
|
14
|
+
*/
|
|
15
|
+
export declare function sessionMcpInjectionAvailable(agent: Agent): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Whether compose_permissions should write the per-folder apra-fleet entry.
|
|
18
|
+
* Not for a local claude member: every dispatch to it gets the member config
|
|
19
|
+
* per session, so a folder entry would only change the human's own sessions
|
|
20
|
+
* in that clone. Remote members keep it as the fallback for a dispatch where
|
|
21
|
+
* injection is unavailable.
|
|
22
|
+
*/
|
|
23
|
+
export declare function perFolderMcpEntryNeeded(agent: Agent): boolean;
|
|
24
|
+
/**
|
|
25
|
+
* The config file body: exactly one http `apra-fleet` server at the member URL.
|
|
26
|
+
*
|
|
27
|
+
* `alwaysLoad: true` (Claude Code MCP server option) keeps every tool of that
|
|
28
|
+
* server in the session's prompt instead of deferring it behind the
|
|
29
|
+
* tool-search tool, so a role session can call kb_* / code_* from its first
|
|
30
|
+
* turn without a discovery round-trip. Emitted only when the caller has
|
|
31
|
+
* established that the member's CLI accepts it (see resolveSessionMcpAlwaysLoad).
|
|
32
|
+
*/
|
|
33
|
+
export declare function sessionMcpConfigContent(agent: Pick<Agent, 'id' | 'agentType' | 'memberMcpPort' | 'encryptedMemberMcpSecret'>, opts?: {
|
|
34
|
+
alwaysLoad?: boolean;
|
|
35
|
+
}): string;
|
|
36
|
+
/** First `X.Y.Z` in a CLI's version output (e.g. "2.1.291 (Claude Code)"). */
|
|
37
|
+
export declare function parseCliVersion(output: string): string | undefined;
|
|
38
|
+
/** Numeric dotted-version comparison: true when `version` >= `min`. */
|
|
39
|
+
export declare function cliVersionAtLeast(version: string, min: string): boolean;
|
|
40
|
+
/** How long a probed member CLI version is reused before it is probed again
|
|
41
|
+
* (a CLI update on the member is picked up within this window). */
|
|
42
|
+
export declare const CLI_VERSION_CACHE_TTL_MS: number;
|
|
43
|
+
/** Test hook: forget every cached member CLI version. */
|
|
44
|
+
export declare function resetCliVersionCache(): void;
|
|
45
|
+
/**
|
|
46
|
+
* Decides whether this dispatch's session config may carry `alwaysLoad`.
|
|
47
|
+
* The provider names the minimum CLI version that supports it
|
|
48
|
+
* (ProviderAdapter.mcpAlwaysLoadMinVersion); the member's CLI version is
|
|
49
|
+
* probed with `versionCmd` and cached per member. Never throws. When the
|
|
50
|
+
* mechanism cannot be applied the config is written WITHOUT the key (an
|
|
51
|
+
* unknown key could invalidate the entry on an older CLI, leaving the session
|
|
52
|
+
* with no apra-fleet server at all) and `warning` names the cause, so the
|
|
53
|
+
* dispatcher can log it -- the tools then stay deferred for that session.
|
|
54
|
+
*/
|
|
55
|
+
export declare function resolveSessionMcpAlwaysLoad(agent: Pick<Agent, 'id'>, minVersion: string | undefined, versionCmd: string, exec: MemberExecFn, now?: () => number): Promise<{
|
|
56
|
+
alwaysLoad: boolean;
|
|
57
|
+
warning?: string;
|
|
58
|
+
}>;
|
|
59
|
+
/** Absolute member-side path of the config file (see the header for the layout). */
|
|
60
|
+
export declare function sessionMcpConfigPath(agent: Agent, resolvedWorkFolder: string): string;
|
|
61
|
+
/** remove_member: deletes a local member's reused config file (no-op when absent).
|
|
62
|
+
* A remote member's file is per dispatch and already removed with its prompt file. */
|
|
63
|
+
export declare function removeLocalSessionMcpConfig(agent: Pick<Agent, 'id' | 'agentType'>): void;
|
|
64
|
+
/** True when the file lives in the work folder and must be removed after the dispatch. */
|
|
65
|
+
export declare function sessionMcpConfigIsPerDispatch(agent: Agent): boolean;
|
|
66
|
+
/**
|
|
67
|
+
* Writes the config file. Local: through fs, owner-only. Remote: a config
|
|
68
|
+
* carrying the access secret goes through the owner-only secret-file channel
|
|
69
|
+
* plus a content-free move (never a command string); one without a secret (an
|
|
70
|
+
* install older than the secret) through the shared member file writer
|
|
71
|
+
* (quoted resolved path, read back). Never throws: a failure returns its
|
|
72
|
+
* detail so the caller falls back to a dispatch without the flag.
|
|
73
|
+
*/
|
|
74
|
+
export declare function writeSessionMcpConfig(agent: Agent, absPath: string, exec: MemberExecFn, opts?: {
|
|
75
|
+
alwaysLoad?: boolean;
|
|
76
|
+
stage?: StageSecretFileFn;
|
|
77
|
+
}): Promise<{
|
|
78
|
+
ok: true;
|
|
79
|
+
} | {
|
|
80
|
+
ok: false;
|
|
81
|
+
detail: string;
|
|
82
|
+
}>;
|
|
83
|
+
//# sourceMappingURL=session-mcp-config.d.ts.map
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
// Per-session apra-fleet MCP config for Claude role dispatches.
|
|
2
|
+
//
|
|
3
|
+
// Every Claude session execute_prompt starts for a member is given the
|
|
4
|
+
// member-scoped apra-fleet server (http://localhost:<port>/mcp?member=<uuid>,
|
|
5
|
+
// see memberMcpUrl) through the CLI's `--mcp-config <file>` flag. The entry is
|
|
6
|
+
// named `apra-fleet`, so it overrides a user-scope `apra-fleet` entry for THAT
|
|
7
|
+
// session only, while every other configured server (deepwiki, ...) stays
|
|
8
|
+
// available. `--strict-mcp-config` is deliberately NOT used for that reason.
|
|
9
|
+
//
|
|
10
|
+
// The per-folder entry compose_permissions writes for remote members is the
|
|
11
|
+
// fallback for a dispatch where injection is unavailable (fewer tools, never
|
|
12
|
+
// zero). Local members need no per-folder entry at all.
|
|
13
|
+
//
|
|
14
|
+
// File location (resolved in JavaScript, never by the member's shell):
|
|
15
|
+
// - local members: <FLEET_DIR>/session-mcp/<uuid>.json -- one file per
|
|
16
|
+
// member, outside the work folder, overwritten on every dispatch (no
|
|
17
|
+
// accumulation, and the human's own sessions in that folder are untouched);
|
|
18
|
+
// - remote members: <workFolder>/.fleet-session-mcp.json, written next to the
|
|
19
|
+
// prompt file and removed with it when the dispatch ends. The name is not
|
|
20
|
+
// `.mcp.json`, so no Claude session picks it up on its own.
|
|
21
|
+
//
|
|
22
|
+
// The entry carries the member install's access secret as an http header
|
|
23
|
+
// (member-access-secret.ts): its server refuses a `?member=` session without
|
|
24
|
+
// it. So the file is owner-only -- local: written with mode 0600; remote:
|
|
25
|
+
// staged through the owner-only secret-file channel and moved into place by
|
|
26
|
+
// a content-free command, never written through a command string.
|
|
27
|
+
import fs from 'node:fs';
|
|
28
|
+
import path from 'node:path';
|
|
29
|
+
import { FLEET_DIR } from '../paths.js';
|
|
30
|
+
import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
|
|
31
|
+
import { ensureGitExcluded, joinMemberPath, memberMcpUrl, writeMemberFile, MEMBER_MCP_SERVER_NAME } from './member-config-io.js';
|
|
32
|
+
import { deliverMemberFileViaSecretChannel, memberMcpHeaders } from './member-access-secret.js';
|
|
33
|
+
import { removeMemberSecretFile, writeMemberSecretFile } from './member-secret-env.js';
|
|
34
|
+
/** Work-folder-relative name of a remote member's per-dispatch config file. */
|
|
35
|
+
export const REMOTE_SESSION_MCP_FILE = '.fleet-session-mcp.json';
|
|
36
|
+
/** Recorded fleetMcp reasons that still mean the member's own server answers
|
|
37
|
+
* a ?member= session (the problem is elsewhere), so injection is safe. */
|
|
38
|
+
const SERVER_OK_REASONS = new Set(['role-agents-hide-member-tools']);
|
|
39
|
+
/**
|
|
40
|
+
* Whether a dispatch to `agent` gets the per-session member config.
|
|
41
|
+
* - claude only (the flag is a Claude CLI flag);
|
|
42
|
+
* - local members: always -- they share this server -- except while the
|
|
43
|
+
* recorded fleetMcp says this server refused the member session;
|
|
44
|
+
* - remote members: only when the member's recorded fleetMcp says its own
|
|
45
|
+
* server answered a member session. Pointing a session at a server that is
|
|
46
|
+
* not there would replace a working user-scope entry with a dead one.
|
|
47
|
+
*/
|
|
48
|
+
export function sessionMcpInjectionAvailable(agent) {
|
|
49
|
+
if ((agent.llmProvider ?? 'claude') !== 'claude')
|
|
50
|
+
return false;
|
|
51
|
+
const f = agent.fleetMcp;
|
|
52
|
+
// Local: this server -- unless it last refused this member's session.
|
|
53
|
+
if (agent.agentType === 'local')
|
|
54
|
+
return !(f?.state === 'unavailable' && f.reason === 'member-session-failed');
|
|
55
|
+
if (!f)
|
|
56
|
+
return false;
|
|
57
|
+
if (f.state === 'available')
|
|
58
|
+
return f.unverified !== true;
|
|
59
|
+
return !!f.reason && SERVER_OK_REASONS.has(f.reason);
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Whether compose_permissions should write the per-folder apra-fleet entry.
|
|
63
|
+
* Not for a local claude member: every dispatch to it gets the member config
|
|
64
|
+
* per session, so a folder entry would only change the human's own sessions
|
|
65
|
+
* in that clone. Remote members keep it as the fallback for a dispatch where
|
|
66
|
+
* injection is unavailable.
|
|
67
|
+
*/
|
|
68
|
+
export function perFolderMcpEntryNeeded(agent) {
|
|
69
|
+
return !(agent.agentType === 'local' && (agent.llmProvider ?? 'claude') === 'claude');
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The config file body: exactly one http `apra-fleet` server at the member URL.
|
|
73
|
+
*
|
|
74
|
+
* `alwaysLoad: true` (Claude Code MCP server option) keeps every tool of that
|
|
75
|
+
* server in the session's prompt instead of deferring it behind the
|
|
76
|
+
* tool-search tool, so a role session can call kb_* / code_* from its first
|
|
77
|
+
* turn without a discovery round-trip. Emitted only when the caller has
|
|
78
|
+
* established that the member's CLI accepts it (see resolveSessionMcpAlwaysLoad).
|
|
79
|
+
*/
|
|
80
|
+
export function sessionMcpConfigContent(agent, opts = {}) {
|
|
81
|
+
const entry = { type: 'http', url: memberMcpUrl(agent) };
|
|
82
|
+
const headers = memberMcpHeaders(agent);
|
|
83
|
+
if (headers)
|
|
84
|
+
entry.headers = headers;
|
|
85
|
+
if (opts.alwaysLoad)
|
|
86
|
+
entry.alwaysLoad = true;
|
|
87
|
+
return JSON.stringify({ mcpServers: { [MEMBER_MCP_SERVER_NAME]: entry } });
|
|
88
|
+
}
|
|
89
|
+
/** First `X.Y.Z` in a CLI's version output (e.g. "2.1.291 (Claude Code)"). */
|
|
90
|
+
export function parseCliVersion(output) {
|
|
91
|
+
return /(\d+)\.(\d+)\.(\d+)/.exec(output)?.[0];
|
|
92
|
+
}
|
|
93
|
+
/** Numeric dotted-version comparison: true when `version` >= `min`. */
|
|
94
|
+
export function cliVersionAtLeast(version, min) {
|
|
95
|
+
const a = version.split('.').map(Number);
|
|
96
|
+
const b = min.split('.').map(Number);
|
|
97
|
+
for (let i = 0; i < Math.max(a.length, b.length); i++) {
|
|
98
|
+
const d = (a[i] ?? 0) - (b[i] ?? 0);
|
|
99
|
+
if (d !== 0)
|
|
100
|
+
return d > 0;
|
|
101
|
+
}
|
|
102
|
+
return true;
|
|
103
|
+
}
|
|
104
|
+
/** How long a probed member CLI version is reused before it is probed again
|
|
105
|
+
* (a CLI update on the member is picked up within this window). */
|
|
106
|
+
export const CLI_VERSION_CACHE_TTL_MS = 10 * 60 * 1000;
|
|
107
|
+
const cliVersionCache = new Map();
|
|
108
|
+
/** Test hook: forget every cached member CLI version. */
|
|
109
|
+
export function resetCliVersionCache() {
|
|
110
|
+
cliVersionCache.clear();
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Decides whether this dispatch's session config may carry `alwaysLoad`.
|
|
114
|
+
* The provider names the minimum CLI version that supports it
|
|
115
|
+
* (ProviderAdapter.mcpAlwaysLoadMinVersion); the member's CLI version is
|
|
116
|
+
* probed with `versionCmd` and cached per member. Never throws. When the
|
|
117
|
+
* mechanism cannot be applied the config is written WITHOUT the key (an
|
|
118
|
+
* unknown key could invalidate the entry on an older CLI, leaving the session
|
|
119
|
+
* with no apra-fleet server at all) and `warning` names the cause, so the
|
|
120
|
+
* dispatcher can log it -- the tools then stay deferred for that session.
|
|
121
|
+
*/
|
|
122
|
+
export async function resolveSessionMcpAlwaysLoad(agent, minVersion, versionCmd, exec, now = Date.now) {
|
|
123
|
+
if (!minVersion) {
|
|
124
|
+
return { alwaysLoad: false, warning: 'the provider has no MCP always-load option; kb/code tools may stay deferred behind tool search' };
|
|
125
|
+
}
|
|
126
|
+
let version;
|
|
127
|
+
const cached = cliVersionCache.get(agent.id);
|
|
128
|
+
if (cached && now() - cached.at < CLI_VERSION_CACHE_TTL_MS) {
|
|
129
|
+
version = cached.version;
|
|
130
|
+
}
|
|
131
|
+
else {
|
|
132
|
+
try {
|
|
133
|
+
const r = await exec(versionCmd, 30_000);
|
|
134
|
+
if (typeof r.code !== 'number' || r.code === 0)
|
|
135
|
+
version = parseCliVersion(`${r.stdout}\n${r.stderr}`);
|
|
136
|
+
}
|
|
137
|
+
catch { /* reported below */ }
|
|
138
|
+
if (version)
|
|
139
|
+
cliVersionCache.set(agent.id, { version, at: now() });
|
|
140
|
+
}
|
|
141
|
+
if (!version) {
|
|
142
|
+
return { alwaysLoad: false, warning: `member CLI version could not be determined, so the MCP always-load option was not applied (needs >= ${minVersion}); kb/code tools may stay deferred behind tool search` };
|
|
143
|
+
}
|
|
144
|
+
if (!cliVersionAtLeast(version, minVersion)) {
|
|
145
|
+
return { alwaysLoad: false, warning: `member CLI ${version} is older than ${minVersion}, so the MCP always-load option was not applied; kb/code tools stay deferred behind tool search (update the member CLI)` };
|
|
146
|
+
}
|
|
147
|
+
return { alwaysLoad: true };
|
|
148
|
+
}
|
|
149
|
+
/** Absolute member-side path of the config file (see the header for the layout). */
|
|
150
|
+
export function sessionMcpConfigPath(agent, resolvedWorkFolder) {
|
|
151
|
+
if (agent.agentType === 'local') {
|
|
152
|
+
return path.join(FLEET_DIR, 'session-mcp', `${agent.id}.json`);
|
|
153
|
+
}
|
|
154
|
+
return joinMemberPath(resolvedWorkFolder, REMOTE_SESSION_MCP_FILE, getAgentOS(agent) === 'windows', getAgentShell(agent));
|
|
155
|
+
}
|
|
156
|
+
/** remove_member: deletes a local member's reused config file (no-op when absent).
|
|
157
|
+
* A remote member's file is per dispatch and already removed with its prompt file. */
|
|
158
|
+
export function removeLocalSessionMcpConfig(agent) {
|
|
159
|
+
if (agent.agentType !== 'local')
|
|
160
|
+
return;
|
|
161
|
+
try {
|
|
162
|
+
fs.unlinkSync(path.join(FLEET_DIR, 'session-mcp', `${agent.id}.json`));
|
|
163
|
+
}
|
|
164
|
+
catch { /* absent */ }
|
|
165
|
+
}
|
|
166
|
+
/** True when the file lives in the work folder and must be removed after the dispatch. */
|
|
167
|
+
export function sessionMcpConfigIsPerDispatch(agent) {
|
|
168
|
+
return agent.agentType !== 'local';
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Writes the config file. Local: through fs, owner-only. Remote: a config
|
|
172
|
+
* carrying the access secret goes through the owner-only secret-file channel
|
|
173
|
+
* plus a content-free move (never a command string); one without a secret (an
|
|
174
|
+
* install older than the secret) through the shared member file writer
|
|
175
|
+
* (quoted resolved path, read back). Never throws: a failure returns its
|
|
176
|
+
* detail so the caller falls back to a dispatch without the flag.
|
|
177
|
+
*/
|
|
178
|
+
export async function writeSessionMcpConfig(agent, absPath, exec, opts = {}) {
|
|
179
|
+
const content = sessionMcpConfigContent(agent, opts);
|
|
180
|
+
try {
|
|
181
|
+
if (agent.agentType === 'local') {
|
|
182
|
+
fs.mkdirSync(path.dirname(absPath), { recursive: true });
|
|
183
|
+
fs.writeFileSync(absPath, content, { encoding: 'utf-8', mode: 0o600 });
|
|
184
|
+
try {
|
|
185
|
+
fs.chmodSync(absPath, 0o600);
|
|
186
|
+
}
|
|
187
|
+
catch { /* Windows */ }
|
|
188
|
+
return { ok: true };
|
|
189
|
+
}
|
|
190
|
+
const posix = isPosixShell(getAgentOS(agent), getAgentShell(agent));
|
|
191
|
+
if (memberMcpHeaders(agent)) {
|
|
192
|
+
const stage = opts.stage ?? ((a, c) => writeMemberSecretFile(a, c, 'session-mcp'));
|
|
193
|
+
await deliverMemberFileViaSecretChannel(agent, exec, absPath, content, stage, removeMemberSecretFile);
|
|
194
|
+
}
|
|
195
|
+
else {
|
|
196
|
+
await writeMemberFile(exec, absPath, content, posix);
|
|
197
|
+
}
|
|
198
|
+
// Keep the file out of `git status` (and a role's `git add -A`) even when
|
|
199
|
+
// compose never ran for this clone. Best effort: a non-repo or a failed
|
|
200
|
+
// exclude never blocks the dispatch.
|
|
201
|
+
try {
|
|
202
|
+
await ensureGitExcluded(exec, agent.workFolder, [REMOTE_SESSION_MCP_FILE], getAgentOS(agent) === 'windows', getAgentShell(agent));
|
|
203
|
+
}
|
|
204
|
+
catch { /* best effort */ }
|
|
205
|
+
return { ok: true };
|
|
206
|
+
}
|
|
207
|
+
catch (err) {
|
|
208
|
+
return { ok: false, detail: err instanceof Error ? err.message : String(err) };
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
//# sourceMappingURL=session-mcp-config.js.map
|
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
export type SessionStatus = 'online' | 'busy' | 'idle';
|
|
3
|
+
/**
|
|
4
|
+
* Stable registry id of the operator's own orchestrating session.
|
|
5
|
+
*
|
|
6
|
+
* A session with no member identity (no member JWT, no ?member=) is the local
|
|
7
|
+
* orchestrator/PM session. When such a session declares the `claude/channel`
|
|
8
|
+
* capability at initialize -- i.e. it can actually receive channel pushes --
|
|
9
|
+
* http-transport registers it under this id in the local workspace, so
|
|
10
|
+
* send_message({ member_id: 'orchestrator' }) reaches it. With several such
|
|
11
|
+
* sessions open, the most recently connected one holds the id; when it closes
|
|
12
|
+
* the id moves back to the most recent one still open. Member ids are UUIDs,
|
|
13
|
+
* so this id cannot collide with a member entry.
|
|
14
|
+
*/
|
|
15
|
+
export declare const ORCHESTRATOR_SESSION_ID = "orchestrator";
|
|
3
16
|
export interface SessionState {
|
|
4
17
|
member_id: string;
|
|
5
18
|
/** HARD security boundary -- every session belongs to exactly one workspace.
|