Enum ProviderOp 

pub enum ProviderOp {
    List {
        json: bool,
        target: AuthTarget,
    },
    Add {

        name: String,
        kind: String,
        base_url: String,
        model: Option<String>,
        models: Vec<String>,
        supported_clients: Vec<String>,
        api_key: Option<String>,
        api_key_stdin: bool,
        api_key_env: Option<String>,
        subscriber_id: Option<String>,
        acknowledge_intermediary_risk: bool,
        acknowledge_unsupported_client: Vec<String>,
        enabled: bool,
        if_absent: bool,
        target: AuthTarget,
    
},
    Show {
        name: String,
        json: bool,
        target: AuthTarget,
    },
    Remove {
        name: String,
        target: AuthTarget,
    },
    Import {
        path: PathBuf,
        target: AuthTarget,
    },
}

Variants

List

List configured upstream providers.

Fields

json: bool

Emit JSON instead of the table (issue #314).

target: AuthTarget

Add

Add or replace an API provider or policy-gated credential class.

create and issue are accepted too (issue #314).

Fields

name: String

Name this provider is referred to by, in routing and in providers show. Adding an existing name replaces that record.

kind: String

Wire protocol the upstream speaks.

base_url: String

The upstream’s own base URL — not the router’s. --server names the router; this names the machine it forwards to (issue #314).

model: Option<String>

Single model this provider serves, for an upstream that serves one.

models: Vec<String>

Comma-separated models this provider serves.

supported_clients: Vec<String>

Canonical managed clients explicitly supported by this ordinary provider adapter. Repeat or comma-separate values.

api_key: Option<String>

Vendor API key, stored encrypted under the deployment’s TOKEN_SECRET.

Prefer --api-key-stdin: a key given here is visible in shell history and in ps (issue #314).

api_key_stdin: bool

Read the vendor API key as one line from standard input.

The one secret in this tool that could travel only through argv, while every other has had a stdin form and clients setup --help warns against argv for exactly this reason (issue #314).

api_key_env: Option<String>

Environment variable the router process reads the key from at request time, instead of storing one.

subscriber_id: Option<String>

Single subscriber allowed to spend a personal Coding Plan key.

acknowledge_intermediary_risk: bool

Accept the documented account risk of intermediary personal proxying.

acknowledge_unsupported_client: Vec<String>

Individually risk-accept a known tool not listed by z.ai.

enabled: bool

Whether this provider takes part in routing. Disabled records are kept and ignored, so one can be parked without deleting it.

if_absent: bool

Create only when the provider name is absent; never replace it.

target: AuthTarget

Show

Show one provider with secret material redacted.

Fields

name: String

json: bool

Accepted for symmetry with list: show already emits JSON, so this changes nothing (issue #314). A script should not have to know which verb of a family takes the flag.

target: AuthTarget

Remove

Remove one provider.

revoke and delete are accepted too (issue #314).

Fields

name: String

target: AuthTarget

Import

Import providers from JSON, .lenv, or indented Links-style config.

Fields

path: PathBuf

target: AuthTarget

Implementations

impl ProviderOp

pub const fn target(&self) -> &AuthTarget

Which router this provider operation acts on.

Trait Implementations

impl Debug for ProviderOp

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for ProviderOp

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for ProviderOp

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand