@apralabs/apra-fleet 0.3.6 → 0.4.1
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 +378 -252
- package/dist/agents/backlog-groomer.md +303 -0
- package/dist/agents/ci-watcher.md +13 -1
- package/dist/agents/deployer.md +66 -13
- package/dist/agents/doer.md +67 -8
- package/dist/agents/harvester.md +22 -3
- package/dist/agents/integ-test-runner.md +166 -60
- package/dist/agents/kb-reconciler.md +216 -0
- package/dist/agents/plan-reviewer.md +88 -18
- package/dist/agents/planner.md +182 -19
- package/dist/agents/regression-test-runner.md +234 -0
- package/dist/agents/reviewer.md +125 -9
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/doer-output.json +63 -3
- package/dist/agents/schemas/harvester-output.json +59 -2
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/kb-reconciler-output.json +87 -0
- package/dist/agents/schemas/planner-output.json +65 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +108 -7
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +45 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +736 -109
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/kb-commit.d.ts +12 -0
- package/dist/cli/kb-commit.d.ts.map +1 -0
- package/dist/cli/kb-commit.js +53 -0
- package/dist/cli/kb-commit.js.map +1 -0
- package/dist/cli/kb-directives.d.ts +17 -0
- package/dist/cli/kb-directives.d.ts.map +1 -0
- package/dist/cli/kb-directives.js +146 -0
- package/dist/cli/kb-directives.js.map +1 -0
- package/dist/cli/kb-import.d.ts +13 -0
- package/dist/cli/kb-import.d.ts.map +1 -0
- package/dist/cli/kb-import.js +56 -0
- package/dist/cli/kb-import.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +120 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/watch.d.ts +53 -4
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +118 -17
- package/dist/cli/watch.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/commands/kb-server.d.ts +8 -0
- package/dist/commands/kb-server.d.ts.map +1 -0
- package/dist/commands/kb-server.js +221 -0
- package/dist/commands/kb-server.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +254 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +14 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +80 -4
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +15 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +36 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +74 -18
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +20 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +259 -21
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +16 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +283 -16
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +13 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +36 -6
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +13 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +34 -7
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/email/headers.d.ts +15 -0
- package/dist/providers/email/headers.d.ts.map +1 -0
- package/dist/providers/email/headers.js +42 -0
- package/dist/providers/email/headers.js.map +1 -0
- package/dist/providers/email/index.d.ts +18 -0
- package/dist/providers/email/index.d.ts.map +1 -0
- package/dist/providers/email/index.js +60 -0
- package/dist/providers/email/index.js.map +1 -0
- package/dist/providers/email/provider.d.ts +49 -0
- package/dist/providers/email/provider.d.ts.map +1 -0
- package/dist/providers/email/provider.js +2 -0
- package/dist/providers/email/provider.js.map +1 -0
- package/dist/providers/email/sendgrid.d.ts +12 -0
- package/dist/providers/email/sendgrid.d.ts.map +1 -0
- package/dist/providers/email/sendgrid.js +67 -0
- package/dist/providers/email/sendgrid.js.map +1 -0
- package/dist/providers/email/smtp.d.ts +65 -0
- package/dist/providers/email/smtp.d.ts.map +1 -0
- package/dist/providers/email/smtp.js +373 -0
- package/dist/providers/email/smtp.js.map +1 -0
- package/dist/providers/gemini.d.ts +13 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +49 -5
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +61 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +124 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +14 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +104 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +156 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +54 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +11 -7
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +3 -0
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/cloud/task-wrapper.d.ts +18 -0
- package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
- package/dist/services/cloud/task-wrapper.js +157 -0
- package/dist/services/cloud/task-wrapper.js.map +1 -1
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +12 -2
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/knowledge/audn.d.ts +37 -0
- package/dist/services/knowledge/audn.d.ts.map +1 -0
- package/dist/services/knowledge/audn.js +219 -0
- package/dist/services/knowledge/audn.js.map +1 -0
- package/dist/services/knowledge/file-hash.d.ts +11 -0
- package/dist/services/knowledge/file-hash.d.ts.map +1 -0
- package/dist/services/knowledge/file-hash.js +123 -0
- package/dist/services/knowledge/file-hash.js.map +1 -0
- package/dist/services/knowledge/http-provider.d.ts +46 -0
- package/dist/services/knowledge/http-provider.d.ts.map +1 -0
- package/dist/services/knowledge/http-provider.js +254 -0
- package/dist/services/knowledge/http-provider.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +15 -0
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
- package/dist/services/knowledge/kb-providers.js +92 -0
- package/dist/services/knowledge/kb-providers.js.map +1 -0
- package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
- package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
- package/dist/services/knowledge/kb-scope-input.js +11 -0
- package/dist/services/knowledge/kb-scope-input.js.map +1 -0
- package/dist/services/knowledge/kb-service.d.ts +3 -0
- package/dist/services/knowledge/kb-service.d.ts.map +1 -0
- package/dist/services/knowledge/kb-service.js +2 -0
- package/dist/services/knowledge/kb-service.js.map +1 -0
- package/dist/services/knowledge/path-validation.d.ts +2 -0
- package/dist/services/knowledge/path-validation.d.ts.map +1 -0
- package/dist/services/knowledge/path-validation.js +13 -0
- package/dist/services/knowledge/path-validation.js.map +1 -0
- package/dist/services/knowledge/pre-init.d.ts +14 -0
- package/dist/services/knowledge/pre-init.d.ts.map +1 -0
- package/dist/services/knowledge/pre-init.js +147 -0
- package/dist/services/knowledge/pre-init.js.map +1 -0
- package/dist/services/knowledge/project-slug.d.ts +2 -0
- package/dist/services/knowledge/project-slug.d.ts.map +1 -0
- package/dist/services/knowledge/project-slug.js +49 -0
- package/dist/services/knowledge/project-slug.js.map +1 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
- package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
- package/dist/services/knowledge/sqlite-provider.js +1646 -0
- package/dist/services/knowledge/sqlite-provider.js.map +1 -0
- package/dist/services/knowledge/types.d.ts +163 -0
- package/dist/services/knowledge/types.d.ts.map +1 -0
- package/dist/services/knowledge/types.js +9 -0
- package/dist/services/knowledge/types.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/member-home.d.ts +89 -0
- package/dist/services/member-home.d.ts.map +1 -0
- package/dist/services/member-home.js +256 -0
- package/dist/services/member-home.js.map +1 -0
- package/dist/services/member-remote-url.d.ts +34 -0
- package/dist/services/member-remote-url.d.ts.map +1 -0
- package/dist/services/member-remote-url.js +39 -0
- package/dist/services/member-remote-url.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +59 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +122 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/preflight-check.d.ts +56 -0
- package/dist/services/preflight-check.d.ts.map +1 -0
- package/dist/services/preflight-check.js +277 -0
- package/dist/services/preflight-check.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts +11 -8
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +17 -33
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +32 -0
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +187 -12
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +50 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +268 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +57 -7
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +225 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +32 -1
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/services/version-check.d.ts +22 -0
- package/dist/services/version-check.d.ts.map +1 -0
- package/dist/services/version-check.js +103 -0
- package/dist/services/version-check.js.map +1 -0
- package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/dist/skills/pm/beads.md +6 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/skills/pm/fleet-addendum.md +6 -0
- package/dist/skills/pm/index.md +56 -0
- package/dist/skills/pm/kb-reconcile.md +132 -0
- package/dist/skills/pm/kb-review.md +109 -0
- package/dist/tools/check-status.d.ts +47 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +250 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
- package/dist/tools/code-intelligence-codebase-memory.js +270 -0
- package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
- package/dist/tools/code-intelligence-freshness.d.ts +2 -0
- package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
- package/dist/tools/code-intelligence-freshness.js +26 -0
- package/dist/tools/code-intelligence-freshness.js.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.js +475 -0
- package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.js +65 -0
- package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
- package/dist/tools/code-intelligence-reindex.d.ts +7 -0
- package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
- package/dist/tools/code-intelligence-reindex.js +106 -0
- package/dist/tools/code-intelligence-reindex.js.map +1 -0
- package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
- package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
- package/dist/tools/code-intelligence-telemetry.js +52 -0
- package/dist/tools/code-intelligence-telemetry.js.map +1 -0
- package/dist/tools/code-intelligence-tests.d.ts +2 -0
- package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
- package/dist/tools/code-intelligence-tests.js +24 -0
- package/dist/tools/code-intelligence-tests.js.map +1 -0
- package/dist/tools/code-intelligence.d.ts +114 -0
- package/dist/tools/code-intelligence.d.ts.map +1 -0
- package/dist/tools/code-intelligence.js +124 -0
- package/dist/tools/code-intelligence.js.map +1 -0
- package/dist/tools/compose-permissions.d.ts +38 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +295 -33
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +13 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +108 -21
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +84 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1191 -88
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/kb-capture.d.ts +53 -0
- package/dist/tools/kb-capture.d.ts.map +1 -0
- package/dist/tools/kb-capture.js +130 -0
- package/dist/tools/kb-capture.js.map +1 -0
- package/dist/tools/kb-context.d.ts +17 -0
- package/dist/tools/kb-context.d.ts.map +1 -0
- package/dist/tools/kb-context.js +29 -0
- package/dist/tools/kb-context.js.map +1 -0
- package/dist/tools/kb-export.d.ts +19 -0
- package/dist/tools/kb-export.d.ts.map +1 -0
- package/dist/tools/kb-export.js +344 -0
- package/dist/tools/kb-export.js.map +1 -0
- package/dist/tools/kb-feedback.d.ts +23 -0
- package/dist/tools/kb-feedback.d.ts.map +1 -0
- package/dist/tools/kb-feedback.js +43 -0
- package/dist/tools/kb-feedback.js.map +1 -0
- package/dist/tools/kb-freshness-sweep.d.ts +14 -0
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
- package/dist/tools/kb-freshness-sweep.js +29 -0
- package/dist/tools/kb-freshness-sweep.js.map +1 -0
- package/dist/tools/kb-harvest.d.ts +20 -0
- package/dist/tools/kb-harvest.d.ts.map +1 -0
- package/dist/tools/kb-harvest.js +143 -0
- package/dist/tools/kb-harvest.js.map +1 -0
- package/dist/tools/kb-import.d.ts +44 -0
- package/dist/tools/kb-import.d.ts.map +1 -0
- package/dist/tools/kb-import.js +239 -0
- package/dist/tools/kb-import.js.map +1 -0
- package/dist/tools/kb-invalidate.d.ts +19 -0
- package/dist/tools/kb-invalidate.d.ts.map +1 -0
- package/dist/tools/kb-invalidate.js +34 -0
- package/dist/tools/kb-invalidate.js.map +1 -0
- package/dist/tools/kb-list.d.ts +32 -0
- package/dist/tools/kb-list.d.ts.map +1 -0
- package/dist/tools/kb-list.js +43 -0
- package/dist/tools/kb-list.js.map +1 -0
- package/dist/tools/kb-promote.d.ts +20 -0
- package/dist/tools/kb-promote.d.ts.map +1 -0
- package/dist/tools/kb-promote.js +20 -0
- package/dist/tools/kb-promote.js.map +1 -0
- package/dist/tools/kb-query.d.ts +35 -0
- package/dist/tools/kb-query.d.ts.map +1 -0
- package/dist/tools/kb-query.js +111 -0
- package/dist/tools/kb-query.js.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.js +26 -0
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
- package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
- package/dist/tools/kb-resolve-contradiction.js +37 -0
- package/dist/tools/kb-resolve-contradiction.js.map +1 -0
- package/dist/tools/kb-session-prime.d.ts +26 -0
- package/dist/tools/kb-session-prime.d.ts.map +1 -0
- package/dist/tools/kb-session-prime.js +392 -0
- package/dist/tools/kb-session-prime.js.map +1 -0
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.d.ts.map +1 -0
- package/dist/tools/kb-setup.js +49 -0
- package/dist/tools/kb-setup.js.map +1 -0
- package/dist/tools/kb-stats.d.ts +20 -0
- package/dist/tools/kb-stats.d.ts.map +1 -0
- package/dist/tools/kb-stats.js +115 -0
- package/dist/tools/kb-stats.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +16 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +21 -3
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +10 -3
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +20 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +174 -6
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +17 -3
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +45 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-email.d.ts +69 -0
- package/dist/tools/send-email.d.ts.map +1 -0
- package/dist/tools/send-email.js +177 -0
- package/dist/tools/send-email.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -0
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +11 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +36 -2
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +16 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/session-caller.d.ts +28 -0
- package/dist/utils/session-caller.d.ts.map +1 -0
- package/dist/utils/session-caller.js +24 -0
- package/dist/utils/session-caller.js.map +1 -0
- package/dist/utils/work-folder-validation.d.ts +39 -0
- package/dist/utils/work-folder-validation.d.ts.map +1 -0
- package/dist/utils/work-folder-validation.js +60 -0
- package/dist/utils/work-folder-validation.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +994 -91
- package/package.json +40 -9
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +510 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +864 -0
- package/packages/apra-fleet-se/bin/serve.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
- package/packages/apra-fleet-se/package.json +29 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/knowledge-agent.md +66 -0
- package/skills/fleet/permissions.md +76 -2
- package/skills/fleet/profiles/base-dev.json +11 -1
- package/skills/fleet/profiles/base-reviewer.json +9 -1
- package/skills/fleet/profiles/node.json +2 -2
- package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@apralabs/apra-fleet",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "MCP server for orchestrating multiple agentic AI instances (Claude, Gemini, Codex, Copilot, AGY) across machines via SSH",
|
|
5
5
|
"author": "Apra Labs",
|
|
6
6
|
"homepage": "https://github.com/Apra-Labs/apra-fleet",
|
|
@@ -12,40 +12,62 @@
|
|
|
12
12
|
"url": "https://github.com/Apra-Labs/apra-fleet/issues"
|
|
13
13
|
},
|
|
14
14
|
"type": "module",
|
|
15
|
+
"workspaces": [
|
|
16
|
+
"packages/apra-fleet-client",
|
|
17
|
+
"packages/apra-fleet-workflow",
|
|
18
|
+
"packages/apra-fleet-se",
|
|
19
|
+
"packages/fleet-api-contract"
|
|
20
|
+
],
|
|
15
21
|
"main": "dist/index.js",
|
|
16
22
|
"bin": {
|
|
17
23
|
"apra-fleet": "dist/index.js"
|
|
18
24
|
},
|
|
19
25
|
"engines": {
|
|
20
|
-
"node": ">=22.
|
|
26
|
+
"node": ">=22.5.0"
|
|
21
27
|
},
|
|
22
28
|
"files": [
|
|
23
29
|
"dist/",
|
|
24
30
|
"hooks/",
|
|
25
31
|
"scripts/fleet-statusline.sh",
|
|
26
|
-
"scripts/agy-settings-merge.js",
|
|
27
32
|
"scripts/agy-transcript-reader.js",
|
|
28
33
|
"skills/",
|
|
29
|
-
"version.json"
|
|
34
|
+
"version.json",
|
|
35
|
+
"packages/apra-fleet-se/workflow.json",
|
|
36
|
+
"packages/apra-fleet-se/package.json",
|
|
37
|
+
"packages/apra-fleet-se/fleet-sprint/",
|
|
38
|
+
"packages/apra-fleet-se/bin/",
|
|
39
|
+
"packages/apra-fleet-se/apra-pm/agents/",
|
|
40
|
+
"packages/apra-fleet-se/apra-pm/skills/",
|
|
41
|
+
"packages/apra-fleet-workflow/src/",
|
|
42
|
+
"packages/apra-fleet-workflow/package.json",
|
|
43
|
+
"packages/apra-fleet-client/src/",
|
|
44
|
+
"packages/apra-fleet-client/package.json"
|
|
30
45
|
],
|
|
31
46
|
"publishConfig": {
|
|
32
47
|
"access": "public"
|
|
33
48
|
},
|
|
49
|
+
"overrides": {
|
|
50
|
+
"undici": "^7.29.0",
|
|
51
|
+
"fast-uri": "4.1.2"
|
|
52
|
+
},
|
|
34
53
|
"scripts": {
|
|
35
|
-
"build": "tsc",
|
|
54
|
+
"build": "npm run build:contract && tsc",
|
|
55
|
+
"build:contract": "npm run build --workspace=@apralabs/fleet-api-contract",
|
|
56
|
+
"gen:openapi": "npm run gen:openapi --workspace=@apralabs/fleet-api-contract",
|
|
57
|
+
"dist-pm": "node scripts/dist-pm.mjs",
|
|
36
58
|
"build:sea": "node scripts/build-sea.mjs",
|
|
37
59
|
"build:sea-config": "node scripts/gen-sea-config.mjs",
|
|
38
60
|
"build:sea-package": "node scripts/package-sea.mjs",
|
|
39
61
|
"build:binary": "npm run build && npm run build:sea && npm run build:sea-config && npm run build:sea-package",
|
|
40
62
|
"start": "node dist/index.js",
|
|
41
63
|
"dev": "tsc --watch",
|
|
42
|
-
"pretest": "
|
|
43
|
-
"test": "
|
|
64
|
+
"pretest": "npm run build:contract",
|
|
65
|
+
"test": "node scripts/run-all-tests.mjs",
|
|
44
66
|
"test:watch": "vitest",
|
|
45
67
|
"smoke": "tsc && node dist/smoke-test.js",
|
|
46
|
-
"integration": "tsc && npx tsx tests/integration.test.ts",
|
|
47
68
|
"prepare": "node scripts/install-hooks.mjs",
|
|
48
|
-
"
|
|
69
|
+
"sync-agent-docs": "node scripts/sync-agent-docs.mjs",
|
|
70
|
+
"prepublishOnly": "npm run dist-pm && npm run build"
|
|
49
71
|
},
|
|
50
72
|
"keywords": [
|
|
51
73
|
"ai-agent",
|
|
@@ -64,18 +86,27 @@
|
|
|
64
86
|
],
|
|
65
87
|
"license": "Apache-2.0",
|
|
66
88
|
"dependencies": {
|
|
89
|
+
"@apralabs/apra-fleet-client": "file:packages/apra-fleet-client",
|
|
67
90
|
"@inquirer/password": "^5.0.11",
|
|
68
91
|
"@modelcontextprotocol/sdk": "^1.27.0",
|
|
92
|
+
"ajv": "^8.12.0",
|
|
93
|
+
"better-sqlite3": "^9.6.0",
|
|
94
|
+
"pg": "^8.22.0",
|
|
69
95
|
"smol-toml": "^1.6.1",
|
|
70
96
|
"ssh2": "^1.17.0",
|
|
97
|
+
"undici": "^7.29.0",
|
|
71
98
|
"uuid": "^14.0.0",
|
|
72
99
|
"zod": "^3.25.0"
|
|
73
100
|
},
|
|
74
101
|
"devDependencies": {
|
|
102
|
+
"@apralabs/fleet-api-contract": "^0.1.0",
|
|
103
|
+
"@types/better-sqlite3": "^7.6.13",
|
|
75
104
|
"@types/node": "^22.0.0",
|
|
105
|
+
"@types/pg": "^8.20.0",
|
|
76
106
|
"@types/ssh2": "^1.15.0",
|
|
77
107
|
"@types/uuid": "^10.0.0",
|
|
78
108
|
"esbuild": "^0.27.4",
|
|
109
|
+
"pg-mem": "^3.0.14",
|
|
79
110
|
"postject": "^1.0.0-alpha.6",
|
|
80
111
|
"typescript": "^5.5.0",
|
|
81
112
|
"vitest": "^4.0.18"
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@apralabs/apra-fleet-client",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "MCP Client SDK for Apra Fleet",
|
|
5
|
+
"private": true,
|
|
6
|
+
"engines": {
|
|
7
|
+
"node": ">=22.0.0"
|
|
8
|
+
},
|
|
9
|
+
"main": "src/client/api.mjs",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": "./src/client/api.mjs",
|
|
12
|
+
"./client": "./src/client/client.mjs",
|
|
13
|
+
"./factory": "./src/client/factory.mjs",
|
|
14
|
+
"./transport": "./src/client/transport.mjs",
|
|
15
|
+
"./server-resolution": "./src/client/server-resolution.mjs"
|
|
16
|
+
},
|
|
17
|
+
"scripts": {
|
|
18
|
+
"test": "node --test test/*.test.mjs"
|
|
19
|
+
},
|
|
20
|
+
"type": "module",
|
|
21
|
+
"author": "Apra Labs",
|
|
22
|
+
"license": "Apache-2.0",
|
|
23
|
+
"dependencies": {
|
|
24
|
+
"undici": "^7.29.0"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -0,0 +1,510 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @typedef {Object} ExecutePromptOptions
|
|
3
|
+
* @property {string} prompt - The prompt to send to the LLM on the remote member
|
|
4
|
+
* @property {string} [agent] - Optional agent name to activate
|
|
5
|
+
* @property {number} [max_total_s] - Hard ceiling in seconds
|
|
6
|
+
* @property {number} [max_turns] - Max turns for claude -p (default: 50)
|
|
7
|
+
* @property {string} [member_id] - UUID of the member
|
|
8
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
9
|
+
* @property {string} [model] - Model tier ("cheap", "standard", "premium") or a specific model ID
|
|
10
|
+
* @property {boolean|string} [resume] - Resume the previous session if one exists. Defaults to
|
|
11
|
+
* true at this client/transport layer when the field is omitted entirely. NOTE: the
|
|
12
|
+
* FleetWorkflow.agent() workflow layer (packages/apra-fleet-workflow/src/workflow/index.mjs)
|
|
13
|
+
* always sends this field explicitly, defaulting it to `false` for workflow-authored
|
|
14
|
+
* prompts (see AgentOptions.resume there and apra-fleet-unw.3 / F10) -- so workflow
|
|
15
|
+
* callers effectively opt out of this client-level default unless they ask for resume.
|
|
16
|
+
* @property {string} [session_id] - Optional explicit session ID to resume (shorthand alias for resume: "<sessionId>")
|
|
17
|
+
* @property {Record<string, string>} [substitutions] - Optional map of token name to replacement value
|
|
18
|
+
* @property {number} [timeout_s] - Inactivity timeout in seconds (default: 300)
|
|
19
|
+
* @property {number} [expected_context_tokens] - Optional estimate of how many
|
|
20
|
+
* tokens this dispatch will add to the target session's context. When set (or context_size is
|
|
21
|
+
* set), the server compares it against the session's remaining context-window headroom BEFORE
|
|
22
|
+
* invoking the LLM: too little headroom rejects the call with {reason:
|
|
23
|
+
* "insufficient_context_headroom", detail: {demand, headroom, window}} and no spawn; a fit that
|
|
24
|
+
* lands inside the safety margin still proceeds but attaches a structured contextWarning. Wins
|
|
25
|
+
* over context_size when both are set. Omitting both fields disables the check entirely --
|
|
26
|
+
* pre-existing behavior is unchanged. Matches src/tools/execute-prompt.ts's
|
|
27
|
+
* expected_context_tokens field exactly (number, optional).
|
|
28
|
+
* @property {'S'|'M'|'L'} [context_size] - Optional size-bucket shorthand for
|
|
29
|
+
* expected_context_tokens: S/M/L map to configured token estimates (fleet
|
|
30
|
+
* defaults, overridable via config.json's contextAdmission.sizeBucketTokens). Ignored when
|
|
31
|
+
* expected_context_tokens is also set. Matches src/tools/execute-prompt.ts's context_size field
|
|
32
|
+
* exactly (enum 'S'|'M'|'L', optional).
|
|
33
|
+
* @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
|
|
34
|
+
* the server; consumed locally by McpClient.request(). When omitted, a default is derived
|
|
35
|
+
* from max_total_s/timeout_s (see deriveTimeoutMs in this file).
|
|
36
|
+
* @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
|
|
37
|
+
* a response. Not sent to the server. Aborting rejects the pending request locally; it
|
|
38
|
+
* cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* @typedef {Object} ExecuteCommandOptions
|
|
43
|
+
* @property {string} command - The shell command to execute
|
|
44
|
+
* @property {boolean} [long_running] - Run as background task. Supported on linux and windows
|
|
45
|
+
* members. Windows launches the task detached via `Invoke-CimMethod Win32_Process.Create`
|
|
46
|
+
* (WMI provider host / session 0), independent of the SSH session's job object, since a plain
|
|
47
|
+
* background launch dies with the SSH channel there. darwin gets an advisory warning (the
|
|
48
|
+
* wrapper script is designed for Linux) but is not blocked. Matches
|
|
49
|
+
* src/tools/execute-command.ts's long_running branch exactly.
|
|
50
|
+
* @property {number} [max_retries] - Max crash retries (long_running only)
|
|
51
|
+
* @property {string} [member_id] - UUID of the member
|
|
52
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
53
|
+
* @property {string} [restart_command] - Command for retry runs, e.g. checkpoint resume
|
|
54
|
+
* @property {string} [run_from] - Override directory to run from
|
|
55
|
+
* @property {number} [timeout_s] - Timeout in seconds (default: 120)
|
|
56
|
+
* @property {number} [timeoutMs] - Client-side request timeout override (ms). Not sent to
|
|
57
|
+
* the server; consumed locally by McpClient.request(). When omitted, a default is derived
|
|
58
|
+
* from timeout_s (see deriveTimeoutMs in this file).
|
|
59
|
+
* @property {AbortSignal} [signal] - Optional AbortSignal to cancel the client-side wait for
|
|
60
|
+
* a response. Not sent to the server. Aborting rejects the pending request locally; it
|
|
61
|
+
* cannot cancel a job already accepted by the remote fleet-server (see client.mjs).
|
|
62
|
+
*/
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* @typedef {Object} ListMembersOptions
|
|
66
|
+
* @property {"compact" | "json"} [format] - Output format
|
|
67
|
+
* @property {string[]} [tags] - Filter members by tags (AND semantics)
|
|
68
|
+
*/
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* @typedef {Object} FleetStatusOptions
|
|
72
|
+
* @property {"compact" | "json"} [format] - Output format
|
|
73
|
+
*/
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* @typedef {Object} SendFilesOptions
|
|
77
|
+
* @property {string[]} local_paths - Array of local file paths to upload
|
|
78
|
+
* @property {string} [dest_subdir] - Destination subdirectory relative to work_folder on the member
|
|
79
|
+
* @property {string} [member_id] - UUID of the member
|
|
80
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
81
|
+
* @property {Record<string, string>} [substitutions] - Optional map of token name to replacement value
|
|
82
|
+
*/
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* @typedef {Object} ReceiveFilesOptions
|
|
86
|
+
* @property {string[]} remote_paths - Paths on the member to download
|
|
87
|
+
* @property {string} local_dest_dir - Local directory to write the downloaded files into
|
|
88
|
+
* @property {string} [member_id] - UUID of the member
|
|
89
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
90
|
+
*/
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* @typedef {Object} RegisterMemberOptions
|
|
94
|
+
* @property {string} friendly_name - Human-friendly name for this member (required)
|
|
95
|
+
* @property {string} work_folder - Working directory on the target machine (required). For remote members, must be a fully-qualified/absolute path -- "~" and relative paths are rejected.
|
|
96
|
+
* @property {"local" | "remote"} [member_type] - Member type (default: "remote")
|
|
97
|
+
* @property {string} [host] - IP address or hostname of the remote machine
|
|
98
|
+
* @property {string} [username] - SSH username
|
|
99
|
+
* @property {number} [port] - SSH port (default: 22)
|
|
100
|
+
* @property {"password" | "key"} [auth_type] - Authentication method
|
|
101
|
+
* @property {string} [password] - SSH password
|
|
102
|
+
* @property {string} [key_path] - Path to SSH private key
|
|
103
|
+
* @property {string} [llm_provider] - LLM provider for this member
|
|
104
|
+
* @property {string} [category] - Optional group label
|
|
105
|
+
* @property {string[]} [tags] - Optional list of free-form labels
|
|
106
|
+
* @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode for unattended execution
|
|
107
|
+
*/
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* @typedef {Object} UpdateMemberOptions
|
|
111
|
+
* @property {string} [member_id] - UUID of the member
|
|
112
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
113
|
+
* @property {string} [friendly_name] - New friendly name
|
|
114
|
+
* @property {string} [work_folder] - New working directory. For non-local (remote/relay) members, must be a fully-qualified/absolute path -- "~" and relative paths are rejected.
|
|
115
|
+
* @property {string} [host] - New host
|
|
116
|
+
* @property {string} [username] - New SSH username
|
|
117
|
+
* @property {number} [port] - New SSH port
|
|
118
|
+
* @property {"password" | "key"} [auth_type] - New auth method
|
|
119
|
+
* @property {string} [password] - New SSH password
|
|
120
|
+
* @property {string} [key_path] - New SSH private key path
|
|
121
|
+
* @property {string} [llm_provider] - Change the LLM provider
|
|
122
|
+
* @property {string} [category] - Group label
|
|
123
|
+
* @property {string[]} [tags] - Free-form labels
|
|
124
|
+
* @property {"false" | "auto" | "dangerous"} [unattended] - Permission mode
|
|
125
|
+
*/
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* @typedef {Object} RemoveMemberOptions
|
|
129
|
+
* @property {string} [member_id] - UUID of the member
|
|
130
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
131
|
+
* @property {boolean} [force] - Remove even if the member is currently busy
|
|
132
|
+
*/
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* @typedef {Object} ProvisionLlmAuthOptions
|
|
136
|
+
* @property {string} [member_id] - UUID of the member
|
|
137
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
138
|
+
* @property {string} [api_key] - AI provider API key. If omitted, the local OAuth
|
|
139
|
+
* session is copied to the member instead. Supports {{secure.NAME}} token --
|
|
140
|
+
* resolved from the credential store server-side before use.
|
|
141
|
+
*/
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* @typedef {Object} ProvisionVcsAuthOptions
|
|
145
|
+
* @property {string} [member_id] - UUID of the member
|
|
146
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
147
|
+
* @property {"github" | "bitbucket" | "azure-devops"} provider - VCS provider to configure
|
|
148
|
+
* @property {string} [label] - Credential label (slug, e.g. "work-github"). Defaults to provider name.
|
|
149
|
+
* @property {string} [scope_url] - Git credential scope URL (e.g. "https://github.com/my-org").
|
|
150
|
+
* Defaults to "https://<host>".
|
|
151
|
+
* @property {"github-app" | "pat"} [github_mode] - GitHub auth mode: github-app (mint via
|
|
152
|
+
* configured app) or pat (personal access token)
|
|
153
|
+
* @property {string} [token] - Personal access token (GitHub PAT or Azure DevOps PAT).
|
|
154
|
+
* Supports {{secure.NAME}} token -- resolved from the credential store server-side before use.
|
|
155
|
+
* @property {"read" | "push" | "push+pr" | "admin" | "issues" | "full"} [git_access] - GitHub App access
|
|
156
|
+
* level override
|
|
157
|
+
* @property {string[]} [repos] - GitHub App repository list override
|
|
158
|
+
* @property {string} [email] - Bitbucket account email
|
|
159
|
+
* @property {string} [api_token] - Bitbucket API token. Supports {{secure.NAME}} token --
|
|
160
|
+
* resolved from the credential store server-side before use.
|
|
161
|
+
* @property {string} [workspace] - Bitbucket workspace slug
|
|
162
|
+
* @property {string} [org_url] - Azure DevOps organization URL (e.g. https://dev.azure.com/myorg)
|
|
163
|
+
* @property {string} [pat] - Azure DevOps personal access token. Supports {{secure.NAME}}
|
|
164
|
+
* token -- resolved from the credential store server-side before use.
|
|
165
|
+
*/
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* @typedef {Object} ComposePermissionsOptions
|
|
169
|
+
* @property {string} [member_id] - UUID of the member
|
|
170
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
171
|
+
* @property {"doer" | "reviewer"} [role] - Base profile. Provide at least one of role or tags.
|
|
172
|
+
* @property {string[]} [tags] - Member tags; "doer"/"reviewer" sets the primary mode
|
|
173
|
+
* and wins over role when both are given. Other tags load tag-<name>.json profiles.
|
|
174
|
+
* @property {string} [project_folder] - Local project folder containing the
|
|
175
|
+
* permissions.json ledger. Omit to skip ledger merge.
|
|
176
|
+
* @property {string[]} [grant] - Reactive mode: additional permissions to grant.
|
|
177
|
+
* Each entry is checked against the NEVER_AUTO_GRANT denylist, which is
|
|
178
|
+
* wildcard-matched (not exact-matched) against a normalized form of the
|
|
179
|
+
* request: sudo/su/doas, `bash -c`/`sh -c`/eval, env/printenv, nc/nmap,
|
|
180
|
+
* `chmod 777`, any catch-all such as `Bash(*)`, and any payload containing a
|
|
181
|
+
* shell-chaining metacharacter (| ; && backtick $() are rejected outright,
|
|
182
|
+
* for every caller.
|
|
183
|
+
* @property {string} [grant_reason] - Reason for the grant (stored in ledger)
|
|
184
|
+
*/
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* @typedef {Object} SetupSshKeyOptions
|
|
188
|
+
* @property {string} [member_id] - UUID of the member
|
|
189
|
+
* @property {string} [member_name] - Friendly name of the member
|
|
190
|
+
*/
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* @typedef {Object} SendEmailOptions
|
|
194
|
+
* @property {"sendgrid" | "smtp"} [provider] - Email provider to use (default "sendgrid").
|
|
195
|
+
* Secrets are resolved server-side from the credential store ("sendgrid_api_key" / "smtp_password").
|
|
196
|
+
* @property {string} from - Sender email address (required)
|
|
197
|
+
* @property {string} [host] - SMTP server hostname (required for smtp provider)
|
|
198
|
+
* @property {number} [port] - SMTP server port (default 587, or 465 when secure is true)
|
|
199
|
+
* @property {string} [user] - SMTP username (required for smtp provider)
|
|
200
|
+
* @property {boolean} [secure] - Use implicit TLS, e.g. port 465 (default false).
|
|
201
|
+
* When false, STARTTLS is required; plaintext AUTH is refused.
|
|
202
|
+
* @property {string | string[]} to - Recipient email address, or list of addresses
|
|
203
|
+
* @property {string} subject - Email subject line
|
|
204
|
+
* @property {string} body - Plain-text email body
|
|
205
|
+
* @property {string} [html] - Optional HTML email body
|
|
206
|
+
* @property {string[]} [cc] - CC recipient addresses
|
|
207
|
+
* @property {string[]} [bcc] - BCC recipient addresses
|
|
208
|
+
* @property {{ filename: string, content: string, contentType?: string }[]} [attachments] - Optional file attachments (base64-encoded content)
|
|
209
|
+
*/
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
// Grace margin added on top of the payload's own timeout hint (timeout_s /
|
|
213
|
+
// max_total_s) so the client doesn't race the server's own deadline -- the
|
|
214
|
+
// server should have a chance to reply with its own timeout/error first.
|
|
215
|
+
//
|
|
216
|
+
// This single-budget (max_total_s * 1) + grace shape relies on the server
|
|
217
|
+
// (src/tools/execute-prompt.ts, apra-fleet-y8q.1) sharing ONE max_total_s
|
|
218
|
+
// deadline budget across an original dispatch attempt AND any single retry it
|
|
219
|
+
// runs on its own (e.g. the fresh-session retry after an SSH inactivity
|
|
220
|
+
// exception) -- a retry's own maxTotalMs/timeoutMs is capped to whatever
|
|
221
|
+
// remains of max_total_s since the dispatch started, and skipped entirely
|
|
222
|
+
// once that budget is exhausted. Without that server-side sharing, a retry
|
|
223
|
+
// could burn a second full max_total_s budget and the client's hard timeout
|
|
224
|
+
// here would fire before the server's own clean retry-and-report path ever
|
|
225
|
+
// gets a chance, surfacing a raw client transport timeout instead of the
|
|
226
|
+
// server's typed error. Do not widen this to max_total_s * 2 unless that
|
|
227
|
+
// server-side sharing invariant is removed.
|
|
228
|
+
const TIMEOUT_GRACE_MS = 30 * 1000;
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* Derives a client-side McpClient.request() timeout (ms) from a payload's
|
|
232
|
+
* own timeout hints. Prefers max_total_s (a hard ceiling) over timeout_s
|
|
233
|
+
* (an inactivity timeout) when both are present, then adds a grace margin.
|
|
234
|
+
* Returns undefined when neither hint is present, letting McpClient fall
|
|
235
|
+
* back to its own conservative default (never infinite).
|
|
236
|
+
*
|
|
237
|
+
* See the TIMEOUT_GRACE_MS comment above: this budget is only sufficient
|
|
238
|
+
* because the server shares a single max_total_s deadline across an attempt
|
|
239
|
+
* and its own internal retry, rather than granting each a fresh full budget.
|
|
240
|
+
*
|
|
241
|
+
* @param {{ max_total_s?: number, timeout_s?: number }} payload
|
|
242
|
+
* @returns {number | undefined}
|
|
243
|
+
*/
|
|
244
|
+
export function deriveTimeoutMs(payload = {}) {
|
|
245
|
+
const hintSeconds = payload.max_total_s ?? payload.timeout_s;
|
|
246
|
+
if (typeof hintSeconds !== 'number' || !Number.isFinite(hintSeconds) || hintSeconds <= 0) {
|
|
247
|
+
return undefined;
|
|
248
|
+
}
|
|
249
|
+
return hintSeconds * 1000 + TIMEOUT_GRACE_MS;
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* Extract the JSON payload from a raw MCP tool-call result.
|
|
254
|
+
*
|
|
255
|
+
* Every ApraFleet wrapper returns the raw callTool() result --
|
|
256
|
+
* `{ content: [{ type: 'text', text }, ...] }` -- NOT a JSON string, so
|
|
257
|
+
* `JSON.parse(result)` on it throws. Tool results can also carry
|
|
258
|
+
* display-only items (e.g. an `<apra-fleet-display>` onboarding block)
|
|
259
|
+
* AHEAD of the payload, so content[0] is not reliable either. This helper
|
|
260
|
+
* returns the first content item that parses as JSON.
|
|
261
|
+
*
|
|
262
|
+
* @param {{ content?: { text?: string }[] }} result - raw callTool() result
|
|
263
|
+
* @returns {any} the parsed JSON payload
|
|
264
|
+
* @throws {Error} when no content item contains valid JSON
|
|
265
|
+
*/
|
|
266
|
+
export function parseToolJson(result) {
|
|
267
|
+
for (const item of result?.content ?? []) {
|
|
268
|
+
try { return JSON.parse(item.text); } catch { /* not the payload */ }
|
|
269
|
+
}
|
|
270
|
+
throw new Error('No JSON payload in tool result');
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
export class ApraFleet {
|
|
274
|
+
/**
|
|
275
|
+
* @param {{ callTool: (name: string, args: Record<string, any>, opts?: { timeoutMs?: number, signal?: AbortSignal }) => Promise<any> }} mcpClient
|
|
276
|
+
*/
|
|
277
|
+
constructor(mcpClient) {
|
|
278
|
+
this.mcpClient = mcpClient;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* Run an AI prompt on a member.
|
|
283
|
+
* @param {ExecutePromptOptions} options
|
|
284
|
+
*/
|
|
285
|
+
async executePrompt(options) {
|
|
286
|
+
const { timeoutMs, signal, ...payload } = options;
|
|
287
|
+
return this.mcpClient.callTool('execute_prompt', payload, {
|
|
288
|
+
timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
|
|
289
|
+
signal
|
|
290
|
+
});
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/**
|
|
294
|
+
* Run a shell command on a member.
|
|
295
|
+
* @param {ExecuteCommandOptions} options
|
|
296
|
+
*/
|
|
297
|
+
async executeCommand(options) {
|
|
298
|
+
const { timeoutMs, signal, ...payload } = options;
|
|
299
|
+
return this.mcpClient.callTool('execute_command', payload, {
|
|
300
|
+
timeoutMs: timeoutMs ?? deriveTimeoutMs(payload),
|
|
301
|
+
signal
|
|
302
|
+
});
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
/**
|
|
306
|
+
* List all fleet members and their current status.
|
|
307
|
+
* @param {ListMembersOptions} [options]
|
|
308
|
+
*/
|
|
309
|
+
async listMembers(options = {}) {
|
|
310
|
+
return this.mcpClient.callTool('list_members', options);
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
/**
|
|
314
|
+
* Get status of all fleet members.
|
|
315
|
+
* @param {FleetStatusOptions} [options]
|
|
316
|
+
*/
|
|
317
|
+
async fleetStatus(options = {}) {
|
|
318
|
+
return this.mcpClient.callTool('fleet_status', options);
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
/**
|
|
322
|
+
* Get detailed status for one member: connectivity, session, work folder, provider.
|
|
323
|
+
* @param {{ member_id?: string, member_name?: string, format?: 'compact'|'json' }} options
|
|
324
|
+
*/
|
|
325
|
+
async memberDetail(options) {
|
|
326
|
+
return this.mcpClient.callTool('member_detail', options);
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
/**
|
|
330
|
+
* Get a member's cheap/standard/premium tier resolved to a concrete
|
|
331
|
+
* model and its real per-1M-token price (apra-fleet-dv5.5/dv5.6).
|
|
332
|
+
* @param {{ member_id?: string, member_name?: string }} options
|
|
333
|
+
*/
|
|
334
|
+
async getMemberModelPricing(options) {
|
|
335
|
+
return this.mcpClient.callTool('get_member_model_pricing', options);
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
/**
|
|
339
|
+
* Transfer local files to a member.
|
|
340
|
+
* @param {SendFilesOptions} options
|
|
341
|
+
*/
|
|
342
|
+
async sendFiles(options) {
|
|
343
|
+
return this.mcpClient.callTool('send_files', options);
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
/**
|
|
347
|
+
* Download files from a member to a local directory.
|
|
348
|
+
* @param {ReceiveFilesOptions} options
|
|
349
|
+
*/
|
|
350
|
+
async receiveFiles(options) {
|
|
351
|
+
return this.mcpClient.callTool('receive_files', options);
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
/**
|
|
355
|
+
* Add a machine to the fleet.
|
|
356
|
+
* @param {RegisterMemberOptions} options
|
|
357
|
+
*/
|
|
358
|
+
async registerMember(options) {
|
|
359
|
+
return this.mcpClient.callTool('register_member', options);
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
/**
|
|
363
|
+
* Change a member's settings.
|
|
364
|
+
* @param {UpdateMemberOptions} options
|
|
365
|
+
*/
|
|
366
|
+
async updateMember(options) {
|
|
367
|
+
return this.mcpClient.callTool('update_member', options);
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* Remove a member from the fleet.
|
|
372
|
+
* @param {RemoveMemberOptions} options
|
|
373
|
+
*/
|
|
374
|
+
async removeMember(options) {
|
|
375
|
+
return this.mcpClient.callTool('remove_member', options);
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/**
|
|
379
|
+
* Provision LLM auth (OAuth session copy or API key) onto a member.
|
|
380
|
+
* @param {ProvisionLlmAuthOptions} options
|
|
381
|
+
*/
|
|
382
|
+
async provisionLlmAuth(options) {
|
|
383
|
+
return this.mcpClient.callTool('provision_llm_auth', options);
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
/**
|
|
387
|
+
* Provision VCS (git host) auth -- GitHub App token / PAT, Bitbucket API
|
|
388
|
+
* token, or Azure DevOps PAT -- onto a member.
|
|
389
|
+
* @param {ProvisionVcsAuthOptions} options
|
|
390
|
+
*/
|
|
391
|
+
async provisionVcsAuth(options) {
|
|
392
|
+
return this.mcpClient.callTool('provision_vcs_auth', options);
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
/**
|
|
396
|
+
* Compose and deliver a scoped permission profile to a member.
|
|
397
|
+
* @param {ComposePermissionsOptions} options
|
|
398
|
+
*/
|
|
399
|
+
async composePermissions(options) {
|
|
400
|
+
return this.mcpClient.callTool('compose_permissions', options);
|
|
401
|
+
}
|
|
402
|
+
|
|
403
|
+
/**
|
|
404
|
+
* Convert a remote member from password to SSH key authentication.
|
|
405
|
+
* @param {SetupSshKeyOptions} options
|
|
406
|
+
*/
|
|
407
|
+
async setupSshKey(options) {
|
|
408
|
+
return this.mcpClient.callTool('setup_ssh_key', options);
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
/**
|
|
412
|
+
* Send an email. Pass provider config inline (provider, from, and for
|
|
413
|
+
* SMTP: host, port, user, secure). Secrets resolve from the credential
|
|
414
|
+
* store (sendgrid_api_key / smtp_password).
|
|
415
|
+
* @param {SendEmailOptions} options
|
|
416
|
+
*/
|
|
417
|
+
async sendEmail(options) {
|
|
418
|
+
return this.mcpClient.callTool('send_email', options);
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
/**
|
|
422
|
+
* Collect a secret from the user out-of-band and store it in the fleet
|
|
423
|
+
* credential store. The secret value never passes through the caller.
|
|
424
|
+
* @param {{ name: string, prompt: string, persist?: boolean,
|
|
425
|
+
* network_policy?: 'allow'|'confirm'|'deny', members?: string,
|
|
426
|
+
* ttl_seconds?: number }} options
|
|
427
|
+
*/
|
|
428
|
+
async credentialStoreSet(options) {
|
|
429
|
+
return this.mcpClient.callTool('credential_store_set', options);
|
|
430
|
+
}
|
|
431
|
+
|
|
432
|
+
/**
|
|
433
|
+
* List stored credentials (names and metadata only -- no values).
|
|
434
|
+
* The result payload is a JSON array of { name, scope, ... } entries;
|
|
435
|
+
* extract it with parseToolJson().
|
|
436
|
+
*/
|
|
437
|
+
async credentialStoreList() {
|
|
438
|
+
return this.mcpClient.callTool('credential_store_list', {});
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
/**
|
|
442
|
+
* Delete a named credential from the store.
|
|
443
|
+
* @param {{ name: string }} options
|
|
444
|
+
*/
|
|
445
|
+
async credentialStoreDelete(options) {
|
|
446
|
+
return this.mcpClient.callTool('credential_store_delete', options);
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
/**
|
|
450
|
+
* Update metadata (members, TTL, network policy) on an existing
|
|
451
|
+
* credential without re-entering the secret.
|
|
452
|
+
* @param {{ name: string, members?: string, ttl_seconds?: number,
|
|
453
|
+
* network_policy?: 'allow'|'confirm'|'deny' }} options
|
|
454
|
+
*/
|
|
455
|
+
async credentialStoreUpdate(options) {
|
|
456
|
+
return this.mcpClient.callTool('credential_store_update', options);
|
|
457
|
+
}
|
|
458
|
+
|
|
459
|
+
/**
|
|
460
|
+
* Fleet-server-hosted global dolt push mutex (apra-fleet-f34.2,
|
|
461
|
+
* src/tools/dolt-push-mutex.ts). Serializes cross-sprint `bd dolt push`
|
|
462
|
+
* for sprints launched WITHOUT a supervisor to coordinate through.
|
|
463
|
+
*
|
|
464
|
+
* `acquire` is ticketed (an MCP call cannot long-poll): it returns
|
|
465
|
+
* `{ granted, ticket, token? }` after a bounded wait, and the caller
|
|
466
|
+
* re-`poll`s the SAME ticket until granted. Polling never dequeues the
|
|
467
|
+
* waiter, so FIFO order is preserved. Pass the caller's real `pid` so a
|
|
468
|
+
* crashed holder is reclaimed by the dead-pid probe.
|
|
469
|
+
*
|
|
470
|
+
* @param {{ action: 'acquire'|'poll'|'release'|'renew'|'cancel'|'status',
|
|
471
|
+
* sprint_id?: string, ticket?: string, token?: string,
|
|
472
|
+
* pid?: number, wait_ms?: number }} options
|
|
473
|
+
*/
|
|
474
|
+
async doltPushMutex(options) {
|
|
475
|
+
return this.mcpClient.callTool('dolt_push_mutex', options);
|
|
476
|
+
}
|
|
477
|
+
|
|
478
|
+
/**
|
|
479
|
+
* Fleet-server-hosted global child-bead-id allocator (apra-fleet-f34.2,
|
|
480
|
+
* src/tools/child-id-allocator.ts). Mints globally-distinct child ids under
|
|
481
|
+
* a shared parent for sprints launched WITHOUT a supervisor, so two sprints
|
|
482
|
+
* creating children under the same parent never derive the same id.
|
|
483
|
+
*
|
|
484
|
+
* @param {{ action: 'allocate'|'confirm'|'release'|'status',
|
|
485
|
+
* parent_id?: string, token?: string, sprint_id?: string,
|
|
486
|
+
* pid?: number, floor?: number }} options
|
|
487
|
+
*/
|
|
488
|
+
async childIdAllocator(options) {
|
|
489
|
+
return this.mcpClient.callTool('child_id_allocator', options);
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
/**
|
|
493
|
+
* Gracefully shut down the fleet server this client is connected to.
|
|
494
|
+
* Self-terminates the server process (deletes the singleton pointer,
|
|
495
|
+
* closes the HTTP transport and all SSH connections) -- does not touch
|
|
496
|
+
* the OS service-manager layer at all, so it works even when service
|
|
497
|
+
* registration (systemd/schtasks) never succeeded.
|
|
498
|
+
*
|
|
499
|
+
* The server closing its own transport as part of shutting down can race
|
|
500
|
+
* this very request's response -- callers should treat ANY outcome
|
|
501
|
+
* (resolve, reject, or timeout) as inconclusive on its own and verify via
|
|
502
|
+
* a direct status check instead. opts.timeoutMs (default 5000) keeps a
|
|
503
|
+
* lost response from hanging the caller up to the SDK's normal 15-minute
|
|
504
|
+
* default.
|
|
505
|
+
* @param {{ timeoutMs?: number }} [opts]
|
|
506
|
+
*/
|
|
507
|
+
async shutdownServer(opts = {}) {
|
|
508
|
+
return this.mcpClient.callTool('shutdown_server', {}, { timeoutMs: opts.timeoutMs ?? 5000 });
|
|
509
|
+
}
|
|
510
|
+
}
|