inventory

type AgentDetail struct {
	// Version is the agent's reported version, when available.
	Version string
	// PermissionMode is the agent's configured permission mode.
	PermissionMode string
	// InstructionFiles is the set of instruction files driving the agent.
	InstructionFiles []string
	// Model is the configured LLM model identifier.
	Model string
	// APIKeyEnvName is the env var name (not value) holding the API key.
	APIKeyEnvName string
}

type EmitFunc func(*Item) error

type Item struct {
	// Kind classifies the item.
	Kind Kind
	// ItemIdentity is the deterministic dedup key (FNV-64a of
	// app/kind/scope/name/config_path); computed by the scanner adapter.
	ItemIdentity string
	// SourceID groups items emitted from the same source (app + config file).
	SourceID string
	// Name is the human-readable label for the item.
	Name string
	// App is the application that owns / configures this item.
	App string
	// Scope is system-wide vs project-local.
	Scope Scope
	// ConfigPath is the absolute path to the config file the item was found in.
	ConfigPath string
	// Enabled is the optional enabled flag; nil means unknown.
	Enabled *bool
	// MCPServer carries MCP-server-specific details when Kind == KindMCPServer.
	MCPServer *MCPServerDetail
	// Agent carries coding-agent-specific details when Kind == KindCodingAgent.
	Agent *AgentDetail
	// Metadata holds free-form, kind-specific attributes for kinds without a
	// typed sub-message (CLI tools, AI extensions, etc.).
	Metadata map[string]string
}

type Kind int

type MCPServerDetail struct {
	// Transport is the MCP transport classification.
	Transport Transport
	// Command is the binary executed for stdio transports.
	Command string
	// Args is the command-line arguments for stdio transports.
	Args []string
	// URL is the endpoint for HTTP-based transports.
	URL string
	// EnvVarNames is the names (not values) of env vars referenced.
	EnvVarNames []string
	// HeaderNames is the names (not values) of HTTP headers referenced.
	HeaderNames []string
	// AllowedTools is the explicit tool allowlist if configured.
	AllowedTools []string
	// AllowedResources is the explicit resource allowlist if configured.
	AllowedResources []string
}

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

type ScanConfig struct {
	// HomeDir overrides the user home directory; empty string means
	// "use the OS-detected home".
	HomeDir string
	// ProjectDir is the project root for project-scoped discovery; empty
	// string means project-scoped discovery is skipped.
	ProjectDir string
	// Scopes is the allowlist of scopes a scanner should enumerate.
	// A nil slice means "all scopes enabled" (mirrors aitool.DiscoveryConfig
	// semantics). An empty (non-nil) slice means "no scopes enabled".
	Scopes []Scope
}

type ScanError struct {
	// ScannerName is the Scanner.Name() of the active scanner. Sink.Emit
	// failures are attributed here too, matching the proto's discoverer
	// field semantics.
	ScannerName string
	// ErrorType is a coarse classifier (e.g. "scanner_failed",
	// "sink_emit_failed"). Optional; empty when not classified.
	ErrorType string
	// Message is the human-readable failure description.
	Message string
}

type ScanSummary struct {
	// TotalObserved is the number of items emitted across all scanners.
	TotalObserved uint64
	// KindCounts is the per-Kind tally of emitted items.
	KindCounts map[Kind]uint64
	// Errors are the discoverer-level failures collected during the scan;
	// the scan continues past each error.
	Errors []ScanError
}

type Scanner interface {
	// Name is a stable, log-safe identifier (e.g. "aitool", "browser_ext").
	Name() string
	// Scan walks the configured sources and invokes emit for each item.
	// Scan returns nil on success, the emit-callback's error if it
	// requested early termination, or a discoverer-level failure.
	Scan(ctx context.Context, cfg ScanConfig, emit EmitFunc) error
}

type Scope int

type Session struct {
	// InvocationID is a UUID identifying this scan run. Equal across all
	// events emitted by the same Run; distinct between Runs.
	InvocationID string
	// StartedAt is the wall-clock time the session was created.
	StartedAt time.Time
}

type Sink interface {
	// Begin announces a new scan. Returning an error aborts the Run.
	Begin(ctx context.Context, session *Session) error
	// Emit consumes one observed item. The orchestrator does not retry; an
	// error is captured into the ScanSummary and the next sink is called.
	Emit(ctx context.Context, item *Item) error
	// End delivers the aggregated summary at end-of-scan.
	End(ctx context.Context, summary *ScanSummary) error
	// Close releases resources held by the sink.
	Close(ctx context.Context) error
}

type Transport int