@apralabs/apra-fleet 0.4.1 → 0.4.3
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 +53 -12
- package/dist/agents/backlog-groomer.md +42 -21
- package/dist/agents/ci-watcher.md +14 -0
- package/dist/agents/deployer.md +59 -46
- package/dist/agents/doer.md +157 -134
- package/dist/agents/harvester.md +31 -32
- package/dist/agents/integ-test-runner.md +92 -113
- package/dist/agents/kb-reconciler.md +40 -42
- package/dist/agents/plan-reviewer.md +139 -63
- package/dist/agents/planner.md +176 -100
- package/dist/agents/regression-test-runner.md +77 -81
- package/dist/agents/reviewer.md +69 -85
- package/dist/agents/schemas/integ-test-runner-output.json +1 -1
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/cli/agent-transform.d.ts +83 -2
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +266 -21
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +29 -11
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +7 -5
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +44 -43
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts +33 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +294 -61
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/kb-directives.d.ts.map +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-directives.js.map +1 -1
- package/dist/cli/register-member.d.ts.map +1 -1
- package/dist/cli/register-member.js +7 -3
- package/dist/cli/register-member.js.map +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +5 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +26 -3
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +41 -9
- package/dist/cli/watch.js.map +1 -1
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.d.ts.map +1 -1
- package/dist/commands/kb-server.js +43 -3
- package/dist/commands/kb-server.js.map +1 -1
- package/dist/index.js +3 -3
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +36 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +68 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +98 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +259 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +73 -8
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +118 -8
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +580 -55
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +83 -4
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +365 -12
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +7 -4
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +24 -4
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +7 -4
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +27 -4
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +7 -4
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +22 -4
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +6 -3
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +27 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +215 -11
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +58 -2
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.js +2 -2
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/agy-project.d.ts +102 -0
- package/dist/services/agy-project.d.ts.map +1 -0
- package/dist/services/agy-project.js +356 -0
- package/dist/services/agy-project.js.map +1 -0
- package/dist/services/auth-socket.js +4 -4
- package/dist/services/auth-web.js +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +33 -4
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +47 -10
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.d.ts.map +1 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/exit-drain.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +32 -4
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +1 -0
- package/dist/services/http-transport.d.ts.map +1 -1
- package/dist/services/http-transport.js +48 -1
- package/dist/services/http-transport.js.map +1 -1
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.d.ts.map +1 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-config.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +7 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
- package/dist/services/knowledge/kb-providers.js +191 -17
- package/dist/services/knowledge/kb-providers.js.map +1 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
- package/dist/services/member-home.d.ts +1 -1
- package/dist/services/member-home.d.ts.map +1 -1
- package/dist/services/member-home.js +15 -12
- package/dist/services/member-home.js.map +1 -1
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -8
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +6 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +17 -14
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.js +2 -2
- package/dist/services/preflight-check.js.map +1 -1
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.d.ts.map +1 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/secret-token.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +3 -1
- package/dist/services/service-manager/types.d.ts.map +1 -1
- package/dist/services/service-manager/windows.d.ts +14 -2
- package/dist/services/service-manager/windows.d.ts.map +1 -1
- package/dist/services/service-manager/windows.js +65 -7
- package/dist/services/service-manager/windows.js.map +1 -1
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +60 -4
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +26 -15
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +53 -4
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +212 -34
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +35 -42
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +119 -8
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/substitution-engine.js.map +1 -1
- package/dist/services/tool-registry.d.ts.map +1 -1
- package/dist/services/tool-registry.js +5 -3
- package/dist/services/tool-registry.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +67 -2
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +281 -15
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +24 -0
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/dist/skills/pm/SKILL.md +1 -2
- package/dist/skills/pm/cost.md +0 -4
- package/dist/skills/pm/fleet-addendum.md +2 -3
- package/dist/tools/check-status.d.ts +7 -4
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +5 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/compose-permissions.d.ts +6 -0
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +211 -50
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +56 -29
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +15 -2
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1214 -873
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/kb-capture.d.ts +2 -2
- package/dist/tools/kb-capture.d.ts.map +1 -1
- package/dist/tools/kb-capture.js +29 -5
- package/dist/tools/kb-capture.js.map +1 -1
- package/dist/tools/kb-export.d.ts +2 -2
- package/dist/tools/kb-export.d.ts.map +1 -1
- package/dist/tools/kb-export.js +3 -28
- package/dist/tools/kb-export.js.map +1 -1
- package/dist/tools/kb-feedback.d.ts.map +1 -1
- package/dist/tools/kb-feedback.js +3 -1
- package/dist/tools/kb-feedback.js.map +1 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
- package/dist/tools/kb-freshness-sweep.js +3 -1
- package/dist/tools/kb-freshness-sweep.js.map +1 -1
- package/dist/tools/kb-import.d.ts.map +1 -1
- package/dist/tools/kb-import.js +2 -1
- package/dist/tools/kb-import.js.map +1 -1
- package/dist/tools/kb-list.d.ts.map +1 -1
- package/dist/tools/kb-list.js +3 -1
- package/dist/tools/kb-list.js.map +1 -1
- package/dist/tools/kb-query.d.ts +2 -2
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
- package/dist/tools/kb-reconcile-prefilter.js +3 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
- package/dist/tools/kb-resolve-contradiction.js +3 -1
- package/dist/tools/kb-resolve-contradiction.js.map +1 -1
- package/dist/tools/kb-setup.d.ts.map +1 -1
- package/dist/tools/kb-setup.js +125 -20
- package/dist/tools/kb-setup.js.map +1 -1
- package/dist/tools/kb-stats.d.ts.map +1 -1
- package/dist/tools/kb-stats.js +64 -43
- package/dist/tools/kb-stats.js.map +1 -1
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +7 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +2 -2
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +22 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +58 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +71 -18
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +17 -2
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts +80 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +147 -59
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +96 -3
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +254 -88
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +21 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +141 -16
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +29 -4
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/setup-git-app.d.ts.map +1 -1
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/setup-git-app.js.map +1 -1
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -1
- 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 +23 -1
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +21 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +61 -12
- package/dist/tools/update-member.js.map +1 -1
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
- package/dist/tools/vcs-credential-exec.js +197 -0
- package/dist/tools/vcs-credential-exec.js.map +1 -0
- package/dist/types.d.ts +24 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/log-helpers.d.ts.map +1 -1
- package/dist/utils/log-helpers.js +2 -2
- package/dist/utils/log-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +7 -1
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/shell-escape.d.ts +16 -0
- package/dist/utils/shell-escape.d.ts.map +1 -1
- package/dist/utils/shell-escape.js +22 -2
- package/dist/utils/shell-escape.js.map +1 -1
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/vcs-provider-detect.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +20 -17
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +180 -32
- package/package.json +7 -5
- package/packages/apra-fleet-client/src/client/api.mjs +403 -12
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
- package/packages/apra-fleet-se/bin/cli.mjs +280 -3
- package/packages/apra-fleet-se/bin/serve.mjs +114 -5
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
- package/skills/fleet/SKILL.md +27 -16
- package/skills/fleet/auth-azdevops.md +57 -7
- package/skills/fleet/auth-bitbucket.md +5 -5
- package/skills/fleet/auth-github.md +7 -6
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/onboarding.md +6 -6
- package/skills/fleet/permissions.md +11 -7
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +4 -3
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -52
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -236
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { LlmProvider } from '../types.js';
|
|
2
2
|
import type { SSHExecResult } from '../types.js';
|
|
3
3
|
import type { PromptErrorCategory } from '../utils/prompt-errors.js';
|
|
4
|
+
import type { MemberShell } from '../os/os-commands.js';
|
|
4
5
|
export type { LlmProvider };
|
|
5
6
|
/** The OS of the machine a resolved path will be USED on (the member's own
|
|
6
7
|
* machine), which is NOT necessarily the OS this hub process runs on. */
|
|
@@ -12,7 +13,7 @@ export type TargetOS = 'linux' | 'macos' | 'windows';
|
|
|
12
13
|
* Providers previously built member-side log paths with the default `path`
|
|
13
14
|
* module, so a Windows hub produced backslash-joined paths for a Linux member
|
|
14
15
|
* (and vice versa) -- a path that can never exist on the member, which silently
|
|
15
|
-
* disables stall detection (Claude
|
|
16
|
+
* disables stall detection (Claude) or manufactures a false-positive
|
|
16
17
|
* stall kill (AGY/OpenCode).
|
|
17
18
|
*
|
|
18
19
|
* `targetOs === undefined` deliberately keeps the legacy host-convention
|
|
@@ -39,10 +40,36 @@ export type SessionIdStrategy = {
|
|
|
39
40
|
} | {
|
|
40
41
|
type: 'provider-minted';
|
|
41
42
|
};
|
|
43
|
+
/**
|
|
44
|
+
* apra-fleet-25yl.2.1: what the EXEC-LEVEL ROLLING (inactivity) timeout handed
|
|
45
|
+
* to `strategy.execCommand()` is derived from, for this provider.
|
|
46
|
+
*
|
|
47
|
+
* - 'inactivity_timeout' -- derive it from the caller's `timeout_s`. Choose
|
|
48
|
+
* this when the exec channel (stdout/stderr on the dispatch pipe) is a
|
|
49
|
+
* REAL mid-turn liveness signal for the provider, OR when preserving the
|
|
50
|
+
* provider's current behaviour is the point. Codex is the load-bearing
|
|
51
|
+
* case: its adapter returns null from resolveSessionLogDir(), so the
|
|
52
|
+
* StallDetector has no transcript to poll and this timer is its ONLY stall
|
|
53
|
+
* signal -- decoupling it there disables stall detection outright.
|
|
54
|
+
* - 'total_ceiling' -- do NOT arm a `timeout_s`-sized rolling deadline;
|
|
55
|
+
* derive it from `max_total_s` instead (a value that can never bind before
|
|
56
|
+
* the caller's own hard ceiling does). Choose this when the provider is
|
|
57
|
+
* batch/CONOUT$-only, so the exec channel emits nothing mid-turn and a
|
|
58
|
+
* `timeout_s`-sized rolling deadline is a false kill. The StallDetector's
|
|
59
|
+
* transcript polling is the real stall mechanism for these providers, and
|
|
60
|
+
* it still gets `timeout_s` as its thresholdMs.
|
|
61
|
+
*
|
|
62
|
+
* This is deliberately a REQUIRED member of {@link ProviderAdapter} rather
|
|
63
|
+
* than an optional one with a default: a newly added provider must state its
|
|
64
|
+
* own answer (a compile error if it does not) instead of silently inheriting
|
|
65
|
+
* whichever branch happens to be the fallback, because the wrong branch
|
|
66
|
+
* silently disables a kill path.
|
|
67
|
+
*/
|
|
68
|
+
export type ExecTimeoutSource = 'inactivity_timeout' | 'total_ceiling';
|
|
42
69
|
export declare function encodeClaudeProjectDir(workFolder: string): string;
|
|
43
70
|
/**
|
|
44
71
|
* Build a `--resume <id>` flag with session ID sanitization and quoting.
|
|
45
|
-
* Shared by providers that pass session IDs on the command line (Claude
|
|
72
|
+
* Shared by providers that pass session IDs on the command line (Claude).
|
|
46
73
|
* @param sessionId - The raw session ID (will be sanitized)
|
|
47
74
|
* @param fallback - Value to return when sessionId is absent (default: '')
|
|
48
75
|
*/
|
|
@@ -52,6 +79,22 @@ export declare function buildResumeFlag(sessionId: string | undefined, fallback?
|
|
|
52
79
|
* @param sessionId - The raw session ID (will be sanitized)
|
|
53
80
|
*/
|
|
54
81
|
export declare function buildSessionIdFlag(sessionId: string): string;
|
|
82
|
+
/**
|
|
83
|
+
* Build a fork-mode resume flag: seed context from `sourceSessionId`'s transcript
|
|
84
|
+
* but yield a NEW, distinct session id rather than continuing the source id in
|
|
85
|
+
* place (contrast with {@link buildResumeFlag}, which resumes the source id
|
|
86
|
+
* unchanged). Shared by providers whose CLI supports resuming into a forked
|
|
87
|
+
* session id (Claude's `--fork-session`, used together with `--resume`).
|
|
88
|
+
*
|
|
89
|
+
* The forked session id is pre-minted by the caller and passed explicitly via
|
|
90
|
+
* `--session-id` alongside `--resume ... --fork-session`, rather than letting
|
|
91
|
+
* the CLI mint its own id and scraping it out of the response afterward -- the
|
|
92
|
+
* CLI honors a caller-supplied `--session-id` even in fork mode.
|
|
93
|
+
* @param sourceSessionId - The session ID to seed/fork from (will be sanitized)
|
|
94
|
+
* @param newSessionId - The caller-minted id the forked session should be created under (will be sanitized)
|
|
95
|
+
* @param fallback - Value to return when sourceSessionId is absent (default: '')
|
|
96
|
+
*/
|
|
97
|
+
export declare function buildForkFlag(sourceSessionId: string | undefined, newSessionId: string | undefined, fallback?: string): string;
|
|
55
98
|
export interface PromptOptions {
|
|
56
99
|
folder: string;
|
|
57
100
|
promptFile: string;
|
|
@@ -63,7 +106,44 @@ export interface PromptOptions {
|
|
|
63
106
|
maxTurns?: number;
|
|
64
107
|
inv?: string;
|
|
65
108
|
agentName?: string;
|
|
109
|
+
/** Provider project the run is bound to (AGY: `--project <id>`, from
|
|
110
|
+
* Agent.agyProjectId). Ignored by providers without {@link ProviderAdapter.projectFlag}. */
|
|
111
|
+
projectId?: string;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* apra-fleet-hzeb.1: a provider-agnostic "this dispatch hit a usage/quota limit
|
|
115
|
+
* and cannot make progress until `resumeAt`" signal. Distinct from a transient
|
|
116
|
+
* overload (529/overloaded), which is retryable after a short backoff -- a usage
|
|
117
|
+
* limit needs a real wall-clock wait until the quota window resets.
|
|
118
|
+
*
|
|
119
|
+
* `resumeAt` is ALWAYS a concrete ISO-8601 UTC timestamp, never null: when the
|
|
120
|
+
* provider CLI exposes a real reset time we parse it (`resumeAtSource: 'parsed'`);
|
|
121
|
+
* otherwise we fall back to a guessed window (`resumeAtSource: 'guessed'`), so a
|
|
122
|
+
* consumer can always schedule a resume without special-casing "unknown".
|
|
123
|
+
*/
|
|
124
|
+
export interface UsageLimitSignal {
|
|
125
|
+
type: 'usage_limit';
|
|
126
|
+
/** ISO-8601 UTC instant at which work may resume. Never null. */
|
|
127
|
+
resumeAt: string;
|
|
128
|
+
/** Whether `resumeAt` was parsed from the provider's own reset time, or guessed. */
|
|
129
|
+
resumeAtSource: 'parsed' | 'guessed';
|
|
130
|
+
/** The raw message/output that identified this as a usage limit (for logging). */
|
|
131
|
+
message: string;
|
|
66
132
|
}
|
|
133
|
+
/**
|
|
134
|
+
* apra-fleet-hzeb.1: THE provider-adapter default resume window for a guessed
|
|
135
|
+
* usage-limit signal (1 hour). This is the single source of truth for the guess --
|
|
136
|
+
* fleet-sprint and other consumers must read the signal's `resumeAt`, never
|
|
137
|
+
* hardcode their own 1h fallback.
|
|
138
|
+
*/
|
|
139
|
+
export declare const DEFAULT_USAGE_LIMIT_RESUME_MS: number;
|
|
140
|
+
/**
|
|
141
|
+
* apra-fleet-hzeb.1: build a guessed usage-limit signal whose `resumeAt` is
|
|
142
|
+
* `now + DEFAULT_USAGE_LIMIT_RESUME_MS`. `now` is injectable for deterministic
|
|
143
|
+
* tests.
|
|
144
|
+
*/
|
|
145
|
+
export declare function guessedUsageLimitSignal(message: string, now?: number): UsageLimitSignal;
|
|
146
|
+
export declare function defaultUsageLimitSignal(output: string, now?: number): UsageLimitSignal | null;
|
|
67
147
|
export interface ParsedResponse {
|
|
68
148
|
result: string;
|
|
69
149
|
sessionId?: string;
|
|
@@ -77,6 +157,51 @@ export interface ParsedResponse {
|
|
|
77
157
|
subtype?: string;
|
|
78
158
|
/** e.g. 'max_turns' -- the CLI result event's own terminal_reason, when present. */
|
|
79
159
|
terminalReason?: string;
|
|
160
|
+
/** apra-fleet-hzeb.1: the Claude result event's api_error_status (e.g. 429), when
|
|
161
|
+
* present -- previously dropped by the parser. Used by detectUsageLimit. */
|
|
162
|
+
apiErrorStatus?: number;
|
|
163
|
+
/** apra-fleet-hzeb.1: set by execute_prompt (from detectUsageLimit) when this
|
|
164
|
+
* dispatch was terminated by a provider usage/quota limit. */
|
|
165
|
+
usageLimit?: UsageLimitSignal;
|
|
166
|
+
/** Set by a provider parser when the CLI refused one or more tool calls for
|
|
167
|
+
* lack of a permission grant (AGY headless mode auto-denies them). */
|
|
168
|
+
permissionDenial?: PermissionDenial;
|
|
169
|
+
}
|
|
170
|
+
/** A tool call the member CLI refused because no grant allowed it. */
|
|
171
|
+
export interface PermissionDenialItem {
|
|
172
|
+
/** Provider permission action, e.g. 'command', 'read_file', 'mcp'. */
|
|
173
|
+
action: string;
|
|
174
|
+
/** The concrete target, when the CLI named it, e.g. 'git status --short --branch'. */
|
|
175
|
+
target?: string;
|
|
176
|
+
}
|
|
177
|
+
/** Structured permission denial surfaced by execute_prompt as
|
|
178
|
+
* `reason: 'permission_denied'`. */
|
|
179
|
+
export interface PermissionDenial {
|
|
180
|
+
/** Unique denied actions, in first-seen order. */
|
|
181
|
+
actions: string[];
|
|
182
|
+
denials: PermissionDenialItem[];
|
|
183
|
+
/** compose_permissions `grant` values that would allow the denied calls
|
|
184
|
+
* (empty when there is no canonical mapping for an action). The primary
|
|
185
|
+
* suggestion comes first; a narrower alternative may follow it. */
|
|
186
|
+
suggestedGrants: string[];
|
|
187
|
+
/** One-line remediation for a human or an orchestrator. */
|
|
188
|
+
hint: string;
|
|
189
|
+
/** Which of the CLI's signals reported the denial. */
|
|
190
|
+
signals: Array<'result_json' | 'stderr' | 'transcript'>;
|
|
191
|
+
}
|
|
192
|
+
/** Context parseResponse may use; providers that do not need it ignore it. */
|
|
193
|
+
export interface ParseResponseContext {
|
|
194
|
+
/** The member's OS (e.g. agy's permission-denial hint differs on Windows). */
|
|
195
|
+
agentOs?: 'linux' | 'macos' | 'windows';
|
|
196
|
+
}
|
|
197
|
+
/** Extra inputs to composePermissionConfig; providers that do not need them
|
|
198
|
+
* ignore them. */
|
|
199
|
+
export interface ComposePermissionOptions {
|
|
200
|
+
/** The member's home directory, resolved in JavaScript (getMemberHomeDir). */
|
|
201
|
+
memberHomeDir?: string | null;
|
|
202
|
+
/** Receives lines for grants that could not be expressed and were dropped;
|
|
203
|
+
* compose_permissions shows them in its result. */
|
|
204
|
+
warnings?: string[];
|
|
80
205
|
}
|
|
81
206
|
export declare function isMaxTurnsResponse(parsed: ParsedResponse | undefined | null): boolean;
|
|
82
207
|
export interface RegisterMcpEndpointOptions {
|
|
@@ -99,6 +224,23 @@ export interface RegisterMcpEndpointResult {
|
|
|
99
224
|
* type (rather than importing AgentStrategy) so providers.ts has no dependency on
|
|
100
225
|
* services/strategy.ts. */
|
|
101
226
|
export type WorkspaceTrustExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
|
|
227
|
+
/** Optional file-delivery channel for {@link ProviderAdapter.ensureWorkspaceTrusted}
|
|
228
|
+
* (GitHub #499). Writes `content` to `relPath`, resolved relative to the MEMBER's home
|
|
229
|
+
* directory, without going through a shell command line: node:fs for a local member,
|
|
230
|
+
* SFTP for an SSH member. A merged ~/.claude.json can be far larger than any command
|
|
231
|
+
* line a Windows process may carry (CreateProcess caps it at 32767 chars; cmd.exe at
|
|
232
|
+
* 8191), so the adapter prefers this channel when present and only falls back to
|
|
233
|
+
* exec-based delivery (chunked on Windows) when it is absent or fails. Must throw on
|
|
234
|
+
* failure so the adapter can fall back. */
|
|
235
|
+
export type WorkspaceTrustWriteHomeFileFn = (relPath: string, content: string) => Promise<void>;
|
|
236
|
+
export type WorkspaceTrustReadHomeFileFn = (relPath: string) => Promise<{
|
|
237
|
+
found: boolean;
|
|
238
|
+
content?: string;
|
|
239
|
+
} | undefined>;
|
|
240
|
+
export interface WorkspaceTrustTransport {
|
|
241
|
+
writeHomeFile?: WorkspaceTrustWriteHomeFileFn;
|
|
242
|
+
readHomeFile?: WorkspaceTrustReadHomeFileFn;
|
|
243
|
+
}
|
|
102
244
|
export interface EnsureWorkspaceTrustedResult {
|
|
103
245
|
/** true only when this call just wrote hasTrustDialogAccepted=true because it was
|
|
104
246
|
* missing. false when the provider no-ops, or when trust was already present. */
|
|
@@ -119,7 +261,12 @@ export interface ProviderAdapter {
|
|
|
119
261
|
readonly instructionFileName: string;
|
|
120
262
|
cliCommand(args: string): string;
|
|
121
263
|
versionCommand(): string;
|
|
122
|
-
|
|
264
|
+
/** `shell` is the member's registered shell (only meaningful for
|
|
265
|
+
* `os === 'windows'`). A gitbash Windows member gets a bash-invokable
|
|
266
|
+
* install string; every other combination -- including a Windows member
|
|
267
|
+
* with no shell recorded, or pwsh7/powershell5 -- resolves exactly as it
|
|
268
|
+
* did before the shell parameter existed (apra-fleet-7dir.2.7). */
|
|
269
|
+
installCommand(os: 'linux' | 'macos' | 'windows', shell?: MemberShell): string;
|
|
123
270
|
updateCommand(): string;
|
|
124
271
|
buildPromptCommand(opts: PromptOptions): string;
|
|
125
272
|
skipPermissionsFlag(): string;
|
|
@@ -143,12 +290,60 @@ export interface ProviderAdapter {
|
|
|
143
290
|
* os/windows.ts call this instead of re-deriving the branching
|
|
144
291
|
* themselves, so the two dispatch paths cannot diverge. */
|
|
145
292
|
resolvePermissionFlag(unattended: false | 'auto' | 'dangerous' | undefined): string;
|
|
146
|
-
parseResponse(result: SSHExecResult): ParsedResponse;
|
|
293
|
+
parseResponse(result: SSHExecResult, ctx?: ParseResponseContext): ParsedResponse;
|
|
294
|
+
/** apra-fleet-hzeb.1: detect whether this dispatch was terminated by a provider
|
|
295
|
+
* usage/quota limit (as opposed to a transient overload). Returns a
|
|
296
|
+
* {@link UsageLimitSignal} with a concrete `resumeAt`, or null when this was not
|
|
297
|
+
* a usage limit. REQUIRED on every adapter: none.ts returns null; the non-Claude
|
|
298
|
+
* adapters delegate to {@link defaultUsageLimitSignal} on their raw output; Claude
|
|
299
|
+
* keys off its api_error_status / terminal_reason plus its own limit message. */
|
|
300
|
+
detectUsageLimit(result: SSHExecResult, parsed: ParsedResponse): UsageLimitSignal | null;
|
|
147
301
|
supportsResume(): boolean;
|
|
148
302
|
supportsMaxTurns(): boolean;
|
|
149
303
|
resumeFlag(sessionId?: string, resuming?: boolean): string;
|
|
150
304
|
/** Defines whether this provider accepts caller-minted UUIDs or generates session IDs natively. */
|
|
151
305
|
sessionIdStrategy(): SessionIdStrategy;
|
|
306
|
+
/** apra-fleet-25yl.2.1: what the exec-level rolling (inactivity) timeout is
|
|
307
|
+
* derived from for this provider -- see {@link ExecTimeoutSource}. REQUIRED
|
|
308
|
+
* on every adapter, deliberately with no default, so a new provider must
|
|
309
|
+
* state its answer rather than inherit one. */
|
|
310
|
+
execTimeoutSource(): ExecTimeoutSource;
|
|
311
|
+
/** apra-fleet-lmtg.1: true when this provider supports fork-mode dispatch --
|
|
312
|
+
* branching a NEW, distinct session id from an existing session's context,
|
|
313
|
+
* as opposed to resume (which continues the source id in place). Optional:
|
|
314
|
+
* providers that do not implement it are NOT fork-capable. Callers MUST
|
|
315
|
+
* check `provider.supportsFork?.() ?? false` before ever calling
|
|
316
|
+
* {@link forkFlag} -- never assume support. */
|
|
317
|
+
supportsFork?(): boolean;
|
|
318
|
+
/** Builds the CLI flag(s) for a fork-mode dispatch: seeds context from
|
|
319
|
+
* `sourceSessionId`'s transcript but yields a NEW session id distinct from
|
|
320
|
+
* the source (the source session itself is left untouched). `newSessionId`
|
|
321
|
+
* is the caller-minted id the forked session should be created under --
|
|
322
|
+
* passed explicitly (e.g. as `--session-id`) rather than left for the CLI
|
|
323
|
+
* to mint and scrape back out of the response afterward. Only called
|
|
324
|
+
* when `supportsFork()` returns true. For providers whose CLI cannot
|
|
325
|
+
* express "new id, seeded from an existing transcript" (i.e. mints a new
|
|
326
|
+
* session id NOT derived from source context, same as a fresh dispatch),
|
|
327
|
+
* omit both this and {@link supportsFork} rather than faking support. */
|
|
328
|
+
forkFlag?(sourceSessionId: string, newSessionId: string): string;
|
|
329
|
+
/** Builds the CLI flag that makes a folder the dispatched session's WORKSPACE,
|
|
330
|
+
* for providers whose CLI does not adopt the process working directory as
|
|
331
|
+
* its workspace (AGY: `--add-dir <folder>`). Optional -- omit it for any
|
|
332
|
+
* provider where `cd <folder>` already establishes the workspace (claude,
|
|
333
|
+
* codex, copilot, opencode), and callers MUST treat a missing
|
|
334
|
+
* implementation as "nothing to add" rather than assuming a default flag.
|
|
335
|
+
* @param escapedFolder the work folder ALREADY escaped for the caller's own
|
|
336
|
+
* target shell (same contract as {@link modelFlag}) -- a POSIX caller
|
|
337
|
+
* passes escapeDoubleQuoted(folder), a Windows caller escapeWindowsArg(folder).
|
|
338
|
+
* Escaping cannot be done here: this method does not know the member's shell,
|
|
339
|
+
* and escapeDoubleQuoted would mangle the backslashes in a Windows path. */
|
|
340
|
+
workspaceDirFlag?(escapedFolder: string): string | null;
|
|
341
|
+
/** Builds the CLI flag that binds the run to the member's provider project
|
|
342
|
+
* (AGY: `--project <id>`), whose permission grants are the member's own.
|
|
343
|
+
* Optional -- omit it for providers with no project binding. An
|
|
344
|
+
* implementation must throw for a missing id rather than return '', so a
|
|
345
|
+
* dispatch can never silently run under a shared default project. */
|
|
346
|
+
projectFlag?(projectId?: string): string;
|
|
152
347
|
/** Resolves the session transcript log path for a given session ID, AS IT EXISTS
|
|
153
348
|
* ON THE MEMBER'S MACHINE.
|
|
154
349
|
* @param homeDir The MEMBER's home directory. `undefined` falls back to this
|
|
@@ -177,16 +372,19 @@ export interface ProviderAdapter {
|
|
|
177
372
|
* Default: passthrough (return content unchanged). */
|
|
178
373
|
transformAgent(content: string, relPath: string): string;
|
|
179
374
|
/** Returns the CLI flag/prefix for activating a named agent.
|
|
180
|
-
* Claude/AGY: '--agent "name"'.
|
|
375
|
+
* Claude/AGY: '--agent "name"'. Others: ''. */
|
|
181
376
|
agentNameFlag(agentName: string): string;
|
|
182
377
|
classifyError(output: string): PromptErrorCategory;
|
|
183
|
-
/**
|
|
378
|
+
/** Optional hook called during compose_permissions before config delivery; returns
|
|
379
|
+
* warnings to surface in the tool result (e.g. AGY's global-skills check). */
|
|
380
|
+
preparePermissionsDelivery?(agent: import('../types.js').Agent, execCommand: WorkspaceTrustExecFn, memberHomeDir?: string | null, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell): Promise<string[] | void>;
|
|
381
|
+
/** Returns the config file path(s) for this provider's permission config (relative to repo root or home-anchored).
|
|
184
382
|
* Parallel to the array returned by composePermissionConfig(). */
|
|
185
|
-
permissionConfigPaths(): string[];
|
|
383
|
+
permissionConfigPaths(agent?: import('../types.js').Agent): string[];
|
|
186
384
|
/** Returns provider-native permission config for the given role.
|
|
187
385
|
* Each element corresponds to the path at the same index in permissionConfigPaths().
|
|
188
386
|
* JSON providers return Record<string, unknown>; TOML providers return a string. */
|
|
189
|
-
composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[]): Array<Record<string, unknown> | string>;
|
|
387
|
+
composePermissionConfig(role: 'doer' | 'reviewer', allow?: string[], agent?: import('../types.js').Agent, opts?: ComposePermissionOptions): Array<Record<string, unknown> | string>;
|
|
190
388
|
supportsOAuthCopy(): boolean;
|
|
191
389
|
supportsApiKey(): boolean;
|
|
192
390
|
oauthCredentialFiles(): Array<{
|
|
@@ -202,7 +400,7 @@ export interface ProviderAdapter {
|
|
|
202
400
|
/** JSON output flag for the CLI (e.g. --output-format json, --json, --format json) */
|
|
203
401
|
jsonOutputFlag(): string;
|
|
204
402
|
/** Args for headless invocation with a safe literal prompt string.
|
|
205
|
-
* Returns e.g. `-p "LITERAL"` for Claude/
|
|
403
|
+
* Returns e.g. `-p "LITERAL"` for Claude/AGY/Copilot or `exec "LITERAL"` for Codex. */
|
|
206
404
|
headlessInvocation(promptLiteral: string): string;
|
|
207
405
|
/** Register (or update) this member's apra-fleet MCP endpoint using the provider's own
|
|
208
406
|
* native mechanism (CLI verb, e.g. Claude's `claude mcp add`; or config-file merge, e.g.
|
|
@@ -234,7 +432,13 @@ export interface ProviderAdapter {
|
|
|
234
432
|
* `execCommand` is the delivery channel (same one compose_permissions' deliverConfigFile
|
|
235
433
|
* uses), so this works uniformly for local and remote (SSH) members. Non-Claude
|
|
236
434
|
* providers no-op -- see each implementation's rationale comment (apra-fleet-eft.40
|
|
237
|
-
* provider trust matrix). Callers should log distinctly on `seeded: true` vs `false`.
|
|
238
|
-
|
|
435
|
+
* provider trust matrix). Callers should log distinctly on `seeded: true` vs `false`.
|
|
436
|
+
* `shell` is the member's REGISTERED shell and is only meaningful when `agentOs` is
|
|
437
|
+
* 'windows': a member registered as Git-for-Windows bash needs POSIX command strings,
|
|
438
|
+
* because the PowerShell ones are handed straight to bash.exe and fail (apra-fleet-7dir.2.8).
|
|
439
|
+
* `transport.writeHomeFile`, when present, delivers the merged file without a shell
|
|
440
|
+
* command line (node:fs / SFTP) so a large ~/.claude.json cannot overflow the Windows
|
|
441
|
+
* CreateProcess limit (GitHub #499); without it the adapter chunks the write on Windows. */
|
|
442
|
+
ensureWorkspaceTrusted(workFolder: string, execCommand: WorkspaceTrustExecFn, agentOs?: 'linux' | 'macos' | 'windows', shell?: MemberShell, transport?: WorkspaceTrustTransport, memberHomeDir?: string | null): Promise<EnsureWorkspaceTrustedResult>;
|
|
239
443
|
}
|
|
240
444
|
//# sourceMappingURL=provider.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;
|
|
1
|
+
{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
|
|
@@ -8,7 +8,7 @@ import { sanitizeSessionId } from '../os/os-commands.js';
|
|
|
8
8
|
* Providers previously built member-side log paths with the default `path`
|
|
9
9
|
* module, so a Windows hub produced backslash-joined paths for a Linux member
|
|
10
10
|
* (and vice versa) -- a path that can never exist on the member, which silently
|
|
11
|
-
* disables stall detection (Claude
|
|
11
|
+
* disables stall detection (Claude) or manufactures a false-positive
|
|
12
12
|
* stall kill (AGY/OpenCode).
|
|
13
13
|
*
|
|
14
14
|
* `targetOs === undefined` deliberately keeps the legacy host-convention
|
|
@@ -45,7 +45,7 @@ export function encodeClaudeProjectDir(workFolder) {
|
|
|
45
45
|
}
|
|
46
46
|
/**
|
|
47
47
|
* Build a `--resume <id>` flag with session ID sanitization and quoting.
|
|
48
|
-
* Shared by providers that pass session IDs on the command line (Claude
|
|
48
|
+
* Shared by providers that pass session IDs on the command line (Claude).
|
|
49
49
|
* @param sessionId - The raw session ID (will be sanitized)
|
|
50
50
|
* @param fallback - Value to return when sessionId is absent (default: '')
|
|
51
51
|
*/
|
|
@@ -62,6 +62,62 @@ export function buildResumeFlag(sessionId, fallback = '') {
|
|
|
62
62
|
export function buildSessionIdFlag(sessionId) {
|
|
63
63
|
return `--session-id "${sanitizeSessionId(sessionId)}"`;
|
|
64
64
|
}
|
|
65
|
+
/**
|
|
66
|
+
* Build a fork-mode resume flag: seed context from `sourceSessionId`'s transcript
|
|
67
|
+
* but yield a NEW, distinct session id rather than continuing the source id in
|
|
68
|
+
* place (contrast with {@link buildResumeFlag}, which resumes the source id
|
|
69
|
+
* unchanged). Shared by providers whose CLI supports resuming into a forked
|
|
70
|
+
* session id (Claude's `--fork-session`, used together with `--resume`).
|
|
71
|
+
*
|
|
72
|
+
* The forked session id is pre-minted by the caller and passed explicitly via
|
|
73
|
+
* `--session-id` alongside `--resume ... --fork-session`, rather than letting
|
|
74
|
+
* the CLI mint its own id and scraping it out of the response afterward -- the
|
|
75
|
+
* CLI honors a caller-supplied `--session-id` even in fork mode.
|
|
76
|
+
* @param sourceSessionId - The session ID to seed/fork from (will be sanitized)
|
|
77
|
+
* @param newSessionId - The caller-minted id the forked session should be created under (will be sanitized)
|
|
78
|
+
* @param fallback - Value to return when sourceSessionId is absent (default: '')
|
|
79
|
+
*/
|
|
80
|
+
export function buildForkFlag(sourceSessionId, newSessionId, fallback = '') {
|
|
81
|
+
if (sourceSessionId) {
|
|
82
|
+
const sessionIdPart = newSessionId ? `--session-id "${sanitizeSessionId(newSessionId)}" ` : '';
|
|
83
|
+
return `${sessionIdPart}--resume "${sanitizeSessionId(sourceSessionId)}" --fork-session`;
|
|
84
|
+
}
|
|
85
|
+
return fallback;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* apra-fleet-hzeb.1: THE provider-adapter default resume window for a guessed
|
|
89
|
+
* usage-limit signal (1 hour). This is the single source of truth for the guess --
|
|
90
|
+
* fleet-sprint and other consumers must read the signal's `resumeAt`, never
|
|
91
|
+
* hardcode their own 1h fallback.
|
|
92
|
+
*/
|
|
93
|
+
export const DEFAULT_USAGE_LIMIT_RESUME_MS = 60 * 60 * 1000;
|
|
94
|
+
/**
|
|
95
|
+
* apra-fleet-hzeb.1: build a guessed usage-limit signal whose `resumeAt` is
|
|
96
|
+
* `now + DEFAULT_USAGE_LIMIT_RESUME_MS`. `now` is injectable for deterministic
|
|
97
|
+
* tests.
|
|
98
|
+
*/
|
|
99
|
+
export function guessedUsageLimitSignal(message, now = Date.now()) {
|
|
100
|
+
return {
|
|
101
|
+
type: 'usage_limit',
|
|
102
|
+
resumeAt: new Date(now + DEFAULT_USAGE_LIMIT_RESUME_MS).toISOString(),
|
|
103
|
+
resumeAtSource: 'guessed',
|
|
104
|
+
message,
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* apra-fleet-hzeb.1: generic quota/usage-limit detector shared by the
|
|
109
|
+
* non-Claude adapters. Matches the durable "you are out of quota" signatures
|
|
110
|
+
* (a bare 429, "rate limit", "quota exceeded", "usage limit", "credit limit",
|
|
111
|
+
* "resource_exhausted") and returns a GUESSED signal. Transient overload
|
|
112
|
+
* (529 / "overloaded") deliberately does NOT match here -- that stays a
|
|
113
|
+
* retryable overload, not a usage limit.
|
|
114
|
+
*/
|
|
115
|
+
const USAGE_LIMIT_QUOTA_RE = /\b429\b|rate limit|quota exceeded|usage limit|credit limit|resource_exhausted/i;
|
|
116
|
+
export function defaultUsageLimitSignal(output, now = Date.now()) {
|
|
117
|
+
if (!output || !USAGE_LIMIT_QUOTA_RE.test(output))
|
|
118
|
+
return null;
|
|
119
|
+
return guessedUsageLimitSignal(output, now);
|
|
120
|
+
}
|
|
65
121
|
// apra-fleet-iuc.1 / apra-fleet-ekm: single source of truth for classifying a
|
|
66
122
|
// parsed response as turn-limit terminated. The claude provider normalizes
|
|
67
123
|
// terminalReason to 'max_turns' when the transcript carried the signal via any
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"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"}
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import { createHash } from 'node:crypto';
|
|
12
12
|
import { getOsCommands } from '../os/index.js';
|
|
13
|
-
import { getAgentOS } from '../utils/agent-helpers.js';
|
|
13
|
+
import { getAgentOS, getAgentShell } from '../utils/agent-helpers.js';
|
|
14
14
|
import { getStrategy } from './strategy.js';
|
|
15
15
|
import { uploadContentToHome } from './sftp.js';
|
|
16
16
|
import { loadAgentAssets } from '../cli/install.js';
|
|
@@ -53,7 +53,7 @@ const HASH_LINE_RE = /^([0-9a-fA-F]{64})\s+\*?(.+)$/;
|
|
|
53
53
|
* successful probe that yields an empty map.
|
|
54
54
|
*/
|
|
55
55
|
export async function probeRemoteAgentHashes(agent, dir) {
|
|
56
|
-
const cmds = getOsCommands(getAgentOS(agent));
|
|
56
|
+
const cmds = getOsCommands(getAgentOS(agent), getAgentShell(agent));
|
|
57
57
|
const strategy = getStrategy(agent);
|
|
58
58
|
let result;
|
|
59
59
|
try {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-provisioner.js","sourceRoot":"","sources":["../../src/services/agent-provisioner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;
|
|
1
|
+
{"version":3,"file":"agent-provisioner.js","sourceRoot":"","sources":["../../src/services/agent-provisioner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import type { Agent, SSHExecResult } from '../types.js';
|
|
2
|
+
export type AgyExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
|
|
3
|
+
/** Raised when an agy project cannot be created or verified. */
|
|
4
|
+
export declare class AgyProjectError extends Error {
|
|
5
|
+
constructor(message: string);
|
|
6
|
+
}
|
|
7
|
+
export declare function isValidAgyProjectId(id: unknown): id is string;
|
|
8
|
+
/** The prompt of the one model turn `agy --new-project` needs. It asks for no
|
|
9
|
+
* tool use: the id is read from the new project file and agy's own log, never
|
|
10
|
+
* from the model (the model does not know it -- see docs/agy-provider.md section 1). */
|
|
11
|
+
export declare const AGY_NEW_PROJECT_PROMPT = "Reply with only the word OK. Do not use any tools.";
|
|
12
|
+
export declare function buildAgyProjectProbeScript(projectId: string, home?: string | null): string;
|
|
13
|
+
export interface NewProjectScriptOptions {
|
|
14
|
+
workFolder: string;
|
|
15
|
+
model: string;
|
|
16
|
+
home?: string | null;
|
|
17
|
+
/** Extra environment for the agy process (the member's stored auth env vars). */
|
|
18
|
+
env?: Record<string, string>;
|
|
19
|
+
/** Test seam: run this executable (plus leading args) instead of `agy`. */
|
|
20
|
+
agyCommand?: {
|
|
21
|
+
file: string;
|
|
22
|
+
args: string[];
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Member-side node script: list ~/.gemini/config/projects, run
|
|
27
|
+
* `agy --new-project` (spawned directly, no shell) in the work folder with a
|
|
28
|
+
* --log-file, list again, and report the new file names plus the ids agy
|
|
29
|
+
* logged as `created project "<name>" (id=<id>)`. The log file is deleted and
|
|
30
|
+
* its content is never echoed (it carries the account e-mail).
|
|
31
|
+
*/
|
|
32
|
+
export declare function buildAgyNewProjectScript(opts: NewProjectScriptOptions): string;
|
|
33
|
+
/**
|
|
34
|
+
* Member-side script for remove_member's best-effort cleanup: deletes the
|
|
35
|
+
* member's own `<projectId>.json` plus, if present, the legacy
|
|
36
|
+
* `fleet-<memberId>.json` from an earlier design (older fleet versions), from ~/.gemini/config/projects only. A missing
|
|
37
|
+
* target is not an error (fs.rm's force:true); any other failure (e.g.
|
|
38
|
+
* permission denied) is reported back per target so the caller can decide
|
|
39
|
+
* whether it is warning-worthy.
|
|
40
|
+
*/
|
|
41
|
+
export declare function buildAgyProjectDeleteScript(projectId: string, memberId: string, home?: string | null): string;
|
|
42
|
+
export interface AgyProjectDeleteResult {
|
|
43
|
+
deleted: string[];
|
|
44
|
+
errors: string[];
|
|
45
|
+
}
|
|
46
|
+
export declare function parseAgyProjectDeleteResult(result: SSHExecResult): AgyProjectDeleteResult;
|
|
47
|
+
export type AgyProjectState = 'ok' | 'missing' | 'corrupt' | 'id_mismatch';
|
|
48
|
+
export declare function parseAgyProjectProbe(result: SSHExecResult): AgyProjectState;
|
|
49
|
+
/**
|
|
50
|
+
* Validates the output of the new-project script: exactly one new
|
|
51
|
+
* `<uuid>.json` must have appeared, and agy's own log must name the same id.
|
|
52
|
+
* Anything else throws with the evidence.
|
|
53
|
+
*/
|
|
54
|
+
export declare function parseAgyNewProjectResult(result: SSHExecResult): string;
|
|
55
|
+
export declare function probeAgyProject(agent: Agent, projectId: string, exec?: AgyExecFn): Promise<AgyProjectState>;
|
|
56
|
+
/**
|
|
57
|
+
* remove_member's best-effort cleanup: deletes the member's own agy project
|
|
58
|
+
* file (and a legacy fleet-<id>.json, if present) from its machine. Callers
|
|
59
|
+
* must skip this entirely when another registered member shares the same
|
|
60
|
+
* agyProjectId, and must treat any thrown AgyProjectError as a warning, not a
|
|
61
|
+
* reason to abort the removal.
|
|
62
|
+
*/
|
|
63
|
+
export declare function removeAgyProject(agent: Agent, exec?: AgyExecFn): Promise<AgyProjectDeleteResult>;
|
|
64
|
+
/** Test seam: run a stand-in executable instead of the real `agy` on the
|
|
65
|
+
* member (undefined restores the default). */
|
|
66
|
+
export declare function setAgyCommandForTests(cmd: {
|
|
67
|
+
file: string;
|
|
68
|
+
args: string[];
|
|
69
|
+
} | undefined): void;
|
|
70
|
+
/** Creates a new agy project for the member and returns its id. Does not
|
|
71
|
+
* persist it -- see ensureAgyProject. */
|
|
72
|
+
export declare function provisionAgyProject(agent: Agent, exec?: AgyExecFn, agyCommand?: {
|
|
73
|
+
file: string;
|
|
74
|
+
args: string[];
|
|
75
|
+
} | undefined): Promise<string>;
|
|
76
|
+
export interface EnsureAgyProjectResult {
|
|
77
|
+
projectId: string;
|
|
78
|
+
/** Set when a project was created by this call, with the reason. */
|
|
79
|
+
provisioned?: 'no_project_id' | 'missing' | 'corrupt' | 'id_mismatch' | 'invalid_project_id';
|
|
80
|
+
}
|
|
81
|
+
export interface EnsureAgyProjectOptions {
|
|
82
|
+
exec?: AgyExecFn;
|
|
83
|
+
/** Write a newly created id to the registry (default true). register_member
|
|
84
|
+
* passes false because the member is not in the registry yet. */
|
|
85
|
+
persist?: boolean;
|
|
86
|
+
/** Test seam, forwarded to provisionAgyProject. */
|
|
87
|
+
agyCommand?: {
|
|
88
|
+
file: string;
|
|
89
|
+
args: string[];
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Returns a verified project id for an agy member, creating the project when
|
|
94
|
+
* the member has none (upgrade path for members registered before project
|
|
95
|
+
* binding) or when its project file is missing, unparseable or names a
|
|
96
|
+
* different id. Sets `agent.agyProjectId` on the passed object and, unless
|
|
97
|
+
* persist is false, in the registry. Throws AgyProjectError on failure --
|
|
98
|
+
* callers must treat that as a hard error, never fall back to running agy
|
|
99
|
+
* without --project.
|
|
100
|
+
*/
|
|
101
|
+
export declare function ensureAgyProject(agent: Agent, options?: EnsureAgyProjectOptions): Promise<EnsureAgyProjectResult>;
|
|
102
|
+
//# sourceMappingURL=agy-project.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agy-project.d.ts","sourceRoot":"","sources":["../../src/services/agy-project.ts"],"names":[],"mappings":"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"}
|