diff --git a/CHANGELOG.md b/CHANGELOG.md index fb1a6370f..1b19f5805 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ ### Bug Fixes: +- fix(ai-runtime-control): update AI Runtime Control command descriptions to reflect the latest API references ([#1939](https://github.com/fastly/cli/pull/1939)) + ### Enhancements: ### Dependencies: diff --git a/pkg/commands/airuntimecontrol/doc.go b/pkg/commands/airuntimecontrol/doc.go index 5fcf2b239..39d245d79 100644 --- a/pkg/commands/airuntimecontrol/doc.go +++ b/pkg/commands/airuntimecontrol/doc.go @@ -1,2 +1,2 @@ -// Package airuntimecontrol contains commands to inspect and manipulate AI Runtime Control (ARC) objects. +// Package airuntimecontrol contains commands to inspect and manipulate AI Runtime Control objects. package airuntimecontrol diff --git a/pkg/commands/airuntimecontrol/key/delete.go b/pkg/commands/airuntimecontrol/key/delete.go index a325be435..9542532bc 100644 --- a/pkg/commands/airuntimecontrol/key/delete.go +++ b/pkg/commands/airuntimecontrol/key/delete.go @@ -30,7 +30,7 @@ func NewDeleteCommand(parent argparser.Registerer, g *global.Data) *DeleteComman Globals: g, }, } - c.CmdClause = parent.Command("delete", "Delete a virtual key").Alias("remove") + c.CmdClause = parent.Command("delete", "Delete a virtual key and any associated security configuration").Alias("remove") // Required. c.CmdClause.Flag("key-id", "Alphanumeric string identifying the virtual key").Required().StringVar(&c.keyID) diff --git a/pkg/commands/airuntimecontrol/key/doc.go b/pkg/commands/airuntimecontrol/key/doc.go index 6198be9b3..12d0a6bf4 100644 --- a/pkg/commands/airuntimecontrol/key/doc.go +++ b/pkg/commands/airuntimecontrol/key/doc.go @@ -1,2 +1,2 @@ -// Package key contains commands to inspect and manipulate AI Runtime Control (ARC) virtual keys. +// Package key contains commands to inspect and manipulate AI Runtime Control virtual keys. package key diff --git a/pkg/commands/airuntimecontrol/key/root.go b/pkg/commands/airuntimecontrol/key/root.go index 13e892c1e..c92227503 100644 --- a/pkg/commands/airuntimecontrol/key/root.go +++ b/pkg/commands/airuntimecontrol/key/root.go @@ -21,7 +21,7 @@ const CommandName = "key" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage ARC virtual keys") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control virtual keys") return &c } diff --git a/pkg/commands/airuntimecontrol/key/rotate.go b/pkg/commands/airuntimecontrol/key/rotate.go index bcd3b6d1f..e69af93ab 100644 --- a/pkg/commands/airuntimecontrol/key/rotate.go +++ b/pkg/commands/airuntimecontrol/key/rotate.go @@ -32,7 +32,7 @@ func NewRotateCommand(parent argparser.Registerer, g *global.Data) *RotateComman Globals: g, }, } - c.CmdClause = parent.Command("rotate", "Rotate a virtual key, generating a new access token") + c.CmdClause = parent.Command("rotate", "Rotate a virtual key, generating a new access token and invalidating the previous one") // Required. c.CmdClause.Flag("key-id", "Alphanumeric string identifying the virtual key").Required().StringVar(&c.keyID) diff --git a/pkg/commands/airuntimecontrol/provider/doc.go b/pkg/commands/airuntimecontrol/provider/doc.go index 7999c3c3c..43e9cb914 100644 --- a/pkg/commands/airuntimecontrol/provider/doc.go +++ b/pkg/commands/airuntimecontrol/provider/doc.go @@ -1,2 +1,2 @@ -// Package provider contains commands to inspect AI Runtime Control (ARC) providers. +// Package provider contains commands to inspect AI Runtime Control providers. package provider diff --git a/pkg/commands/airuntimecontrol/provider/list.go b/pkg/commands/airuntimecontrol/provider/list.go index 50e06e25f..b52414803 100644 --- a/pkg/commands/airuntimecontrol/provider/list.go +++ b/pkg/commands/airuntimecontrol/provider/list.go @@ -27,7 +27,7 @@ func NewListCommand(parent argparser.Registerer, g *global.Data) *ListCommand { Globals: g, }, } - c.CmdClause = parent.Command("list", "List AI providers supported by ARC") + c.CmdClause = parent.Command("list", "List AI providers supported by AI Runtime Control") // Optional. c.RegisterFlagBool(c.JSONFlag()) diff --git a/pkg/commands/airuntimecontrol/provider/root.go b/pkg/commands/airuntimecontrol/provider/root.go index 0fde2b99d..1c8aec048 100644 --- a/pkg/commands/airuntimecontrol/provider/root.go +++ b/pkg/commands/airuntimecontrol/provider/root.go @@ -21,7 +21,7 @@ const CommandName = "provider" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage ARC providers") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control providers") return &c } diff --git a/pkg/commands/airuntimecontrol/providerconnection/create.go b/pkg/commands/airuntimecontrol/providerconnection/create.go index 70cb8409c..294690511 100644 --- a/pkg/commands/airuntimecontrol/providerconnection/create.go +++ b/pkg/commands/airuntimecontrol/providerconnection/create.go @@ -38,9 +38,9 @@ func NewCreateCommand(parent argparser.Registerer, g *global.Data) *CreateComman c.CmdClause = parent.Command("create", "Create a provider connection").Alias("add") // Required. - c.CmdClause.Flag("name", "Human-readable name of the provider").Required().StringVar(&c.name) + c.CmdClause.Flag("name", "Human-readable name of the provider connection").Required().StringVar(&c.name) c.CmdClause.Flag("models", "Comma-separated list of allowed AI model identifiers").Required().StringsVar(&c.models, kingpin.Separator(",")) - c.CmdClause.Flag("base-url", "Base URL for the provider's API").Required().StringVar(&c.baseURL) + c.CmdClause.Flag("base-url", "Base URL for the provider's API. Must be an absolute http or https URL").Required().StringVar(&c.baseURL) c.CmdClause.Flag("api-key", "Provider's secret key for authentication").Required().StringVar(&c.apiKey) // Optional. diff --git a/pkg/commands/airuntimecontrol/providerconnection/delete.go b/pkg/commands/airuntimecontrol/providerconnection/delete.go index cdc456c1c..de68b89ff 100644 --- a/pkg/commands/airuntimecontrol/providerconnection/delete.go +++ b/pkg/commands/airuntimecontrol/providerconnection/delete.go @@ -30,7 +30,7 @@ func NewDeleteCommand(parent argparser.Registerer, g *global.Data) *DeleteComman Globals: g, }, } - c.CmdClause = parent.Command("delete", "Delete a provider connection").Alias("remove") + c.CmdClause = parent.Command("delete", "Delete a provider connection. This is rejected if the connection is still referenced by a virtual key's failover policy").Alias("remove") // Required. c.CmdClause.Flag("id", "Alphanumeric string identifying the provider connection").Required().StringVar(&c.id) diff --git a/pkg/commands/airuntimecontrol/providerconnection/doc.go b/pkg/commands/airuntimecontrol/providerconnection/doc.go index ee73b2875..0fa4ee1f7 100644 --- a/pkg/commands/airuntimecontrol/providerconnection/doc.go +++ b/pkg/commands/airuntimecontrol/providerconnection/doc.go @@ -1,2 +1,2 @@ -// Package providerconnection contains commands to inspect and manipulate AI Runtime Control (ARC) provider connections. +// Package providerconnection contains commands to inspect and manipulate AI Runtime Control provider connections. package providerconnection diff --git a/pkg/commands/airuntimecontrol/providerconnection/root.go b/pkg/commands/airuntimecontrol/providerconnection/root.go index 40277b90c..50dbb0a28 100644 --- a/pkg/commands/airuntimecontrol/providerconnection/root.go +++ b/pkg/commands/airuntimecontrol/providerconnection/root.go @@ -21,7 +21,7 @@ const CommandName = "provider-connection" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage ARC provider connections") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control provider connections") return &c } diff --git a/pkg/commands/airuntimecontrol/providerconnection/update.go b/pkg/commands/airuntimecontrol/providerconnection/update.go index 48f679da8..fa6a6ff8f 100644 --- a/pkg/commands/airuntimecontrol/providerconnection/update.go +++ b/pkg/commands/airuntimecontrol/providerconnection/update.go @@ -44,7 +44,7 @@ func NewUpdateCommand(parent argparser.Registerer, g *global.Data) *UpdateComman // Optional. c.CmdClause.Flag("models", "An updated comma-separated list of allowed AI model identifiers").StringsVar(&c.models, kingpin.Separator(",")) - c.CmdClause.Flag("base-url", "An updated base URL for the provider's API").Action(c.baseURL.Set).StringVar(&c.baseURL.Value) + c.CmdClause.Flag("base-url", "An updated base URL for the provider's API. Must be an absolute http or https URL").Action(c.baseURL.Set).StringVar(&c.baseURL.Value) c.CmdClause.Flag("api-key", "An updated provider secret key for authentication").Action(c.apiKey.Set).StringVar(&c.apiKey.Value) c.RegisterFlagBool(c.JSONFlag()) diff --git a/pkg/commands/airuntimecontrol/root.go b/pkg/commands/airuntimecontrol/root.go index 07dbc8b10..b12487d43 100644 --- a/pkg/commands/airuntimecontrol/root.go +++ b/pkg/commands/airuntimecontrol/root.go @@ -21,7 +21,7 @@ const CommandName = "ai-runtime-control" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control (ARC)") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control") return &c } diff --git a/pkg/commands/airuntimecontrol/session/doc.go b/pkg/commands/airuntimecontrol/session/doc.go index 164e60fe9..5ba33306a 100644 --- a/pkg/commands/airuntimecontrol/session/doc.go +++ b/pkg/commands/airuntimecontrol/session/doc.go @@ -1,2 +1,2 @@ -// Package session contains commands to inspect AI Runtime Control (ARC) session logs. +// Package session contains commands to inspect AI Runtime Control session logs. package session diff --git a/pkg/commands/airuntimecontrol/session/list.go b/pkg/commands/airuntimecontrol/session/list.go index 64be4a174..b1b73ffb8 100644 --- a/pkg/commands/airuntimecontrol/session/list.go +++ b/pkg/commands/airuntimecontrol/session/list.go @@ -41,8 +41,8 @@ func NewListCommand(parent argparser.Registerer, g *global.Data) *ListCommand { // Optional. c.CmdClause.Flag("key", "Filter by a specific virtual key ID").Action(c.key.Set).StringVar(&c.key.Value) - c.CmdClause.Flag("provider", "Filter by provider name").Action(c.provider.Set).StringVar(&c.provider.Value) - c.CmdClause.Flag("model", "Filter by model name").Action(c.model.Set).StringVar(&c.model.Value) + c.CmdClause.Flag("provider", "Filter by provider connection ID").Action(c.provider.Set).StringVar(&c.provider.Value) + c.CmdClause.Flag("model", "Filter by AI model identifier").Action(c.model.Set).StringVar(&c.model.Value) c.CmdClause.Flag("from", "Start of the time range (RFC 3339 format)").HintOptions("2026-07-28T19:24:50+00:00").TimeVar(time.RFC3339, &c.from) c.CmdClause.Flag("to", "End of the time range (RFC 3339 format). Defaults to now").HintOptions("2026-07-28T19:24:50+00:00").TimeVar(time.RFC3339, &c.to) c.RegisterFlagBool(c.JSONFlag()) // --json diff --git a/pkg/commands/airuntimecontrol/session/root.go b/pkg/commands/airuntimecontrol/session/root.go index d6ff0b349..c223f3ed4 100644 --- a/pkg/commands/airuntimecontrol/session/root.go +++ b/pkg/commands/airuntimecontrol/session/root.go @@ -21,7 +21,7 @@ const CommandName = "session" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage ARC session logs") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control session logs") return &c } diff --git a/pkg/commands/airuntimecontrol/usagemetrics/doc.go b/pkg/commands/airuntimecontrol/usagemetrics/doc.go index bf2430b8f..5780e11f1 100644 --- a/pkg/commands/airuntimecontrol/usagemetrics/doc.go +++ b/pkg/commands/airuntimecontrol/usagemetrics/doc.go @@ -1,2 +1,2 @@ -// Package usagemetrics contains commands to inspect AI Runtime Control (ARC) usage metrics. +// Package usagemetrics contains commands to inspect AI Runtime Control usage metrics. package usagemetrics diff --git a/pkg/commands/airuntimecontrol/usagemetrics/flags.go b/pkg/commands/airuntimecontrol/usagemetrics/flags.go index 5b5213105..0b97e5be7 100644 --- a/pkg/commands/airuntimecontrol/usagemetrics/flags.go +++ b/pkg/commands/airuntimecontrol/usagemetrics/flags.go @@ -22,8 +22,8 @@ type filterFlags struct { // register defines the shared filter flags against the given command clause. func (f *filterFlags) register(c argparser.Base) { c.CmdClause.Flag("key", "Filter by a specific virtual key ID").Action(f.key.Set).StringVar(&f.key.Value) - c.CmdClause.Flag("provider", "Filter by provider name").Action(f.provider.Set).StringVar(&f.provider.Value) - c.CmdClause.Flag("model", "Filter by model name").Action(f.model.Set).StringVar(&f.model.Value) + c.CmdClause.Flag("provider", "Filter by provider connection ID").Action(f.provider.Set).StringVar(&f.provider.Value) + c.CmdClause.Flag("model", "Filter by AI model identifier").Action(f.model.Set).StringVar(&f.model.Value) c.CmdClause.Flag("from", "Start of the time range (RFC 3339 format)").HintOptions("2026-07-28T19:24:50+00:00").TimeVar(time.RFC3339, &f.from) c.CmdClause.Flag("to", "End of the time range (RFC 3339 format). Defaults to now").HintOptions("2026-07-28T19:24:50+00:00").TimeVar(time.RFC3339, &f.to) c.CmdClause.Flag("sort", "Sort field. Prefix with '-' for descending order (e.g. \"-date\")").Default("date").Action(f.sort.Set).StringVar(&f.sort.Value) diff --git a/pkg/commands/airuntimecontrol/usagemetrics/root.go b/pkg/commands/airuntimecontrol/usagemetrics/root.go index 868305628..fc3806f06 100644 --- a/pkg/commands/airuntimecontrol/usagemetrics/root.go +++ b/pkg/commands/airuntimecontrol/usagemetrics/root.go @@ -21,7 +21,7 @@ const CommandName = "usage-metrics" func NewRootCommand(parent argparser.Registerer, g *global.Data) *RootCommand { var c RootCommand c.Globals = g - c.CmdClause = parent.Command(CommandName, "Manage ARC usage metrics") + c.CmdClause = parent.Command(CommandName, "Manage AI Runtime Control usage metrics") return &c } diff --git a/pkg/commands/commands.go b/pkg/commands/commands.go index 75bb977a8..9eb14af24 100644 --- a/pkg/commands/commands.go +++ b/pkg/commands/commands.go @@ -252,7 +252,7 @@ func Define( // nolint:revive // function-length } } - // AI Runtime Control (ARC) commands + // AI Runtime Control commands arcRoot := airuntimecontrol.NewRootCommand(app, data) arcKeyRoot := arckey.NewRootCommand(arcRoot.CmdClause, data) arcKeyCreate := arckey.NewCreateCommand(arcKeyRoot.CmdClause, data) diff --git a/pkg/text/provider.go b/pkg/text/provider.go index cb1c6b6c6..f9d7f7bb4 100644 --- a/pkg/text/provider.go +++ b/pkg/text/provider.go @@ -7,7 +7,7 @@ import ( "github.com/fastly/go-fastly/v17/fastly/airuntimecontrol/v1/provider" ) -// PrintProvidersTbl displays ARC providers in a table format. Model lists can +// PrintProvidersTbl displays AI Runtime Control providers in a table format. Model lists can // run into the dozens per provider, so only a count is shown here; use // `list-models --provider-id ` to see the full list for a given provider. func PrintProvidersTbl(out io.Writer, providersToPrint []provider.Provider) { @@ -25,7 +25,7 @@ func PrintProvidersTbl(out io.Writer, providersToPrint []provider.Provider) { tbl.Print() } -// PrintModelsTbl displays ARC models in a table format. +// PrintModelsTbl displays AI Runtime Control models in a table format. func PrintModelsTbl(out io.Writer, modelsToPrint []provider.Model) { tbl := NewTable(out) tbl.AddHeader("ID", "Display Name", "Provider ID") diff --git a/pkg/text/session.go b/pkg/text/session.go index 6567b6b7f..c66b1b2aa 100644 --- a/pkg/text/session.go +++ b/pkg/text/session.go @@ -7,7 +7,7 @@ import ( "github.com/fastly/go-fastly/v17/fastly/airuntimecontrol/v1/session" ) -// PrintSessionsTbl displays ARC session logs in a table format. +// PrintSessionsTbl displays AI Runtime Control session logs in a table format. func PrintSessionsTbl(out io.Writer, sessionsToPrint []session.Session) { tbl := NewTable(out) tbl.AddHeader("ID", "Virtual Key", "Model", "Provider", "Requests", "Input Tokens", "Output Tokens", "Created At") diff --git a/pkg/text/usagemetric.go b/pkg/text/usagemetric.go index d6cdb4878..b7bc958e4 100644 --- a/pkg/text/usagemetric.go +++ b/pkg/text/usagemetric.go @@ -7,7 +7,7 @@ import ( "github.com/fastly/go-fastly/v17/fastly/airuntimecontrol/v1/usagemetrics" ) -// PrintUsageMetricsTbl displays ARC usage metrics in a table format. +// PrintUsageMetricsTbl displays AI Runtime Control usage metrics in a table format. func PrintUsageMetricsTbl(out io.Writer, metricsToPrint []usagemetrics.UsageMetric) { tbl := NewTable(out) tbl.AddHeader("Date", "Usage Type", "Quantity", "Virtual Key", "Provider", "Model")