@apralabs/apra-fleet 0.3.5 → 0.4.0
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 +245 -257
- package/dist/agents/backlog-groomer.md +287 -0
- package/dist/agents/deployer.md +52 -11
- package/dist/agents/doer.md +32 -7
- package/dist/agents/integ-test-runner.md +151 -61
- package/dist/agents/plan-reviewer.md +74 -17
- package/dist/agents/planner.md +94 -14
- package/dist/agents/regression-test-runner.md +216 -0
- package/dist/agents/reviewer.md +21 -6
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/integ-test-runner-output.json +34 -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 +4 -0
- 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 +44 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +604 -108
- 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/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/secret.js +8 -2
- package/dist/cli/secret.js.map +1 -1
- 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 +109 -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/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/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 +179 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +13 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +62 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +10 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +21 -1
- 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 +9 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +127 -14
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +6 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +248 -9
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +7 -0
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +8 -1
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/gemini.d.ts +3 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +11 -1
- 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 +51 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +103 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +4 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +49 -0
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +79 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +10 -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 +12 -5
- 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-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 +1 -0
- 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/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/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 +56 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +111 -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/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.map +1 -1
- package/dist/services/stall/log-path-resolver.js +8 -1
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +39 -7
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +136 -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 +55 -5
- 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 +139 -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/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +8 -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/compose-permissions.d.ts +12 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +55 -4
- 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 +11 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +22 -5
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +72 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +962 -71
- 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/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 +8 -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/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 +17 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +144 -5
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +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 +44 -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-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/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 +8 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +11 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +15 -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/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 +450 -87
- package/package.json +35 -7
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +396 -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 +287 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -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 +22 -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 +18 -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/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/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 +38 -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 +142 -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 +121 -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 +857 -0
- package/packages/apra-fleet-se/bin/serve.mjs +383 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -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 +151 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -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-recovery-path-b.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -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 +222 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
- package/packages/apra-fleet-se/package.json +28 -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 +1325 -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/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 +1723 -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/permissions.md +50 -0
- package/skills/fleet/profiles/base-dev.json +1 -0
- package/skills/fleet/profiles/base-reviewer.json +1 -0
- package/skills/fleet/profiles/node.json +2 -2
- 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
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
import * as fs from 'fs/promises';
|
|
2
|
+
import * as path from 'path';
|
|
3
|
+
import { createHash } from 'crypto';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Execution journal (apra-fleet-unw.11, F6).
|
|
7
|
+
*
|
|
8
|
+
* Borrows the "resumable runs / journal caching" pattern from Claude CLI's
|
|
9
|
+
* dynamic-workflow model: an append-only JSONL log of the SAME
|
|
10
|
+
* `activity:start`/`activity:end`/`end` events `FleetWorkflow` already emits
|
|
11
|
+
* (see src/workflow/index.mjs), persisted verbatim by a plain event
|
|
12
|
+
* listener -- this module does NOT invent a second, parallel event format.
|
|
13
|
+
*
|
|
14
|
+
* OFF BY DEFAULT: none of this module's code runs unless a caller opts in
|
|
15
|
+
* via `WorkflowEngine.executeFile(script, args, { journal, resumeJournal })`.
|
|
16
|
+
* A normal `executeFile()` call with neither option produces zero directory/
|
|
17
|
+
* file I/O and zero change to the shape of emitted events (see the
|
|
18
|
+
* `journalEnabled` gating in engine.mjs / index.mjs).
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
export const DEFAULT_JOURNAL_DIR = '.fleet-workflow';
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Hashes prompt/command text for journal storage. The journal never stores
|
|
25
|
+
* raw prompt/command text for `agent()` calls (which can be large and may
|
|
26
|
+
* contain sensitive content) -- only this hash, used to detect divergence on
|
|
27
|
+
* resume. (`command()`'s existing `activity:start`/`activity:end` events
|
|
28
|
+
* already include the raw, substituted command string as part of their
|
|
29
|
+
* established event contract -- see the `command` field in
|
|
30
|
+
* src/workflow/index.mjs -- so this hash is additional, not a replacement,
|
|
31
|
+
* for that field; it is still what replay matching keys off of.)
|
|
32
|
+
* @param {string|undefined|null} text
|
|
33
|
+
* @returns {string|null}
|
|
34
|
+
*/
|
|
35
|
+
export function hashText(text) {
|
|
36
|
+
if (text === undefined || text === null) return null;
|
|
37
|
+
return createHash('sha256').update(String(text)).digest('hex');
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Deterministic replay key for a single `agent()`/`command()` call: the
|
|
42
|
+
* call's sequence index within the run (assigned once per logical call, not
|
|
43
|
+
* per schema-repair attempt), its type, the target member, and a hash of the
|
|
44
|
+
* dispatched prompt/command text. First mismatch or first missing entry for
|
|
45
|
+
* this key during a resumed run stops replay and switches to live execution
|
|
46
|
+
* from that point onward (Claude-CLI style partial replay).
|
|
47
|
+
*
|
|
48
|
+
* REPLAY-KEY SEMANTICS AND LIMITATIONS (apra-fleet-unw2.14, N6)
|
|
49
|
+
* ------------------------------------------------------------
|
|
50
|
+
* `sequence` is the call's position in the run. Its shape depends on WHERE
|
|
51
|
+
* the call was made:
|
|
52
|
+
*
|
|
53
|
+
* - A call made in the run's top-level (sequential) flow gets a plain
|
|
54
|
+
* numeric sequence: `0`, `1`, `2`, ... in program order. (Stringified
|
|
55
|
+
* into the key, so `0` -> `"0:agent:..."`.) This is the original,
|
|
56
|
+
* pre-N6 shape and is preserved byte-for-byte, so a resumed run of a
|
|
57
|
+
* purely sequential script computes exactly the same keys it always did,
|
|
58
|
+
* and OLD-FORMAT journals (written before N6) still match for these
|
|
59
|
+
* top-level calls.
|
|
60
|
+
*
|
|
61
|
+
* - A call made INSIDE a `parallel()` branch gets a HIERARCHICAL,
|
|
62
|
+
* scheduler-INDEPENDENT sequence of the form
|
|
63
|
+
* `<parentPrefix><barrierIndex>:<branchIndex>:<localSeq>` -- e.g.
|
|
64
|
+
* `0:1:0` = the first parallel() barrier (barrierIndex 0) entered at
|
|
65
|
+
* this level, its branch at STATIC input-array index 1, that branch's
|
|
66
|
+
* first (localSeq 0) agent()/command() call. `branchIndex` is the
|
|
67
|
+
* branch's fixed position in the array passed to `parallel()`, NOT its
|
|
68
|
+
* completion/scheduling order, and `localSeq` counts only within that
|
|
69
|
+
* one branch. Nested `parallel()` calls extend the prefix further
|
|
70
|
+
* (`0:1:0:2:0` etc.).
|
|
71
|
+
*
|
|
72
|
+
* WHAT IS GUARANTEED: For a given logical call site, the key is IDENTICAL
|
|
73
|
+
* regardless of how the parallel branches actually interleave at runtime.
|
|
74
|
+
* Recording a journal under one interleaving and resuming it under a totally
|
|
75
|
+
* different interleaving therefore still hits the replay cache for every
|
|
76
|
+
* already-completed call across the barrier -- no live re-dispatch of doers
|
|
77
|
+
* whose work already happened. This is the whole point of N6: before it,
|
|
78
|
+
* `sequence` was a single shared counter incremented by whichever branch's
|
|
79
|
+
* agent()/command() happened to run next, so a resumed multi-streak run
|
|
80
|
+
* computed different sequence numbers, missed the cache, and re-executed
|
|
81
|
+
* everything live.
|
|
82
|
+
*
|
|
83
|
+
* WHAT IS NOT GUARANTEED: Determinism still requires the SAME logical
|
|
84
|
+
* script structure on replay -- same top-level call order, same number and
|
|
85
|
+
* static ordering of `parallel()` branches, same per-branch call order,
|
|
86
|
+
* same prompt/command text (the textHash). If the script itself is edited
|
|
87
|
+
* (calls added/removed/reordered, branches added, prompts changed) between
|
|
88
|
+
* the recording and the resume, keys legitimately diverge at the first
|
|
89
|
+
* changed call, exactly as intended -- that is real divergence, not a
|
|
90
|
+
* scheduling artifact. Non-determinism WITHIN a single branch (e.g. a
|
|
91
|
+
* branch that dispatches a different number of agent() calls depending on a
|
|
92
|
+
* coin flip) will also shift that branch's localSeq and diverge; branches
|
|
93
|
+
* must be internally deterministic for replay to be exact.
|
|
94
|
+
*
|
|
95
|
+
* OLD-FORMAT (pre-N6) journals degrade gracefully, never crash: their
|
|
96
|
+
* parallel-region records used the old shared global counter, so the new
|
|
97
|
+
* hierarchical keys won't match for calls inside a `parallel()` region --
|
|
98
|
+
* those calls simply diverge and re-run live (as they effectively did before
|
|
99
|
+
* N6 anyway), while top-level sequential calls still match and replay. The
|
|
100
|
+
* remedy is to regenerate the journal with a fresh run once the fix is
|
|
101
|
+
* deployed.
|
|
102
|
+
*
|
|
103
|
+
* @param {{ sequence: number|string, type: 'agent'|'command', member?: string, textHash: string|null }} parts
|
|
104
|
+
* @returns {string}
|
|
105
|
+
*/
|
|
106
|
+
export function computeActivityKey({ sequence, type, member, textHash }) {
|
|
107
|
+
return `${sequence}:${type}:${member || ''}:${textHash || ''}`;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Resolves the journal file path an `executeFile()` call should write to
|
|
112
|
+
* (or `null` if journaling is not requested at all), from the same options
|
|
113
|
+
* object `executeFile()` accepts.
|
|
114
|
+
*
|
|
115
|
+
* - `opts.journal === true` -> default path `.fleet-workflow/journal-<runId>.jsonl`
|
|
116
|
+
* - `opts.journal === '<path>'` -> that path
|
|
117
|
+
* - `opts.journal === { path: '<path>' }` -> that path
|
|
118
|
+
* - `opts.journal === false` -> explicitly disabled (even if resumeJournal is set)
|
|
119
|
+
* - no `opts.journal`, but `opts.resumeJournal` set -> continue writing to the
|
|
120
|
+
* SAME file being resumed from (the journal for a resumed run continues the
|
|
121
|
+
* original run's journal rather than starting a fresh one)
|
|
122
|
+
* - neither set -> `null` (no journaling)
|
|
123
|
+
* @param {{journal?: boolean|string|{path:string}, resumeJournal?: string}} opts
|
|
124
|
+
* @param {string} runId
|
|
125
|
+
* @returns {string|null}
|
|
126
|
+
*/
|
|
127
|
+
export function resolveJournalWritePath(opts, runId) {
|
|
128
|
+
if (opts.journal === false) return null;
|
|
129
|
+
if (opts.journal) {
|
|
130
|
+
if (typeof opts.journal === 'string') return path.resolve(opts.journal);
|
|
131
|
+
if (typeof opts.journal === 'object' && opts.journal.path) return path.resolve(opts.journal.path);
|
|
132
|
+
return path.resolve(DEFAULT_JOURNAL_DIR, `journal-${runId}.jsonl`);
|
|
133
|
+
}
|
|
134
|
+
if (opts.resumeJournal) return path.resolve(opts.resumeJournal);
|
|
135
|
+
return null;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* Loads a journal file for resume/replay. Tolerant of a missing file (a
|
|
140
|
+
* `resumeJournal` path that doesn't exist yet is treated as an empty
|
|
141
|
+
* journal -- the whole run simply executes live, same as a fresh run) and of
|
|
142
|
+
* trailing/corrupt partial lines (a crash can leave a half-written final
|
|
143
|
+
* line; it is skipped rather than failing the whole load).
|
|
144
|
+
*
|
|
145
|
+
* @param {string} filePath
|
|
146
|
+
* @returns {Promise<{ completedByKey: Map<string, object>, ambiguous: object[] }>}
|
|
147
|
+
* `completedByKey` maps a replay key (see computeActivityKey) to the
|
|
148
|
+
* merged `activity:start` + `activity:end` record for the last time that
|
|
149
|
+
* key completed (successfully or not -- callers decide whether a
|
|
150
|
+
* non-success record counts as a replay hit).
|
|
151
|
+
*
|
|
152
|
+
* (apra-fleet-unw2.13, N5) For `command()` calls, this merged record
|
|
153
|
+
* carries a `failSoft` boolean (persisted verbatim from the
|
|
154
|
+
* `activity:start`/`activity:end` events -- see the `failSoft` field on
|
|
155
|
+
* `activityMeta` in `command()`, src/workflow/index.mjs) telling the
|
|
156
|
+
* replay path in `command()` whether the ORIGINAL call used
|
|
157
|
+
* `{ failSoft: true }` and therefore must be replayed as the shaped
|
|
158
|
+
* `{ ok, output, error }` object rather than the raw output string.
|
|
159
|
+
* OLD-FORMAT journal lines written before this field existed simply won't
|
|
160
|
+
* have it -- `rec.failSoft` is `undefined` for those, which the caller in
|
|
161
|
+
* `command()` treats as `false` (falls back to the pre-fix raw-string
|
|
162
|
+
* behavior) rather than crashing. That fallback is a known, documented
|
|
163
|
+
* limitation: a failSoft caller resuming from a pre-fix journal cannot be
|
|
164
|
+
* perfectly replayed and will see the same bare-string shape it saw
|
|
165
|
+
* before this fix, until the journal is regenerated by a fresh run.
|
|
166
|
+
* `ambiguous` lists every `activity:start` record with no matching
|
|
167
|
+
* `activity:end` in the file -- i.e. an activity that was dispatched but
|
|
168
|
+
* never recorded as finished, most likely because the run crashed
|
|
169
|
+
* mid-dispatch. These are surfaced (not resolved) by the caller as a
|
|
170
|
+
* possibly-double-dispatched warning; true idempotency requires
|
|
171
|
+
* fleet-server-side keys and is explicitly descoped (see plan.md).
|
|
172
|
+
*/
|
|
173
|
+
export async function loadJournal(filePath) {
|
|
174
|
+
let raw;
|
|
175
|
+
try {
|
|
176
|
+
raw = await fs.readFile(filePath, 'utf-8');
|
|
177
|
+
} catch (err) {
|
|
178
|
+
if (err && err.code === 'ENOENT') {
|
|
179
|
+
return { completedByKey: new Map(), ambiguous: [] };
|
|
180
|
+
}
|
|
181
|
+
throw err;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
const startsById = new Map();
|
|
185
|
+
const endsById = new Map();
|
|
186
|
+
const completedByKey = new Map();
|
|
187
|
+
|
|
188
|
+
for (const line of raw.split('\n')) {
|
|
189
|
+
const trimmed = line.trim();
|
|
190
|
+
if (!trimmed) continue;
|
|
191
|
+
let rec;
|
|
192
|
+
try {
|
|
193
|
+
rec = JSON.parse(trimmed);
|
|
194
|
+
} catch {
|
|
195
|
+
// Tolerate a corrupt/partial trailing line (e.g. the process was
|
|
196
|
+
// killed mid-write) -- skip it rather than failing the load.
|
|
197
|
+
continue;
|
|
198
|
+
}
|
|
199
|
+
if (rec.event === 'activity:start' && rec.id) {
|
|
200
|
+
startsById.set(rec.id, rec);
|
|
201
|
+
} else if (rec.event === 'activity:end' && rec.id) {
|
|
202
|
+
endsById.set(rec.id, rec);
|
|
203
|
+
const startRec = startsById.get(rec.id);
|
|
204
|
+
const replayKey = rec.replayKey || (startRec && startRec.replayKey);
|
|
205
|
+
if (replayKey) {
|
|
206
|
+
// Last one wins: if the same key was resumed/replayed more
|
|
207
|
+
// than once across multiple crash/resume cycles, the most
|
|
208
|
+
// recent completion is what should be trusted.
|
|
209
|
+
completedByKey.set(replayKey, { ...startRec, ...rec });
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
const ambiguous = [];
|
|
215
|
+
for (const [id, startRec] of startsById) {
|
|
216
|
+
if (!endsById.has(id)) {
|
|
217
|
+
ambiguous.push(startRec);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
return { completedByKey, ambiguous };
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Append-only JSONL journal writer. Attaches to a `FleetWorkflow` instance's
|
|
226
|
+
* existing `activity:start`/`activity:end`/`end` events (filtered to a
|
|
227
|
+
* single `runId`) and persists them verbatim, one JSON object per line, plus
|
|
228
|
+
* a synthetic `run:start` record written up front. Writes are serialized
|
|
229
|
+
* through an internal promise chain so concurrent event emissions (e.g. from
|
|
230
|
+
* `parallel()` branches of the same run) can never interleave/corrupt lines.
|
|
231
|
+
*/
|
|
232
|
+
export class JournalWriter {
|
|
233
|
+
/**
|
|
234
|
+
* @param {import('./index.mjs').FleetWorkflow} fleetWorkflow
|
|
235
|
+
* @param {{ runId: string, filePath: string }} opts
|
|
236
|
+
*/
|
|
237
|
+
constructor(fleetWorkflow, { runId, filePath }) {
|
|
238
|
+
this.wf = fleetWorkflow;
|
|
239
|
+
this.runId = runId;
|
|
240
|
+
this.filePath = filePath;
|
|
241
|
+
this._chain = Promise.resolve();
|
|
242
|
+
|
|
243
|
+
this._onActivityStart = (meta) => {
|
|
244
|
+
if (meta.runId === this.runId) this._enqueue({ event: 'activity:start', ...meta });
|
|
245
|
+
};
|
|
246
|
+
this._onActivityEnd = (meta) => {
|
|
247
|
+
if (meta.runId === this.runId) this._enqueue({ event: 'activity:end', ...meta });
|
|
248
|
+
};
|
|
249
|
+
this._onEnd = (meta) => {
|
|
250
|
+
if (meta.runId === this.runId) this._enqueue({ event: 'run:end', ...meta });
|
|
251
|
+
};
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/** Creates the journal directory (if needed) and starts listening. */
|
|
255
|
+
async init() {
|
|
256
|
+
await fs.mkdir(path.dirname(this.filePath), { recursive: true });
|
|
257
|
+
this.wf.on('activity:start', this._onActivityStart);
|
|
258
|
+
this.wf.on('activity:end', this._onActivityEnd);
|
|
259
|
+
this.wf.on('end', this._onEnd);
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/**
|
|
263
|
+
* Writes the run-start record. Best-effort: `args`/`scriptPath` are
|
|
264
|
+
* stringified defensively (non-serializable args must not crash the
|
|
265
|
+
* run).
|
|
266
|
+
* @param {{ scriptPath: string, args: any }} meta
|
|
267
|
+
*/
|
|
268
|
+
async writeRunStart(meta) {
|
|
269
|
+
const record = { event: 'run:start', runId: this.runId, timestamp: Date.now(), scriptPath: meta.scriptPath };
|
|
270
|
+
try {
|
|
271
|
+
record.args = JSON.parse(JSON.stringify(meta.args ?? {}));
|
|
272
|
+
} catch {
|
|
273
|
+
record.args = undefined;
|
|
274
|
+
}
|
|
275
|
+
this._enqueue(record);
|
|
276
|
+
await this._chain;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
_enqueue(record) {
|
|
280
|
+
this._chain = this._chain.then(() => fs.appendFile(this.filePath, JSON.stringify(record) + '\n', 'utf-8'));
|
|
281
|
+
return this._chain;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** Detaches listeners and waits for all queued writes to flush. */
|
|
285
|
+
async close() {
|
|
286
|
+
this.wf.off('activity:start', this._onActivityStart);
|
|
287
|
+
this.wf.off('activity:end', this._onActivityEnd);
|
|
288
|
+
this.wf.off('end', this._onEnd);
|
|
289
|
+
await this._chain;
|
|
290
|
+
}
|
|
291
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// Estimated per-1M-token prices (USD), prompt/completion split.
|
|
2
|
+
// These are point-in-time ESTIMATES, not a live pricing feed -- do not treat
|
|
3
|
+
// them as authoritative for billing. lastUpdated: 2024 (see apra-fleet-unw.4;
|
|
4
|
+
// no new prices were invented when this table was reviewed -- if a model you
|
|
5
|
+
// need isn't listed below, calculateCost() returns `null` rather than
|
|
6
|
+
// guessing at a price).
|
|
7
|
+
//
|
|
8
|
+
// apra-fleet-dv5.2: this table is now the FALLBACK layer only. Real
|
|
9
|
+
// per-member pricing (apra-fleet-dv5.5's get_member_model_pricing MCP tool,
|
|
10
|
+
// consumed client-side by apra-fleet-dv5.6) is the PRIMARY mechanism --
|
|
11
|
+
// these rows are the honest degrade-path used only when real pricing is
|
|
12
|
+
// unavailable for a given run/member (older fleet server, tool-call
|
|
13
|
+
// failure, or an unpriced provider/model).
|
|
14
|
+
//
|
|
15
|
+
// Two independent key families live in this table:
|
|
16
|
+
// - Tier bands ('cheap'/'standard'/'premium'): what runner.js's
|
|
17
|
+
// FIXED_ROLE_TIER and the planner's per-bead metadata convention emit by
|
|
18
|
+
// default (apra-fleet-dv5.1) -- provider-agnostic, resolved to a
|
|
19
|
+
// concrete model per member server-side. Seeded from the pre-existing
|
|
20
|
+
// haiku/sonnet/opus rows below (same relative ordering), NOT sourced
|
|
21
|
+
// from an official published price list.
|
|
22
|
+
// - Concrete model IDs ('fable'/'opus'/'sonnet'/'haiku' and the
|
|
23
|
+
// non-fleet rows further below): a fully legitimate, permanent
|
|
24
|
+
// alternative to a tier keyword -- not a deprecated/legacy convention --
|
|
25
|
+
// for a caller that already knows which concrete model a target member
|
|
26
|
+
// runs and wants to price against that specifically. Matched via
|
|
27
|
+
// substring-of-modelName (see calculateCost()), so a more specific real
|
|
28
|
+
// model id (e.g. 'claude-haiku-4.5-20260601') still matches 'haiku'.
|
|
29
|
+
export const MODEL_PRICING = {
|
|
30
|
+
// Standard models (price per 1M tokens)
|
|
31
|
+
'gpt-4o': { prompt: 5.00, completion: 15.00 },
|
|
32
|
+
'gpt-4-turbo': { prompt: 10.00, completion: 30.00 },
|
|
33
|
+
'claude-3-5-sonnet-20240620': { prompt: 3.00, completion: 15.00 },
|
|
34
|
+
'claude-3-opus-20240229': { prompt: 15.00, completion: 75.00 },
|
|
35
|
+
'gemini-1.5-pro': { prompt: 3.50, completion: 10.50 },
|
|
36
|
+
'gemini-1.5-flash': { prompt: 0.35, completion: 1.05 },
|
|
37
|
+
|
|
38
|
+
// Tier-band fallback rows (apra-fleet-dv5.2) -- used only when real
|
|
39
|
+
// per-member pricing is unavailable. Seeded from the haiku/sonnet/opus
|
|
40
|
+
// rows below; keep in sync if those are ever revised.
|
|
41
|
+
'cheap': { prompt: 0.80, completion: 4.00 },
|
|
42
|
+
'standard': { prompt: 3.00, completion: 15.00 },
|
|
43
|
+
'premium': { prompt: 15.00, completion: 75.00 },
|
|
44
|
+
|
|
45
|
+
// Concrete fleet model IDs (N10, apra-fleet-unw2.8) -- ESTIMATES, see
|
|
46
|
+
// comment above. A legitimate, permanent input form (not legacy).
|
|
47
|
+
'haiku': { prompt: 0.80, completion: 4.00 }, // Claude Haiku 4.5 (estimate) -- cheapest/fastest tier
|
|
48
|
+
'sonnet': { prompt: 3.00, completion: 15.00 }, // Claude Sonnet 5 (estimate) -- mid tier, unchanged from the 2024 sonnet row
|
|
49
|
+
'opus': { prompt: 15.00, completion: 75.00 }, // Claude Opus 4.8 (estimate) -- premium tier, unchanged from the 2024 opus row
|
|
50
|
+
'fable': { prompt: 15.00, completion: 75.00 } // Claude Fable 5 (estimate) -- treated as premium tier, same order of magnitude as opus
|
|
51
|
+
};
|
|
52
|
+
|
|
53
|
+
// Tier-band keys are exact-match only (see calculateCost()) -- excluded
|
|
54
|
+
// from the substring scan so a near-miss string ('standard-tier') never
|
|
55
|
+
// silently matches a real tier keyword ('standard').
|
|
56
|
+
const TIER_BAND_KEYS = new Set(['cheap', 'standard', 'premium']);
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* @param {string} modelName
|
|
60
|
+
* @param {{ input_tokens?: number, output_tokens?: number }|null} usage
|
|
61
|
+
* @returns {number|null} the estimated cost in USD, or `null` when usage is
|
|
62
|
+
* missing/empty, or when `modelName` doesn't match any entry in
|
|
63
|
+
* MODEL_PRICING (unknown models are never silently priced with a default
|
|
64
|
+
* -- see apra-fleet-unw.4).
|
|
65
|
+
*/
|
|
66
|
+
export function calculateCost(modelName, usage) {
|
|
67
|
+
if (!usage || (!usage.input_tokens && !usage.output_tokens)) return null;
|
|
68
|
+
|
|
69
|
+
let pricing = null;
|
|
70
|
+
if (modelName) {
|
|
71
|
+
const lower = modelName.toLowerCase();
|
|
72
|
+
// Exact match first (apra-fleet-dv5.2): a tier band ('cheap',
|
|
73
|
+
// 'standard', 'premium') only ever prices an EXACT tier keyword --
|
|
74
|
+
// it is deliberately excluded from the substring scan below, so a
|
|
75
|
+
// string like 'standard-tier' (a plausible typo/mismatch, not a
|
|
76
|
+
// real tier keyword) stays unpriced rather than silently matching
|
|
77
|
+
// 'standard'. Substring matching remains reserved for concrete
|
|
78
|
+
// model IDs (e.g. 'claude-haiku-4.5-20260601' still matches
|
|
79
|
+
// 'haiku'), where a caller legitimately passes a longer real model
|
|
80
|
+
// string that happens to contain a known short concrete-id key.
|
|
81
|
+
if (Object.prototype.hasOwnProperty.call(MODEL_PRICING, lower)) {
|
|
82
|
+
pricing = MODEL_PRICING[lower];
|
|
83
|
+
} else {
|
|
84
|
+
const key = Object.keys(MODEL_PRICING)
|
|
85
|
+
.filter((k) => !TIER_BAND_KEYS.has(k))
|
|
86
|
+
.find((k) => lower.includes(k));
|
|
87
|
+
if (key) pricing = MODEL_PRICING[key];
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
if (!pricing) return null;
|
|
91
|
+
|
|
92
|
+
const pTokens = usage.input_tokens || 0;
|
|
93
|
+
const cTokens = usage.output_tokens || 0;
|
|
94
|
+
|
|
95
|
+
const promptCost = (pTokens / 1000000) * pricing.prompt;
|
|
96
|
+
const compCost = (cTokens / 1000000) * pricing.completion;
|
|
97
|
+
|
|
98
|
+
return promptCost + compCost;
|
|
99
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @typedef {Object} VettingResult
|
|
3
|
+
* @property {number} riskScore - 0 (safe) to 100 (critical risk)
|
|
4
|
+
* @property {string[]} warnings - List of identified risks or violations
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Interface for a vetting analyzer.
|
|
9
|
+
* Other developers can implement this interface to add custom checks.
|
|
10
|
+
*/
|
|
11
|
+
export class WorkflowAnalyzer {
|
|
12
|
+
/**
|
|
13
|
+
* @param {string} sourceCode
|
|
14
|
+
* @returns {Promise<VettingResult>}
|
|
15
|
+
*/
|
|
16
|
+
async analyze(sourceCode) {
|
|
17
|
+
throw new Error("analyze() must be implemented");
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* A basic analyzer that scans for patterns worth a developer's attention --
|
|
23
|
+
* fs/child_process imports, process.env access, dynamic eval -- in a
|
|
24
|
+
* workflow script. This is a heuristic lint for code review purposes, not an
|
|
25
|
+
* enforcement mechanism: workflow scripts are trusted code that already runs
|
|
26
|
+
* with full Node.js privileges (see engine.mjs), so none of these patterns
|
|
27
|
+
* are actually "not allowed"; they're just worth a human glancing at before
|
|
28
|
+
* running an unfamiliar script.
|
|
29
|
+
*/
|
|
30
|
+
export class BasicSecurityAnalyzer extends WorkflowAnalyzer {
|
|
31
|
+
async analyze(sourceCode) {
|
|
32
|
+
let riskScore = 0;
|
|
33
|
+
const warnings = [];
|
|
34
|
+
|
|
35
|
+
// In a real system, we'd use an AST parser (like Acorn or Babel) to inspect imports and globals.
|
|
36
|
+
// For this first implementation, we use simple heuristic regex matching.
|
|
37
|
+
// NOTE: as regex matching over source text, this is trivially bypassable (string
|
|
38
|
+
// concatenation, indirect references, etc.) -- it is not a security control, only a lint.
|
|
39
|
+
|
|
40
|
+
if (/(?:import|require)\s*\(\s*(?:'|")(?:fs|child_process|crypto|os|net|http)(?:'|")\s*\)/i.test(sourceCode) ||
|
|
41
|
+
/import\s+.*(?:'|")(?:fs|child_process|crypto|os|net|http)(?:'|")/i.test(sourceCode)) {
|
|
42
|
+
riskScore = Math.max(riskScore, 80);
|
|
43
|
+
warnings.push("Imports a core Node.js system module -- worth a review pass, but not blocked (workflow scripts are trusted code with full Node privileges).");
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
if (/process\.env/i.test(sourceCode)) {
|
|
47
|
+
riskScore = Math.max(riskScore, 50);
|
|
48
|
+
warnings.push("Accesses process environment variables directly.");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
if (/eval\s*\(/i.test(sourceCode) || /new\s+Function\s*\(/i.test(sourceCode)) {
|
|
52
|
+
riskScore = Math.max(riskScore, 90);
|
|
53
|
+
warnings.push("Uses dynamic code evaluation (eval or new Function).");
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
return { riskScore, warnings };
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* The Vetting Engine runs workflow scripts through all registered analyzers
|
|
62
|
+
* to generate a cumulative risk assessment before execution.
|
|
63
|
+
*
|
|
64
|
+
* NOTE: this is an advisory lint, not a security boundary. Workflow scripts
|
|
65
|
+
* are TRUSTED code loaded as real ES modules with full Node.js privileges
|
|
66
|
+
* (see engine.mjs); a regex-based heuristic scan cannot meaningfully sandbox
|
|
67
|
+
* arbitrary JavaScript, and this class does not attempt to. Findings are
|
|
68
|
+
* logged as warnings; by default WorkflowEngine.executeFile() never blocks
|
|
69
|
+
* on them. Pass `{ strictVetting: true }` to executeFile() if you want
|
|
70
|
+
* high-risk scripts (riskScore > 50) to throw instead of just warn.
|
|
71
|
+
*/
|
|
72
|
+
export class VettingEngine {
|
|
73
|
+
constructor() {
|
|
74
|
+
/** @type {WorkflowAnalyzer[]} */
|
|
75
|
+
this.analyzers = [
|
|
76
|
+
new BasicSecurityAnalyzer()
|
|
77
|
+
];
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* @param {WorkflowAnalyzer} analyzer
|
|
82
|
+
*/
|
|
83
|
+
registerAnalyzer(analyzer) {
|
|
84
|
+
this.analyzers.push(analyzer);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Assess the risk of a workflow script.
|
|
89
|
+
* @param {string} sourceCode
|
|
90
|
+
* @returns {Promise<VettingResult>}
|
|
91
|
+
*/
|
|
92
|
+
async assessRisk(sourceCode) {
|
|
93
|
+
let maxRisk = 0;
|
|
94
|
+
const allWarnings = [];
|
|
95
|
+
|
|
96
|
+
for (const analyzer of this.analyzers) {
|
|
97
|
+
try {
|
|
98
|
+
const result = await analyzer.analyze(sourceCode);
|
|
99
|
+
maxRisk = Math.max(maxRisk, result.riskScore);
|
|
100
|
+
allWarnings.push(...result.warnings);
|
|
101
|
+
} catch (err) {
|
|
102
|
+
console.error(`[VettingEngine] Analyzer failed:`, err);
|
|
103
|
+
// Fail secure by flagging unanalyzable scripts
|
|
104
|
+
maxRisk = Math.max(maxRisk, 100);
|
|
105
|
+
allWarnings.push("An analyzer crashed while analyzing this script.");
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
return { riskScore: maxRisk, warnings: allWarnings };
|
|
110
|
+
}
|
|
111
|
+
}
|
|
@@ -24,6 +24,7 @@ try {
|
|
|
24
24
|
id, '.system_generated', 'logs', 'transcript.jsonl'
|
|
25
25
|
);
|
|
26
26
|
if (fs.existsSync(tp)) {
|
|
27
|
+
console.log('FLEET_SESSION_ID:' + id);
|
|
27
28
|
console.log('FLEET_TRANSCRIPT_START');
|
|
28
29
|
console.log(fs.readFileSync(tp, 'utf8'));
|
|
29
30
|
console.log('FLEET_TRANSCRIPT_END');
|
|
@@ -1,14 +1,18 @@
|
|
|
1
1
|
#!/usr/bin/env bash
|
|
2
|
-
# Fleet statusline script for Claude Code.
|
|
2
|
+
# Fleet statusline script for Claude Code and AGY.
|
|
3
3
|
# Reads pre-rendered statusline.txt and appends a freshness indicator
|
|
4
|
-
# based on file mtime
|
|
4
|
+
# based on file mtime - gradient from green to red:
|
|
5
5
|
#
|
|
6
|
-
# Claude Code pipes JSON session data to stdin
|
|
6
|
+
# Claude Code pipes JSON session data to stdin - we consume it to avoid
|
|
7
7
|
# broken-pipe but don't need it; the fleet server writes the real state.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
# Drain stdin with timeout if present to prevent hanging in AGY / interactive terminals
|
|
10
|
+
if [ ! -t 0 ]; then
|
|
11
|
+
timeout 0.2 cat > /dev/null 2>/dev/null || true
|
|
12
|
+
fi
|
|
10
13
|
|
|
11
|
-
|
|
14
|
+
HOME_DIR="${HOME:-$USERPROFILE}"
|
|
15
|
+
STATUSLINE_FILE="${APRA_FLEET_DATA_DIR:-${HOME_DIR}/.apra-fleet/data}/statusline.txt"
|
|
12
16
|
|
|
13
17
|
if [ ! -f "$STATUSLINE_FILE" ]; then
|
|
14
18
|
echo "Fleet: no status"
|
|
@@ -30,14 +34,14 @@ fi
|
|
|
30
34
|
NOW=$(date +%s)
|
|
31
35
|
AGE=$(( NOW - ${MTIME:-0} ))
|
|
32
36
|
|
|
33
|
-
if [ "$AGE" -lt 10 ]; then FRESH="
|
|
34
|
-
elif [ "$AGE" -lt 60 ]; then FRESH="
|
|
35
|
-
elif [ "$AGE" -lt 300 ]; then FRESH="
|
|
36
|
-
elif [ "$AGE" -lt 900 ]; then FRESH="
|
|
37
|
-
elif [ "$AGE" -lt 1800 ]; then FRESH="
|
|
38
|
-
elif [ "$AGE" -lt 3600 ]; then FRESH="
|
|
39
|
-
elif [ "$AGE" -lt 7200 ]; then FRESH="
|
|
40
|
-
else FRESH="
|
|
37
|
+
if [ "$AGE" -lt 10 ]; then FRESH="[OK]" # <10s fresh
|
|
38
|
+
elif [ "$AGE" -lt 60 ]; then FRESH="[OK]" # <1m recent
|
|
39
|
+
elif [ "$AGE" -lt 300 ]; then FRESH="[OK]" # <5m ok
|
|
40
|
+
elif [ "$AGE" -lt 900 ]; then FRESH="[WAIT]" # <15m getting stale
|
|
41
|
+
elif [ "$AGE" -lt 1800 ]; then FRESH="[WARN]" # <30m stale warning
|
|
42
|
+
elif [ "$AGE" -lt 3600 ]; then FRESH="[STALE]" # <1h attention
|
|
43
|
+
elif [ "$AGE" -lt 7200 ]; then FRESH="[STALE]" # <2h concern
|
|
44
|
+
else FRESH="[DOWN]" # >2h stale, possibly down
|
|
41
45
|
fi
|
|
42
46
|
|
|
43
47
|
echo "${LINE} ${FRESH}"
|
package/skills/fleet/SKILL.md
CHANGED
|
@@ -128,7 +128,7 @@ Do not dispatch to a busy member. If busy, wait or re-check `member_detail`.
|
|
|
128
128
|
|
|
129
129
|
Both `send_files` and `receive_files` are batch operations - always transfer all files in a single call, never one file per call.
|
|
130
130
|
|
|
131
|
-
- `send_files` - push any files to a member: context files, plans, scripts, binaries, configs, or any other content. Takes `local_paths` (array of local file paths) and optional `dest_subdir` (destination subdirectory relative to work_folder on member; defaults to work_folder root, equivalent to `"."`). Always try to batch multiple files in a single call.
|
|
131
|
+
- `send_files` - push any files to a member: context files, plans, scripts, binaries, configs, or any other content. Takes `local_paths` (array of local file paths) and optional `dest_subdir` (destination subdirectory relative to work_folder on member; defaults to work_folder root, equivalent to `"."`). Optional `substitutions: { name: value }` replaces every `{{name}}` token in each file before transfer - see Substitutions section below. Always try to batch multiple files in a single call.
|
|
132
132
|
- `receive_files` - pull files back: results, logs, build artifacts, updated configs, etc. Takes `remote_paths` (array of file paths on the member) and `local_dest_dir` (local directory to write files into). Always try to batch multiple files in a single call.
|
|
133
133
|
|
|
134
134
|
**Directories and globs:** `send_files` accepts individual file paths only - directories and glob patterns are not supported yet. To transfer an entire directory, tar it locally and extract on the member:
|
|
@@ -141,6 +141,37 @@ Both `send_files` and `receive_files` are batch operations - always transfer a
|
|
|
141
141
|
|
|
142
142
|
**Cross-OS transfers:** Both `send_files` and `receive_files` work bidirectionally for Linux<->Windows transfers (fleet host on Linux, member on Windows, and vice versa).
|
|
143
143
|
|
|
144
|
+
## Substitutions (send_files and execute_prompt)
|
|
145
|
+
|
|
146
|
+
Both `send_files` and `execute_prompt` accept an optional `substitutions: { "token_name": "value" }` parameter that replaces `{{token_name}}` placeholders in file content or prompt text before the content is delivered to the member.
|
|
147
|
+
|
|
148
|
+
**Usage:**
|
|
149
|
+
```
|
|
150
|
+
send_files(
|
|
151
|
+
local_paths=["docs/sprint-briefing.md"],
|
|
152
|
+
substitutions={ branch: "feat/task-1", base_branch: "main", member_name: "Alice" }
|
|
153
|
+
)
|
|
154
|
+
|
|
155
|
+
execute_prompt(
|
|
156
|
+
member=...,
|
|
157
|
+
prompt="Continue Phase {{phase}}. Branch: {{branch}}.",
|
|
158
|
+
substitutions={ phase: "3", branch: "feat/task-1" }
|
|
159
|
+
)
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
**Rules:**
|
|
163
|
+
- Token names must match `[A-Za-z_][A-Za-z0-9_]*` - no dots, hyphens, or other special characters.
|
|
164
|
+
- All tokens used in any file (or the prompt string) must have a corresponding key in `substitutions`. Missing tokens cause the call to fail with zero side effects (no files written, no CLI invoked).
|
|
165
|
+
- Extra keys are silently ignored - pass a superset map without error.
|
|
166
|
+
- No recursive substitution: values containing `{{...}}` are written verbatim.
|
|
167
|
+
- Source files on the fleet host are never modified; only the delivered copy is substituted.
|
|
168
|
+
- If `substitutions` is omitted and file/prompt content contains `{{token}}` patterns, a warning is returned (call still succeeds).
|
|
169
|
+
|
|
170
|
+
**[SECURE] Secrets boundary -- never use substitutions for secrets:**
|
|
171
|
+
- Substitution keys with dots (e.g. `secure.github_pat`) are rejected outright.
|
|
172
|
+
- `{{secure.NAME}}` patterns in file/prompt content pass through verbatim - they are resolved later only by `execute_command` via the credential store, not here.
|
|
173
|
+
- Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{secure.NAME}}` in `execute_command` for secrets.
|
|
174
|
+
|
|
144
175
|
## Permissions
|
|
145
176
|
|
|
146
177
|
`compose_permissions` produces provider-native config automatically. See `permissions.md` for:
|
|
@@ -148,7 +179,11 @@ Both `send_files` and `receive_files` are batch operations - always transfer a
|
|
|
148
179
|
- How to handle permission denials during execution
|
|
149
180
|
- How to recompose when switching roles
|
|
150
181
|
|
|
151
|
-
## execute_prompt
|
|
182
|
+
## execute_prompt Parameters
|
|
183
|
+
|
|
184
|
+
`execute_prompt` accepts `substitutions` (see Substitutions section above), `model`, `resume`, and timeout parameters.
|
|
185
|
+
|
|
186
|
+
### Timeout Parameters
|
|
152
187
|
|
|
153
188
|
`execute_prompt` accepts two independent timeout parameters:
|
|
154
189
|
|