@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -40,7 +40,55 @@ export type SessionIdStrategy = {
|
|
|
40
40
|
} | {
|
|
41
41
|
type: 'provider-minted';
|
|
42
42
|
};
|
|
43
|
-
|
|
43
|
+
/**
|
|
44
|
+
* apra-fleet-25yl.2.1: what the EXEC-LEVEL ROLLING (inactivity) timeout handed
|
|
45
|
+
* to `strategy.execCommand()` is derived from, for this provider.
|
|
46
|
+
*
|
|
47
|
+
* - 'inactivity_timeout' -- derive it from the caller's `timeout_s`. Choose
|
|
48
|
+
* this when the exec channel (stdout/stderr on the dispatch pipe) is a
|
|
49
|
+
* REAL mid-turn liveness signal for the provider, OR when preserving the
|
|
50
|
+
* provider's current behaviour is the point. Codex is the load-bearing
|
|
51
|
+
* case: its adapter returns null from resolveSessionLogDir(), so the
|
|
52
|
+
* StallDetector has no transcript to poll and this timer is its ONLY stall
|
|
53
|
+
* signal -- decoupling it there disables stall detection outright.
|
|
54
|
+
* - 'total_ceiling' -- do NOT arm a `timeout_s`-sized rolling deadline;
|
|
55
|
+
* derive it from `max_total_s` instead (a value that can never bind before
|
|
56
|
+
* the caller's own hard ceiling does). Choose this when the provider is
|
|
57
|
+
* batch/CONOUT$-only, so the exec channel emits nothing mid-turn and a
|
|
58
|
+
* `timeout_s`-sized rolling deadline is a false kill. The StallDetector's
|
|
59
|
+
* transcript polling is the real stall mechanism for these providers, and
|
|
60
|
+
* it still gets `timeout_s` as its thresholdMs.
|
|
61
|
+
*
|
|
62
|
+
* This is deliberately a REQUIRED member of {@link ProviderAdapter} rather
|
|
63
|
+
* than an optional one with a default: a newly added provider must state its
|
|
64
|
+
* own answer (a compile error if it does not) instead of silently inheriting
|
|
65
|
+
* whichever branch happens to be the fallback, because the wrong branch
|
|
66
|
+
* silently disables a kill path.
|
|
67
|
+
*/
|
|
68
|
+
export type ExecTimeoutSource = 'inactivity_timeout' | 'total_ceiling';
|
|
69
|
+
/** Claude Code caps an encoded project-dir name at this many characters. */
|
|
70
|
+
export declare const CLAUDE_PROJECT_DIR_MAX_LEN = 200;
|
|
71
|
+
/**
|
|
72
|
+
* The 32-bit string hash Claude Code appends to an over-long project-dir name
|
|
73
|
+
* (ported verbatim from the claude CLI bundle: h = ((h << 5) - h + charCode) | 0
|
|
74
|
+
* over UTF-16 code units).
|
|
75
|
+
*/
|
|
76
|
+
export declare function claudeProjectDirHash(s: string): number;
|
|
77
|
+
/**
|
|
78
|
+
* Normalize a work folder to the cwd string Claude Code itself sees: no
|
|
79
|
+
* trailing separator (process.cwd() never has one, except at a root), and on
|
|
80
|
+
* Windows backslash separators (only the over-200 hash suffix depends on the
|
|
81
|
+
* separator; the visible encoding maps both to '-').
|
|
82
|
+
*/
|
|
83
|
+
export declare function claudeCwdForm(workFolder: string, windows: boolean): string;
|
|
84
|
+
/**
|
|
85
|
+
* The ~/.claude/projects/<name> directory name Claude Code uses for a cwd:
|
|
86
|
+
* every non-alphanumeric char becomes '-', and a name longer than 200 chars is
|
|
87
|
+
* cut to 200 and suffixed with '-' + base36(|hash(cwd)|) -- the same rule as
|
|
88
|
+
* the claude CLI. `windows` selects the member's cwd form (defaults to this
|
|
89
|
+
* host's platform).
|
|
90
|
+
*/
|
|
91
|
+
export declare function encodeClaudeProjectDir(workFolder: string, windows?: boolean): string;
|
|
44
92
|
/**
|
|
45
93
|
* Build a `--resume <id>` flag with session ID sanitization and quoting.
|
|
46
94
|
* Shared by providers that pass session IDs on the command line (Claude).
|
|
@@ -53,6 +101,22 @@ export declare function buildResumeFlag(sessionId: string | undefined, fallback?
|
|
|
53
101
|
* @param sessionId - The raw session ID (will be sanitized)
|
|
54
102
|
*/
|
|
55
103
|
export declare function buildSessionIdFlag(sessionId: string): string;
|
|
104
|
+
/**
|
|
105
|
+
* Build a fork-mode resume flag: seed context from `sourceSessionId`'s transcript
|
|
106
|
+
* but yield a NEW, distinct session id rather than continuing the source id in
|
|
107
|
+
* place (contrast with {@link buildResumeFlag}, which resumes the source id
|
|
108
|
+
* unchanged). Shared by providers whose CLI supports resuming into a forked
|
|
109
|
+
* session id (Claude's `--fork-session`, used together with `--resume`).
|
|
110
|
+
*
|
|
111
|
+
* The forked session id is pre-minted by the caller and passed explicitly via
|
|
112
|
+
* `--session-id` alongside `--resume ... --fork-session`, rather than letting
|
|
113
|
+
* the CLI mint its own id and scraping it out of the response afterward -- the
|
|
114
|
+
* CLI honors a caller-supplied `--session-id` even in fork mode.
|
|
115
|
+
* @param sourceSessionId - The session ID to seed/fork from (will be sanitized)
|
|
116
|
+
* @param newSessionId - The caller-minted id the forked session should be created under (will be sanitized)
|
|
117
|
+
* @param fallback - Value to return when sourceSessionId is absent (default: '')
|
|
118
|
+
*/
|
|
119
|
+
export declare function buildForkFlag(sourceSessionId: string | undefined, newSessionId: string | undefined, fallback?: string): string;
|
|
56
120
|
export interface PromptOptions {
|
|
57
121
|
folder: string;
|
|
58
122
|
promptFile: string;
|
|
@@ -64,42 +128,219 @@ export interface PromptOptions {
|
|
|
64
128
|
maxTurns?: number;
|
|
65
129
|
inv?: string;
|
|
66
130
|
agentName?: string;
|
|
131
|
+
/** Provider project the run is bound to (AGY: `--project <id>`, from
|
|
132
|
+
* Agent.agyProjectId). Ignored by providers without {@link ProviderAdapter.projectFlag}. */
|
|
133
|
+
projectId?: string;
|
|
134
|
+
/** Absolute member-side path of a per-session MCP config file (Claude:
|
|
135
|
+
* `--mcp-config <file>`), already written by the caller. Ignored by
|
|
136
|
+
* providers without {@link ProviderAdapter.mcpConfigFlag}. */
|
|
137
|
+
mcpConfigPath?: string;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* apra-fleet-hzeb.1: a provider-agnostic "this dispatch hit a usage/quota limit
|
|
141
|
+
* and cannot make progress until `resumeAt`" signal. Distinct from a transient
|
|
142
|
+
* overload (529/overloaded), which is retryable after a short backoff -- a usage
|
|
143
|
+
* limit needs a real wall-clock wait until the quota window resets.
|
|
144
|
+
*
|
|
145
|
+
* `resumeAt` is ALWAYS a concrete ISO-8601 UTC timestamp, never null: when the
|
|
146
|
+
* provider CLI exposes a real reset time we parse it (`resumeAtSource: 'parsed'`);
|
|
147
|
+
* otherwise we fall back to a guessed window (`resumeAtSource: 'guessed'`), so a
|
|
148
|
+
* consumer can always schedule a resume without special-casing "unknown".
|
|
149
|
+
*/
|
|
150
|
+
export interface UsageLimitSignal {
|
|
151
|
+
type: 'usage_limit';
|
|
152
|
+
/** ISO-8601 UTC instant at which work may resume. Never null. */
|
|
153
|
+
resumeAt: string;
|
|
154
|
+
/** Whether `resumeAt` was parsed from the provider's own reset time, or guessed. */
|
|
155
|
+
resumeAtSource: 'parsed' | 'guessed';
|
|
156
|
+
/** The raw message/output that identified this as a usage limit (for logging). */
|
|
157
|
+
message: string;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* apra-fleet-hzeb.1: THE provider-adapter default resume window for a guessed
|
|
161
|
+
* usage-limit signal (1 hour). This is the single source of truth for the guess --
|
|
162
|
+
* fleet-sprint and other consumers must read the signal's `resumeAt`, never
|
|
163
|
+
* hardcode their own 1h fallback.
|
|
164
|
+
*/
|
|
165
|
+
export declare const DEFAULT_USAGE_LIMIT_RESUME_MS: number;
|
|
166
|
+
/**
|
|
167
|
+
* apra-fleet-hzeb.1: build a guessed usage-limit signal whose `resumeAt` is
|
|
168
|
+
* `now + DEFAULT_USAGE_LIMIT_RESUME_MS`. `now` is injectable for deterministic
|
|
169
|
+
* tests.
|
|
170
|
+
*/
|
|
171
|
+
export declare function guessedUsageLimitSignal(message: string, now?: number): UsageLimitSignal;
|
|
172
|
+
export declare function defaultUsageLimitSignal(output: string, now?: number): UsageLimitSignal | null;
|
|
173
|
+
/**
|
|
174
|
+
* Token counts one dispatch reported. input_tokens/output_tokens are required;
|
|
175
|
+
* the cache fields are provider-optional -- an adapter whose CLI reports
|
|
176
|
+
* prompt-cache traffic (Claude: cache_read_input_tokens /
|
|
177
|
+
* cache_creation_input_tokens on the result event's usage) fills them, every
|
|
178
|
+
* other adapter leaves them absent and consumers treat absent as 0. They are
|
|
179
|
+
* billed input tokens that are NOT included in input_tokens, so a cost figure
|
|
180
|
+
* that ignores them undercounts a cache-heavy dispatch several-fold.
|
|
181
|
+
*/
|
|
182
|
+
export interface TokenUsage {
|
|
183
|
+
input_tokens: number;
|
|
184
|
+
output_tokens: number;
|
|
185
|
+
/** Prompt tokens served from the provider's prompt cache. */
|
|
186
|
+
cache_read_input_tokens?: number;
|
|
187
|
+
/** Prompt tokens written into the provider's prompt cache. */
|
|
188
|
+
cache_creation_input_tokens?: number;
|
|
189
|
+
/** USD this dispatch cost, as the provider CLI itself reported it (Claude:
|
|
190
|
+
* the delta of the result's cumulative total_cost_usd, see
|
|
191
|
+
* services/session-cost.ts). Absent when the provider reports no cost;
|
|
192
|
+
* cost consumers then price the token counts from the rate table. */
|
|
193
|
+
cost_usd?: number;
|
|
67
194
|
}
|
|
68
195
|
export interface ParsedResponse {
|
|
69
196
|
result: string;
|
|
70
197
|
sessionId?: string;
|
|
71
198
|
isError: boolean;
|
|
72
199
|
raw: string;
|
|
73
|
-
usage?:
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
200
|
+
usage?: TokenUsage;
|
|
201
|
+
/** The CLI's CUMULATIVE session cost in USD (Claude: total_cost_usd), when
|
|
202
|
+
* reported. Not per dispatch: execute_prompt turns it into the dispatch's
|
|
203
|
+
* usage.cost_usd. */
|
|
204
|
+
sessionCostUsd?: number;
|
|
77
205
|
/** e.g. 'error_max_turns' -- the CLI result event's own subtype, when present. */
|
|
78
206
|
subtype?: string;
|
|
79
207
|
/** e.g. 'max_turns' -- the CLI result event's own terminal_reason, when present. */
|
|
80
208
|
terminalReason?: string;
|
|
209
|
+
/** apra-fleet-hzeb.1: the Claude result event's api_error_status (e.g. 429), when
|
|
210
|
+
* present -- previously dropped by the parser. Used by detectUsageLimit. */
|
|
211
|
+
apiErrorStatus?: number;
|
|
212
|
+
/** apra-fleet-hzeb.1: set by execute_prompt (from detectUsageLimit) when this
|
|
213
|
+
* dispatch was terminated by a provider usage/quota limit. */
|
|
214
|
+
usageLimit?: UsageLimitSignal;
|
|
215
|
+
/** Set by a provider parser when the CLI refused one or more tool calls for
|
|
216
|
+
* lack of a permission grant (AGY headless mode auto-denies them). */
|
|
217
|
+
permissionDenial?: PermissionDenial;
|
|
218
|
+
}
|
|
219
|
+
/** A tool call the member CLI refused because no grant allowed it. */
|
|
220
|
+
export interface PermissionDenialItem {
|
|
221
|
+
/** Provider permission action, e.g. 'command', 'read_file', 'mcp'. */
|
|
222
|
+
action: string;
|
|
223
|
+
/** The concrete target, when the CLI named it, e.g. 'git status --short --branch'. */
|
|
224
|
+
target?: string;
|
|
225
|
+
/** compose_permissions grants that would allow this one call, primary
|
|
226
|
+
* first (empty when no grant maps to it). */
|
|
227
|
+
suggestedGrants?: string[];
|
|
228
|
+
}
|
|
229
|
+
/** Structured permission denial surfaced by execute_prompt as
|
|
230
|
+
* `reason: 'permission_denied'`. */
|
|
231
|
+
export interface PermissionDenial {
|
|
232
|
+
/** Unique denied actions, in first-seen order. */
|
|
233
|
+
actions: string[];
|
|
234
|
+
denials: PermissionDenialItem[];
|
|
235
|
+
/** compose_permissions `grant` values that would allow the denied calls
|
|
236
|
+
* (empty when there is no canonical mapping for an action, and always
|
|
237
|
+
* empty when healable is false). The primary suggestion comes first; a
|
|
238
|
+
* narrower alternative may follow it. */
|
|
239
|
+
suggestedGrants: string[];
|
|
240
|
+
/** One-line remediation for a human or an orchestrator. */
|
|
241
|
+
hint: string;
|
|
242
|
+
/** Which of the CLI's signals reported the denial. */
|
|
243
|
+
signals: Array<'result_json' | 'stderr' | 'transcript'>;
|
|
244
|
+
/** The permission mode the session ran in, when the provider knows it
|
|
245
|
+
* (Claude: 'auto' | 'acceptEdits' | 'bypassPermissions'). */
|
|
246
|
+
permissionMode?: string;
|
|
247
|
+
/** false when no grant may ever be added for these denials: in Claude auto
|
|
248
|
+
* mode a refusal comes from the safety classifier or a deny rule, not from
|
|
249
|
+
* a missing allow rule; in any mode, a refusal of a fleet tool outside the
|
|
250
|
+
* member allowlist is the member tool policy (cause 'policy_deny'). Absent
|
|
251
|
+
* = a grant may heal it. */
|
|
252
|
+
healable?: boolean;
|
|
253
|
+
/** 'policy_deny': at least one refused call was a fleet tool outside the
|
|
254
|
+
* member allowlist, denied by the deny rules compose writes on purpose.
|
|
255
|
+
* Always comes with healable: false. */
|
|
256
|
+
cause?: 'policy_deny';
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Splits a command line into its pipeline stages (on pipe `|`), respecting
|
|
260
|
+
* single and double quotes, and ignoring logical OR `||`.
|
|
261
|
+
*/
|
|
262
|
+
export declare function splitPipelineStages(line: string): string[];
|
|
263
|
+
/** Extracts the base executable command from a single command or pipeline stage. */
|
|
264
|
+
export declare function extractCommandFromStage(stage: string): string | undefined;
|
|
265
|
+
export declare function suggestedGrantsForDenial(item: PermissionDenialItem): string[];
|
|
266
|
+
export declare function suggestedGrantForDenial(item: PermissionDenialItem): string | undefined;
|
|
267
|
+
/** Context parseResponse may use; providers that do not need it ignore it. */
|
|
268
|
+
export interface ParseResponseContext {
|
|
269
|
+
/** The member's OS (e.g. agy's permission-denial hint differs on Windows). */
|
|
270
|
+
agentOs?: 'linux' | 'macos' | 'windows';
|
|
271
|
+
/** The member's unattended setting and the model the dispatch ran with, so
|
|
272
|
+
* a provider can tell which permission mode the session ran in. */
|
|
273
|
+
unattended?: false | 'auto' | 'dangerous';
|
|
274
|
+
model?: string;
|
|
275
|
+
}
|
|
276
|
+
/** Extra inputs to composePermissionConfig; providers that do not need them
|
|
277
|
+
* ignore them. */
|
|
278
|
+
export interface ComposePermissionOptions {
|
|
279
|
+
/** The member's home directory, resolved in JavaScript (getMemberHomeDir). */
|
|
280
|
+
memberHomeDir?: string | null;
|
|
281
|
+
/** Receives lines for grants that could not be expressed and were dropped;
|
|
282
|
+
* compose_permissions shows them in its result. */
|
|
283
|
+
warnings?: string[];
|
|
81
284
|
}
|
|
82
285
|
export declare function isMaxTurnsResponse(parsed: ParsedResponse | undefined | null): boolean;
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
286
|
+
/** Context for {@link ProviderAdapter.syncMemberMcpEntry}. */
|
|
287
|
+
export interface MemberMcpSyncContext {
|
|
288
|
+
agent: import('../types.js').Agent;
|
|
289
|
+
execCommand: WorkspaceTrustExecFn;
|
|
290
|
+
/** The member's home directory, resolved in JavaScript (getMemberHomeDir); null when unresolvable. */
|
|
291
|
+
memberHomeDir: string | null;
|
|
292
|
+
agentOs: 'linux' | 'macos' | 'windows';
|
|
293
|
+
shell?: MemberShell;
|
|
294
|
+
/** Out-of-band file channel for large home-anchored files (see WorkspaceTrustTransport). */
|
|
295
|
+
transport?: WorkspaceTrustTransport;
|
|
296
|
+
/** Owner-only secret-file channel, tried when the file channel is unavailable
|
|
297
|
+
* (see MemberSecretFileChannel). With neither, the write fails loudly. */
|
|
298
|
+
secretChannel?: MemberSecretFileChannel;
|
|
299
|
+
/** The per-folder apra-fleet entry URL (.../mcp?member=<uuid>) to write, or null to REMOVE
|
|
300
|
+
* the entry this provider wrote for the member's folder (provider switch cleanup). */
|
|
301
|
+
url: string | null;
|
|
302
|
+
/** HTTP headers the entry carries with `url` -- the member install's access
|
|
303
|
+
* secret (member-access-secret.ts), without which its server refuses the
|
|
304
|
+
* `?member=` session. A config carrying it is written only through a file
|
|
305
|
+
* channel, never a command string. Absent when no secret is known. */
|
|
306
|
+
headers?: Record<string, string>;
|
|
307
|
+
/** With url null: remove the folder's apra-fleet entry only when it points at
|
|
308
|
+
* THIS member (?member=<uuid>), leaving any other apra-fleet entry alone. */
|
|
309
|
+
removeOnlyOwnEntry?: boolean;
|
|
90
310
|
}
|
|
91
|
-
export interface
|
|
92
|
-
/**
|
|
93
|
-
|
|
94
|
-
|
|
311
|
+
export interface MemberMcpSyncResult {
|
|
312
|
+
/** Work-folder-relative files this provider owns for the member MCP entry -- the
|
|
313
|
+
* caller keeps them out of `git status` via the clone's .git/info/exclude. */
|
|
314
|
+
workFolderFiles: string[];
|
|
315
|
+
/** Human-readable summary for logs/tool output. */
|
|
95
316
|
detail: string;
|
|
96
317
|
}
|
|
97
|
-
/** Delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted} -- the SAME
|
|
98
|
-
* channel compose_permissions' deliverConfigFile already uses (AgentStrategy.execCommand:
|
|
99
|
-
* SSH for remote members, local shell exec for local members). Kept as a narrow function
|
|
100
|
-
* type (rather than importing AgentStrategy) so providers.ts has no dependency on
|
|
101
|
-
* services/strategy.ts. */
|
|
102
318
|
export type WorkspaceTrustExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
|
|
319
|
+
/** Optional file-delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted}
|
|
320
|
+
* (GitHub #499). Writes `content` to `relPath`, resolved relative to the MEMBER's home
|
|
321
|
+
* directory, without going through a shell command line: node:fs for a local member,
|
|
322
|
+
* SFTP for an SSH member. A merged ~/.claude.json can be far larger than any command
|
|
323
|
+
* line a Windows process may carry (CreateProcess caps it at 32767 chars; cmd.exe at
|
|
324
|
+
* 8191), so the adapter prefers this channel when present and only falls back to
|
|
325
|
+
* exec-based delivery (chunked on Windows) when it is absent or fails. Must throw on
|
|
326
|
+
* failure so the adapter can fall back. */
|
|
327
|
+
export type WorkspaceTrustWriteHomeFileFn = (relPath: string, content: string) => Promise<void>;
|
|
328
|
+
export type WorkspaceTrustReadHomeFileFn = (relPath: string) => Promise<{
|
|
329
|
+
found: boolean;
|
|
330
|
+
content?: string;
|
|
331
|
+
} | undefined>;
|
|
332
|
+
/** Owner-only secret-file channel (writeMemberSecretFile): stages `content` in a
|
|
333
|
+
* fresh owner-only file on the member WITHOUT a command line and returns its
|
|
334
|
+
* absolute member-side path. Used when the home-anchored file channel is
|
|
335
|
+
* unavailable; `remove` is best-effort cleanup of a staged file. */
|
|
336
|
+
export interface MemberSecretFileChannel {
|
|
337
|
+
write(content: string): Promise<string>;
|
|
338
|
+
remove(filePath: string): Promise<void>;
|
|
339
|
+
}
|
|
340
|
+
export interface WorkspaceTrustTransport {
|
|
341
|
+
writeHomeFile?: WorkspaceTrustWriteHomeFileFn;
|
|
342
|
+
readHomeFile?: WorkspaceTrustReadHomeFileFn;
|
|
343
|
+
}
|
|
103
344
|
export interface EnsureWorkspaceTrustedResult {
|
|
104
345
|
/** true only when this call just wrote hasTrustDialogAccepted=true because it was
|
|
105
346
|
* missing. false when the provider no-ops, or when trust was already present. */
|
|
@@ -128,6 +369,18 @@ export interface ProviderAdapter {
|
|
|
128
369
|
installCommand(os: 'linux' | 'macos' | 'windows', shell?: MemberShell): string;
|
|
129
370
|
updateCommand(): string;
|
|
130
371
|
buildPromptCommand(opts: PromptOptions): string;
|
|
372
|
+
/** The per-session MCP config flag for a resolved absolute member-side path,
|
|
373
|
+
* quoted by the provider for the member's shell (`posix` false = PowerShell).
|
|
374
|
+
* Callers append it after every positional argument: Claude's --mcp-config
|
|
375
|
+
* is variadic and would swallow a following positional prompt. Optional:
|
|
376
|
+
* providers without one never get a session config. */
|
|
377
|
+
mcpConfigFlag?(absPath: string, posix: boolean): string;
|
|
378
|
+
/** Minimum CLI version whose per-session MCP config accepts an always-load
|
|
379
|
+
* option that keeps the server's tools out of tool-search deferral (Claude:
|
|
380
|
+
* the `alwaysLoad` server key). The dispatcher probes the member's CLI
|
|
381
|
+
* version and writes the option only at or above this, logging a WARN
|
|
382
|
+
* otherwise. Optional: providers without one never get the option. */
|
|
383
|
+
mcpAlwaysLoadMinVersion?(): string;
|
|
131
384
|
skipPermissionsFlag(): string;
|
|
132
385
|
/** Returns the CLI flag for unattended='auto', or null if the provider does not support it. */
|
|
133
386
|
permissionModeAutoFlag(): string | null;
|
|
@@ -147,14 +400,64 @@ export interface ProviderAdapter {
|
|
|
147
400
|
* applies. This is the single source of truth for unattended-mode flag
|
|
148
401
|
* resolution: both buildPromptCommand() (POSIX, via os/linux.ts) and
|
|
149
402
|
* os/windows.ts call this instead of re-deriving the branching
|
|
150
|
-
* themselves, so the two dispatch paths cannot diverge.
|
|
151
|
-
|
|
152
|
-
|
|
403
|
+
* themselves, so the two dispatch paths cannot diverge. `model` is the
|
|
404
|
+
* model the dispatch runs (Claude falls back from auto to acceptEdits on a
|
|
405
|
+
* model without auto-mode support). */
|
|
406
|
+
resolvePermissionFlag(unattended: false | 'auto' | 'dangerous' | undefined, model?: string): string;
|
|
407
|
+
parseResponse(result: SSHExecResult, ctx?: ParseResponseContext): ParsedResponse;
|
|
408
|
+
/** apra-fleet-hzeb.1: detect whether this dispatch was terminated by a provider
|
|
409
|
+
* usage/quota limit (as opposed to a transient overload). Returns a
|
|
410
|
+
* {@link UsageLimitSignal} with a concrete `resumeAt`, or null when this was not
|
|
411
|
+
* a usage limit. REQUIRED on every adapter: none.ts returns null; the non-Claude
|
|
412
|
+
* adapters delegate to {@link defaultUsageLimitSignal} on their raw output; Claude
|
|
413
|
+
* keys off its api_error_status / terminal_reason plus its own limit message. */
|
|
414
|
+
detectUsageLimit(result: SSHExecResult, parsed: ParsedResponse): UsageLimitSignal | null;
|
|
153
415
|
supportsResume(): boolean;
|
|
154
416
|
supportsMaxTurns(): boolean;
|
|
155
417
|
resumeFlag(sessionId?: string, resuming?: boolean): string;
|
|
156
418
|
/** Defines whether this provider accepts caller-minted UUIDs or generates session IDs natively. */
|
|
157
419
|
sessionIdStrategy(): SessionIdStrategy;
|
|
420
|
+
/** apra-fleet-25yl.2.1: what the exec-level rolling (inactivity) timeout is
|
|
421
|
+
* derived from for this provider -- see {@link ExecTimeoutSource}. REQUIRED
|
|
422
|
+
* on every adapter, deliberately with no default, so a new provider must
|
|
423
|
+
* state its answer rather than inherit one. */
|
|
424
|
+
execTimeoutSource(): ExecTimeoutSource;
|
|
425
|
+
/** apra-fleet-lmtg.1: true when this provider supports fork-mode dispatch --
|
|
426
|
+
* branching a NEW, distinct session id from an existing session's context,
|
|
427
|
+
* as opposed to resume (which continues the source id in place). Optional:
|
|
428
|
+
* providers that do not implement it are NOT fork-capable. Callers MUST
|
|
429
|
+
* check `provider.supportsFork?.() ?? false` before ever calling
|
|
430
|
+
* {@link forkFlag} -- never assume support. */
|
|
431
|
+
supportsFork?(): boolean;
|
|
432
|
+
/** Builds the CLI flag(s) for a fork-mode dispatch: seeds context from
|
|
433
|
+
* `sourceSessionId`'s transcript but yields a NEW session id distinct from
|
|
434
|
+
* the source (the source session itself is left untouched). `newSessionId`
|
|
435
|
+
* is the caller-minted id the forked session should be created under --
|
|
436
|
+
* passed explicitly (e.g. as `--session-id`) rather than left for the CLI
|
|
437
|
+
* to mint and scrape back out of the response afterward. Only called
|
|
438
|
+
* when `supportsFork()` returns true. For providers whose CLI cannot
|
|
439
|
+
* express "new id, seeded from an existing transcript" (i.e. mints a new
|
|
440
|
+
* session id NOT derived from source context, same as a fresh dispatch),
|
|
441
|
+
* omit both this and {@link supportsFork} rather than faking support. */
|
|
442
|
+
forkFlag?(sourceSessionId: string, newSessionId: string): string;
|
|
443
|
+
/** Builds the CLI flag that makes a folder the dispatched session's WORKSPACE,
|
|
444
|
+
* for providers whose CLI does not adopt the process working directory as
|
|
445
|
+
* its workspace (AGY: `--add-dir <folder>`). Optional -- omit it for any
|
|
446
|
+
* provider where `cd <folder>` already establishes the workspace (claude,
|
|
447
|
+
* codex, copilot, opencode), and callers MUST treat a missing
|
|
448
|
+
* implementation as "nothing to add" rather than assuming a default flag.
|
|
449
|
+
* @param escapedFolder the work folder ALREADY escaped for the caller's own
|
|
450
|
+
* target shell (same contract as {@link modelFlag}) -- a POSIX caller
|
|
451
|
+
* passes escapeDoubleQuoted(folder), a Windows caller escapeWindowsArg(folder).
|
|
452
|
+
* Escaping cannot be done here: this method does not know the member's shell,
|
|
453
|
+
* and escapeDoubleQuoted would mangle the backslashes in a Windows path. */
|
|
454
|
+
workspaceDirFlag?(escapedFolder: string): string | null;
|
|
455
|
+
/** Builds the CLI flag that binds the run to the member's provider project
|
|
456
|
+
* (AGY: `--project <id>`), whose permission grants are the member's own.
|
|
457
|
+
* Optional -- omit it for providers with no project binding. An
|
|
458
|
+
* implementation must throw for a missing id rather than return '', so a
|
|
459
|
+
* dispatch can never silently run under a shared default project. */
|
|
460
|
+
projectFlag?(projectId?: string): string;
|
|
158
461
|
/** Resolves the session transcript log path for a given session ID, AS IT EXISTS
|
|
159
462
|
* ON THE MEMBER'S MACHINE.
|
|
160
463
|
* @param homeDir The MEMBER's home directory. `undefined` falls back to this
|
|
@@ -186,13 +489,16 @@ export interface ProviderAdapter {
|
|
|
186
489
|
* Claude/AGY: '--agent "name"'. Others: ''. */
|
|
187
490
|
agentNameFlag(agentName: string): string;
|
|
188
491
|
classifyError(output: string): PromptErrorCategory;
|
|
189
|
-
/**
|
|
492
|
+
/** Optional hook called during compose_permissions before config delivery; returns
|
|
493
|
+
* warnings to surface in the tool result (e.g. AGY's global-skills check). */
|
|
494
|
+
preparePermissionsDelivery?(agent: import('../types.js').Agent, execCommand: WorkspaceTrustExecFn, memberHomeDir?: string | null, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell): Promise<string[] | void>;
|
|
495
|
+
/** Returns the config file path(s) for this provider's permission config (relative to repo root or home-anchored).
|
|
190
496
|
* Parallel to the array returned by composePermissionConfig(). */
|
|
191
|
-
permissionConfigPaths(): string[];
|
|
497
|
+
permissionConfigPaths(agent?: import('../types.js').Agent): string[];
|
|
192
498
|
/** Returns provider-native permission config for the given role.
|
|
193
499
|
* Each element corresponds to the path at the same index in permissionConfigPaths().
|
|
194
500
|
* JSON providers return Record<string, unknown>; TOML providers return a string. */
|
|
195
|
-
composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[]): Array<Record<string, unknown> | string>;
|
|
501
|
+
composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[], agent?: import('../types.js').Agent, opts?: ComposePermissionOptions): Array<Record<string, unknown> | string>;
|
|
196
502
|
supportsOAuthCopy(): boolean;
|
|
197
503
|
supportsApiKey(): boolean;
|
|
198
504
|
oauthCredentialFiles(): Array<{
|
|
@@ -203,6 +509,27 @@ export interface ProviderAdapter {
|
|
|
203
509
|
oauthEnvVarsToUnset(): string[];
|
|
204
510
|
/** Returns the correct environment variable name for the given API key/token. */
|
|
205
511
|
authEnvVarForToken(token: string): string;
|
|
512
|
+
/**
|
|
513
|
+
* Every env var name this provider's CLI reads a credential from. They are
|
|
514
|
+
* mutually exclusive: provisioning one clears the others (shell profiles and
|
|
515
|
+
* the member's stored encryptedEnvVars) so the CLI cannot pick a stale
|
|
516
|
+
* credential of the other kind. Optional -- providers with a single auth env
|
|
517
|
+
* var need not implement it.
|
|
518
|
+
*/
|
|
519
|
+
authEnvVarNames?(): string[];
|
|
520
|
+
/**
|
|
521
|
+
* A warning when the token's shape is not one this provider recognises
|
|
522
|
+
* (the env var chosen for it is then a guess), or null when recognised.
|
|
523
|
+
* Must be pure -- preflight probes authEnvVarForToken with fake tokens.
|
|
524
|
+
* Never echoes the token itself.
|
|
525
|
+
*/
|
|
526
|
+
authTokenKindWarning?(token: string): string | null;
|
|
527
|
+
/**
|
|
528
|
+
* Remote credential files an env-var token supersedes. When an env token is
|
|
529
|
+
* provisioned these are moved aside (renamed, never deleted) so a stale
|
|
530
|
+
* copied login cannot shadow or confuse the provisioned credential.
|
|
531
|
+
*/
|
|
532
|
+
credentialFilesSupersededByEnvToken?(token: string): string[];
|
|
206
533
|
/** On Windows, wrap the command for execution (e.g. via .NET ProcessStartInfo or direct shell). */
|
|
207
534
|
wrapWindowsPrompt(setupCmd: string, filePath: string, argList: string, sessionId?: string, model?: string, tier?: 'cheap' | 'standard' | 'premium'): string;
|
|
208
535
|
/** JSON output flag for the CLI (e.g. --output-format json, --json, --format json) */
|
|
@@ -210,12 +537,12 @@ export interface ProviderAdapter {
|
|
|
210
537
|
/** Args for headless invocation with a safe literal prompt string.
|
|
211
538
|
* Returns e.g. `-p "LITERAL"` for Claude/AGY/Copilot or `exec "LITERAL"` for Codex. */
|
|
212
539
|
headlessInvocation(promptLiteral: string): string;
|
|
213
|
-
/**
|
|
214
|
-
*
|
|
215
|
-
*
|
|
216
|
-
*
|
|
217
|
-
*
|
|
218
|
-
|
|
540
|
+
/** Writes (ctx.url set) or removes (ctx.url null) the member's PER-FOLDER `apra-fleet`
|
|
541
|
+
* MCP entry in this provider's native per-project config, and prunes the legacy
|
|
542
|
+
* `apra-fleet-member` url+bearer entry wherever this provider keeps MCP servers.
|
|
543
|
+
* Never writes a tracked project `.mcp.json`; never touches deepwiki or any other
|
|
544
|
+
* server. Omitted by providers with nothing to write or prune. */
|
|
545
|
+
syncMemberMcpEntry?(ctx: MemberMcpSyncContext): Promise<MemberMcpSyncResult>;
|
|
219
546
|
/** Optional provider-NATIVE usage/quota read for execute_prompt budget
|
|
220
547
|
* awareness (apra-fleet-eft.80.2). When implemented, this is the PRIMARY
|
|
221
548
|
* source of "spent so far" for a member/workspace budget, in the requested
|
|
@@ -243,7 +570,13 @@ export interface ProviderAdapter {
|
|
|
243
570
|
* provider trust matrix). Callers should log distinctly on `seeded: true` vs `false`.
|
|
244
571
|
* `shell` is the member's REGISTERED shell and is only meaningful when `agentOs` is
|
|
245
572
|
* 'windows': a member registered as Git-for-Windows bash needs POSIX command strings,
|
|
246
|
-
* because the PowerShell ones are handed straight to bash.exe and fail (apra-fleet-7dir.2.8).
|
|
247
|
-
|
|
573
|
+
* because the PowerShell ones are handed straight to bash.exe and fail (apra-fleet-7dir.2.8).
|
|
574
|
+
* `transport.writeHomeFile`, when present, delivers the merged file without a shell
|
|
575
|
+
* command line (node:fs / SFTP) so a large ~/.claude.json cannot overflow the Windows
|
|
576
|
+
* CreateProcess limit (GitHub #499); without it the adapter chunks the write on Windows.
|
|
577
|
+
* `memberHomeDir` is the member home resolved in JavaScript (getMemberHomeDir); every
|
|
578
|
+
* member-side path is built from it, never from a shell home variable, and an adapter
|
|
579
|
+
* that needs it refuses (seeded: false, E-MEMBER-HOME-UNRESOLVED) when it is absent. */
|
|
580
|
+
ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell, transport?: WorkspaceTrustTransport, memberHomeDir?: string | null, secretChannel?: MemberSecretFileChannel): Promise<EnsureWorkspaceTrustedResult>;
|
|
248
581
|
}
|
|
249
582
|
//# sourceMappingURL=provider.d.ts.map
|