---
name: actionway-dev
description: Use the installed Actionway development channel to discover, inspect, price, and call capabilities against dev.actionway.ai; test confirmed calls and async jobs; or inspect the deployed dev CLI source SHA without touching the stable Actionway installation. Trigger for Actionway dev environment, staging verification, a newly merged dev deployment, or pre-production Codex testing.
---

# Actionway Dev

Use only the `actionway-dev` executable. Never substitute the stable `actionway` command.

## Prepare

1. Run `actionway-dev update` once per Agent session. It follows public `@actionway/cli-dev@latest` from the latest successful `dev` deployment and never updates the stable `@actionway/cli` package.
2. Run `actionway-dev status` when the user asks which source SHA is installed.
3. Run `actionway-dev whoami`. On `E_NOT_AUTHENTICATED`, run `actionway-dev init` and ask the user only to approve browser login. Never request or expose credentials.

## Discover and call

1. For long-tail capabilities run `actionway-dev tools search "<intent>"`, then inspect exactly one supported result with `actionway-dev tools inspect <tool_ref>`.
2. Match the inspected Schema exactly and call with `actionway-dev tools call <tool_ref> --input-json '<object>'`.
3. On `confirmation_required`, present the server plan and quote. Resume only after approval with `actionway-dev tools call --resume <call_ref>`.
4. On `accepted`, immediately run `actionway-dev wait --job-ref=<uuid>`. Reuse the same reference until terminal state; never resubmit a pending call.

Use typed commands only when `actionway-dev --help` exposes an exact fit. Read command help and `--print-schema`, then run `--dry-run` before a real typed call.

For Web Search, use `actionway-dev search "search terms" --k 5`; omit `--provider` for automatic routing unless testing a specific provider. Legacy `--query="search terms"` is still accepted, but do not combine it with positional search terms. Enum flags accept plain values such as `--freshness pw`; old JSON-quoted enum values remain supported. Capability discovery is `actionway-dev tools search`, not `actionway-dev search`.

## Boundaries

- Treat the development Gateway as the authority for Schema, price, confirmation, and results.
- Development calls can consume development credits and real upstream vendor cost.
- Do not run the stable CLI's updater, publish npm packages, or change production configuration.