MingaAgent.Introspection (Minga v0.1.0)

Runtime self-description for external clients.

Produces structured capability manifests, tool descriptions, and session descriptions. All functions are pure data transforms over the current registry and session state. No side effects beyond ETS reads and one GenServer call.

External clients use this to discover what the runtime can do before making requests. The API gateway exposes these as JSON-RPC methods.

Summary

Types

capabilities_manifest()

Runtime capabilities manifest.

session_description()

Structured session description for external clients.

tool_description()

Structured tool description for external clients.

Functions

capabilities()

Returns a capabilities manifest describing the runtime.

describe_sessions()

Returns structured descriptions of all active sessions.

describe_tools()

Returns structured descriptions of all registered tools.

Types

capabilities_manifest()

@type capabilities_manifest() :: %{
  version: String.t(),
  tool_count: non_neg_integer(),
  session_count: non_neg_integer(),
  tool_categories: [MingaAgent.Tool.Spec.category()],
  features: [atom()]
}

Runtime capabilities manifest.

session_description()

@type session_description() :: %{
  session_id: String.t(),
  model_name: String.t(),
  status: atom(),
  created_at: String.t()
}

Structured session description for external clients.

tool_description()

@type tool_description() :: %{
  name: String.t(),
  description: String.t(),
  parameter_schema: map(),
  category: MingaAgent.Tool.Spec.category(),
  approval_level: MingaAgent.Tool.Spec.approval_level()
}

Structured tool description for external clients.

Functions

capabilities()

@spec capabilities() :: capabilities_manifest()

Returns a capabilities manifest describing the runtime.

describe_sessions()

@spec describe_sessions() :: [session_description()]

Returns structured descriptions of all active sessions.

describe_tools()

@spec describe_tools() :: [tool_description()]

Returns structured descriptions of all registered tools.