Skip to content

Improve agentic API CLI ergonomics#84

Open
odyslam wants to merge 29 commits intomainfrom
codex/agentic-full-api-cli
Open

Improve agentic API CLI ergonomics#84
odyslam wants to merge 29 commits intomainfrom
codex/agentic-full-api-cli

Conversation

@odyslam
Copy link
Copy Markdown
Contributor

@odyslam odyslam commented May 2, 2026

Summary

  • add workflow-shaped pcl api commands for project, assertion, incident, account, access, release, deployment, integration, protocol-manager, transfer, event, and search actions
  • make TOON the default structured output for successes and errors, with --json as the explicit full-envelope option
  • make auth status truthful for agents by reporting token validity, expiry, platform URL, and returning a structured nonzero error for expired tokens
  • let raw api call accept inline ?query strings, return nonzero structured envelopes for non-2xx API responses, surface request IDs, and write response bodies with --output
  • add pcl api incidents --all --limit <n> --output <file> pagination support for incident list workflows
  • add executable OpenAPI discovery CTAs, compact inspect output, action-specific body templates, oneOf body variants, and a structured agent manifest
  • guard ambiguous/missing write-action flags and preserve API error response bodies for agent recovery
  • update README and command help so agents see the current TOON-default / JSON-optional contract

Tests

  • cargo fmt --check
  • cargo test -q --workspace --all-targets
  • cargo +nightly-2026-01-07 clippy --all-targets --workspace --locked --profile dev -- -D warnings -D clippy::pedantic
  • git diff --check
  • CLI smokes for auth status logged-out/expired token, raw query-string calls, raw API non-2xx exits, --output, default TOON errors, --json errors, public CTAs, and body-template variants

Note: crates/dapp-api-client/src/generated/client.rs has a pre-existing unstaged local change and is intentionally not part of this PR.

@odyslam odyslam requested a review from lean-apple May 2, 2026 03:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant