[CDTOOL-1807] Update AI Runtime Control Docs

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:

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

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)

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

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
 }
 

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)

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

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())

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
 }
 

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.

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)

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

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
 }
 

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())
 

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
 }
 

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

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

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
 }
 

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

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)

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
 }
 

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)

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 <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")

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")

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")