@stigmer/cli 0.1.0-dev.20261017064309.g94d062a29f89 → 0.1.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 +5 -4
- package/auth/auth0.js +1 -1
- package/auth/auth0.js.map +1 -1
- package/auth/token.d.ts +26 -4
- package/auth/token.d.ts.map +1 -1
- package/auth/token.js +120 -24
- package/auth/token.js.map +1 -1
- package/client/client.d.ts.map +1 -1
- package/client/client.js +21 -8
- package/client/client.js.map +1 -1
- package/command-tree.d.ts +63 -0
- package/command-tree.d.ts.map +1 -0
- package/command-tree.js +128 -0
- package/command-tree.js.map +1 -0
- package/commands/access-history/index.d.ts.map +1 -1
- package/commands/access-history/index.js +13 -1
- package/commands/access-history/index.js.map +1 -1
- package/commands/agent-exec-flags.d.ts +2 -0
- package/commands/agent-exec-flags.d.ts.map +1 -1
- package/commands/agent-exec-flags.js +9 -5
- package/commands/agent-exec-flags.js.map +1 -1
- package/commands/apikey/duration.d.ts.map +1 -1
- package/commands/apikey/duration.js +1 -2
- package/commands/apikey/duration.js.map +1 -1
- package/commands/apikey/index.d.ts.map +1 -1
- package/commands/apikey/index.js +3 -4
- package/commands/apikey/index.js.map +1 -1
- package/commands/apply.d.ts.map +1 -1
- package/commands/apply.js +2 -32
- package/commands/apply.js.map +1 -1
- package/commands/auth/index.d.ts.map +1 -1
- package/commands/auth/index.js +7 -5
- package/commands/auth/index.js.map +1 -1
- package/commands/auth/whoami.js +1 -1
- package/commands/config/index.js +3 -3
- package/commands/config/kv.d.ts.map +1 -1
- package/commands/config/kv.js +18 -14
- package/commands/config/kv.js.map +1 -1
- package/commands/connect.d.ts.map +1 -1
- package/commands/connect.js +18 -2
- package/commands/connect.js.map +1 -1
- package/commands/download.d.ts.map +1 -1
- package/commands/download.js +81 -54
- package/commands/download.js.map +1 -1
- package/commands/eval.d.ts.map +1 -1
- package/commands/eval.js +17 -19
- package/commands/eval.js.map +1 -1
- package/commands/file.d.ts +3 -0
- package/commands/file.d.ts.map +1 -0
- package/commands/file.js +64 -0
- package/commands/file.js.map +1 -0
- package/commands/get.d.ts.map +1 -1
- package/commands/get.js +20 -13
- package/commands/get.js.map +1 -1
- package/commands/help.d.ts +15 -0
- package/commands/help.d.ts.map +1 -0
- package/commands/help.js +175 -0
- package/commands/help.js.map +1 -0
- package/commands/internal-daemon.d.ts.map +1 -1
- package/commands/internal-daemon.js +9 -2
- package/commands/internal-daemon.js.map +1 -1
- package/commands/list.d.ts.map +1 -1
- package/commands/list.js +22 -1
- package/commands/list.js.map +1 -1
- package/commands/logs.js +1 -1
- package/commands/logs.js.map +1 -1
- package/commands/mcp-server.d.ts +16 -6
- package/commands/mcp-server.d.ts.map +1 -1
- package/commands/mcp-server.js +51 -26
- package/commands/mcp-server.js.map +1 -1
- package/commands/provider-key/index.d.ts +3 -0
- package/commands/provider-key/index.d.ts.map +1 -0
- package/commands/provider-key/index.js +156 -0
- package/commands/provider-key/index.js.map +1 -0
- package/commands/push.js +8 -8
- package/commands/push.js.map +1 -1
- package/commands/resume.d.ts.map +1 -1
- package/commands/resume.js +17 -11
- package/commands/resume.js.map +1 -1
- package/commands/routine.d.ts.map +1 -1
- package/commands/routine.js +42 -3
- package/commands/routine.js.map +1 -1
- package/commands/run.d.ts.map +1 -1
- package/commands/run.js +34 -15
- package/commands/run.js.map +1 -1
- package/commands/runs/approve.d.ts.map +1 -1
- package/commands/runs/approve.js +10 -2
- package/commands/runs/approve.js.map +1 -1
- package/commands/runs/control.d.ts.map +1 -1
- package/commands/runs/control.js +24 -16
- package/commands/runs/control.js.map +1 -1
- package/commands/runs/index.d.ts.map +1 -1
- package/commands/runs/index.js +1 -2
- package/commands/runs/index.js.map +1 -1
- package/commands/runs/logs.d.ts.map +1 -1
- package/commands/runs/logs.js +7 -4
- package/commands/runs/logs.js.map +1 -1
- package/commands/runs/to-eval-case.d.ts.map +1 -1
- package/commands/runs/to-eval-case.js +13 -4
- package/commands/runs/to-eval-case.js.map +1 -1
- package/commands/runs/trace.js +1 -1
- package/commands/runs/trace.js.map +1 -1
- package/commands/search.js +2 -3
- package/commands/search.js.map +1 -1
- package/commands/service-account/index.d.ts.map +1 -1
- package/commands/service-account/index.js +4 -2
- package/commands/service-account/index.js.map +1 -1
- package/commands/session-help.d.ts +5 -0
- package/commands/session-help.d.ts.map +1 -0
- package/commands/session-help.js +38 -0
- package/commands/session-help.js.map +1 -0
- package/commands/setup.js +5 -5
- package/commands/setup.js.map +1 -1
- package/commands/shared.d.ts +10 -2
- package/commands/shared.d.ts.map +1 -1
- package/commands/shared.js +30 -3
- package/commands/shared.js.map +1 -1
- package/commands/tag.d.ts.map +1 -1
- package/commands/tag.js +11 -6
- package/commands/tag.js.map +1 -1
- package/commands/up.d.ts.map +1 -1
- package/commands/up.js +51 -21
- package/commands/up.js.map +1 -1
- package/commands/validate.js +2 -2
- package/commands/validate.js.map +1 -1
- package/commands/version.d.ts.map +1 -1
- package/commands/version.js +8 -4
- package/commands/version.js.map +1 -1
- package/config/config.d.ts +5 -22
- package/config/config.d.ts.map +1 -1
- package/config/config.js +56 -47
- package/config/config.js.map +1 -1
- package/config/index.d.ts +2 -2
- package/config/index.d.ts.map +1 -1
- package/config/index.js +1 -1
- package/config/index.js.map +1 -1
- package/config/keys.js +4 -4
- package/config/keys.js.map +1 -1
- package/config/paths.js +2 -2
- package/config/paths.js.map +1 -1
- package/config/resolve.d.ts +12 -2
- package/config/resolve.d.ts.map +1 -1
- package/config/resolve.js +18 -8
- package/config/resolve.js.map +1 -1
- package/errors/classify.d.ts +20 -0
- package/errors/classify.d.ts.map +1 -1
- package/errors/classify.js +97 -21
- package/errors/classify.js.map +1 -1
- package/errors/command-line.d.ts +14 -0
- package/errors/command-line.d.ts.map +1 -0
- package/errors/command-line.js +90 -0
- package/errors/command-line.js.map +1 -0
- package/errors/handle.js +2 -2
- package/errors/handle.js.map +1 -1
- package/errors/index.d.ts +2 -2
- package/errors/index.d.ts.map +1 -1
- package/errors/index.js +12 -2
- package/errors/index.js.map +1 -1
- package/errors/usage-error.js +1 -1
- package/errors/usage-error.js.map +1 -1
- package/global-options.d.ts +35 -0
- package/global-options.d.ts.map +1 -0
- package/global-options.js +81 -0
- package/global-options.js.map +1 -0
- package/local/artifact.d.ts +1 -20
- package/local/artifact.d.ts.map +1 -1
- package/local/artifact.js +35 -117
- package/local/artifact.js.map +1 -1
- package/local/constants.d.ts +3 -9
- package/local/constants.d.ts.map +1 -1
- package/local/constants.js +3 -9
- package/local/constants.js.map +1 -1
- package/local/daemon/components.d.ts +18 -5
- package/local/daemon/components.d.ts.map +1 -1
- package/local/daemon/components.js +61 -23
- package/local/daemon/components.js.map +1 -1
- package/local/daemon/env.d.ts +1 -5
- package/local/daemon/env.d.ts.map +1 -1
- package/local/daemon/env.js +0 -2
- package/local/daemon/env.js.map +1 -1
- package/local/daemon/host.d.ts +5 -0
- package/local/daemon/host.d.ts.map +1 -1
- package/local/daemon/host.js +68 -21
- package/local/daemon/host.js.map +1 -1
- package/local/daemon/index.d.ts +2 -1
- package/local/daemon/index.d.ts.map +1 -1
- package/local/daemon/index.js +2 -1
- package/local/daemon/index.js.map +1 -1
- package/local/daemon/launch.d.ts +58 -9
- package/local/daemon/launch.d.ts.map +1 -1
- package/local/daemon/launch.js +210 -64
- package/local/daemon/launch.js.map +1 -1
- package/local/daemon/process.d.ts +11 -7
- package/local/daemon/process.d.ts.map +1 -1
- package/local/daemon/process.js +74 -38
- package/local/daemon/process.js.map +1 -1
- package/local/daemon/signals.d.ts +3 -0
- package/local/daemon/signals.d.ts.map +1 -0
- package/local/daemon/signals.js +19 -0
- package/local/daemon/signals.js.map +1 -0
- package/local/daemon/supervisor.d.ts +9 -2
- package/local/daemon/supervisor.d.ts.map +1 -1
- package/local/daemon/supervisor.js +81 -22
- package/local/daemon/supervisor.js.map +1 -1
- package/local/daemon/types.d.ts +6 -1
- package/local/daemon/types.d.ts.map +1 -1
- package/local/daemon/types.js +2 -3
- package/local/daemon/types.js.map +1 -1
- package/local/llm-config.d.ts +4 -2
- package/local/llm-config.d.ts.map +1 -1
- package/local/llm-config.js +15 -9
- package/local/llm-config.js.map +1 -1
- package/local/logs/view.d.ts.map +1 -1
- package/local/logs/view.js +5 -6
- package/local/logs/view.js.map +1 -1
- package/local/net/tcp.d.ts +8 -6
- package/local/net/tcp.d.ts.map +1 -1
- package/local/net/tcp.js +13 -8
- package/local/net/tcp.js.map +1 -1
- package/local/paths.d.ts +1 -1
- package/local/paths.d.ts.map +1 -1
- package/local/paths.js +2 -3
- package/local/paths.js.map +1 -1
- package/local/provider-reach.d.ts +18 -0
- package/local/provider-reach.d.ts.map +1 -0
- package/local/provider-reach.js +109 -0
- package/local/provider-reach.js.map +1 -0
- package/local/reset.d.ts.map +1 -1
- package/local/reset.js +1 -2
- package/local/reset.js.map +1 -1
- package/local/runtime/index.d.ts.map +1 -1
- package/local/runtime/index.js +1 -2
- package/local/runtime/index.js.map +1 -1
- package/local/runtime/node.js +1 -1
- package/local/runtime/runner.js +2 -2
- package/local/runtime/runner.js.map +1 -1
- package/local/runtime/runtimes-install.js +1 -1
- package/local/runtime/server.d.ts.map +1 -1
- package/local/runtime/server.js +2 -4
- package/local/runtime/server.js.map +1 -1
- package/local/runtime/which.js +1 -1
- package/local/runtime/which.js.map +1 -1
- package/local/setup/wizard.d.ts +1 -1
- package/local/setup/wizard.d.ts.map +1 -1
- package/local/setup/wizard.js +7 -5
- package/local/setup/wizard.js.map +1 -1
- package/local/state/health-state.d.ts +6 -0
- package/local/state/health-state.d.ts.map +1 -1
- package/local/state/health-state.js +6 -2
- package/local/state/health-state.js.map +1 -1
- package/local/state/lock.d.ts +3 -2
- package/local/state/lock.d.ts.map +1 -1
- package/local/state/lock.js +26 -28
- package/local/state/lock.js.map +1 -1
- package/local/state/log-rotation.d.ts.map +1 -1
- package/local/state/log-rotation.js +2 -3
- package/local/state/log-rotation.js.map +1 -1
- package/local/state/pidfile.d.ts +24 -1
- package/local/state/pidfile.d.ts.map +1 -1
- package/local/state/pidfile.js +54 -6
- package/local/state/pidfile.js.map +1 -1
- package/local/state/proc.d.ts +31 -0
- package/local/state/proc.d.ts.map +1 -1
- package/local/state/proc.js +98 -1
- package/local/state/proc.js.map +1 -1
- package/local/state/startup-config.d.ts +2 -2
- package/local/status.d.ts +2 -4
- package/local/status.d.ts.map +1 -1
- package/local/status.js +26 -41
- package/local/status.js.map +1 -1
- package/local/temporal/download.d.ts +9 -5
- package/local/temporal/download.d.ts.map +1 -1
- package/local/temporal/download.js +29 -8
- package/local/temporal/download.js.map +1 -1
- package/local/temporal/index.d.ts +1 -1
- package/local/temporal/index.d.ts.map +1 -1
- package/local/temporal/index.js +1 -1
- package/local/temporal/index.js.map +1 -1
- package/local/temporal/manager.d.ts +31 -5
- package/local/temporal/manager.d.ts.map +1 -1
- package/local/temporal/manager.js +74 -35
- package/local/temporal/manager.js.map +1 -1
- package/local/temporal/supervisor.js +1 -1
- package/local/temporal/supervisor.js.map +1 -1
- package/local/webconsole/index.d.ts +5 -2
- package/local/webconsole/index.d.ts.map +1 -1
- package/local/webconsole/index.js +8 -6
- package/local/webconsole/index.js.map +1 -1
- package/marketplace/github.js +1 -1
- package/marketplace/github.js.map +1 -1
- package/marketplace/official.js +1 -1
- package/marketplace/official.js.map +1 -1
- package/output/command-result.d.ts +6 -0
- package/output/command-result.d.ts.map +1 -1
- package/output/command-result.js +13 -2
- package/output/command-result.js.map +1 -1
- package/output/confirm.d.ts.map +1 -1
- package/output/confirm.js +2 -3
- package/output/confirm.js.map +1 -1
- package/output/format.d.ts.map +1 -1
- package/output/format.js +5 -6
- package/output/format.js.map +1 -1
- package/output/index.d.ts +2 -2
- package/output/index.d.ts.map +1 -1
- package/output/index.js +2 -2
- package/output/index.js.map +1 -1
- package/output/printable.d.ts +8 -0
- package/output/printable.d.ts.map +1 -0
- package/output/printable.js +24 -0
- package/output/printable.js.map +1 -0
- package/output/proto.d.ts.map +1 -1
- package/output/proto.js +3 -4
- package/output/proto.js.map +1 -1
- package/output/style.js +2 -2
- package/output/style.js.map +1 -1
- package/output/table.d.ts +20 -1
- package/output/table.d.ts.map +1 -1
- package/output/table.js +75 -17
- package/output/table.js.map +1 -1
- package/package.json +13 -10
- package/program.d.ts +0 -14
- package/program.d.ts.map +1 -1
- package/program.js +57 -119
- package/program.js.map +1 -1
- package/registry/aliases.d.ts.map +1 -1
- package/registry/aliases.js +0 -3
- package/registry/aliases.js.map +1 -1
- package/registry/index.d.ts +1 -1
- package/registry/index.d.ts.map +1 -1
- package/registry/index.js +1 -1
- package/registry/index.js.map +1 -1
- package/registry/metadata.d.ts +0 -15
- package/registry/metadata.d.ts.map +1 -1
- package/registry/metadata.js +16 -57
- package/registry/metadata.js.map +1 -1
- package/registry/registry.d.ts +1 -5
- package/registry/registry.d.ts.map +1 -1
- package/registry/registry.js +3 -11
- package/registry/registry.js.map +1 -1
- package/registry/verb-support.d.ts.map +1 -1
- package/registry/verb-support.js +28 -5
- package/registry/verb-support.js.map +1 -1
- package/resources/agent/quality.d.ts +10 -5
- package/resources/agent/quality.d.ts.map +1 -1
- package/resources/agent/quality.js +19 -9
- package/resources/agent/quality.js.map +1 -1
- package/resources/agent/resolve.js +3 -3
- package/resources/agent/resolve.js.map +1 -1
- package/resources/apply/apply.d.ts +4 -3
- package/resources/apply/apply.d.ts.map +1 -1
- package/resources/apply/apply.js +54 -41
- package/resources/apply/apply.js.map +1 -1
- package/resources/apply/handlers.d.ts.map +1 -1
- package/resources/apply/handlers.js +3 -4
- package/resources/apply/handlers.js.map +1 -1
- package/resources/channel.d.ts.map +1 -1
- package/resources/channel.js +3 -4
- package/resources/channel.js.map +1 -1
- package/resources/connect/connect.js +2 -2
- package/resources/connect/connect.js.map +1 -1
- package/resources/delete.d.ts.map +1 -1
- package/resources/delete.js +38 -4
- package/resources/delete.js.map +1 -1
- package/resources/documents.js +1 -1
- package/resources/documents.js.map +1 -1
- package/resources/download.d.ts +43 -3
- package/resources/download.d.ts.map +1 -1
- package/resources/download.js +169 -34
- package/resources/download.js.map +1 -1
- package/resources/eval-run/options.d.ts +3 -1
- package/resources/eval-run/options.d.ts.map +1 -1
- package/resources/eval-run/options.js +36 -18
- package/resources/eval-run/options.js.map +1 -1
- package/resources/eval-run/report.d.ts +4 -2
- package/resources/eval-run/report.d.ts.map +1 -1
- package/resources/eval-run/report.js +9 -7
- package/resources/eval-run/report.js.map +1 -1
- package/resources/eval-run/run.d.ts +2 -1
- package/resources/eval-run/run.d.ts.map +1 -1
- package/resources/eval-run/run.js +13 -7
- package/resources/eval-run/run.js.map +1 -1
- package/resources/file.d.ts +27 -0
- package/resources/file.d.ts.map +1 -0
- package/resources/file.js +82 -0
- package/resources/file.js.map +1 -0
- package/resources/get-bindings.d.ts.map +1 -1
- package/resources/get-bindings.js +18 -0
- package/resources/get-bindings.js.map +1 -1
- package/resources/git.d.ts +1 -1
- package/resources/git.js +1 -1
- package/resources/list.d.ts +21 -2
- package/resources/list.d.ts.map +1 -1
- package/resources/list.js +148 -31
- package/resources/list.js.map +1 -1
- package/resources/plugin.d.ts.map +1 -1
- package/resources/plugin.js +4 -0
- package/resources/plugin.js.map +1 -1
- package/resources/provider-key.d.ts +81 -0
- package/resources/provider-key.d.ts.map +1 -0
- package/resources/provider-key.js +261 -0
- package/resources/provider-key.js.map +1 -0
- package/resources/reference.d.ts +15 -21
- package/resources/reference.d.ts.map +1 -1
- package/resources/reference.js +42 -88
- package/resources/reference.js.map +1 -1
- package/resources/render.d.ts +31 -7
- package/resources/render.d.ts.map +1 -1
- package/resources/render.js +66 -38
- package/resources/render.js.map +1 -1
- package/resources/routine.d.ts +21 -5
- package/resources/routine.d.ts.map +1 -1
- package/resources/routine.js +104 -15
- package/resources/routine.js.map +1 -1
- package/resources/run/agent-exec.d.ts +12 -2
- package/resources/run/agent-exec.d.ts.map +1 -1
- package/resources/run/agent-exec.js +85 -38
- package/resources/run/agent-exec.js.map +1 -1
- package/resources/run/create.d.ts +16 -12
- package/resources/run/create.d.ts.map +1 -1
- package/resources/run/create.js +14 -15
- package/resources/run/create.js.map +1 -1
- package/resources/run/engines.d.ts +32 -0
- package/resources/run/engines.d.ts.map +1 -0
- package/resources/run/engines.js +39 -0
- package/resources/run/engines.js.map +1 -0
- package/resources/run/environment.d.ts +11 -0
- package/resources/run/environment.d.ts.map +1 -0
- package/resources/run/environment.js +30 -0
- package/resources/run/environment.js.map +1 -0
- package/resources/run/epilogue.d.ts +1 -1
- package/resources/run/epilogue.d.ts.map +1 -1
- package/resources/run/epilogue.js +18 -19
- package/resources/run/epilogue.js.map +1 -1
- package/resources/run/files.d.ts +104 -0
- package/resources/run/files.d.ts.map +1 -0
- package/resources/run/files.js +316 -0
- package/resources/run/files.js.map +1 -0
- package/resources/run/header.d.ts +11 -9
- package/resources/run/header.d.ts.map +1 -1
- package/resources/run/header.js +14 -14
- package/resources/run/header.js.map +1 -1
- package/resources/run/prepare.d.ts +31 -25
- package/resources/run/prepare.d.ts.map +1 -1
- package/resources/run/prepare.js +42 -51
- package/resources/run/prepare.js.map +1 -1
- package/resources/run/references.d.ts.map +1 -1
- package/resources/run/references.js +6 -5
- package/resources/run/references.js.map +1 -1
- package/resources/run/resolve.js +1 -1
- package/resources/run/resolve.js.map +1 -1
- package/resources/run/resume.d.ts +3 -1
- package/resources/run/resume.d.ts.map +1 -1
- package/resources/run/resume.js +25 -10
- package/resources/run/resume.js.map +1 -1
- package/resources/run/stream.d.ts +34 -2
- package/resources/run/stream.d.ts.map +1 -1
- package/resources/run/stream.js +92 -8
- package/resources/run/stream.js.map +1 -1
- package/resources/run/workspace.d.ts +9 -12
- package/resources/run/workspace.d.ts.map +1 -1
- package/resources/run/workspace.js +29 -36
- package/resources/run/workspace.js.map +1 -1
- package/resources/run-approve.d.ts.map +1 -1
- package/resources/run-approve.js +2 -11
- package/resources/run-approve.js.map +1 -1
- package/resources/run-control.d.ts +3 -3
- package/resources/run-control.d.ts.map +1 -1
- package/resources/run-control.js +4 -5
- package/resources/run-control.js.map +1 -1
- package/resources/run-format.d.ts +2 -2
- package/resources/run-format.d.ts.map +1 -1
- package/resources/run-format.js +3 -4
- package/resources/run-format.js.map +1 -1
- package/resources/run-logs.d.ts +2 -0
- package/resources/run-logs.d.ts.map +1 -1
- package/resources/run-logs.js +16 -6
- package/resources/run-logs.js.map +1 -1
- package/resources/run-scores.d.ts +6 -2
- package/resources/run-scores.d.ts.map +1 -1
- package/resources/run-scores.js +7 -4
- package/resources/run-scores.js.map +1 -1
- package/resources/run-to-eval-case.js +2 -2
- package/resources/run-to-eval-case.js.map +1 -1
- package/resources/runs.d.ts +3 -3
- package/resources/runs.d.ts.map +1 -1
- package/resources/runs.js +5 -5
- package/resources/runs.js.map +1 -1
- package/resources/search.d.ts.map +1 -1
- package/resources/search.js +1 -2
- package/resources/search.js.map +1 -1
- package/resources/service-account.d.ts +2 -0
- package/resources/service-account.d.ts.map +1 -1
- package/resources/service-account.js +3 -1
- package/resources/service-account.js.map +1 -1
- package/resources/session.d.ts +4 -3
- package/resources/session.d.ts.map +1 -1
- package/resources/session.js +10 -7
- package/resources/session.js.map +1 -1
- package/resources/skill.d.ts +1 -1
- package/resources/skill.d.ts.map +1 -1
- package/resources/skill.js +7 -8
- package/resources/skill.js.map +1 -1
- package/resources/stream/answer.d.ts +1 -2
- package/resources/stream/answer.d.ts.map +1 -1
- package/resources/stream/answer.js +3 -16
- package/resources/stream/answer.js.map +1 -1
- package/resources/stream/composer.d.ts +16 -0
- package/resources/stream/composer.d.ts.map +1 -0
- package/resources/stream/composer.js +171 -0
- package/resources/stream/composer.js.map +1 -0
- package/resources/stream/ink.d.ts +20 -4
- package/resources/stream/ink.d.ts.map +1 -1
- package/resources/stream/ink.js +34 -3
- package/resources/stream/ink.js.map +1 -1
- package/resources/stream/render-plaintext.d.ts +1 -0
- package/resources/stream/render-plaintext.d.ts.map +1 -1
- package/resources/stream/render-plaintext.js +21 -4
- package/resources/stream/render-plaintext.js.map +1 -1
- package/resources/stream/tty.js +1 -1
- package/resources/stream/tty.js.map +1 -1
- package/resources/tag.d.ts.map +1 -1
- package/resources/tag.js +7 -8
- package/resources/tag.js.map +1 -1
- package/resources/usage.d.ts +3 -2
- package/resources/usage.d.ts.map +1 -1
- package/resources/usage.js +19 -16
- package/resources/usage.js.map +1 -1
- package/resources/validate.d.ts.map +1 -1
- package/resources/validate.js +1 -12
- package/resources/validate.js.map +1 -1
- package/resources/version.d.ts +17 -3
- package/resources/version.d.ts.map +1 -1
- package/resources/version.js +105 -14
- package/resources/version.js.map +1 -1
- package/resources/views/agent.d.ts +3 -0
- package/resources/views/agent.d.ts.map +1 -0
- package/resources/views/agent.js +54 -0
- package/resources/views/agent.js.map +1 -0
- package/resources/views/environment.d.ts +3 -0
- package/resources/views/environment.d.ts.map +1 -0
- package/resources/views/environment.js +37 -0
- package/resources/views/environment.js.map +1 -0
- package/resources/views/index.d.ts +22 -0
- package/resources/views/index.d.ts.map +1 -0
- package/resources/views/index.js +70 -0
- package/resources/views/index.js.map +1 -0
- package/resources/views/organization.d.ts +3 -0
- package/resources/views/organization.d.ts.map +1 -0
- package/resources/views/organization.js +27 -0
- package/resources/views/organization.js.map +1 -0
- package/resources/views/routine.d.ts +3 -0
- package/resources/views/routine.d.ts.map +1 -0
- package/resources/views/routine.js +37 -0
- package/resources/views/routine.js.map +1 -0
- package/resources/views/run.d.ts +3 -0
- package/resources/views/run.d.ts.map +1 -0
- package/resources/views/run.js +45 -0
- package/resources/views/run.js.map +1 -0
- package/resources/views/session.d.ts +5 -0
- package/resources/views/session.d.ts.map +1 -0
- package/resources/views/session.js +85 -0
- package/resources/views/session.js.map +1 -0
- package/resources/views/skill.d.ts +5 -0
- package/resources/views/skill.d.ts.map +1 -0
- package/resources/views/skill.js +48 -0
- package/resources/views/skill.js.map +1 -0
- package/resources/views/view.d.ts +66 -0
- package/resources/views/view.d.ts.map +1 -0
- package/resources/views/view.js +130 -0
- package/resources/views/view.js.map +1 -0
- package/resources/views/words.d.ts +52 -0
- package/resources/views/words.d.ts.map +1 -0
- package/resources/views/words.js +190 -0
- package/resources/views/words.js.map +1 -0
- package/runtime.d.ts +22 -0
- package/runtime.d.ts.map +1 -1
- package/runtime.js +33 -2
- package/runtime.js.map +1 -1
- package/src/auth/auth0.ts +1 -1
- package/src/auth/token.ts +136 -26
- package/src/client/client.ts +23 -16
- package/src/command-tree.ts +152 -0
- package/src/commands/access-history/index.ts +15 -2
- package/src/commands/agent-exec-flags.ts +11 -5
- package/src/commands/apikey/duration.ts +1 -2
- package/src/commands/apikey/index.ts +3 -4
- package/src/commands/apply.ts +3 -22
- package/src/commands/auth/index.ts +7 -5
- package/src/commands/auth/whoami.ts +1 -1
- package/src/commands/config/index.ts +3 -3
- package/src/commands/config/kv.ts +18 -14
- package/src/commands/connect.ts +21 -3
- package/src/commands/download.ts +106 -62
- package/src/commands/eval.ts +22 -21
- package/src/commands/file.ts +80 -0
- package/src/commands/get.ts +19 -13
- package/src/commands/help.ts +182 -0
- package/src/commands/internal-daemon.ts +9 -2
- package/src/commands/list.ts +22 -1
- package/src/commands/logs.ts +1 -1
- package/src/commands/mcp-server.ts +57 -28
- package/src/commands/provider-key/index.ts +192 -0
- package/src/commands/push.ts +8 -8
- package/src/commands/resume.ts +20 -12
- package/src/commands/routine.ts +58 -5
- package/src/commands/run.ts +37 -17
- package/src/commands/runs/approve.ts +13 -4
- package/src/commands/runs/control.ts +50 -27
- package/src/commands/runs/index.ts +1 -2
- package/src/commands/runs/logs.ts +9 -5
- package/src/commands/runs/to-eval-case.ts +18 -6
- package/src/commands/runs/trace.ts +1 -1
- package/src/commands/search.ts +2 -3
- package/src/commands/service-account/index.ts +7 -2
- package/src/commands/session-help.ts +39 -0
- package/src/commands/setup.ts +5 -5
- package/src/commands/shared.ts +32 -3
- package/src/commands/tag.ts +13 -7
- package/src/commands/up.ts +55 -21
- package/src/commands/validate.ts +2 -2
- package/src/commands/version.ts +9 -4
- package/src/config/config.ts +66 -69
- package/src/config/index.ts +1 -2
- package/src/config/keys.ts +4 -4
- package/src/config/paths.ts +2 -2
- package/src/config/resolve.ts +20 -8
- package/src/errors/classify.ts +110 -21
- package/src/errors/command-line.ts +95 -0
- package/src/errors/handle.ts +2 -2
- package/src/errors/index.ts +12 -2
- package/src/errors/usage-error.ts +1 -1
- package/src/global-options.ts +100 -0
- package/src/local/artifact.ts +46 -140
- package/src/local/constants.ts +3 -9
- package/src/local/daemon/components.ts +78 -22
- package/src/local/daemon/env.ts +3 -8
- package/src/local/daemon/host.ts +64 -19
- package/src/local/daemon/index.ts +2 -1
- package/src/local/daemon/launch.ts +251 -72
- package/src/local/daemon/process.ts +78 -46
- package/src/local/daemon/signals.ts +19 -0
- package/src/local/daemon/supervisor.ts +84 -21
- package/src/local/daemon/types.ts +8 -4
- package/src/local/llm-config.ts +15 -9
- package/src/local/logs/view.ts +5 -6
- package/src/local/net/tcp.ts +18 -11
- package/src/local/paths.ts +2 -3
- package/src/local/provider-reach.ts +124 -0
- package/src/local/reset.ts +1 -2
- package/src/local/runtime/index.ts +1 -2
- package/src/local/runtime/node.ts +1 -1
- package/src/local/runtime/runner.ts +2 -2
- package/src/local/runtime/runtimes-install.ts +1 -1
- package/src/local/runtime/server.ts +2 -4
- package/src/local/runtime/which.ts +1 -1
- package/src/local/setup/wizard.ts +7 -5
- package/src/local/state/health-state.ts +10 -2
- package/src/local/state/lock.ts +26 -28
- package/src/local/state/log-rotation.ts +2 -3
- package/src/local/state/pidfile.ts +61 -6
- package/src/local/state/proc.ts +104 -1
- package/src/local/state/startup-config.ts +2 -2
- package/src/local/status.ts +30 -41
- package/src/local/temporal/download.ts +31 -9
- package/src/local/temporal/index.ts +1 -1
- package/src/local/temporal/manager.ts +94 -34
- package/src/local/temporal/supervisor.ts +1 -1
- package/src/local/webconsole/index.ts +8 -5
- package/src/marketplace/github.ts +1 -1
- package/src/marketplace/official.ts +1 -1
- package/src/output/command-result.ts +14 -2
- package/src/output/confirm.ts +2 -3
- package/src/output/format.ts +5 -6
- package/src/output/index.ts +8 -1
- package/src/output/printable.ts +26 -0
- package/src/output/proto.ts +3 -4
- package/src/output/style.ts +2 -2
- package/src/output/table.ts +118 -15
- package/src/program.ts +58 -128
- package/src/registry/aliases.ts +0 -3
- package/src/registry/index.ts +0 -1
- package/src/registry/metadata.ts +16 -64
- package/src/registry/registry.ts +3 -13
- package/src/registry/verb-support.ts +28 -5
- package/src/resources/agent/quality.ts +29 -8
- package/src/resources/agent/resolve.ts +3 -3
- package/src/resources/apply/apply.ts +58 -49
- package/src/resources/apply/handlers.ts +3 -4
- package/src/resources/channel.ts +3 -4
- package/src/resources/connect/connect.ts +2 -2
- package/src/resources/delete.ts +44 -4
- package/src/resources/documents.ts +1 -1
- package/src/resources/download.ts +239 -43
- package/src/resources/eval-run/options.ts +38 -17
- package/src/resources/eval-run/report.ts +11 -5
- package/src/resources/eval-run/run.ts +13 -9
- package/src/resources/file.ts +114 -0
- package/src/resources/get-bindings.ts +18 -0
- package/src/resources/git.ts +1 -1
- package/src/resources/list.ts +178 -34
- package/src/resources/plugin.ts +3 -0
- package/src/resources/provider-key.ts +327 -0
- package/src/resources/reference.ts +41 -85
- package/src/resources/render.ts +72 -38
- package/src/resources/routine.ts +152 -15
- package/src/resources/run/agent-exec.ts +95 -44
- package/src/resources/run/create.ts +27 -24
- package/src/resources/run/engines.ts +57 -0
- package/src/resources/run/environment.ts +43 -0
- package/src/resources/run/epilogue.ts +18 -17
- package/src/resources/run/files.ts +433 -0
- package/src/resources/run/header.ts +18 -18
- package/src/resources/run/prepare.ts +67 -74
- package/src/resources/run/references.ts +6 -5
- package/src/resources/run/resolve.ts +1 -1
- package/src/resources/run/resume.ts +28 -9
- package/src/resources/run/stream.ts +110 -9
- package/src/resources/run/workspace.ts +37 -47
- package/src/resources/run-approve.ts +2 -14
- package/src/resources/run-control.ts +4 -5
- package/src/resources/run-format.ts +3 -4
- package/src/resources/run-logs.ts +17 -6
- package/src/resources/run-scores.ts +14 -4
- package/src/resources/run-to-eval-case.ts +2 -2
- package/src/resources/runs.ts +5 -5
- package/src/resources/search.ts +1 -2
- package/src/resources/service-account.ts +4 -1
- package/src/resources/session.ts +10 -7
- package/src/resources/skill.ts +7 -8
- package/src/resources/stream/answer.ts +3 -19
- package/src/resources/stream/composer.ts +170 -0
- package/src/resources/stream/ink.tsx +74 -10
- package/src/resources/stream/render-plaintext.ts +22 -4
- package/src/resources/stream/tty.ts +1 -1
- package/src/resources/tag.ts +7 -9
- package/src/resources/usage.ts +19 -15
- package/src/resources/validate.ts +1 -10
- package/src/resources/version.ts +117 -15
- package/src/resources/views/agent.ts +60 -0
- package/src/resources/views/environment.ts +41 -0
- package/src/resources/views/index.ts +82 -0
- package/src/resources/views/organization.ts +29 -0
- package/src/resources/views/routine.ts +39 -0
- package/src/resources/views/run.ts +46 -0
- package/src/resources/views/session.ts +91 -0
- package/src/resources/views/skill.ts +49 -0
- package/src/resources/views/view.ts +188 -0
- package/src/resources/views/words.ts +191 -0
- package/src/runtime.ts +51 -2
- package/errors/exit-codes.d.ts +0 -10
- package/errors/exit-codes.d.ts.map +0 -1
- package/errors/exit-codes.js +0 -15
- package/errors/exit-codes.js.map +0 -1
- package/resources/run/attachments.d.ts +0 -24
- package/resources/run/attachments.d.ts.map +0 -1
- package/resources/run/attachments.js +0 -237
- package/resources/run/attachments.js.map +0 -1
- package/src/errors/exit-codes.ts +0 -17
- package/src/resources/run/attachments.ts +0 -300
- package/src/types/marked-terminal.d.ts +0 -31
package/errors/classify.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
// Classifies any thrown value into a CliError: an exit code, a user-facing
|
|
2
|
-
// message, and optional remediation hints.
|
|
3
|
-
//
|
|
4
|
-
// still map to the right exit code.
|
|
2
|
+
// message, and optional remediation hints. It walks the error chain so
|
|
3
|
+
// wrapped RPC errors still map to the right exit code.
|
|
5
4
|
//
|
|
6
5
|
// A refusal that carries a reason the CLI knows gets its own copy. Today
|
|
7
6
|
// there are two:
|
|
@@ -15,10 +14,21 @@
|
|
|
15
14
|
// is printed as is, with `stigmer usage hours` as the place to see the
|
|
16
15
|
// standing. A child organization's refusal names no plan (its parent
|
|
17
16
|
// manages it) and gets no hint: the hours are its parent's to read.
|
|
17
|
+
//
|
|
18
|
+
// Every other kind ends with what to do, in the CLI's own commands (the
|
|
19
|
+
// terminal kit words its failures the same way: headline, cause, next;
|
|
20
|
+
// sdk/ink/src/errors.ts). A server that cannot be reached is named by the
|
|
21
|
+
// address the backend client dialled, read from the record the client
|
|
22
|
+
// left in runtime.ts when it was made, never resolved again here; the next
|
|
23
|
+
// step follows where that address came from. A code path that made no
|
|
24
|
+
// client names no address. A missing resource points at the list of its
|
|
25
|
+
// type when the command recorded one, and a refused request at the running
|
|
26
|
+
// command's help.
|
|
18
27
|
import { Code, ConnectError } from "@connectrpc/connect";
|
|
19
28
|
import { getErrorReason, StigmerError } from "@stigmer/client";
|
|
20
29
|
import { CliExitError } from "./cli-exit-error.js";
|
|
21
|
-
import { ExitCode } from "
|
|
30
|
+
import { ExitCode } from "@stigmer/client/exit-codes";
|
|
31
|
+
import { actionCommandPath, actionResourceType, dialedServerAddress, } from "../runtime.js";
|
|
22
32
|
// Guards against pathological/circular `cause` chains.
|
|
23
33
|
const MAX_CHAIN_DEPTH = 20;
|
|
24
34
|
// The server's reason for refusing a key created before sign-in was turned
|
|
@@ -34,8 +44,7 @@ export function classify(err) {
|
|
|
34
44
|
}
|
|
35
45
|
// Local cancellation (Ctrl-C / AbortController) is a clean outcome, not a
|
|
36
46
|
// failure — exit 0 silently. A *remote* Canceled status is a genuine failure
|
|
37
|
-
// and falls through to classifyConnectCode (exit 1).
|
|
38
|
-
// the TS CLI deliberately improves on the Go CLI, which exits 1 for both.
|
|
47
|
+
// and falls through to classifyConnectCode (exit 1).
|
|
39
48
|
if (isLocalAbort(err)) {
|
|
40
49
|
return { exitCode: ExitCode.Success, message: "", cause: toError(err) };
|
|
41
50
|
}
|
|
@@ -76,9 +85,8 @@ export function classify(err) {
|
|
|
76
85
|
}
|
|
77
86
|
return { exitCode: ExitCode.General, message: messageOf(err), cause: toError(err) };
|
|
78
87
|
}
|
|
79
|
-
// Walks the cause chain for the first SDK StigmerError or raw ConnectError
|
|
80
|
-
//
|
|
81
|
-
// CLI's extractGRPCStatus which walks Unwrap to handle wrapped RPC errors.
|
|
88
|
+
// Walks the cause chain for the first SDK StigmerError or raw ConnectError, so
|
|
89
|
+
// a wrapped RPC error still classifies by its status.
|
|
82
90
|
function extractCoded(err) {
|
|
83
91
|
let depth = 0;
|
|
84
92
|
for (let current = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
|
|
@@ -91,6 +99,27 @@ function extractCoded(err) {
|
|
|
91
99
|
}
|
|
92
100
|
return undefined;
|
|
93
101
|
}
|
|
102
|
+
// The network's own refusals, by the code Node gives them or the words its
|
|
103
|
+
// fetch and HTTP/2 client use: no connection, no address, a reset or a hang-up.
|
|
104
|
+
const TRANSPORT_FAILURE = /\b(ECONNREFUSED|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|ECONNRESET|EHOSTUNREACH|ENETUNREACH|EPIPE|UND_ERR_\w+)\b|fetch failed|socket hang up|other side closed|NGHTTP2_\w+/;
|
|
105
|
+
/**
|
|
106
|
+
* Whether an Unavailable is the transport's (the request never reached a
|
|
107
|
+
* server) rather than a server's answer: its message, or an error in its
|
|
108
|
+
* cause chain, names a network failure.
|
|
109
|
+
*/
|
|
110
|
+
export function isTransportFailure(message, cause) {
|
|
111
|
+
if (TRANSPORT_FAILURE.test(message))
|
|
112
|
+
return true;
|
|
113
|
+
let depth = 0;
|
|
114
|
+
for (let current = cause; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
|
|
115
|
+
const errno = current.code;
|
|
116
|
+
if (typeof errno === "string" && TRANSPORT_FAILURE.test(errno))
|
|
117
|
+
return true;
|
|
118
|
+
if (current instanceof Error && TRANSPORT_FAILURE.test(current.message))
|
|
119
|
+
return true;
|
|
120
|
+
}
|
|
121
|
+
return false;
|
|
122
|
+
}
|
|
94
123
|
function isLocalAbort(err) {
|
|
95
124
|
let depth = 0;
|
|
96
125
|
for (let current = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
|
|
@@ -103,13 +132,12 @@ function isLocalAbort(err) {
|
|
|
103
132
|
function classifyConnectCode(code, message, cause) {
|
|
104
133
|
switch (code) {
|
|
105
134
|
case Code.Unavailable:
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
cause,
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
};
|
|
135
|
+
// A request that never reached the server names the address it was
|
|
136
|
+
// sent to; one the server answered with Unavailable keeps its words.
|
|
137
|
+
if (isTransportFailure(message, cause)) {
|
|
138
|
+
return { exitCode: ExitCode.Connection, code, cause, ...cannotConnect(dialedServerAddress()) };
|
|
139
|
+
}
|
|
140
|
+
return { exitCode: ExitCode.Connection, code, cause, message, hints: ["The server could not take the request just now. Try again in a moment."] };
|
|
113
141
|
case Code.DeadlineExceeded:
|
|
114
142
|
return {
|
|
115
143
|
exitCode: ExitCode.Connection,
|
|
@@ -127,13 +155,13 @@ function classifyConnectCode(code, message, cause) {
|
|
|
127
155
|
hints: ["Too many requests. Wait a moment and try again."],
|
|
128
156
|
};
|
|
129
157
|
case Code.NotFound:
|
|
130
|
-
return { exitCode: ExitCode.NotFound, code, cause, message };
|
|
158
|
+
return { exitCode: ExitCode.NotFound, code, cause, message, hints: [notFoundHint()] };
|
|
131
159
|
case Code.InvalidArgument:
|
|
132
|
-
return { exitCode: ExitCode.Usage, code, cause, message };
|
|
160
|
+
return { exitCode: ExitCode.Usage, code, cause, message, hints: [helpHint()] };
|
|
133
161
|
case Code.FailedPrecondition:
|
|
134
|
-
return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}
|
|
162
|
+
return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}`, hints: [helpHint()] };
|
|
135
163
|
case Code.AlreadyExists:
|
|
136
|
-
return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}
|
|
164
|
+
return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}`, hints: [helpHint()] };
|
|
137
165
|
case Code.Unauthenticated:
|
|
138
166
|
return {
|
|
139
167
|
exitCode: ExitCode.Auth,
|
|
@@ -170,16 +198,64 @@ function classifyConnectCode(code, message, cause) {
|
|
|
170
198
|
hints: ["The operation was interrupted. You can safely retry."],
|
|
171
199
|
};
|
|
172
200
|
case Code.Canceled:
|
|
173
|
-
return {
|
|
201
|
+
return {
|
|
202
|
+
exitCode: ExitCode.General,
|
|
203
|
+
code,
|
|
204
|
+
cause,
|
|
205
|
+
message: "Operation cancelled",
|
|
206
|
+
hints: ["The server cancelled the request. Try again."],
|
|
207
|
+
};
|
|
174
208
|
default:
|
|
175
209
|
return {
|
|
176
210
|
exitCode: ExitCode.General,
|
|
177
211
|
code,
|
|
178
212
|
cause,
|
|
179
213
|
message: `${codeName(code)}: ${message}`,
|
|
214
|
+
hints: ["Run with --debug for more details."],
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* The words for a server that could not be reached at `address`, with the
|
|
220
|
+
* next step its source calls for: start the local daemon, check the named
|
|
221
|
+
* backend, or look at the override. With no address (no client was made)
|
|
222
|
+
* it names none. The connect timeout (client/client.ts) words itself with
|
|
223
|
+
* this too, so both failures read alike.
|
|
224
|
+
*/
|
|
225
|
+
export function cannotConnect(address) {
|
|
226
|
+
// The next step for a named backend, and for a failure that names no
|
|
227
|
+
// address: the status command prints the active backend and its endpoint.
|
|
228
|
+
const checkBackend = "Check the backend: stigmer config backend status";
|
|
229
|
+
if (address === undefined) {
|
|
230
|
+
return { message: "Could not reach the Stigmer server", hints: [checkBackend] };
|
|
231
|
+
}
|
|
232
|
+
switch (address.source) {
|
|
233
|
+
case "environment":
|
|
234
|
+
return {
|
|
235
|
+
message: `Could not reach the Stigmer server at ${address.address} (set by STIGMER_SERVER_ADDRESS)`,
|
|
236
|
+
hints: ["Start the server it names, or unset STIGMER_SERVER_ADDRESS to use the active backend."],
|
|
180
237
|
};
|
|
238
|
+
case "local":
|
|
239
|
+
return { message: `Could not reach the Stigmer server at ${address.address}`, hints: ["Start it: stigmer up"] };
|
|
240
|
+
case "cloud":
|
|
241
|
+
case "selfhost":
|
|
242
|
+
return { message: `Could not reach the Stigmer server at ${address.address}`, hints: [checkBackend] };
|
|
181
243
|
}
|
|
182
244
|
}
|
|
245
|
+
// A missing resource: the list of its type when the running command
|
|
246
|
+
// recorded one (get, delete and download do), else the two things a
|
|
247
|
+
// reference is made of.
|
|
248
|
+
function notFoundHint() {
|
|
249
|
+
const type = actionResourceType();
|
|
250
|
+
return type === "" ? "Check the reference and the organization (--org)." : `Check the reference: stigmer list ${type}`;
|
|
251
|
+
}
|
|
252
|
+
// A refused request: the running command's help, worded as a command-line
|
|
253
|
+
// refusal words it (errors/command-line.ts); the root's before any command
|
|
254
|
+
// ran.
|
|
255
|
+
function helpHint() {
|
|
256
|
+
const path = actionCommandPath();
|
|
257
|
+
return `Run \`${path === "" ? "stigmer" : path} --help\` for usage.`;
|
|
258
|
+
}
|
|
183
259
|
function causeOf(value) {
|
|
184
260
|
return value !== null && typeof value === "object"
|
|
185
261
|
? value.cause
|
package/errors/classify.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/errors/classify.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,
|
|
1
|
+
{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/errors/classify.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { Command, CommanderError } from "commander";
|
|
2
|
+
import { CliExitError } from "./cli-exit-error.js";
|
|
3
|
+
/** A refusal of the command line itself, carrying Commander's code (`commander.unknownOption`). */
|
|
4
|
+
export declare class CommandLineError extends CliExitError {
|
|
5
|
+
readonly code: string;
|
|
6
|
+
constructor(message: string, exitCode: number, code: string, hints?: readonly string[]);
|
|
7
|
+
}
|
|
8
|
+
/** Declare the code a usage error on `cmd` exits with, in place of 2 (module header). */
|
|
9
|
+
export declare function usageExitCode(cmd: Command, code: number): Command;
|
|
10
|
+
/** Give every command in the tree its own exit callback and silence Commander's error output. */
|
|
11
|
+
export declare function installCommandLineErrors(program: Command): void;
|
|
12
|
+
/** The CLI's error for a Commander refusal on `cmd` (module header). */
|
|
13
|
+
export declare function commandLineErrorOf(cmd: Command, error: CommanderError): CommandLineError;
|
|
14
|
+
//# sourceMappingURL=command-line.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-line.d.ts","sourceRoot":"","sources":["../src/errors/command-line.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,mGAAmG;AACnG,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE;CAKvF;AAID,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO/D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAOxF"}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
// Commander's own refusals (an unknown option, a missing or extra argument,
|
|
2
|
+
// a group run without its subcommand) worded and exited like every other
|
|
3
|
+
// usage error: `Error: ...` on stderr, the command's help named on the next
|
|
4
|
+
// line, exit 2, through the one exit point (handle.ts).
|
|
5
|
+
//
|
|
6
|
+
// Commander reports through `_exit`, which calls a command's exit callback
|
|
7
|
+
// with no command attached, so each command gets a callback of its own, a
|
|
8
|
+
// closure over it, and the hint names the command the error happened on.
|
|
9
|
+
// Commander's own error output is silenced, so the error prints once.
|
|
10
|
+
//
|
|
11
|
+
// An unknown option is named without what follows it (a value written after
|
|
12
|
+
// '=', or a short option's attached value), and extra arguments are counted,
|
|
13
|
+
// never listed (a newer Commander lists them): a key pasted onto the wrong
|
|
14
|
+
// option, or after the arguments, does not reach a terminal's log. An unknown
|
|
15
|
+
// command and a value an option's own parser refuses are still echoed, as
|
|
16
|
+
// Commander words them.
|
|
17
|
+
//
|
|
18
|
+
// A usage error exits 2, except on a command that declares its own code for
|
|
19
|
+
// one (`usageExitCode`): `eval run` keeps the plugin-eval table, where 2 is a
|
|
20
|
+
// partial run and an invalid option is 1.
|
|
21
|
+
//
|
|
22
|
+
// Help and version (exit code 0) leave quietly with 0; a group run without
|
|
23
|
+
// its subcommand has printed its help to stderr and exits 2.
|
|
24
|
+
import { ExitCode } from "@stigmer/client/exit-codes";
|
|
25
|
+
import { commandPath, everyCommand, registeredArguments } from "../command-tree.js";
|
|
26
|
+
import { CliExitError } from "./cli-exit-error.js";
|
|
27
|
+
/** A refusal of the command line itself, carrying Commander's code (`commander.unknownOption`). */
|
|
28
|
+
export class CommandLineError extends CliExitError {
|
|
29
|
+
code;
|
|
30
|
+
constructor(message, exitCode, code, hints) {
|
|
31
|
+
super(message, exitCode, hints);
|
|
32
|
+
this.name = "CommandLineError";
|
|
33
|
+
this.code = code;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
const USAGE_EXIT = new WeakMap();
|
|
37
|
+
/** Declare the code a usage error on `cmd` exits with, in place of 2 (module header). */
|
|
38
|
+
export function usageExitCode(cmd, code) {
|
|
39
|
+
USAGE_EXIT.set(cmd, code);
|
|
40
|
+
return cmd;
|
|
41
|
+
}
|
|
42
|
+
/** Give every command in the tree its own exit callback and silence Commander's error output. */
|
|
43
|
+
export function installCommandLineErrors(program) {
|
|
44
|
+
for (const cmd of everyCommand(program)) {
|
|
45
|
+
cmd.exitOverride((error) => {
|
|
46
|
+
throw commandLineErrorOf(cmd, error);
|
|
47
|
+
});
|
|
48
|
+
cmd.configureOutput({ outputError: () => undefined });
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
/** The CLI's error for a Commander refusal on `cmd` (module header). */
|
|
52
|
+
export function commandLineErrorOf(cmd, error) {
|
|
53
|
+
if (error.exitCode === 0)
|
|
54
|
+
return new CommandLineError("", ExitCode.Success, error.code);
|
|
55
|
+
// A group run without its subcommand: its help is already on stderr.
|
|
56
|
+
const exitCode = USAGE_EXIT.get(cmd) ?? ExitCode.Usage;
|
|
57
|
+
if (error.code === "commander.help")
|
|
58
|
+
return new CommandLineError("", exitCode, error.code);
|
|
59
|
+
const hint = `Run \`${commandPath(cmd)} --help\` for usage.`;
|
|
60
|
+
return new CommandLineError(wording(cmd, error), exitCode, error.code, [hint]);
|
|
61
|
+
}
|
|
62
|
+
function wording(cmd, error) {
|
|
63
|
+
if (error.code === "commander.excessArguments")
|
|
64
|
+
return excessArguments(cmd, error.message);
|
|
65
|
+
const message = error.message.replace(/^error: /, "");
|
|
66
|
+
if (error.code === "commander.unknownOption")
|
|
67
|
+
return unknownOption(message);
|
|
68
|
+
return message
|
|
69
|
+
.split("\n")
|
|
70
|
+
.map((line) => line.trim())
|
|
71
|
+
.filter((line) => line !== "")
|
|
72
|
+
.join(" ");
|
|
73
|
+
}
|
|
74
|
+
// Commander echoes an unknown option as typed, so `--name=VALUE` would print
|
|
75
|
+
// the value, newlines and all; the answer names the option alone, with
|
|
76
|
+
// Commander's suggestion when its last line is one (an option's name only).
|
|
77
|
+
function unknownOption(message) {
|
|
78
|
+
const name = /^unknown option '(--[A-Za-z0-9-]+|-[A-Za-z0-9])/.exec(message)?.[1];
|
|
79
|
+
if (name === undefined)
|
|
80
|
+
return "unknown option";
|
|
81
|
+
const suggestion = /\n(\(Did you mean --?[A-Za-z0-9-]+\?\))$/.exec(message)?.[1];
|
|
82
|
+
return suggestion === undefined ? `unknown option '${name}'` : `unknown option '${name}' ${suggestion}`;
|
|
83
|
+
}
|
|
84
|
+
function excessArguments(cmd, message) {
|
|
85
|
+
const expected = registeredArguments(cmd).length;
|
|
86
|
+
const got = /got (\d+)/.exec(message)?.[1];
|
|
87
|
+
const takes = expected === 0 ? "takes no arguments" : `takes ${expected} argument${expected === 1 ? "" : "s"}`;
|
|
88
|
+
return got === undefined ? `${commandPath(cmd)} ${takes}` : `${commandPath(cmd)} ${takes}, got ${got}`;
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=command-line.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-line.js","sourceRoot":"","sources":["../src/errors/command-line.ts"],"names":[],"mappings":"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"}
|
package/errors/handle.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
// The single exit point for command-level errors: classify, print to stderr,
|
|
2
|
-
// and exit with the mapped code.
|
|
2
|
+
// and exit with the mapped code.
|
|
3
3
|
import { isDebug } from "../runtime.js";
|
|
4
4
|
import { classify, codeName } from "./classify.js";
|
|
5
|
-
import { ExitCode } from "
|
|
5
|
+
import { ExitCode } from "@stigmer/client/exit-codes";
|
|
6
6
|
/**
|
|
7
7
|
* Render a CliError for stderr. In debug mode it appends the raw error chain
|
|
8
8
|
* and numeric gRPC code. Returns "" when there is nothing to print (a clean
|
package/errors/handle.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/errors/handle.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,
|
|
1
|
+
{"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/errors/handle.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iCAAiC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAiB,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,SAAkB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}
|
package/errors/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
export { ExitCode } from "
|
|
2
|
-
export { type CliError, classify, codeName } from "./classify.js";
|
|
1
|
+
export { ExitCode } from "@stigmer/client/exit-codes";
|
|
2
|
+
export { cannotConnect, type CliError, classify, codeName, type ConnectFailure } from "./classify.js";
|
|
3
3
|
export { CliExitError } from "./cli-exit-error.js";
|
|
4
4
|
export { formatError, handle } from "./handle.js";
|
|
5
5
|
export { UsageError } from "./usage-error.js";
|
package/errors/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
|
package/errors/index.js
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
// Public surface of the CLI error-handling module.
|
|
2
|
-
|
|
3
|
-
|
|
2
|
+
//
|
|
3
|
+
// Exit codes come from @stigmer/client/exit-codes, the table the terminal kit's
|
|
4
|
+
// stigmer-ink reads too, so scripts and CI branch on `$?` the same way for
|
|
5
|
+
// both. classify() maps gRPC/Connect status codes onto them. One command
|
|
6
|
+
// departs: `eval run` exits with Claude Code's plugin-eval codes (2 is its
|
|
7
|
+
// partial run, 130 an interrupt, and a refused start is 1), keeping only 3
|
|
8
|
+
// and 4 from this table (resources/eval-run/report.ts). A run (`run`,
|
|
9
|
+
// `resume`) exits by its newest turn's phase through the client's
|
|
10
|
+
// `exitCodeOf`: 0 completed; 1 failed, cancelled or stopped; 130 left while
|
|
11
|
+
// it works (resources/run/stream.ts).
|
|
12
|
+
export { ExitCode } from "@stigmer/client/exit-codes";
|
|
13
|
+
export { cannotConnect, classify, codeName } from "./classify.js";
|
|
4
14
|
export { CliExitError } from "./cli-exit-error.js";
|
|
5
15
|
export { formatError, handle } from "./handle.js";
|
|
6
16
|
export { UsageError } from "./usage-error.js";
|
package/errors/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,kEAAkE;AAClE,4EAA4E;AAC5E,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAiB,QAAQ,EAAE,QAAQ,EAAuB,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
|
package/errors/usage-error.js
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// same code the server's InvalidArgument produces, so scripts see a consistent
|
|
4
4
|
// "usage" exit regardless of where validation happened.
|
|
5
5
|
import { CliExitError } from "./cli-exit-error.js";
|
|
6
|
-
import { ExitCode } from "
|
|
6
|
+
import { ExitCode } from "@stigmer/client/exit-codes";
|
|
7
7
|
export class UsageError extends CliExitError {
|
|
8
8
|
constructor(message) {
|
|
9
9
|
super(message, ExitCode.Usage);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"usage-error.js","sourceRoot":"","sources":["../src/errors/usage-error.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,wDAAwD;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"usage-error.js","sourceRoot":"","sources":["../src/errors/usage-error.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,wDAAwD;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { type Command, type HelpConfiguration } from "commander";
|
|
2
|
+
/** A global option that may also follow the command. */
|
|
3
|
+
interface TrailingGlobal {
|
|
4
|
+
readonly flags: string;
|
|
5
|
+
readonly long: string;
|
|
6
|
+
readonly short?: string;
|
|
7
|
+
readonly description: string;
|
|
8
|
+
}
|
|
9
|
+
/** The global options that may be written after the command too, as the root declares them. */
|
|
10
|
+
export declare const TRAILING_GLOBALS: readonly TrailingGlobal[];
|
|
11
|
+
/** Declare the trailing globals on the root, in help's order. */
|
|
12
|
+
export declare function addGlobalOptions(program: Command): Command;
|
|
13
|
+
/** Give every runnable command hidden copies of the trailing globals it does not declare itself. */
|
|
14
|
+
export declare function acceptGlobalsAfterCommand(program: Command): void;
|
|
15
|
+
/** The global options as the command that runs sees them: its own trailing copy first, then the root's. */
|
|
16
|
+
export interface GlobalOptions {
|
|
17
|
+
readonly debug: boolean;
|
|
18
|
+
readonly standalone: boolean;
|
|
19
|
+
/** The Stigmer API key, read from the root alone (module header). */
|
|
20
|
+
readonly apiKey: string;
|
|
21
|
+
}
|
|
22
|
+
/** An option's value on `cmd` or, when unset there, on the nearest command above it that has one. */
|
|
23
|
+
export declare function nearestOption(cmd: Command, key: string): unknown;
|
|
24
|
+
/** Read the global options for the action command `action` under `root`. */
|
|
25
|
+
export declare function readGlobalOptions(root: Command, action: Command): GlobalOptions;
|
|
26
|
+
/**
|
|
27
|
+
* The help every command shows: the globals once per page, and each
|
|
28
|
+
* subcommand listed by its name alone, as gh and kubectl list theirs; its
|
|
29
|
+
* arguments and options are on its own help's usage line. (Commander's own
|
|
30
|
+
* term would print "[options]" for every command, since each holds the
|
|
31
|
+
* hidden global copies, and its arguments widen the list past 80 columns.)
|
|
32
|
+
*/
|
|
33
|
+
export declare const helpConfiguration: HelpConfiguration;
|
|
34
|
+
export {};
|
|
35
|
+
//# sourceMappingURL=global-options.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"global-options.d.ts","sourceRoot":"","sources":["src/global-options.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAU,MAAM,WAAW,CAAC;AAGzE,wDAAwD;AACxD,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAIrD,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED,oGAAoG;AACpG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAShE;AAED,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAO/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAM/B,CAAC"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
// The global options a person may write before or after the command:
|
|
2
|
+
// `stigmer --org acme run reviewer` and `stigmer run reviewer --org acme`
|
|
3
|
+
// read alike, as gh and kubectl take theirs.
|
|
4
|
+
//
|
|
5
|
+
// The root keeps positional options (`enablePositionalOptions`), because they
|
|
6
|
+
// are what keeps `stigmer setup --api-key` (the Anthropic key) from being read
|
|
7
|
+
// as the global Stigmer key. So the root's options do not reach a command's
|
|
8
|
+
// own arguments; instead each runnable command gets hidden copies of the ones
|
|
9
|
+
// that may follow it, and every reader takes the nearest command's value
|
|
10
|
+
// (`nearestOption`): the one written after the command wins over the one
|
|
11
|
+
// before it. Commander's own `optsWithGlobals` lets the root win, so it is
|
|
12
|
+
// not used for these.
|
|
13
|
+
//
|
|
14
|
+
// - `--org`, `-d/--debug` and `--standalone` follow any command that does not
|
|
15
|
+
// declare the name itself (`config context set --org` keeps its own
|
|
16
|
+
// meaning).
|
|
17
|
+
// - `--api-key` stays before the command: two commands give the name another
|
|
18
|
+
// meaning (`setup`, `mcp-server`), and a key belongs in the environment
|
|
19
|
+
// (`STIGMER_API_KEY`), not in a shell's history.
|
|
20
|
+
//
|
|
21
|
+
// The copies are hidden, so help shows the globals once, in its "Global
|
|
22
|
+
// Options" section, and the docs generator leaves them out of each page.
|
|
23
|
+
import { Option } from "commander";
|
|
24
|
+
import { runnableCommands } from "./command-tree.js";
|
|
25
|
+
/** The global options that may be written after the command too, as the root declares them. */
|
|
26
|
+
export const TRAILING_GLOBALS = [
|
|
27
|
+
{ flags: "-d, --debug", long: "--debug", short: "-d", description: "enable debug output" },
|
|
28
|
+
{ flags: "--standalone", long: "--standalone", description: "ignore the config file; use flags and environment only" },
|
|
29
|
+
{ flags: "--org <slug>", long: "--org", description: "organization, on servers that hold several" },
|
|
30
|
+
];
|
|
31
|
+
/** Declare the trailing globals on the root, in help's order. */
|
|
32
|
+
export function addGlobalOptions(program) {
|
|
33
|
+
for (const global of TRAILING_GLOBALS)
|
|
34
|
+
program.option(global.flags, global.description);
|
|
35
|
+
return program.option("--api-key <key>", "API key for authentication (before the command)");
|
|
36
|
+
}
|
|
37
|
+
/** Give every runnable command hidden copies of the trailing globals it does not declare itself. */
|
|
38
|
+
export function acceptGlobalsAfterCommand(program) {
|
|
39
|
+
for (const cmd of runnableCommands(program)) {
|
|
40
|
+
for (const global of TRAILING_GLOBALS) {
|
|
41
|
+
if (cmd.options.some((option) => option.long === global.long))
|
|
42
|
+
continue;
|
|
43
|
+
const shortTaken = global.short !== undefined && cmd.options.some((option) => option.short === global.short);
|
|
44
|
+
const flags = shortTaken || global.short === undefined ? global.flags.replace(/^-\w, /, "") : global.flags;
|
|
45
|
+
cmd.addOption(new Option(flags, global.description).hideHelp());
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
/** An option's value on `cmd` or, when unset there, on the nearest command above it that has one. */
|
|
50
|
+
export function nearestOption(cmd, key) {
|
|
51
|
+
for (let current = cmd; current !== null; current = current.parent) {
|
|
52
|
+
const value = current.opts()[key];
|
|
53
|
+
if (value !== undefined)
|
|
54
|
+
return value;
|
|
55
|
+
}
|
|
56
|
+
return undefined;
|
|
57
|
+
}
|
|
58
|
+
/** Read the global options for the action command `action` under `root`. */
|
|
59
|
+
export function readGlobalOptions(root, action) {
|
|
60
|
+
const apiKey = root.opts().apiKey;
|
|
61
|
+
return {
|
|
62
|
+
debug: Boolean(nearestOption(action, "debug")),
|
|
63
|
+
standalone: Boolean(nearestOption(action, "standalone")),
|
|
64
|
+
apiKey: typeof apiKey === "string" ? apiKey : "",
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* The help every command shows: the globals once per page, and each
|
|
69
|
+
* subcommand listed by its name alone, as gh and kubectl list theirs; its
|
|
70
|
+
* arguments and options are on its own help's usage line. (Commander's own
|
|
71
|
+
* term would print "[options]" for every command, since each holds the
|
|
72
|
+
* hidden global copies, and its arguments widen the list past 80 columns.)
|
|
73
|
+
*/
|
|
74
|
+
export const helpConfiguration = {
|
|
75
|
+
showGlobalOptions: true,
|
|
76
|
+
subcommandTerm: (cmd) => {
|
|
77
|
+
const alias = cmd.aliases()[0];
|
|
78
|
+
return alias === undefined ? cmd.name() : `${cmd.name()}|${alias}`;
|
|
79
|
+
},
|
|
80
|
+
};
|
|
81
|
+
//# sourceMappingURL=global-options.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"global-options.js","sourceRoot":"","sources":["src/global-options.ts"],"names":[],"mappings":"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"}
|
package/local/artifact.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
export { DOWNLOAD_ATTEMPTS, DOWNLOAD_RETRY_BASE_DELAY_MS, extractTarEntry, parseShasum, sha256Hex } from "@stigmer/artifact-fetch";
|
|
1
2
|
/** Release OS token, matching the `<os>` segment of our release asset names. */
|
|
2
3
|
export declare function mapReleaseOs(platform: NodeJS.Platform): string;
|
|
3
4
|
/** Release arch token, matching the `<arch>` segment of our release asset names. */
|
|
@@ -44,10 +45,6 @@ export type TarballInstall = {
|
|
|
44
45
|
source: "network";
|
|
45
46
|
cache: CacheMiss;
|
|
46
47
|
};
|
|
47
|
-
/** Attempts per download before a transient failure is reported. */
|
|
48
|
-
export declare const DOWNLOAD_ATTEMPTS = 4;
|
|
49
|
-
/** The wait before the second attempt; it doubles before each later one (1 s, 2 s, 4 s). */
|
|
50
|
-
export declare const DOWNLOAD_RETRY_BASE_DELAY_MS = 1000;
|
|
51
48
|
/**
|
|
52
49
|
* Install the named entry of a `.tar.gz` at `binPath` with executable
|
|
53
50
|
* permissions: from the cache directory when it holds a copy that matches its
|
|
@@ -58,20 +55,4 @@ export declare const DOWNLOAD_RETRY_BASE_DELAY_MS = 1000;
|
|
|
58
55
|
* extraction failure, and with the path when the cache cannot be read or written.
|
|
59
56
|
*/
|
|
60
57
|
export declare function fetchTarballBinary(src: TarballBinarySource): Promise<TarballInstall>;
|
|
61
|
-
/** Lowercase hex sha256 of `bytes`. */
|
|
62
|
-
export declare function sha256Hex(bytes: Uint8Array): string;
|
|
63
|
-
/**
|
|
64
|
-
* The sha256 a `shasum`/`sha256sum`-format file records for `filename`, lowercase
|
|
65
|
-
* hex, or "" when the file has no entry for it. Each line is "<hex> <filename>";
|
|
66
|
-
* `sha256sum -b` writes the filename with a leading "*" (binary mode), which is
|
|
67
|
-
* not part of the name. A release-wide file lists every asset, so the match is
|
|
68
|
-
* by filename, never by position.
|
|
69
|
-
*/
|
|
70
|
-
export declare function parseShasum(content: string, filename: string): string;
|
|
71
|
-
/**
|
|
72
|
-
* Extract a single regular-file entry whose basename matches `name` from an
|
|
73
|
-
* (uncompressed) tar buffer. Minimal POSIX/ustar reader: 512-byte header blocks,
|
|
74
|
-
* octal size at offset 124, type flag at 156, data padded to 512 bytes.
|
|
75
|
-
*/
|
|
76
|
-
export declare function extractTarEntry(buf: Uint8Array, name: string): Uint8Array | null;
|
|
77
58
|
//# sourceMappingURL=artifact.d.ts.map
|
package/local/artifact.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/local/artifact.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/local/artifact.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEnI,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAS9D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3F;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsC1F"}
|