cli

type CLIFlagHint ¶ added in v1.0.48

type CLIFlagHint struct {
	Shorthand string `json:"shorthand,omitempty"`
	Alias     string `json:"alias,omitempty"`
}

CLIFlagHint holds CLI flag alias/shorthand metadata for a tool parameter.

type CanonicalProduct ¶ added in v1.0.48

type CanonicalProduct struct {
	ID          string           `json:"id"`
	DisplayName string           `json:"display_name"`
	Description string           `json:"description,omitempty"`
	ServerKey   string           `json:"server_key"`
	Endpoint    string           `json:"endpoint"`
	Source      string           `json:"source,omitempty"`
	Tools       []ToolDescriptor `json:"tools"`
}

CanonicalProduct represents a single MCP product in the catalog.

func (p CanonicalProduct) FindTool(name string) (ToolDescriptor, bool)

type Catalog ¶ added in v1.0.48

type Catalog struct {
	Products []CanonicalProduct `json:"products"`
}

Catalog holds the discovered MCP product surface.

func (c Catalog) FindProduct(id string) (CanonicalProduct, bool)

type CatalogDegraded ¶ added in v1.0.9

type CatalogDegraded struct {
	Reason      CatalogDegradedReason
	Hint        string
	ServerCount int
}

CatalogDegraded is returned by EnvironmentLoader.Load when discovery fails for a diagnosable reason. Callers that need graceful degradation (e.g. the runtime runner) can check errors.As and fall back to an empty catalog; callers like the schema command can surface the hint.

func (e *CatalogDegraded) Error() string

type CatalogDegradedReason ¶ added in v1.0.9

type CatalogDegradedReason string

CatalogDegradedReason identifies why catalog discovery returned empty.

const (
	DegradedUnauthenticated   CatalogDegradedReason = "unauthenticated"
	DegradedMarketUnreachable CatalogDegradedReason = "market_unreachable"
	DegradedRuntimeAllFailed  CatalogDegradedReason = "runtime_all_failed"
)

type CatalogLoader ¶

type CatalogLoader interface {
	Load(context.Context) (Catalog, error)
}

CatalogLoader loads the canonical catalog.

func CatalogLoaderFrom(catalog Catalog, err error) CatalogLoader

type EnvironmentLoader ¶

type EnvironmentLoader struct {
	LookupEnv              func(string) (string, bool)
	CatalogBaseURLOverride string
	AuthTokenFunc          func(context.Context) string
	LoggerFunc             func() *slog.Logger
}

EnvironmentLoader provides catalog loading. In the post-discovery architecture this always returns an empty catalog; endpoint resolution is handled by the direct runtime path.

func NewEnvironmentLoader() EnvironmentLoader

func (l EnvironmentLoader) Load(_ context.Context) (Catalog, error)

type FlagKind ¶

type FlagKind string

type FlagSpec ¶

type FlagSpec struct {
	PropertyName string
	FlagName     string
	Alias        string
	Shorthand    string
	Kind         FlagKind
	Description  string
}

func BuildFlagSpecs(schema map[string]any, hints map[string]CLIFlagHint) []FlagSpec

type HelperToolFetcher ¶ added in v1.0.42

type HelperToolFetcher func(ctx context.Context, source string) (map[string]HelperToolSchema, error)

HelperToolFetcher loads a helper MCP server's tools/list LIVE and returns toolName→schema for the given source (e.g. "op-app" for dev app commands, "devdoc" for dev doc commands). The schema command injects this so dev_schema.go can resolve a command's MCP tool and render its real schema without the cli package importing app/transport. Implementations should cache per-source per-process so repeated `dws schema dev.*` only hit the network once per source.

type HelperToolSchema ¶ added in v1.0.42

type HelperToolSchema struct {
	Name        string
	Description string
	Properties  map[string]any // MCP param name → property object {type,description,default?,...}
	Required    []string       // MCP param names that are required
}

HelperToolSchema is the live op-app tool schema the renderer needs: the raw MCP description plus the inputSchema's properties/required, exactly as the server returned them (no local transformation of CONTENT).

type StaticLoader ¶

type StaticLoader struct {
	Catalog Catalog
}

StaticLoader returns a pre-built catalog.

func (l StaticLoader) Load(_ context.Context) (Catalog, error)

type StdinGuard ¶

type StdinGuard struct {
	// contains filtered or unexported fields
}

StdinGuard ensures stdin is consumed at most once per command invocation. Multiple flags using @- or implicit stdin fallback would race on the same reader; StdinGuard detects and rejects the second claim with a clear error.

func NewStdinGuard() *StdinGuard

func (g *StdinGuard) Claim(source string) error

func (g *StdinGuard) Claimed() bool

type ToolDescriptor ¶ added in v1.0.48

type ToolDescriptor struct {
	RPCName       string `json:"rpc_name"`
	CanonicalPath string `json:"canonical_path"`
}

ToolDescriptor represents a single tool in a canonical product.