openpond 0.0.30-bootstrap.0

package/docs/command-reference.md

@@ -0,0 +1,695 @@
+# OpenPond CLI command reference
+
+<!-- Generated by `pnpm --dir apps/cli docs:commands`; do not edit by hand. -->
+
+Parsing, aliases, command help, and this reference use the same authoritative registry.
+
+## help
+
+```text
+Usage:
+  openpond help
+```
+## version
+
+```text
+Usage:
+  openpond version
+```
+## check-update
+
+```text
+Usage:
+  openpond check-update
+```
+## login
+
+```text
+Usage:
+  openpond login [--base-url <url>]
+
+Options:
+  --account <string>
+  --api-baseurl <string>
+  --api-base-url <string>
+  --baseurl <string>
+  --base-url <string>
+  --chat-api-baseurl <string>
+  --chat-api-base-url <string>
+  --check-update
+  --cwd <string>
+  --help
+  --json
+  --profile <string>
+  --sandbox-apiurl <string>
+  --sandbox-api-url <string>
+  --tui
+  --version
+```
+## init
+
+```text
+Usage:
+  openpond init [--path <dir>]
+
+Options:
+  --path <string>
+```
+## profile
+
+```text
+Usage:
+  openpond profile <current|init|load|check|push|commit|diff|catalog>
+
+Options:
+  --check-kind <string>
+  --conversation-id <string>
+  --ensure-hosted
+  --expected-manifest-hash <string>
+  --force
+  --hosted-check-kind <string>
+  --hosted-run-agent-id <string>
+  --hosted-run-conversation-id <string>
+  --hosted-run-idempotency-key <string>
+  --hosted-run-input <json>
+  --hosted-run-retry
+  --hosted-run-target-project-id <string>
+  --hosted-source-agent-id <string>
+  --hosted-source-checks
+  --hosted-source-dispatch <string>
+  --hosted-source-project-id <string>
+  --json
+  --kind <string>
+  --path <string>
+  --publish-hosted-source
+  --team-id <string>
+  --work-item-id <string>
+```
+## agents
+
+```text
+Usage:
+  openpond agents [--json]
+
+Options:
+  --json
+```
+## inspect
+
+```text
+Usage:
+  openpond inspect [args]
+
+Options:
+  --cwd <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --path <string>
+```
+## build
+
+```text
+Usage:
+  openpond build [args]
+
+Options:
+  --cwd <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --path <string>
+```
+## validate
+
+```text
+Usage:
+  openpond validate [args]
+
+Options:
+  --cwd <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --path <string>
+```
+## eval
+
+```text
+Usage:
+  openpond eval [args]
+
+Options:
+  --cwd <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --path <string>
+```
+## run
+
+```text
+Usage:
+  openpond run [args]
+
+Options:
+  --cwd <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --path <string>
+```
+## extend
+
+```text
+Usage:
+  openpond extend <instructions>
+
+Options:
+  --cwd <string>
+```
+## edit
+
+```text
+Usage:
+  openpond edit <instructions>
+
+Options:
+  --cwd <string>
+```
+## profiles
+
+```text
+Usage:
+  openpond profiles [args]
+
+Options:
+  --json
+```
+## account
+
+```text
+Usage:
+  openpond account
+
+Options:
+  --json
+```
+## health
+
+```text
+Usage:
+  openpond health
+
+Options:
+  --json
+```
+## serve
+
+```text
+Usage:
+  openpond serve [args]
+
+Options:
+  --host <string>
+  --hostname <string>
+  --listen <string>
+  --port <integer>
+```
+## ui
+
+```text
+Usage:
+  openpond ui [args]
+
+Options:
+  --host <string>
+  --hostname <string>
+  --listen <string>
+  --port <integer>
+  --web-root <string>
+```
+## tui
+
+```text
+Usage:
+  openpond tui [--provider <id>] [--model <id>] [--project <id>]
+
+Aliases:
+  interactive
+
+Options:
+  --cwd <string>
+  --model <string>
+  --no-server-start
+  --project <string>
+  --provider <string>
+  --server <string>
+```
+## chat
+
+```text
+Usage:
+  openpond chat (--message-file <path>|--message <text>|--stdin) --non-interactive [--provider <id>] [--model <id>] [--project <id>] [--yes] [--approval-policy <policy>] [--json] [--timeout-sec <n>] [--max-output-bytes <n>] [--sandbox <mode>]
+
+Options:
+  --approval-policy <string>
+  --cwd <string>
+  --json
+  --max-output-bytes <integer>
+  --message <string>
+  --message-file <string>
+  --model <string>
+  --non-interactive
+  --no-server-start
+  --project <string>
+  --provider <string>
+  --sandbox <string>
+  --server <string>
+  --stdin
+  --timeout-sec <integer>
+  --yes
+```
+## tool
+
+```text
+Usage:
+  openpond tool <list|run> <handle>/<repo> [args]
+
+Options:
+  --body <json>
+  --json
+```
+## backtest
+
+```text
+Usage:
+  openpond backtest <run|events|get> <handle>/<repo> [args]
+
+Options:
+  --body <json>
+  --branch <string>
+  --deployment-id <string>
+  --limit <integer>
+  --run-id <string>
+```
+## deploy
+
+```text
+Usage:
+  openpond deploy watch <handle>/<repo> [--branch <branch>]
+
+Options:
+  --branch <string>
+```
+## template
+
+```text
+Usage:
+  openpond template <status|branches|update> <handle>/<repo> [--env preview|production]
+
+Options:
+  --env <string>
+```
+## sandbox-template
+
+```text
+Usage:
+  openpond sandbox-template <command> [args]
+
+Options:
+  --action <string>
+  --agent-id <string>
+  --branch <string>
+  --budget <number>
+  --budget-usd <number>
+  --build <string>
+  --commit
+  --commit-message <string>
+  --description <string>
+  --dir <string>
+  --disable-schedule <string>
+  --disable-schedules <string>
+  --enable-schedule <string>
+  --enable-schedules <string>
+  --entrypoint <string>
+  --env <json>
+  --env-ref <string>
+  --file <string>
+  --force
+  --idle-timeout-seconds <integer>
+  --inherit
+  --input <json>
+  --input-file <string>
+  --input-files <string>
+  --input-json <json>
+  --inputs <json>
+  --json
+  --keep-token-remote
+  --manifest <string>
+  --max-duration-seconds <integer>
+  --name <string>
+  --no-push
+  --no-write
+  --out <string>
+  --out-dir <string>
+  --output <string>
+  --output-dir <string>
+  --params <json>
+  --path <string>
+  --plan <string>
+  --project-id <string>
+  --repo <string>
+  --runtime-agent-id <string>
+  --runtime-base-branch <string>
+  --runtime-base-sha <string>
+  --runtime-id <string>
+  --runtime-project-id <string>
+  --runtime-promotion-policy <string>
+  --schedule-mode <string>
+  --schedule-override <json>
+  --schedule-overrides <json>
+  --schedules <string>
+  --service <string>
+  --set-remote-token
+  --setup-timeout-seconds <integer>
+  --target <string>
+  --team-id <string>
+  --timeout-seconds <integer>
+  --token <string>
+  --workflow-mode <string>
+  --yes
+```
+## repo
+
+```text
+Usage:
+  openpond repo <create|push> [--name <name>] [--path <dir>] [--branch <branch>]
+
+Options:
+  --branch <string>
+  --name <string>
+  --path <string>
+```
+## organizations
+
+```text
+Usage:
+  openpond organizations <login|list|use|logout|whoami> [args]
+
+Aliases:
+  organization
+
+Options:
+  --callback-port <integer>
+  --json
+  --open
+  --timeout-seconds <integer>
+```
+## project
+
+```text
+Usage:
+  openpond project <list|create|upsert|get|update|sync|source-upload|archive> [args]
+
+Options:
+  --branch <string>
+  --commit-message <string>
+  --default-branch <string>
+  --description <string>
+  --git-owner <string>
+  --git-repo <string>
+  --internal-repo-path <string>
+  --json
+  --name <string>
+  --path <string>
+  --project-id <string>
+  --repo <string>
+  --source-check-dispatch <string>
+  --source-type <string>
+  --team-id <string>
+  --template-repo-url <string>
+```
+## agent
+
+```text
+Usage:
+  openpond agent <inspect|build|validate|eval|traces|list|create|upsert|get|update|run|run-test|bind-source|source|edit|archive> [args]
+  openpond agent run <action> [--cwd <project>] [--input <json>]
+  openpond agent run <agentId> --team-id <id> [--conversation-id <id>] [--target-project-id <projectId>] [--input <json>]
+  openpond agent source check-status <workItemId> --team-id <id> [--limit <n>]
+  openpond agent edit open <agentId> --team-id <id> --project-id <id> [--message <text>]
+  openpond agent edit checkpoint-result|commit-result|pr-result <workItemId> --team-id <id> --ref <artifact-ref>
+
+Options:
+  --agent-edit <json>
+  --agent-id <string>
+  --allow-latest-source
+  --attachments-json <json>
+  --base-sha <string>
+  --chat-mode <string>
+  --check-kind <string>
+  --conversation-id <string>
+  --cwd <string>
+  --dispatch <string>
+  --entrypoint-name <string>
+  --entrypoint-scope <string>
+  --eval-status <string>
+  --expected-manifest-hash <string>
+  --expected-source-commit-sha <string>
+  --idempotency-key <string>
+  --input <json>
+  --input-file <string>
+  --json
+  --limit <integer>
+  --message <string>
+  --metadata <json>
+  --name <string>
+  --path <string>
+  --payload <json>
+  --project-id <string>
+  --prompt <string>
+  --published-snapshot-id <string>
+  --ref <string>
+  --required-env <string>
+  --required-integrations <string>
+  --require-published-snapshot
+  --runtime-promotion-policy <string>
+  --runtime-source-mode <string>
+  --source-check-dispatch <string>
+  --source-mode <string>
+  --source-ref <string>
+  --status <string>
+  --target-project-id <string>
+  --team-id <string>
+  --trigger-type <string>
+  --workflow-mode <string>
+  --work-item-id <string>
+```
+## goal
+
+```text
+Usage:
+  openpond goal <command> [args]
+
+Options:
+  --agent-id <string>
+  --cwd <string>
+  --goal-id <string>
+  --goal-storage <string>
+  --json
+```
+## harness
+
+```text
+Usage:
+  openpond harness desktop <run|attach> <scenario...> [--isolated|--attach|--packaged|--none] [--app <path>] [--artifacts-dir <path>] [--json <path>]
+
+Options:
+  --artifacts-dir <string>
+  --attach
+  --cwd <string>
+  --devtools-port <integer>
+  --grep <string>
+  --isolated
+  --json <string>
+  --json-path <string>
+  --keep-home
+  --none
+  --server <string>
+  --timeout-ms <integer>
+  --token <string>
+  --token-file <string>
+```
+## sandbox
+
+```text
+Usage:
+  openpond sandbox <command> [args]
+
+Options:
+  --access <string>
+  --agent-id <string>
+  --all
+  --artifact-paths <string>
+  --async
+  --auth-header <string>
+  --auth-header-value <string>
+  --auth-token <string>
+  --auto-start
+  --base-ref <string>
+  --branch <string>
+  --budget <number>
+  --budget-usd <number>
+  --cleanup
+  --cols <integer>
+  --command <string>
+  --content <string>
+  --content-base64 <string>
+  --contents <string>
+  --contents-base64 <string>
+  --cpu <number>
+  --create
+  --description <string>
+  --disk-gb <number>
+  --docker-build-args <json>
+  --dockerfile <string>
+  --dockerfile-context <string>
+  --dockerfile-target <string>
+  --docker-registry-secret-refs <string>
+  --domain <string>
+  --env-literal <string>
+  --env-name <string>
+  --env-ref <string>
+  --expected-mpp-mode <string>
+  --expected-version <integer>
+  --fail-on-unpreserved-changes
+  --ff-only
+  --force-with-lease
+  --fork
+  --from-path <string>
+  --idempotency-key <string>
+  --idle-timeout-seconds <integer>
+  --image <string>
+  --image-digest <string>
+  --input <string>
+  --input-base64 <string>
+  --integration-capabilities <string>
+  --integration-connection <string>
+  --integration-scopes <string>
+  --interval-ms <integer>
+  --json
+  --keep
+  --label <string>
+  --lease-id <string>
+  --lifecycle-hint <json>
+  --manifest-path <string>
+  --max-duration-seconds <integer>
+  --max-entries <number>
+  --max-results <number>
+  --memory-gb <number>
+  --message <string>
+  --name <string>
+  --no-preview
+  --overwrite
+  --params <json>
+  --path <string>
+  --paths <string>
+  --payload <json>
+  --port <integer>
+  --preview
+  --project-id <string>
+  --publish
+  --q <string>
+  --query <string>
+  --rebase
+  --recursive
+  --registry-secret-ref <string>
+  --remote <string>
+  --replay-state <string>
+  --repo <string>
+  --respond-async
+  --rows <integer>
+  --runtime-agent-id <string>
+  --runtime-base-branch <string>
+  --runtime-base-sha <string>
+  --runtime-id <string>
+  --runtime-profile-id <string>
+  --runtime-project-id <string>
+  --runtime-promotion-policy <string>
+  --runtime-workspace-root <string>
+  --sandbox-id <string>
+  --scope <string>
+  --since <integer>
+  --snapshot
+  --snapshot-id <string>
+  --source-project-id <string>
+  --source-repo-url <string>
+  --source-sandbox-id <string>
+  --start-point <string>
+  --status <string>
+  --stdin
+  --summary
+  --tag <string>
+  --tags <string>
+  --target-id <string>
+  --target-type <string>
+  --team-id <string>
+  --template-name <string>
+  --template-version <string>
+  --template-visibility <string>
+  --timeout-seconds <integer>
+  --to-path <string>
+  --type <string>
+  --use-case <string>
+  --validation-command <string>
+  --value <string>
+  --version <string>
+  --volume-delete-on-sandbox-delete
+  --volume-mount-path <string>
+  --volume-name <string>
+  --volume-storage-gb <number>
+  --workflow-mode <string>
+```
+## opchat
+
+```text
+Usage:
+  openpond opchat <command> [args]
+
+Options:
+  --json
+  --stream
+```
+## teams-bot
+
+```text
+Usage:
+  openpond teams-bot <command> [args]
+
+Options:
+  --json
+  --team-id <string>
+```
+## apps
+
+```text
+Usage:
+  openpond apps <list|code-visibility|tools|deploy|env get|env set|performance|summary|assistant|store events|trade-facts|agent create|positions tx> [args]
+
+Options:
+  --app-id <string>
+  --body <json>
+  --env <json>
+  --json
+  --limit <integer>
+  --refresh
+  --team-id <string>
+  --watch
+```
+## opentool
+
+```text
+Usage:
+  openpond opentool <init|validate|build> [args]
+```