@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,42 @@
|
|
|
1
|
+
import type { Agent } from '../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Delivery of secret VALUES to a member without ever placing them in a
|
|
4
|
+
* member-bound command string (which becomes the argv of the member's shell,
|
|
5
|
+
* readable by every local user via ps / /proc/<pid>/cmdline for as long as
|
|
6
|
+
* the command runs).
|
|
7
|
+
*
|
|
8
|
+
* A value is written to an owner-only file through the member's strategy
|
|
9
|
+
* (SFTP for remote members, fs for local ones; relay members fail loudly);
|
|
10
|
+
* the command only ever references the file's path. The file name is random
|
|
11
|
+
* and carries no part of the secret.
|
|
12
|
+
*/
|
|
13
|
+
/** The remedy any caller surfaces when stored credentials cannot be delivered. */
|
|
14
|
+
export declare const CLEAR_STORED_CREDENTIALS_HINT: string;
|
|
15
|
+
/**
|
|
16
|
+
* A secret could not be delivered to the member without a command line --
|
|
17
|
+
* deterministic (relay member, SFTP subsystem disabled, ...), so callers must
|
|
18
|
+
* classify it before dispatch and never retry it.
|
|
19
|
+
*/
|
|
20
|
+
export declare class SecretDeliveryError extends Error {
|
|
21
|
+
readonly reason: "secret_delivery_unavailable";
|
|
22
|
+
constructor(agent: Agent, cause: string);
|
|
23
|
+
}
|
|
24
|
+
/** Write `content` to a fresh owner-only file on the member; returns its absolute path. */
|
|
25
|
+
export declare function writeMemberSecretFile(agent: Agent, content: string, kind?: string): Promise<string>;
|
|
26
|
+
/** Best-effort removal of a file written by writeMemberSecretFile. */
|
|
27
|
+
export declare function removeMemberSecretFile(agent: Agent, filePath: string): Promise<void>;
|
|
28
|
+
export interface StagedAuthEnv {
|
|
29
|
+
/** Prepend to the member command; '' when there is nothing to deliver. */
|
|
30
|
+
prefix: string;
|
|
31
|
+
/** The staged file (the prefix deletes it once loaded); null when none. */
|
|
32
|
+
path: string | null;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Stage the member's stored auth env vars (encryptedEnvVars) for ONE command.
|
|
36
|
+
* The returned prefix loads the file and deletes it, so every attempt (each
|
|
37
|
+
* retry included) must stage its own file.
|
|
38
|
+
*/
|
|
39
|
+
export declare function stageAuthEnv(agent: Agent): Promise<StagedAuthEnv>;
|
|
40
|
+
/** stageAuthEnv for an explicit set of values (e.g. a key being provisioned). */
|
|
41
|
+
export declare function stageEnvVars(agent: Agent, vars: Record<string, string>): Promise<StagedAuthEnv>;
|
|
42
|
+
//# sourceMappingURL=member-secret-env.d.ts.map
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { isPosixShellMember } from '../utils/agent-helpers.js';
|
|
3
|
+
import { decryptAuthEnvVars, buildAuthEnvFileContent, buildAuthEnvSourcePrefix } from '../utils/auth-env.js';
|
|
4
|
+
import { getStrategy } from './strategy.js';
|
|
5
|
+
/**
|
|
6
|
+
* Delivery of secret VALUES to a member without ever placing them in a
|
|
7
|
+
* member-bound command string (which becomes the argv of the member's shell,
|
|
8
|
+
* readable by every local user via ps / /proc/<pid>/cmdline for as long as
|
|
9
|
+
* the command runs).
|
|
10
|
+
*
|
|
11
|
+
* A value is written to an owner-only file through the member's strategy
|
|
12
|
+
* (SFTP for remote members, fs for local ones; relay members fail loudly);
|
|
13
|
+
* the command only ever references the file's path. The file name is random
|
|
14
|
+
* and carries no part of the secret.
|
|
15
|
+
*/
|
|
16
|
+
/** The remedy any caller surfaces when stored credentials cannot be delivered. */
|
|
17
|
+
export const CLEAR_STORED_CREDENTIALS_HINT = 'or clear the member\'s stored credentials with provision_llm_auth {clear_stored_credentials: true} '
|
|
18
|
+
+ '(registry only; then provide the credential in that machine\'s own environment)';
|
|
19
|
+
/**
|
|
20
|
+
* A secret could not be delivered to the member without a command line --
|
|
21
|
+
* deterministic (relay member, SFTP subsystem disabled, ...), so callers must
|
|
22
|
+
* classify it before dispatch and never retry it.
|
|
23
|
+
*/
|
|
24
|
+
export class SecretDeliveryError extends Error {
|
|
25
|
+
reason = 'secret_delivery_unavailable';
|
|
26
|
+
constructor(agent, cause) {
|
|
27
|
+
const remedy = agent.agentType === 'relay'
|
|
28
|
+
? `Relay members have no channel that delivers a credential without a command line; ${CLEAR_STORED_CREDENTIALS_HINT}.`
|
|
29
|
+
: `Enable the SFTP subsystem on the member's sshd (sshd_config: "Subsystem sftp <path-to-sftp-server>" or "Subsystem sftp internal-sftp", then restart sshd), ${CLEAR_STORED_CREDENTIALS_HINT}.`;
|
|
30
|
+
super(`Cannot deliver a credential to "${agent.friendlyName}" without exposing it on a command line (${cause}). ${remedy}`);
|
|
31
|
+
this.name = 'SecretDeliveryError';
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
/** Write `content` to a fresh owner-only file on the member; returns its absolute path. */
|
|
35
|
+
export async function writeMemberSecretFile(agent, content, kind = 'env') {
|
|
36
|
+
try {
|
|
37
|
+
return await getStrategy(agent).writeSecretFile(`.apra-fleet-${kind}-${randomUUID()}`, content);
|
|
38
|
+
}
|
|
39
|
+
catch (err) {
|
|
40
|
+
if (err instanceof SecretDeliveryError)
|
|
41
|
+
throw err;
|
|
42
|
+
throw new SecretDeliveryError(agent, err?.message ?? String(err));
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
/** Best-effort removal of a file written by writeMemberSecretFile. */
|
|
46
|
+
export async function removeMemberSecretFile(agent, filePath) {
|
|
47
|
+
try {
|
|
48
|
+
await getStrategy(agent).removeSecretFile(filePath);
|
|
49
|
+
}
|
|
50
|
+
catch { /* best-effort */ }
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Stage the member's stored auth env vars (encryptedEnvVars) for ONE command.
|
|
54
|
+
* The returned prefix loads the file and deletes it, so every attempt (each
|
|
55
|
+
* retry included) must stage its own file.
|
|
56
|
+
*/
|
|
57
|
+
export async function stageAuthEnv(agent) {
|
|
58
|
+
return stageEnvVars(agent, decryptAuthEnvVars(agent));
|
|
59
|
+
}
|
|
60
|
+
/** stageAuthEnv for an explicit set of values (e.g. a key being provisioned). */
|
|
61
|
+
export async function stageEnvVars(agent, vars) {
|
|
62
|
+
if (Object.keys(vars).length === 0)
|
|
63
|
+
return { prefix: '', path: null };
|
|
64
|
+
const posix = isPosixShellMember(agent);
|
|
65
|
+
const filePath = await writeMemberSecretFile(agent, buildAuthEnvFileContent(vars, posix), 'env');
|
|
66
|
+
return { prefix: buildAuthEnvSourcePrefix(filePath, posix), path: filePath };
|
|
67
|
+
}
|
|
68
|
+
//# sourceMappingURL=member-secret-env.js.map
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every tool name registered by registerAllTools (src/services/tool-registry.ts).
|
|
3
|
+
* Kept in sync by a unit test that enumerates the registry's server.tool(...)
|
|
4
|
+
* calls; adding a tool there without adding it here fails that test.
|
|
5
|
+
*/
|
|
6
|
+
export declare const REGISTERED_TOOL_NAMES: readonly string[];
|
|
7
|
+
/**
|
|
8
|
+
* Name prefixes of the member tool families. NOT an allow rule: membership is
|
|
9
|
+
* the explicit MEMBER_BASE_TOOLS list. Used to pick the kb_ and code_ tools
|
|
10
|
+
* out of an allowlist (e.g. the role-agent MCP grants in agent-transform.ts).
|
|
11
|
+
*/
|
|
12
|
+
export declare const MEMBER_TOOL_PREFIXES: readonly string[];
|
|
13
|
+
/**
|
|
14
|
+
* Every tool a member session is served (the base member allowlist, before
|
|
15
|
+
* registration filtering). Explicit by design -- see the header.
|
|
16
|
+
*/
|
|
17
|
+
export declare const MEMBER_BASE_TOOLS: readonly string[];
|
|
18
|
+
/**
|
|
19
|
+
* Tools served ONLY to a kb_maintainer member session (the engine's grant), on
|
|
20
|
+
* top of the base allowlist. They mint CONFIRMED, or (kb_demote) withdraw it. Not part of
|
|
21
|
+
* MEMBER_ALLOWED_TOOLS, so client-side deny rules keep them denied for every
|
|
22
|
+
* agent session on a member.
|
|
23
|
+
*/
|
|
24
|
+
export declare const MEMBER_MAINTAINER_TOOLS: readonly string[];
|
|
25
|
+
/**
|
|
26
|
+
* kb_ tools no member session is ever served, whatever its grants. Listed so
|
|
27
|
+
* the classification of every kb_ tool is explicit (and test-checked).
|
|
28
|
+
*/
|
|
29
|
+
export declare const MEMBER_NEVER_TOOLS: readonly string[];
|
|
30
|
+
/**
|
|
31
|
+
* Tools granted ONLY to channel-capable (interactive, claude/channel) member
|
|
32
|
+
* sessions, on top of the base allowlist. Not part of MEMBER_ALLOWED_TOOLS.
|
|
33
|
+
*/
|
|
34
|
+
export declare const MEMBER_CHANNEL_TOOLS: readonly string[];
|
|
35
|
+
/** Is this tool name in the base member allowlist? */
|
|
36
|
+
export declare function isMemberAllowedTool(name: string): boolean;
|
|
37
|
+
/** Is this tool served only to a kb_maintainer member session? */
|
|
38
|
+
export declare function isMemberMaintainerTool(name: string): boolean;
|
|
39
|
+
/** The base member allowlist: every registered tool in MEMBER_BASE_TOOLS. */
|
|
40
|
+
export declare const MEMBER_ALLOWED_TOOLS: readonly string[];
|
|
41
|
+
/**
|
|
42
|
+
* The complement of MEMBER_ALLOWED_TOOLS: every registered tool a member
|
|
43
|
+
* session may NOT use. Providers that support client-side deny rules (claude,
|
|
44
|
+
* agy) deny exactly these on the member's apra-fleet MCP entry. This includes
|
|
45
|
+
* MEMBER_MAINTAINER_TOOLS: an agent session on a member never carries the
|
|
46
|
+
* kb_maintainer grant (only the engine's own member calls do).
|
|
47
|
+
*/
|
|
48
|
+
export declare const MEMBER_DENIED_TOOLS: readonly string[];
|
|
49
|
+
//# sourceMappingURL=member-tool-allowlist.d.ts.map
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
// Single source of truth for which fleet MCP tools a MEMBER session may see.
|
|
2
|
+
//
|
|
3
|
+
// A member session (an MCP connection identified as a registered fleet member,
|
|
4
|
+
// e.g. via ?member=<uuid> or a member JWT) is given a reduced tool list: the
|
|
5
|
+
// knowledge-bank and code-intelligence tools plus a few self-reporting tools.
|
|
6
|
+
// Everything that drives OTHER members or administers the fleet (execute_prompt,
|
|
7
|
+
// execute_command, stop_prompt, send_files, receive_files, member/credential/
|
|
8
|
+
// admin/shutdown tools) is excluded by omission.
|
|
9
|
+
//
|
|
10
|
+
// This module is deliberately dependency-free so it can be imported from the
|
|
11
|
+
// built dist (dist/services/member-tool-allowlist.js) by a plain Node .mjs test
|
|
12
|
+
// without a hardcoded copy of the list.
|
|
13
|
+
//
|
|
14
|
+
// The member lists are EXPLICIT, not derived by name prefix: a newly registered
|
|
15
|
+
// kb_ or code_ tool is NOT member-visible until it is added here on purpose.
|
|
16
|
+
// (The unit test that enumerates tool-registry.ts keeps REGISTERED_TOOL_NAMES
|
|
17
|
+
// complete, and a test asserts every kb_/code_ tool is classified below.)
|
|
18
|
+
//
|
|
19
|
+
// KB write policy (owner decision 2026-10-06):
|
|
20
|
+
// - kb_setup (writes the machine-wide provider config and stores credentials)
|
|
21
|
+
// and kb_export (auto-commits into the work tree) are NEVER served to a
|
|
22
|
+
// member session -- not in any list below.
|
|
23
|
+
// - kb_promote, kb_resolve_contradiction and kb_reconcile_prefilter (which
|
|
24
|
+
// resolves pairs through the same write path as kb_resolve_contradiction)
|
|
25
|
+
// mint CONFIRMED. They are served
|
|
26
|
+
// only to the repository's kb_maintainer member session, i.e. a member
|
|
27
|
+
// session opened with the engine's kb_maintainer grant (see
|
|
28
|
+
// MEMBER_MAINTAINER_TOOLS and src/services/tool-scope.ts). Every other
|
|
29
|
+
// member session -- including a role agent dispatched on the maintainer
|
|
30
|
+
// member, which connects through the plain per-folder ?member= entry --
|
|
31
|
+
// does not see them.
|
|
32
|
+
// - kb_demote lowers CONFIRMED to INFERRED. It is served on the same terms
|
|
33
|
+
// as kb_promote (kb_maintainer session only): the engine applies every
|
|
34
|
+
// reviewer demotion through the maintainer session, and no role agent
|
|
35
|
+
// needs to call it directly.
|
|
36
|
+
// - kb_import is served to every member session, but an explicit `path`
|
|
37
|
+
// (a caller-named bible, equivalent in power to kb_promote) is refused in
|
|
38
|
+
// a member session without the grant (src/tools/kb-import.ts); the
|
|
39
|
+
// repo-resolved checkout bible import is unchanged.
|
|
40
|
+
/**
|
|
41
|
+
* Every tool name registered by registerAllTools (src/services/tool-registry.ts).
|
|
42
|
+
* Kept in sync by a unit test that enumerates the registry's server.tool(...)
|
|
43
|
+
* calls; adding a tool there without adding it here fails that test.
|
|
44
|
+
*/
|
|
45
|
+
export const REGISTERED_TOOL_NAMES = Object.freeze([
|
|
46
|
+
'register_member', 'list_members', 'get_member_model_pricing', 'remove_member',
|
|
47
|
+
'update_member', 'dolt_push_mutex', 'child_id_allocator', 'member_reservation',
|
|
48
|
+
'send_files', 'receive_files', 'execute_prompt', 'execute_command',
|
|
49
|
+
'provision_llm_auth', 'setup_ssh_key', 'setup_git_app', 'provision_vcs_auth',
|
|
50
|
+
'revoke_vcs_auth', 'vcs_credential_exec', 'fleet_status', 'fleet_snapshot', 'member_detail',
|
|
51
|
+
'update_llm_cli', 'shutdown_server', 'version', 'session_stats', 'compose_permissions',
|
|
52
|
+
'cloud_control', 'monitor_task', 'stop_prompt', 'credential_store_set',
|
|
53
|
+
'credential_store_list', 'credential_store_delete', 'credential_store_update',
|
|
54
|
+
'send_email', 'send_message', 'report_status', 'respond_to_message',
|
|
55
|
+
'code_graph', 'code_impact', 'code_query', 'code_context', 'code_map',
|
|
56
|
+
'code_flow', 'code_tests', 'code_reindex', 'code_status',
|
|
57
|
+
'kb_capture', 'kb_invalidate', 'kb_context', 'kb_session_prime', 'kb_query',
|
|
58
|
+
'kb_list', 'kb_harvest', 'kb_promote', 'kb_demote', 'kb_freshness_sweep', 'kb_import',
|
|
59
|
+
'kb_resolve_contradiction', 'kb_reconcile_prefilter', 'kb_setup', 'kb_export',
|
|
60
|
+
'kb_stats', 'kb_feedback', 'kb_bible_commit',
|
|
61
|
+
]);
|
|
62
|
+
/**
|
|
63
|
+
* Name prefixes of the member tool families. NOT an allow rule: membership is
|
|
64
|
+
* the explicit MEMBER_BASE_TOOLS list. Used to pick the kb_ and code_ tools
|
|
65
|
+
* out of an allowlist (e.g. the role-agent MCP grants in agent-transform.ts).
|
|
66
|
+
*/
|
|
67
|
+
export const MEMBER_TOOL_PREFIXES = Object.freeze(['kb_', 'code_']);
|
|
68
|
+
/**
|
|
69
|
+
* Every tool a member session is served (the base member allowlist, before
|
|
70
|
+
* registration filtering). Explicit by design -- see the header.
|
|
71
|
+
*/
|
|
72
|
+
export const MEMBER_BASE_TOOLS = Object.freeze([
|
|
73
|
+
'version', 'report_status', 'session_stats',
|
|
74
|
+
'code_graph', 'code_impact', 'code_query', 'code_context', 'code_map',
|
|
75
|
+
'code_flow', 'code_tests', 'code_reindex', 'code_status',
|
|
76
|
+
'kb_capture', 'kb_invalidate', 'kb_context', 'kb_session_prime', 'kb_query',
|
|
77
|
+
'kb_list', 'kb_harvest', 'kb_freshness_sweep', 'kb_import',
|
|
78
|
+
'kb_stats', 'kb_feedback', 'kb_bible_commit',
|
|
79
|
+
]);
|
|
80
|
+
/**
|
|
81
|
+
* Tools served ONLY to a kb_maintainer member session (the engine's grant), on
|
|
82
|
+
* top of the base allowlist. They mint CONFIRMED, or (kb_demote) withdraw it. Not part of
|
|
83
|
+
* MEMBER_ALLOWED_TOOLS, so client-side deny rules keep them denied for every
|
|
84
|
+
* agent session on a member.
|
|
85
|
+
*/
|
|
86
|
+
export const MEMBER_MAINTAINER_TOOLS = Object.freeze(['kb_promote', 'kb_demote', 'kb_resolve_contradiction', 'kb_reconcile_prefilter']);
|
|
87
|
+
/**
|
|
88
|
+
* kb_ tools no member session is ever served, whatever its grants. Listed so
|
|
89
|
+
* the classification of every kb_ tool is explicit (and test-checked).
|
|
90
|
+
*/
|
|
91
|
+
export const MEMBER_NEVER_TOOLS = Object.freeze(['kb_setup', 'kb_export']);
|
|
92
|
+
/**
|
|
93
|
+
* Tools granted ONLY to channel-capable (interactive, claude/channel) member
|
|
94
|
+
* sessions, on top of the base allowlist. Not part of MEMBER_ALLOWED_TOOLS.
|
|
95
|
+
*/
|
|
96
|
+
export const MEMBER_CHANNEL_TOOLS = Object.freeze(['respond_to_message']);
|
|
97
|
+
/** Is this tool name in the base member allowlist? */
|
|
98
|
+
export function isMemberAllowedTool(name) {
|
|
99
|
+
return MEMBER_BASE_TOOLS.includes(name);
|
|
100
|
+
}
|
|
101
|
+
/** Is this tool served only to a kb_maintainer member session? */
|
|
102
|
+
export function isMemberMaintainerTool(name) {
|
|
103
|
+
return MEMBER_MAINTAINER_TOOLS.includes(name);
|
|
104
|
+
}
|
|
105
|
+
/** The base member allowlist: every registered tool in MEMBER_BASE_TOOLS. */
|
|
106
|
+
export const MEMBER_ALLOWED_TOOLS = Object.freeze(REGISTERED_TOOL_NAMES.filter(isMemberAllowedTool));
|
|
107
|
+
/**
|
|
108
|
+
* The complement of MEMBER_ALLOWED_TOOLS: every registered tool a member
|
|
109
|
+
* session may NOT use. Providers that support client-side deny rules (claude,
|
|
110
|
+
* agy) deny exactly these on the member's apra-fleet MCP entry. This includes
|
|
111
|
+
* MEMBER_MAINTAINER_TOOLS: an agent session on a member never carries the
|
|
112
|
+
* kb_maintainer grant (only the engine's own member calls do).
|
|
113
|
+
*/
|
|
114
|
+
export const MEMBER_DENIED_TOOLS = Object.freeze(REGISTERED_TOOL_NAMES.filter(name => !MEMBER_ALLOWED_TOOLS.includes(name)));
|
|
115
|
+
//# sourceMappingURL=member-tool-allowlist.js.map
|
|
@@ -20,7 +20,26 @@ export interface ModelPrice {
|
|
|
20
20
|
model: string;
|
|
21
21
|
promptPrice: number;
|
|
22
22
|
completionPrice: number;
|
|
23
|
+
/** $/1M prompt tokens served from the prompt cache (cache_read_input_tokens). */
|
|
24
|
+
cacheReadPrice: number;
|
|
25
|
+
/** $/1M prompt tokens written to the prompt cache (cache_creation_input_tokens). */
|
|
26
|
+
cacheWritePrice: number;
|
|
23
27
|
}
|
|
28
|
+
/**
|
|
29
|
+
* Anthropic prompt-cache write pricing, from
|
|
30
|
+
* https://platform.claude.com/docs/en/about-claude/pricing (checked
|
|
31
|
+
* 2026-10-06): a 5-minute cache write costs 1.25x the base input price and a
|
|
32
|
+
* 1-hour write 2x. The Claude Code CLI writes its cache with the 1-hour TTL
|
|
33
|
+
* (every recorded fleet dispatch reports ephemeral_1h_input_tokens and zero
|
|
34
|
+
* ephemeral_5m_input_tokens), so cache writes are priced at 2x. Cache READ
|
|
35
|
+
* rates are NOT one multiplier (0.1x on most models, 0.05x on Opus 5.5,
|
|
36
|
+
* 0.025x on Fable 5.1), so each table row carries its own `cacheRead`.
|
|
37
|
+
*
|
|
38
|
+
* This table is the FALLBACK only: a Claude dispatch's cost is the CLI's own
|
|
39
|
+
* reported figure (usage.cost_usd); the table prices providers and results
|
|
40
|
+
* that report no cost.
|
|
41
|
+
*/
|
|
42
|
+
export declare const ANTHROPIC_CACHE_WRITE_MULTIPLIER = 2;
|
|
24
43
|
export type MemberModelPricing = {
|
|
25
44
|
cheap: ModelPrice | null;
|
|
26
45
|
standard: ModelPrice | null;
|
|
@@ -1,4 +1,24 @@
|
|
|
1
1
|
import { getModelOverride } from './user-config.js';
|
|
2
|
+
/**
|
|
3
|
+
* Anthropic prompt-cache write pricing, from
|
|
4
|
+
* https://platform.claude.com/docs/en/about-claude/pricing (checked
|
|
5
|
+
* 2026-10-06): a 5-minute cache write costs 1.25x the base input price and a
|
|
6
|
+
* 1-hour write 2x. The Claude Code CLI writes its cache with the 1-hour TTL
|
|
7
|
+
* (every recorded fleet dispatch reports ephemeral_1h_input_tokens and zero
|
|
8
|
+
* ephemeral_5m_input_tokens), so cache writes are priced at 2x. Cache READ
|
|
9
|
+
* rates are NOT one multiplier (0.1x on most models, 0.05x on Opus 5.5,
|
|
10
|
+
* 0.025x on Fable 5.1), so each table row carries its own `cacheRead`.
|
|
11
|
+
*
|
|
12
|
+
* This table is the FALLBACK only: a Claude dispatch's cost is the CLI's own
|
|
13
|
+
* reported figure (usage.cost_usd); the table prices providers and results
|
|
14
|
+
* that report no cost.
|
|
15
|
+
*/
|
|
16
|
+
export const ANTHROPIC_CACHE_WRITE_MULTIPLIER = 2;
|
|
17
|
+
/** True for a Claude-family model id, under any provider's naming
|
|
18
|
+
* (claude provider aliases haiku/sonnet/opus, copilot/agy 'claude-*' ids). */
|
|
19
|
+
function isClaudeModel(model) {
|
|
20
|
+
return /^(haiku|sonnet|opus|fable)$/.test(model) || /(^|\/)claude-/.test(model);
|
|
21
|
+
}
|
|
2
22
|
/**
|
|
3
23
|
* provider -> concrete model id -> $/1M-token {prompt, completion}.
|
|
4
24
|
*
|
|
@@ -8,11 +28,21 @@ import { getModelOverride } from './user-config.js';
|
|
|
8
28
|
* an override or a future provider default change) returns null rather
|
|
9
29
|
* than a fabricated/guessed price.
|
|
10
30
|
*/
|
|
31
|
+
// Claude rows are Anthropic list prices (see ANTHROPIC_CACHE_WRITE_MULTIPLIER):
|
|
32
|
+
// `cacheRead` is the model's own cache-hit rate. The claude provider's
|
|
33
|
+
// aliases resolve to the current models: haiku = Haiku 4.5, sonnet =
|
|
34
|
+
// Sonnet 5.5, opus = Opus 5.5 (a recorded result confirms opus ->
|
|
35
|
+
// claude-opus-5-5), fable = Fable 5.1.
|
|
11
36
|
const PROVIDER_MODEL_PRICING = {
|
|
12
37
|
claude: {
|
|
13
|
-
haiku: { prompt:
|
|
14
|
-
sonnet: { prompt:
|
|
15
|
-
opus: { prompt:
|
|
38
|
+
haiku: { prompt: 1.00, completion: 5.00, cacheRead: 0.10 },
|
|
39
|
+
sonnet: { prompt: 2.00, completion: 10.00, cacheRead: 0.20 },
|
|
40
|
+
opus: { prompt: 4.00, completion: 20.00, cacheRead: 0.20 },
|
|
41
|
+
fable: { prompt: 10.00, completion: 50.00, cacheRead: 0.25 },
|
|
42
|
+
'claude-haiku-4-5': { prompt: 1.00, completion: 5.00, cacheRead: 0.10 },
|
|
43
|
+
'claude-sonnet-5-5': { prompt: 2.00, completion: 10.00, cacheRead: 0.20 },
|
|
44
|
+
'claude-opus-5-5': { prompt: 4.00, completion: 20.00, cacheRead: 0.20 },
|
|
45
|
+
'claude-fable-5-1': { prompt: 10.00, completion: 50.00, cacheRead: 0.25 },
|
|
16
46
|
},
|
|
17
47
|
agy: {
|
|
18
48
|
'gemini-3.8-flash-low': { prompt: 0.10, completion: 0.40 },
|
|
@@ -21,16 +51,16 @@ const PROVIDER_MODEL_PRICING = {
|
|
|
21
51
|
'gemini-3.8-flash-high': { prompt: 0.10, completion: 0.40 },
|
|
22
52
|
'gemini-3.1-pro-low': { prompt: 0.35, completion: 1.05 },
|
|
23
53
|
'gemini-3.1-pro-high': { prompt: 0.35, completion: 1.05 },
|
|
24
|
-
'claude-opus-4-6-thinking': { prompt:
|
|
54
|
+
'claude-opus-4-6-thinking': { prompt: 5.00, completion: 25.00, cacheRead: 0.50 },
|
|
25
55
|
},
|
|
26
56
|
codex: {
|
|
27
57
|
'gpt-5.4-mini': { prompt: 0.25, completion: 2.00 },
|
|
28
58
|
'gpt-5.4': { prompt: 5.00, completion: 15.00 },
|
|
29
59
|
},
|
|
30
60
|
copilot: {
|
|
31
|
-
'claude-haiku-4-5': { prompt:
|
|
32
|
-
'claude-sonnet-4-5': { prompt: 3.00, completion: 15.00 },
|
|
33
|
-
'claude-opus-4-5': { prompt:
|
|
61
|
+
'claude-haiku-4-5': { prompt: 1.00, completion: 5.00, cacheRead: 0.10 },
|
|
62
|
+
'claude-sonnet-4-5': { prompt: 3.00, completion: 15.00, cacheRead: 0.30 },
|
|
63
|
+
'claude-opus-4-5': { prompt: 5.00, completion: 25.00, cacheRead: 0.50 },
|
|
34
64
|
},
|
|
35
65
|
// OpenCode's default tier models are all free-tier ($0) -- a real,
|
|
36
66
|
// known price, not an "unknown model" null.
|
|
@@ -87,7 +117,23 @@ function priceModel(providerName, model) {
|
|
|
87
117
|
const price = table[model];
|
|
88
118
|
if (!price)
|
|
89
119
|
return null;
|
|
90
|
-
|
|
120
|
+
// Claude models: the row's own cache-read rate and Anthropic's 1-hour
|
|
121
|
+
// cache-write rate. Other models' adapters report no cache-token counts
|
|
122
|
+
// (always 0), so their cache rates never contribute; they are set to the
|
|
123
|
+
// plain prompt price -- the honest "billed as an input token, no known
|
|
124
|
+
// discount" figure -- rather than an invented discount.
|
|
125
|
+
const claude = isClaudeModel(model);
|
|
126
|
+
return {
|
|
127
|
+
model,
|
|
128
|
+
promptPrice: price.prompt,
|
|
129
|
+
completionPrice: price.completion,
|
|
130
|
+
cacheReadPrice: claude && price.cacheRead !== undefined ? price.cacheRead : price.prompt,
|
|
131
|
+
cacheWritePrice: claude ? round6(price.prompt * ANTHROPIC_CACHE_WRITE_MULTIPLIER) : price.prompt,
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
/** Strip binary floating-point noise (15 * 0.1 = 1.5000000000000002). */
|
|
135
|
+
function round6(n) {
|
|
136
|
+
return Math.round(n * 1e6) / 1e6;
|
|
91
137
|
}
|
|
92
138
|
/**
|
|
93
139
|
* @param agent the member to resolve pricing for
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
export interface PortHolder {
|
|
2
|
+
/** Holding process id; absent when it is not visible to this user. */
|
|
3
|
+
pid?: number;
|
|
4
|
+
/** Login name of the holding process's owner, when known. */
|
|
5
|
+
user?: string;
|
|
6
|
+
/** Numeric uid of the owner (POSIX), when known. */
|
|
7
|
+
uid?: number;
|
|
8
|
+
/** Holding process's command name, when known. */
|
|
9
|
+
command?: string;
|
|
10
|
+
/** Set when the owner's name is not visible but this user was shown NOT to
|
|
11
|
+
* own the holder (process.kill(pid, 0) -> EPERM, or lsof sees no own
|
|
12
|
+
* listener on a bound port). */
|
|
13
|
+
otherUser?: boolean;
|
|
14
|
+
}
|
|
15
|
+
export type PortHolderProbe = (port: number) => Promise<PortHolder | null>;
|
|
16
|
+
/** Test hook: replace the platform probe (null restores it). */
|
|
17
|
+
export declare function _setPortHolderProbeOverride(fn: PortHolderProbe | null): void;
|
|
18
|
+
/** The process holding a LISTEN socket on `port`, or null when unknown. Never throws. */
|
|
19
|
+
export declare function findPortHolder(port: number): Promise<PortHolder | null>;
|
|
20
|
+
/** Parse /proc/net/tcp(6) text: the uid and inode of the LISTEN socket on `port`. */
|
|
21
|
+
export declare function parseProcNetTcp(text: string, port: number): {
|
|
22
|
+
uid: number;
|
|
23
|
+
inode: string;
|
|
24
|
+
} | null;
|
|
25
|
+
/** Login name for a uid from /etc/passwd text, or undefined. */
|
|
26
|
+
export declare function userFromPasswd(text: string, uid: number): string | undefined;
|
|
27
|
+
/** Parse `lsof -F pcLu` output: the first process record. */
|
|
28
|
+
export declare function parseLsofFields(out: string): PortHolder | null;
|
|
29
|
+
type ExecFileText = (file: string, args: string[], opts: object) => string | Buffer;
|
|
30
|
+
/** macOS probe (exported with an exec seam for tests). */
|
|
31
|
+
export declare function lsofPortHolder(port: number, exec?: ExecFileText): PortHolder | null;
|
|
32
|
+
/** The PowerShell probe (wrapped with wrapPowerShellEncoded before it runs). */
|
|
33
|
+
export declare function windowsPortHolderScript(port: number): string;
|
|
34
|
+
/** Parse the PowerShell probe's JSON line. */
|
|
35
|
+
export declare function parseWindowsPortHolder(out: string): PortHolder | null;
|
|
36
|
+
/** Windows probe (exported with seams for tests). */
|
|
37
|
+
export declare function windowsPortHolder(port: number, runProbe?: (cmd: string) => string, kill?: (pid: number, sig: number) => unknown): PortHolder | null;
|
|
38
|
+
/**
|
|
39
|
+
* Pid of the LISTEN socket on `port` from `netstat -ano -p TCP` (no CIM/WMI,
|
|
40
|
+
* so it works for a standard user over SSH). The state column is localized,
|
|
41
|
+
* so a listener is recognised by its unbound foreign address instead.
|
|
42
|
+
*/
|
|
43
|
+
export declare function parseNetstatListenPid(out: string, port: number): number | undefined;
|
|
44
|
+
/** Whether `pid` belongs to another user: signal 0 is refused (EPERM) for one. */
|
|
45
|
+
export declare function pidOwnedByOtherUser(pid: number, kill?: (pid: number, sig: number) => unknown): boolean | undefined;
|
|
46
|
+
/** Windows CIM-free fallback probe (exported with seams for tests). */
|
|
47
|
+
export declare function netstatPortHolder(port: number, exec?: ExecFileText, kill?: (pid: number, sig: number) => unknown): PortHolder | null;
|
|
48
|
+
/** This process's user (name and, on POSIX, uid). */
|
|
49
|
+
export declare function currentUser(): {
|
|
50
|
+
user?: string;
|
|
51
|
+
uid?: number;
|
|
52
|
+
};
|
|
53
|
+
/**
|
|
54
|
+
* True when the holder belongs to a different user than `me`, false when it
|
|
55
|
+
* is the same user, undefined when that cannot be told. uid wins over the
|
|
56
|
+
* name when both sides have one; names compare case-insensitively (Windows).
|
|
57
|
+
*/
|
|
58
|
+
export declare function heldByOtherUser(holder: PortHolder, me?: {
|
|
59
|
+
user?: string;
|
|
60
|
+
uid?: number;
|
|
61
|
+
}): boolean | undefined;
|
|
62
|
+
/** Machine-readable code on the refusal when another user holds the port. */
|
|
63
|
+
export declare const PORT_HELD_BY_OTHER_USER_CODE = "E-PORT-HELD-BY-OTHER-USER";
|
|
64
|
+
/** Which install the conflicting server belongs to: the remedy differs. */
|
|
65
|
+
export type PortConflictInstallKind = 'full' | 'member';
|
|
66
|
+
/** The refusal when ANOTHER user's process holds the port: who, pid, remedy.
|
|
67
|
+
* A member install can move to its own recorded port; a full install's
|
|
68
|
+
* service is not given a custom port, so its remedy is freeing the port. */
|
|
69
|
+
export declare function portHeldByOtherUserMessage(port: number, holder: PortHolder, installKind: PortConflictInstallKind, me?: {
|
|
70
|
+
user?: string;
|
|
71
|
+
uid?: number;
|
|
72
|
+
}): string;
|
|
73
|
+
/**
|
|
74
|
+
* The full operator message for a configured port that is taken, given the
|
|
75
|
+
* generic port-in-use text. Another user's holder -> the refusal above (with
|
|
76
|
+
* `foreign: true`); otherwise the generic text plus the holder when known.
|
|
77
|
+
*/
|
|
78
|
+
export declare function describePortConflict(port: number, genericMessage: string, holder: PortHolder | null, installKind: PortConflictInstallKind, me?: {
|
|
79
|
+
user?: string;
|
|
80
|
+
uid?: number;
|
|
81
|
+
}): {
|
|
82
|
+
foreign: boolean;
|
|
83
|
+
message: string;
|
|
84
|
+
};
|
|
85
|
+
export {};
|
|
86
|
+
//# sourceMappingURL=port-holder.d.ts.map
|