@stigmer/cli 0.1.0-dev.20261017064309.g94d062a29f89 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +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
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { type JsonValue } from "@bufbuild/protobuf";
|
|
2
|
+
import { type ProviderKey } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/api_pb";
|
|
3
|
+
import { type ProviderReadiness } from "@stigmer/apis/ai/stigmer/platform/v1/model_readiness_pb";
|
|
4
|
+
import { type DeploymentMode, type Stigmer } from "@stigmer/client";
|
|
5
|
+
import { CommandResult } from "../output/index.js";
|
|
6
|
+
/** The clients these helpers call: the provider key client and the platform's readiness. */
|
|
7
|
+
export type ProviderKeyClient = Pick<Stigmer, "providerkey" | "platform">;
|
|
8
|
+
/** The providers a key is saved for, as the contract names them (io.proto). */
|
|
9
|
+
export declare const PROVIDERS: readonly ["anthropic", "openai"];
|
|
10
|
+
export type Provider = (typeof PROVIDERS)[number];
|
|
11
|
+
/** The fix `set` and `delete` name on an open-source server. */
|
|
12
|
+
export declare const LOCAL_KEYS_FIX = "On your own machine the runner's keys come from `stigmer setup` (Anthropic) and OPENAI_API_KEY in the shell you start Stigmer from (OpenAI), then `stigmer down && stigmer up`.";
|
|
13
|
+
/** The provider a person typed, by the contract's own names. */
|
|
14
|
+
export declare function parseProvider(value: string): Provider;
|
|
15
|
+
/** A provider's name as a person reads it: Anthropic, OpenAI. */
|
|
16
|
+
export declare function providerDisplayName(provider: string): string;
|
|
17
|
+
/**
|
|
18
|
+
* The base URL `--base-url` names, checked as far as the client can: an
|
|
19
|
+
* https URL. Whether it resolves to a public address is the server's to say.
|
|
20
|
+
*/
|
|
21
|
+
export declare function parseBaseUrl(value: string | undefined): string;
|
|
22
|
+
/**
|
|
23
|
+
* Refuses a key write on a server that keeps no provider keys: open source
|
|
24
|
+
* and Stigmer Enterprise hand runs to runners that hold their own keys.
|
|
25
|
+
*/
|
|
26
|
+
export declare function refuseKeyWritesOff(mode: DeploymentMode): void;
|
|
27
|
+
/** Whether the key list could be read, and why not when it could not. */
|
|
28
|
+
export type KeyDetails = "read" | "not-served" | "not-permitted";
|
|
29
|
+
/** One provider's standing for the organization, with its key when the list was read. */
|
|
30
|
+
export interface ProviderStanding {
|
|
31
|
+
readonly readiness: ProviderReadiness;
|
|
32
|
+
readonly key: ProviderKey | undefined;
|
|
33
|
+
}
|
|
34
|
+
export interface ProviderListing {
|
|
35
|
+
readonly standings: readonly ProviderStanding[];
|
|
36
|
+
readonly keyDetails: KeyDetails;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Every provider's standing for the organization in the server's order,
|
|
40
|
+
* joined with the organization's keys when the server serves the key list
|
|
41
|
+
* and the caller may read it.
|
|
42
|
+
*/
|
|
43
|
+
export declare function listProviders(client: ProviderKeyClient, org: string): Promise<ProviderListing>;
|
|
44
|
+
/** Where a provider stands, in words. */
|
|
45
|
+
export declare function standingWords(readiness: ProviderReadiness): string;
|
|
46
|
+
/** The list's table headers: the key's columns only when the key list was read. */
|
|
47
|
+
export declare function providerTableHeaders(listing: ProviderListing): string[];
|
|
48
|
+
/** The list's table: one row per provider, in the server's order. */
|
|
49
|
+
export declare function providerTableRows(listing: ProviderListing): string[][];
|
|
50
|
+
/**
|
|
51
|
+
* The list as data: each provider's readiness in protojson (snake_case,
|
|
52
|
+
* defaults omitted) and, when the key list was read and the provider has a
|
|
53
|
+
* key, that key under `key`.
|
|
54
|
+
*/
|
|
55
|
+
export declare function providerListJson(listing: ProviderListing): JsonValue[];
|
|
56
|
+
/** The streams reading a key touches, injectable for tests. */
|
|
57
|
+
export interface KeyIo {
|
|
58
|
+
readonly stdinIsTty: boolean;
|
|
59
|
+
readonly readStdin: () => Promise<string>;
|
|
60
|
+
readonly promptHidden: (question: string) => Promise<string>;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Refuses a key given on the command line, as an argument or a flag: it
|
|
64
|
+
* would stay in the shell's history and show in the process list.
|
|
65
|
+
*/
|
|
66
|
+
export declare function refuseKeyOnCommandLine(provider: Provider): never;
|
|
67
|
+
/**
|
|
68
|
+
* The key, read from stdin under `--key-stdin`, otherwise from a hidden
|
|
69
|
+
* prompt on a terminal. Off a terminal without `--key-stdin` there is no
|
|
70
|
+
* one to type it, so the command says how to pipe it in.
|
|
71
|
+
*/
|
|
72
|
+
export declare function readProviderKey(provider: Provider, keyStdin: boolean, io: KeyIo): Promise<string>;
|
|
73
|
+
/** Save the organization's key for `provider`, and say whether the provider confirmed it. */
|
|
74
|
+
export declare function setProviderKey(client: ProviderKeyClient, org: string, provider: Provider, apiKey: string, baseUrl: string): Promise<CommandResult>;
|
|
75
|
+
/** What a save says, by the check the server made with the provider. */
|
|
76
|
+
export declare function savedResult(provider: Provider, saved: ProviderKey): CommandResult;
|
|
77
|
+
/** The question `delete` asks on a terminal before it removes a key. */
|
|
78
|
+
export declare function deletePrompt(provider: Provider, orgLabel: string): string;
|
|
79
|
+
/** Remove the organization's key for `provider`. */
|
|
80
|
+
export declare function deleteProviderKey(client: ProviderKeyClient, org: string, provider: Provider): Promise<CommandResult>;
|
|
81
|
+
//# sourceMappingURL=provider-key.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider-key.d.ts","sourceRoot":"","sources":["../src/resources/provider-key.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,261 @@
|
|
|
1
|
+
// `stigmer provider-key` dispatch: which model providers serve an
|
|
2
|
+
// organization, and on Stigmer Cloud the organization's own provider keys,
|
|
3
|
+
// saved, listed and removed.
|
|
4
|
+
//
|
|
5
|
+
// Two answers are joined. The platform's model readiness says, on every
|
|
6
|
+
// edition, where each provider stands for the organization (its own key, its
|
|
7
|
+
// parent's, the runners', or nothing), in the server's provider order. The
|
|
8
|
+
// provider key list, served by Stigmer Cloud only, adds each key's details:
|
|
9
|
+
// its last four characters, the endpoint it is used against, whether the
|
|
10
|
+
// provider confirmed it when it was saved, who saved it and when, and when a
|
|
11
|
+
// call last used it. A server that does not serve the key list (open source
|
|
12
|
+
// answers Unimplemented), or a caller who may not read it, still gets every
|
|
13
|
+
// provider's standing; the key columns are left out.
|
|
14
|
+
//
|
|
15
|
+
// A key is a secret: it reaches this module already read (the command layer
|
|
16
|
+
// reads it from a hidden prompt or from stdin, never from an argument or an
|
|
17
|
+
// environment variable), is sent once, and is never printed. What comes back
|
|
18
|
+
// is the saved key without its secret.
|
|
19
|
+
//
|
|
20
|
+
// Saving and removing are Stigmer Cloud's: on any other edition the runners
|
|
21
|
+
// hold their own keys, so those commands are refused with the fix for that
|
|
22
|
+
// edition before anything is read or sent.
|
|
23
|
+
import { create } from "@bufbuild/protobuf";
|
|
24
|
+
import { timestampDate } from "@bufbuild/protobuf/wkt";
|
|
25
|
+
import { ProviderKeyCheck, ProviderKeySchema, } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/api_pb";
|
|
26
|
+
import { DeleteProviderKeyInputSchema, ListProviderKeysInputSchema, SetProviderKeyInputSchema, } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/io_pb";
|
|
27
|
+
import { ProviderAvailability, ProviderReadinessSchema, } from "@stigmer/apis/ai/stigmer/platform/v1/model_readiness_pb";
|
|
28
|
+
import { isPermissionDenied, isUnimplemented } from "@stigmer/client";
|
|
29
|
+
import { CliExitError } from "../errors/cli-exit-error.js";
|
|
30
|
+
import { ExitCode } from "@stigmer/client/exit-codes";
|
|
31
|
+
import { UsageError } from "../errors/usage-error.js";
|
|
32
|
+
import { CommandResult, protoToJsonValue } from "../output/index.js";
|
|
33
|
+
import { readCursorPages } from "./cursor-pages.js";
|
|
34
|
+
/** The providers a key is saved for, as the contract names them (io.proto). */
|
|
35
|
+
export const PROVIDERS = ["anthropic", "openai"];
|
|
36
|
+
const DISPLAY_NAMES = new Map([
|
|
37
|
+
["anthropic", "Anthropic"],
|
|
38
|
+
["openai", "OpenAI"],
|
|
39
|
+
]);
|
|
40
|
+
/** The fix `set` and `delete` name on an open-source server. */
|
|
41
|
+
export const LOCAL_KEYS_FIX = "On your own machine the runner's keys come from `stigmer setup` (Anthropic) and OPENAI_API_KEY in the shell you start Stigmer from (OpenAI), then `stigmer down && stigmer up`.";
|
|
42
|
+
/** The provider a person typed, by the contract's own names. */
|
|
43
|
+
export function parseProvider(value) {
|
|
44
|
+
const wanted = value.trim().toLowerCase();
|
|
45
|
+
const found = PROVIDERS.find((provider) => provider === wanted);
|
|
46
|
+
if (found !== undefined)
|
|
47
|
+
return found;
|
|
48
|
+
throw new UsageError(`unknown provider "${value}"\n\nUse anthropic or openai.`);
|
|
49
|
+
}
|
|
50
|
+
/** A provider's name as a person reads it: Anthropic, OpenAI. */
|
|
51
|
+
export function providerDisplayName(provider) {
|
|
52
|
+
return DISPLAY_NAMES.get(provider) ?? provider;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* The base URL `--base-url` names, checked as far as the client can: an
|
|
56
|
+
* https URL. Whether it resolves to a public address is the server's to say.
|
|
57
|
+
*/
|
|
58
|
+
export function parseBaseUrl(value) {
|
|
59
|
+
const baseUrl = (value ?? "").trim();
|
|
60
|
+
if (baseUrl === "")
|
|
61
|
+
return "";
|
|
62
|
+
const url = URL.canParse(baseUrl) ? new URL(baseUrl) : undefined;
|
|
63
|
+
if (url === undefined || url.protocol !== "https:") {
|
|
64
|
+
throw new UsageError(`--base-url must be an https URL, not "${baseUrl}"\n\nFor example: --base-url https://gateway.example.com/openai/v1`);
|
|
65
|
+
}
|
|
66
|
+
return baseUrl;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Refuses a key write on a server that keeps no provider keys: open source
|
|
70
|
+
* and Stigmer Enterprise hand runs to runners that hold their own keys.
|
|
71
|
+
*/
|
|
72
|
+
export function refuseKeyWritesOff(mode) {
|
|
73
|
+
if (mode === "cloud")
|
|
74
|
+
return;
|
|
75
|
+
const fix = mode === "local"
|
|
76
|
+
? LOCAL_KEYS_FIX
|
|
77
|
+
: "This server's runners use the keys whoever runs them gives them.";
|
|
78
|
+
throw new CliExitError("this server keeps no provider keys: they are saved on Stigmer Cloud", ExitCode.Usage, [
|
|
79
|
+
fix,
|
|
80
|
+
]);
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Every provider's standing for the organization in the server's order,
|
|
84
|
+
* joined with the organization's keys when the server serves the key list
|
|
85
|
+
* and the caller may read it.
|
|
86
|
+
*/
|
|
87
|
+
export async function listProviders(client, org) {
|
|
88
|
+
const [readiness, keys] = await Promise.all([
|
|
89
|
+
client.platform.getModelReadiness(org),
|
|
90
|
+
readKeys(client, org),
|
|
91
|
+
]);
|
|
92
|
+
const byProvider = new Map((Array.isArray(keys) ? keys : []).map((key) => [key.provider, key]));
|
|
93
|
+
return {
|
|
94
|
+
standings: readiness.providers.map((provider) => ({
|
|
95
|
+
readiness: provider,
|
|
96
|
+
key: byProvider.get(provider.provider),
|
|
97
|
+
})),
|
|
98
|
+
keyDetails: Array.isArray(keys) ? "read" : keys,
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
async function readKeys(client, org) {
|
|
102
|
+
try {
|
|
103
|
+
return await readCursorPages(0, (pageSize, pageToken) => client.providerkey.list(create(ListProviderKeysInputSchema, { org, pageSize, pageToken })));
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
if (isUnimplemented(err))
|
|
107
|
+
return "not-served";
|
|
108
|
+
if (isPermissionDenied(err))
|
|
109
|
+
return "not-permitted";
|
|
110
|
+
throw err;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
/** Where a provider stands, in words. */
|
|
114
|
+
export function standingWords(readiness) {
|
|
115
|
+
switch (readiness.availability) {
|
|
116
|
+
case ProviderAvailability.served_by_organization:
|
|
117
|
+
return "connected";
|
|
118
|
+
case ProviderAvailability.served_by_parent_organization:
|
|
119
|
+
return readiness.parentOrg === "" ? "through the parent organization" : `through ${readiness.parentOrg}`;
|
|
120
|
+
case ProviderAvailability.served_by_runners:
|
|
121
|
+
return "set on this machine";
|
|
122
|
+
case ProviderAvailability.missing_from_organization:
|
|
123
|
+
case ProviderAvailability.missing_from_runners:
|
|
124
|
+
return "not connected";
|
|
125
|
+
case ProviderAvailability.availability_unknown:
|
|
126
|
+
return "not known: set where the runner runs";
|
|
127
|
+
default:
|
|
128
|
+
return "not known";
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
const STANDING_HEADERS = ["PROVIDER", "STATE"];
|
|
132
|
+
const KEY_HEADERS = ["KEY", "ENDPOINT", "CHECK", "SAVED BY", "SAVED", "LAST USED"];
|
|
133
|
+
/** The list's table headers: the key's columns only when the key list was read. */
|
|
134
|
+
export function providerTableHeaders(listing) {
|
|
135
|
+
return listing.keyDetails === "read" ? [...STANDING_HEADERS, ...KEY_HEADERS] : [...STANDING_HEADERS];
|
|
136
|
+
}
|
|
137
|
+
/** The list's table: one row per provider, in the server's order. */
|
|
138
|
+
export function providerTableRows(listing) {
|
|
139
|
+
return listing.standings.map(({ readiness, key }) => {
|
|
140
|
+
const standing = [providerDisplayName(readiness.provider), standingWords(readiness)];
|
|
141
|
+
if (listing.keyDetails !== "read")
|
|
142
|
+
return standing;
|
|
143
|
+
if (key === undefined)
|
|
144
|
+
return [...standing, ...KEY_HEADERS.map(() => "-")];
|
|
145
|
+
return [
|
|
146
|
+
...standing,
|
|
147
|
+
key.keyHint === "" ? "-" : `…${key.keyHint}`,
|
|
148
|
+
endpointHost(key.baseUrl),
|
|
149
|
+
checkWords(key.check),
|
|
150
|
+
key.createdBy || "-",
|
|
151
|
+
dayOf(key.updatedAt ?? key.createdAt) ?? "-",
|
|
152
|
+
dayOf(key.lastUsedAt) ?? "never",
|
|
153
|
+
];
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* The list as data: each provider's readiness in protojson (snake_case,
|
|
158
|
+
* defaults omitted) and, when the key list was read and the provider has a
|
|
159
|
+
* key, that key under `key`.
|
|
160
|
+
*/
|
|
161
|
+
export function providerListJson(listing) {
|
|
162
|
+
return listing.standings.map(({ readiness, key }) => {
|
|
163
|
+
const row = protoToJsonValue(ProviderReadinessSchema, readiness);
|
|
164
|
+
return key === undefined ? row : { ...row, key: protoToJsonValue(ProviderKeySchema, key) };
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Refuses a key given on the command line, as an argument or a flag: it
|
|
169
|
+
* would stay in the shell's history and show in the process list.
|
|
170
|
+
*/
|
|
171
|
+
export function refuseKeyOnCommandLine(provider) {
|
|
172
|
+
throw new UsageError("a provider key is never taken on the command line: it would stay in your shell history and show in the process list\n\n" +
|
|
173
|
+
`Type it at the hidden prompt: stigmer provider-key set ${provider}\n` +
|
|
174
|
+
`Or pipe it in: stigmer provider-key set ${provider} --key-stdin`);
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* The key, read from stdin under `--key-stdin`, otherwise from a hidden
|
|
178
|
+
* prompt on a terminal. Off a terminal without `--key-stdin` there is no
|
|
179
|
+
* one to type it, so the command says how to pipe it in.
|
|
180
|
+
*/
|
|
181
|
+
export async function readProviderKey(provider, keyStdin, io) {
|
|
182
|
+
const name = providerDisplayName(provider);
|
|
183
|
+
let raw;
|
|
184
|
+
if (keyStdin) {
|
|
185
|
+
raw = await io.readStdin();
|
|
186
|
+
}
|
|
187
|
+
else if (io.stdinIsTty) {
|
|
188
|
+
raw = await io.promptHidden(`${name} key`);
|
|
189
|
+
}
|
|
190
|
+
else {
|
|
191
|
+
throw new UsageError(`no terminal to type the ${name} key at\n\nPipe it in: stigmer provider-key set ${provider} --key-stdin`);
|
|
192
|
+
}
|
|
193
|
+
const key = raw.trim();
|
|
194
|
+
if (key === "")
|
|
195
|
+
throw new UsageError(`no ${name} key given`);
|
|
196
|
+
return key;
|
|
197
|
+
}
|
|
198
|
+
/** Save the organization's key for `provider`, and say whether the provider confirmed it. */
|
|
199
|
+
export async function setProviderKey(client, org, provider, apiKey, baseUrl) {
|
|
200
|
+
const saved = await client.providerkey.set(create(SetProviderKeyInputSchema, { org, provider, apiKey, baseUrl }));
|
|
201
|
+
return savedResult(provider, saved);
|
|
202
|
+
}
|
|
203
|
+
/** What a save says, by the check the server made with the provider. */
|
|
204
|
+
export function savedResult(provider, saved) {
|
|
205
|
+
const name = providerDisplayName(provider);
|
|
206
|
+
let result;
|
|
207
|
+
switch (saved.check) {
|
|
208
|
+
case ProviderKeyCheck.checked:
|
|
209
|
+
result = CommandResult.success(`Saved; checked with ${name}`);
|
|
210
|
+
break;
|
|
211
|
+
case ProviderKeyCheck.unchecked:
|
|
212
|
+
result = CommandResult.warning(`Saved, not checked: ${name} did not answer`);
|
|
213
|
+
result.hint(`The first run that needs ${name} says whether the key works.`);
|
|
214
|
+
break;
|
|
215
|
+
default:
|
|
216
|
+
result = CommandResult.success("Saved");
|
|
217
|
+
}
|
|
218
|
+
const section = result.addSection();
|
|
219
|
+
section.field("Provider", name);
|
|
220
|
+
if (saved.keyHint !== "")
|
|
221
|
+
section.field("Key", `…${saved.keyHint}`);
|
|
222
|
+
if (saved.baseUrl !== "")
|
|
223
|
+
section.field("Endpoint", saved.baseUrl);
|
|
224
|
+
return result.withData(protoToJsonValue(ProviderKeySchema, saved));
|
|
225
|
+
}
|
|
226
|
+
/** The question `delete` asks on a terminal before it removes a key. */
|
|
227
|
+
export function deletePrompt(provider, orgLabel) {
|
|
228
|
+
const name = providerDisplayName(provider);
|
|
229
|
+
const serves = orgLabel === "" ? "this organization" : orgLabel;
|
|
230
|
+
return `Remove the ${name} key? Runs that need ${name} are refused until a key serves ${serves} again. [y/N]`;
|
|
231
|
+
}
|
|
232
|
+
/** Remove the organization's key for `provider`. */
|
|
233
|
+
export async function deleteProviderKey(client, org, provider) {
|
|
234
|
+
const removed = await client.providerkey.delete(create(DeleteProviderKeyInputSchema, { org, provider }));
|
|
235
|
+
const name = providerDisplayName(provider);
|
|
236
|
+
const result = CommandResult.success(`Removed the ${name} key`);
|
|
237
|
+
if (removed.keyHint !== "")
|
|
238
|
+
result.addSection().field("Key", `…${removed.keyHint}`);
|
|
239
|
+
result.hint(`Save another with: stigmer provider-key set ${provider}`);
|
|
240
|
+
return result.withData(protoToJsonValue(ProviderKeySchema, removed));
|
|
241
|
+
}
|
|
242
|
+
function checkWords(check) {
|
|
243
|
+
switch (check) {
|
|
244
|
+
case ProviderKeyCheck.checked:
|
|
245
|
+
return "checked";
|
|
246
|
+
case ProviderKeyCheck.unchecked:
|
|
247
|
+
return "not checked";
|
|
248
|
+
default:
|
|
249
|
+
return "-";
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
/** The endpoint's host, or "-" for the provider's own API. */
|
|
253
|
+
function endpointHost(baseUrl) {
|
|
254
|
+
if (baseUrl === "")
|
|
255
|
+
return "-";
|
|
256
|
+
return URL.canParse(baseUrl) ? new URL(baseUrl).host : baseUrl;
|
|
257
|
+
}
|
|
258
|
+
function dayOf(at) {
|
|
259
|
+
return at === undefined ? undefined : timestampDate(at).toISOString().slice(0, 10);
|
|
260
|
+
}
|
|
261
|
+
//# sourceMappingURL=provider-key.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider-key.js","sourceRoot":"","sources":["../src/resources/provider-key.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,2EAA2E;AAC3E,6BAA6B;AAC7B,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,qDAAqD;AACrD,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,2CAA2C;AAE3C,OAAO,EAAE,MAAM,EAAmC,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAkB,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAEL,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EACL,oBAAoB,EAEpB,uBAAuB,GACxB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAuB,kBAAkB,EAAE,eAAe,EAAgB,MAAM,iBAAiB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKpD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAU,CAAC;AAI1D,MAAM,aAAa,GAAgC,IAAI,GAAG,CAAC;IACzD,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACrB,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GACzB,iLAAiL,CAAC;AAEpL,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAChE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,IAAI,UAAU,CAAC,qBAAqB,KAAK,+BAA+B,CAAC,CAAC;AAClF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAClB,yCAAyC,OAAO,oEAAoE,CACrH,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAoB;IACrD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO;IAC7B,MAAM,GAAG,GACP,IAAI,KAAK,OAAO;QACd,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,kEAAkE,CAAC;IACzE,MAAM,IAAI,YAAY,CAAC,qEAAqE,EAAE,QAAQ,CAAC,KAAK,EAAE;QAC5G,GAAG;KACJ,CAAC,CAAC;AACL,CAAC;AAgBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAyB,EAAE,GAAW;IACxE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC;QACtC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;KACtB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAChG,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,SAAS,EAAE,QAAQ;YACnB,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACvC,CAAC,CAAC;QACH,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;KAChD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,MAAyB,EAAE,GAAW;IAC5D,IAAI,CAAC;QACH,OAAO,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAC3F,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,eAAe,CAAC,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;QAC9C,IAAI,kBAAkB,CAAC,GAAG,CAAC;YAAE,OAAO,eAAe,CAAC;QACpD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,SAA4B;IACxD,QAAQ,SAAS,CAAC,YAAY,EAAE,CAAC;QAC/B,KAAK,oBAAoB,CAAC,sBAAsB;YAC9C,OAAO,WAAW,CAAC;QACrB,KAAK,oBAAoB,CAAC,6BAA6B;YACrD,OAAO,SAAS,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,WAAW,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3G,KAAK,oBAAoB,CAAC,iBAAiB;YACzC,OAAO,qBAAqB,CAAC;QAC/B,KAAK,oBAAoB,CAAC,yBAAyB,CAAC;QACpD,KAAK,oBAAoB,CAAC,oBAAoB;YAC5C,OAAO,eAAe,CAAC;QACzB,KAAK,oBAAoB,CAAC,oBAAoB;YAC5C,OAAO,sCAAsC,CAAC;QAChD;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,OAAO,CAAU,CAAC;AACxD,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAE5F,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,OAAO,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC;AACvG,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,OAAwB;IACxD,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,CAAC,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM;YAAE,OAAO,QAAQ,CAAC;QACnD,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,OAAO;YACL,GAAG,QAAQ;YACX,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE;YAC5C,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;YACzB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YACrB,GAAG,CAAC,SAAS,IAAI,GAAG;YACpB,KAAK,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG;YAC5C,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;QAClD,MAAM,GAAG,GAAG,gBAAgB,CAAC,uBAAuB,EAAE,SAAS,CAAe,CAAC;QAC/E,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,MAAM,IAAI,UAAU,CAClB,yHAAyH;QACvH,0DAA0D,QAAQ,IAAI;QACtE,2CAA2C,QAAQ,cAAc,CACpE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAkB,EAAE,QAAiB,EAAE,EAAS;IACpF,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAW,CAAC;IAChB,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,GAAG,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QACzB,GAAG,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,UAAU,CAClB,2BAA2B,IAAI,mDAAmD,QAAQ,cAAc,CACzG,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,GAAG,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAyB,EACzB,GAAW,EACX,QAAkB,EAClB,MAAc,EACd,OAAe;IAEf,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAClH,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,KAAkB;IAChE,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAqB,CAAC;IAC1B,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,gBAAgB,CAAC,OAAO;YAC3B,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;YAC9D,MAAM;QACR,KAAK,gBAAgB,CAAC,SAAS;YAC7B,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,uBAAuB,IAAI,iBAAiB,CAAC,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,8BAA8B,CAAC,CAAC;YAC5E,MAAM;QACR;YACE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IACpC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,QAAgB;IAC/D,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,OAAO,cAAc,IAAI,wBAAwB,IAAI,mCAAmC,MAAM,eAAe,CAAC;AAChH,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB,EACzB,GAAW,EACX,QAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACzG,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,OAAO,KAAK,EAAE;QAAE,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,MAAM,CAAC,IAAI,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,KAAuB;IACzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,gBAAgB,CAAC,OAAO;YAC3B,OAAO,SAAS,CAAC;QACnB,KAAK,gBAAgB,CAAC,SAAS;YAC7B,OAAO,aAAa,CAAC;QACvB;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC/B,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AACjE,CAAC;AAED,SAAS,KAAK,CAAC,EAAyB;IACtC,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC"}
|
package/resources/reference.d.ts
CHANGED
|
@@ -7,38 +7,32 @@ export type ParsedReference = {
|
|
|
7
7
|
readonly org: string;
|
|
8
8
|
readonly slug: string;
|
|
9
9
|
};
|
|
10
|
-
export declare function parseReference(ref: string, defaultOrg: string,
|
|
10
|
+
export declare function parseReference(ref: string, defaultOrg: string, idPrefix: string): ParsedReference;
|
|
11
11
|
/**
|
|
12
|
-
*
|
|
13
|
-
*
|
|
12
|
+
* The prefix a kind's ids carry (from the proto kind_meta mirror); "" for a
|
|
13
|
+
* kind the mirror lacks.
|
|
14
14
|
*/
|
|
15
|
-
export declare function
|
|
16
|
-
/** True if `ref` carries the agent ID prefix (`agt_
|
|
15
|
+
export declare function idPrefixOf(kind: ApiResourceKind): string;
|
|
16
|
+
/** True if `ref` carries the agent ID prefix (`agt_…`). */
|
|
17
17
|
export declare function isAgentId(ref: string): boolean;
|
|
18
|
-
/** True if `ref` carries the session ID prefix (`ses_
|
|
18
|
+
/** True if `ref` carries the session ID prefix (`ses_…`). */
|
|
19
19
|
export declare function isSessionId(ref: string): boolean;
|
|
20
|
-
/** True if `ref` carries
|
|
20
|
+
/** True if `ref` carries the routine ID prefix (`rtn_…`). */
|
|
21
21
|
export declare function isRoutineId(ref: string): boolean;
|
|
22
|
-
/**
|
|
23
|
-
* True if `ref` is a run ID: `run_…`, or `aex_…` (either separator) for a run
|
|
24
|
-
* minted before the run kind's prefix changed. Case-sensitive, so "RUN_" is
|
|
25
|
-
* not one.
|
|
26
|
-
*/
|
|
22
|
+
/** True if `ref` is a run ID (`run_…`). Case-sensitive, so "RUN_" is not one. */
|
|
27
23
|
export declare function isRunId(ref: string): boolean;
|
|
28
24
|
/**
|
|
29
|
-
* True if `ref` starts with ANY known resource-ID prefix (length-agnostic)
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
* completeness.
|
|
25
|
+
* True if `ref` starts with ANY known resource-ID prefix (length-agnostic):
|
|
26
|
+
* use it to detect *intent* (the user typed something ID-shaped), then
|
|
27
|
+
* {@link validateResourceId} to enforce completeness.
|
|
33
28
|
*/
|
|
34
29
|
export declare function hasResourceIdPrefix(ref: string): boolean;
|
|
35
30
|
/**
|
|
36
31
|
* Validate that `ref` is a syntactically complete resource ID. Returns null
|
|
37
|
-
* when valid, or a user-facing error message otherwise
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
* paste the full ID.
|
|
32
|
+
* when valid, or a user-facing error message otherwise: a known prefix and
|
|
33
|
+
* "_" followed by a 26-char ULID body. A matched prefix with the wrong body
|
|
34
|
+
* length is reported as "incomplete" so callers can guide the user to paste
|
|
35
|
+
* the full ID.
|
|
42
36
|
*/
|
|
43
37
|
export declare function validateResourceId(ref: string): string | null;
|
|
44
38
|
//# sourceMappingURL=reference.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/resources/reference.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/resources/reference.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,mFAAmF,CAAC;AAGpH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,eAAe,CAajB;AAOD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAExD;AAyBD,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW7D"}
|
package/resources/reference.js
CHANGED
|
@@ -1,152 +1,106 @@
|
|
|
1
1
|
// Parse a user-supplied resource reference into either an ID lookup or an
|
|
2
|
-
// org/slug lookup
|
|
2
|
+
// org/slug lookup.
|
|
3
3
|
//
|
|
4
4
|
// "agt_abc123" -> by ID
|
|
5
5
|
// "my-org/my-agent" -> by org/slug (explicit org)
|
|
6
6
|
// "my-agent" -> by org/slug (org from --org/context)
|
|
7
7
|
//
|
|
8
|
-
// The kind's id
|
|
9
|
-
// an ID but "acme" as a slug.
|
|
10
|
-
// minted as "aex_…" before the run kind's prefix became "run"): ids are never
|
|
11
|
-
// rewritten, so a stored id keeps the prefix it was minted with.
|
|
8
|
+
// The kind's id prefix disambiguates a bare token: "org" resolves "org_x" as
|
|
9
|
+
// an ID but "acme" as a slug.
|
|
12
10
|
//
|
|
13
11
|
// The lower half of this module adds the *strict* classification the run/resume
|
|
14
|
-
// resolvers need
|
|
15
|
-
//
|
|
16
|
-
// from parseReference's lenient `${prefix}_` test — `run my-agent` must not
|
|
12
|
+
// resolvers need: prefix-by-kind detection and full ID validation (prefix, "_"
|
|
13
|
+
// and a 26-char ULID, the only id shape the server mints). This is deliberately
|
|
14
|
+
// distinct from parseReference's lenient `${prefix}_` test — `run my-agent` must not
|
|
17
15
|
// treat a slug that merely starts with a known prefix as an ID.
|
|
18
16
|
import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
|
|
19
17
|
import { KIND_META } from "../registry/index.js";
|
|
20
|
-
export function parseReference(ref, defaultOrg,
|
|
18
|
+
export function parseReference(ref, defaultOrg, idPrefix) {
|
|
21
19
|
const trimmed = ref.trim();
|
|
22
20
|
const slash = trimmed.indexOf("/");
|
|
23
21
|
if (slash > 0) {
|
|
24
22
|
return { kind: "ref", org: trimmed.slice(0, slash), slug: trimmed.slice(slash + 1) };
|
|
25
23
|
}
|
|
26
|
-
|
|
27
|
-
if (prefixes.some((prefix) => prefix !== "" && trimmed.startsWith(`${prefix}_`))) {
|
|
24
|
+
if (idPrefix !== "" && trimmed.startsWith(`${idPrefix}_`)) {
|
|
28
25
|
return { kind: "id", id: trimmed };
|
|
29
26
|
}
|
|
30
27
|
return { kind: "ref", org: defaultOrg, slug: trimmed };
|
|
31
28
|
}
|
|
32
|
-
// Crockford base-32 ULID body length.
|
|
33
|
-
//
|
|
34
|
-
//
|
|
29
|
+
// Crockford base-32 ULID body length. The resolver checks only the length (not
|
|
30
|
+
// the alphabet), so a 26-char body after a known prefix is accepted as a
|
|
31
|
+
// complete ID; the server judges the rest.
|
|
35
32
|
const ULID_LENGTH = 26;
|
|
36
33
|
/**
|
|
37
|
-
*
|
|
38
|
-
*
|
|
34
|
+
* The prefix a kind's ids carry (from the proto kind_meta mirror); "" for a
|
|
35
|
+
* kind the mirror lacks.
|
|
39
36
|
*/
|
|
40
|
-
export function
|
|
41
|
-
|
|
42
|
-
if (meta === undefined)
|
|
43
|
-
return [];
|
|
44
|
-
return [meta.idPrefix, ...(meta.retiredIdPrefixes ?? [])].filter((prefix) => prefix !== "");
|
|
37
|
+
export function idPrefixOf(kind) {
|
|
38
|
+
return KIND_META.get(kind)?.idPrefix ?? "";
|
|
45
39
|
}
|
|
46
|
-
// Every known resource-ID prefix,
|
|
47
|
-
//
|
|
48
|
-
//
|
|
40
|
+
// Every known resource-ID prefix, deduped. Built once from the kind_meta
|
|
41
|
+
// mirror so there is a single source of truth shared with the rest of the CLI
|
|
42
|
+
// (the registry) rather than a hand-rolled prefix list.
|
|
49
43
|
const ALL_ID_PREFIXES = (() => {
|
|
50
44
|
const set = new Set();
|
|
51
45
|
for (const kind of KIND_META.keys()) {
|
|
52
|
-
|
|
46
|
+
const prefix = idPrefixOf(kind);
|
|
47
|
+
if (prefix !== "")
|
|
53
48
|
set.add(prefix);
|
|
54
49
|
}
|
|
55
50
|
return [...set];
|
|
56
51
|
})();
|
|
57
|
-
//
|
|
58
|
-
// "run" prefix: no id was ever minted "run-…", and "run-" is how an agent slug
|
|
59
|
-
// such as "run-nightly-report" starts, so that prefix takes "_" only.
|
|
60
|
-
const UNDERSCORE_ONLY_PREFIXES = new Set(["run"]);
|
|
61
|
-
/** The separators an id may carry after `prefix`: "_" canonical, "-" legacy. */
|
|
62
|
-
function separatorsFor(prefix) {
|
|
63
|
-
return UNDERSCORE_ONLY_PREFIXES.has(prefix) ? ["_"] : ["_", "-"];
|
|
64
|
-
}
|
|
65
|
-
// Mirrors Go's reference.isResourceIDWithKind: a kind prefix followed by a
|
|
66
|
-
// separator {@link separatorsFor} allows it. Case-sensitive.
|
|
52
|
+
// A kind prefix followed by "_". Case-sensitive, so "RUN_" is not a run id.
|
|
67
53
|
function hasKindPrefix(ref, prefix) {
|
|
68
54
|
if (prefix === "")
|
|
69
55
|
return false;
|
|
70
|
-
|
|
71
|
-
return separatorsFor(prefix).some((sep) => trimmed.startsWith(`${prefix}${sep}`));
|
|
56
|
+
return ref.trim().startsWith(`${prefix}_`);
|
|
72
57
|
}
|
|
73
|
-
/** True if `ref` carries
|
|
58
|
+
/** True if `ref` carries `kind`'s id prefix. */
|
|
74
59
|
function hasPrefixOf(ref, kind) {
|
|
75
|
-
return
|
|
60
|
+
return hasKindPrefix(ref, idPrefixOf(kind));
|
|
76
61
|
}
|
|
77
|
-
/** True if `ref` carries the agent ID prefix (`agt_
|
|
62
|
+
/** True if `ref` carries the agent ID prefix (`agt_…`). */
|
|
78
63
|
export function isAgentId(ref) {
|
|
79
64
|
return hasPrefixOf(ref, ApiResourceKind.agent);
|
|
80
65
|
}
|
|
81
|
-
/** True if `ref` carries the session ID prefix (`ses_
|
|
66
|
+
/** True if `ref` carries the session ID prefix (`ses_…`). */
|
|
82
67
|
export function isSessionId(ref) {
|
|
83
68
|
return hasPrefixOf(ref, ApiResourceKind.session);
|
|
84
69
|
}
|
|
85
|
-
/** True if `ref` carries
|
|
70
|
+
/** True if `ref` carries the routine ID prefix (`rtn_…`). */
|
|
86
71
|
export function isRoutineId(ref) {
|
|
87
72
|
return hasPrefixOf(ref, ApiResourceKind.routine);
|
|
88
73
|
}
|
|
89
|
-
/**
|
|
90
|
-
* True if `ref` is a run ID: `run_…`, or `aex_…` (either separator) for a run
|
|
91
|
-
* minted before the run kind's prefix changed. Case-sensitive, so "RUN_" is
|
|
92
|
-
* not one.
|
|
93
|
-
*/
|
|
74
|
+
/** True if `ref` is a run ID (`run_…`). Case-sensitive, so "RUN_" is not one. */
|
|
94
75
|
export function isRunId(ref) {
|
|
95
76
|
return hasPrefixOf(ref, ApiResourceKind.run);
|
|
96
77
|
}
|
|
97
78
|
/**
|
|
98
|
-
* True if `ref` starts with ANY known resource-ID prefix (length-agnostic)
|
|
99
|
-
*
|
|
100
|
-
*
|
|
101
|
-
* completeness.
|
|
79
|
+
* True if `ref` starts with ANY known resource-ID prefix (length-agnostic):
|
|
80
|
+
* use it to detect *intent* (the user typed something ID-shaped), then
|
|
81
|
+
* {@link validateResourceId} to enforce completeness.
|
|
102
82
|
*/
|
|
103
83
|
export function hasResourceIdPrefix(ref) {
|
|
104
|
-
|
|
105
|
-
return true;
|
|
106
|
-
return isUuid(ref.trim());
|
|
84
|
+
return ALL_ID_PREFIXES.some((prefix) => hasKindPrefix(ref, prefix));
|
|
107
85
|
}
|
|
108
86
|
/**
|
|
109
87
|
* Validate that `ref` is a syntactically complete resource ID. Returns null
|
|
110
|
-
* when valid, or a user-facing error message otherwise
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
*
|
|
114
|
-
* paste the full ID.
|
|
88
|
+
* when valid, or a user-facing error message otherwise: a known prefix and
|
|
89
|
+
* "_" followed by a 26-char ULID body. A matched prefix with the wrong body
|
|
90
|
+
* length is reported as "incomplete" so callers can guide the user to paste
|
|
91
|
+
* the full ID.
|
|
115
92
|
*/
|
|
116
93
|
export function validateResourceId(ref) {
|
|
117
94
|
const trimmed = ref.trim();
|
|
118
95
|
for (const prefix of ALL_ID_PREFIXES) {
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
if (body.length !== ULID_LENGTH) {
|
|
125
|
-
return "incomplete resource ID: expected 26-character ULID after prefix";
|
|
126
|
-
}
|
|
127
|
-
return null;
|
|
96
|
+
const pfx = `${prefix}_`;
|
|
97
|
+
if (!trimmed.startsWith(pfx))
|
|
98
|
+
continue;
|
|
99
|
+
if (trimmed.length - pfx.length !== ULID_LENGTH) {
|
|
100
|
+
return "incomplete resource ID: expected 26-character ULID after prefix";
|
|
128
101
|
}
|
|
129
|
-
}
|
|
130
|
-
if (isUuid(trimmed))
|
|
131
102
|
return null;
|
|
132
|
-
return "not a recognized resource ID";
|
|
133
|
-
}
|
|
134
|
-
// Mirrors Go's reference.isUUID: 8-4-4-4-12 hex with hyphens at fixed offsets.
|
|
135
|
-
function isUuid(value) {
|
|
136
|
-
if (value.length !== 36)
|
|
137
|
-
return false;
|
|
138
|
-
if (value[8] !== "-" || value[13] !== "-" || value[18] !== "-" || value[23] !== "-") {
|
|
139
|
-
return false;
|
|
140
103
|
}
|
|
141
|
-
|
|
142
|
-
if (i === 8 || i === 13 || i === 18 || i === 23)
|
|
143
|
-
continue;
|
|
144
|
-
if (!isHexDigit(value[i]))
|
|
145
|
-
return false;
|
|
146
|
-
}
|
|
147
|
-
return true;
|
|
148
|
-
}
|
|
149
|
-
function isHexDigit(c) {
|
|
150
|
-
return (c >= "0" && c <= "9") || (c >= "a" && c <= "f") || (c >= "A" && c <= "F");
|
|
104
|
+
return "not a recognized resource ID";
|
|
151
105
|
}
|
|
152
106
|
//# sourceMappingURL=reference.js.map
|