mcp

type Auth struct {
	APIKey        string
	Authorization string
}

type ChatContext struct {
	Current string             `json:"current"`
	History []ChatContextEntry `json:"history,omitempty"`
}

type ChatContextEntry struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type Classifier interface {
	Rank(ctx context.Context, chatCtx ChatContext, digest []ToolDigest) ([]string, error)
	TopK() int
}

type CommandExecutionOptions struct {
	PublicAPIURL string
}

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

type DocsSearchIndexOptions struct {
	DocsSiteURL    string
	SearchIndexURL string
	TTL            time.Duration
	HTTPClient     *http.Client
}

type ExecutionOptions struct {
	Command        []string
	DisplayCommand []string
	Body           any
	Auth           Auth
	PublicAPIURL   string
}

type ExecutionResult struct {
	Stdout          string
	Stderr          string
	StdoutTruncated bool
	StderrTruncated bool
	ExitCode        int
	Payload         any
}

type FlagBinding struct {
	Property string
	FlagName string
	Kind     string
}

type IntentMode string

type IntentOptions struct {
	Mode       IntentMode
	Classifier Classifier
	Specs      []ToolSpec
}

type KnowledgeOptions struct {
	DocsSiteURL     string
	DocsIndexURL    string
	PlatformBaseURL string
	DocsTTL         int64
}

type KnowledgeSearchResult struct {
	Title   string `json:"title"`
	URL     string `json:"url"`
	Snippet string `json:"snippet"`
}

type LinkIntent struct {
	ExplicitLinkRequest bool
	Target              LinkTarget
}

type LinkTarget string

type PlatformLink struct {
	Label string `json:"label"`
	URL   string `json:"url"`
}

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

type PlatformRoute struct {
	Path   string   `json:"path"`
	Tokens []string `json:"tokens"`
}

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

type ServerOptions struct {
	Version      string
	Port         int
	PublicAPIURL string
	Tools        []ToolSpec
	// IntentMode controls the tools/list interceptor. When empty the server
	// defaults to IntentModeCompactOnly, which serves compact stubs but never
	// calls a classifier. Set to IntentModeOn to enable classifier-driven
	// expansion (requires MCP_CLASSIFIER_* env vars). IntentModeOff disables
	// the middleware entirely.
	IntentMode IntentMode
	// Classifier is an optional ranker used when IntentMode == IntentModeOn.
	// If nil while IntentModeOn, the server behaves as IntentModeCompactOnly.
	Classifier Classifier
}

type ToolDigest struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type ToolSpec struct {
	Name           string
	Path           string
	Description    string
	Tool           mcpgo.Tool
	Command        []string
	PositionalArgs []string
	FlagBindings   []FlagBinding
	BodyProperty   string
	// AllowExtraArgs opts the tool into reading a free-form `args` string array
	// from the request payload and forwarding it verbatim to the subprocess.
	// Off by default so the Cobra-to-MCP mapping remains an explicit allowlist.
	AllowExtraArgs bool
}