Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent runs Stella's agents: the pool of live agent services, the session registry, the runner factory, and the per-agent Settings policy that decides which management tools a turn may reach.
|
Package agent runs Stella's agents: the pool of live agent services, the session registry, the runner factory, and the per-agent Settings policy that decides which management tools a turn may reach. |
|
runtime
Package runtime executes agent conversations in already-resolved sessions.
|
Package runtime executes agent conversations in already-resolved sessions. |
|
sandbox
Package sandbox resolves an agent's sandbox config into a live session and provides that session's agent-facing tool projections (bash, read, write, edit).
|
Package sandbox resolves an agent's sandbox config into a live session and provides that session's agent-facing tool projections (bash, read, write, edit). |
|
session
Package session owns agent-session lifecycle.
|
Package session owns agent-session lifecycle. |
|
session/access
Package access is the authoritative Session and Workspace application service.
|
Package access is the authoritative Session and Workspace application service. |
|
session/inbox
Package inbox persists Agent-originated Session inputs without owning their execution.
|
Package inbox persists Agent-originated Session inputs without owning their execution. |
|
session/turnqueue
Package turnqueue serializes synchronous agent-originated turns per Session.
|
Package turnqueue serializes synchronous agent-originated turns per Session. |
|
settingspolicy
Package settingspolicy owns the narrow discovery and turn-capability boundary for conversational Settings tools.
|
Package settingspolicy owns the narrow discovery and turn-capability boundary for conversational Settings tools. |
|
tracehook
Package tracehook is the core agent trace hook: it logs LLM, tool, and memory activity via slog and, when OTel tracing is enabled, records the session/turn/LLM/tool/memory span hierarchy.
|
Package tracehook is the core agent trace hook: it logs LLM, tool, and memory activity via slog and, when OTel tracing is enabled, records the session/turn/LLM/tool/memory span hierarchy. |
|
Package asset stores immutable session media outside mutable workspace and user-data trees.
|
Package asset stores immutable session media outside mutable workspace and user-data trees. |
|
Package auth owns human identity: registration, login, session cookies, and the account records behind them.
|
Package auth owns human identity: registration, login, session cookies, and the account records behind them. |
|
account
Package account is the application boundary for user-account management: the admin and self use cases over users, their login/channel identities, sessions, password credential, and agent assignments.
|
Package account is the application boundary for user-account management: the admin and self use cases over users, their login/channel identities, sessions, password credential, and agent assignments. |
|
Package authz is the shared authorization vocabulary: Authority (who is acting), Action, and the resource identifiers domain services decide against.
|
Package authz is the shared authorization vocabulary: Authority (who is acting), Action, and the resource identifiers domain services decide against. |
|
Package channel is the ingress side of every chat platform: the Channel interface plugins implement, identity resolution from a platform account to a Stella user, slash commands, and group dispatch.
|
Package channel is the ingress side of every chat platform: the Channel interface plugins implement, identity resolution from a platform account to a Stella user, slash commands, and group dispatch. |
|
Package connections owns user-held OAuth connections: the bundles a user may connect, the flows that complete them, and the tokens the agent tools then spend.
|
Package connections owns user-held OAuth connections: the bundles a user may connect, the flows that complete them, and the tokens the agent tools then spend. |
|
Package controlplane owns Stella's deployment control-plane resources: LLM providers, deployment settings (embedding, CLI-tool registry, OAuth provider config), plugins (registered + manifest), and channels.
|
Package controlplane owns Stella's deployment control-plane resources: LLM providers, deployment settings (embedding, CLI-tool registry, OAuth provider config), plugins (registered + manifest), and channels. |
|
Package core groups the leaf kernels every other internal package needs and that need almost nothing back: tool metadata, agent context keys, sentinel errors, agent access checks, provider credentials.
|
Package core groups the leaf kernels every other internal package needs and that need almost nothing back: tool metadata, agent context keys, sentinel errors, agent access checks, provider credentials. |
|
access
Package access is the policy-enforcement point for Agent resources.
|
Package access is the policy-enforcement point for Agent resources. |
|
providercred
Package providercred owns per-Agent LLM Provider API-key overrides.
|
Package providercred owns per-Agent LLM Provider API-key overrides. |
|
toolmeta
Package toolmeta describes generated model-facing tools: the name, the family it belongs to, and the exact input schema bound to one action.
|
Package toolmeta describes generated model-facing tools: the name, the family it belongs to, and the exact input schema bound to one action. |
|
Package credential is the single front door for turning any bearer credential presented to the HTTP API into an authenticated Principal, and for enforcing what that principal may do.
|
Package credential is the single front door for turning any bearer credential presented to the HTTP API into an authenticated Principal, and for enforcing what that principal may do. |
|
Package db owns PostgreSQL: pool construction, goose migrations, the embedded cluster used when no external server is configured, and the asset metadata for the embedded runtime tarball (pgruntime_asset.go).
|
Package db owns PostgreSQL: pool construction, goose migrations, the embedded cluster used when no external server is configured, and the asset metadata for the embedded runtime tarball (pgruntime_asset.go). |
|
dbtest
Package dbtest gives tests an isolated, fully-migrated PostgreSQL database with no external server to run.
|
Package dbtest gives tests an isolated, fully-migrated PostgreSQL database with no external server to run. |
|
pgruntime
Package pgruntime locates, names, and unpacks the bundled PostgreSQL runtime asset (versioned tarball, per-source cache directory, checksum URLs).
|
Package pgruntime locates, names, and unpacks the bundled PostgreSQL runtime asset (versioned tarball, per-source cache directory, checksum URLs). |
|
Package email is the user-owned mail capability: account configuration held in the acting user's vault, plus the list/read/send use cases the HTTP layer and the agent tools share.
|
Package email is the user-owned mail capability: account configuration held in the acting user's vault, plus the list/read/send use cases the HTTP layer and the agent tools share. |
|
Package eventlog owns the authoritative, deduplicated group-message log (ctx_group_message) and its per-group ordering registry (ctx_group_state).
|
Package eventlog owns the authoritative, deduplicated group-message log (ctx_group_message) and its per-group ordering registry (ctx_group_state). |
|
Package goal is the recursive execution core: one entity (the Goal) whose completion is DERIVED from an append-only acceptance ledger, never asserted.
|
Package goal is the recursive execution core: one entity (the Goal) whose completion is DERIVED from an append-only acceptance ledger, never asserted. |
|
cmd/gengoalcontrolschema
command
|
|
|
Package grouptranscript renders public group events into the model-facing transcript.
|
Package grouptranscript renders public group events into the model-facing transcript. |
|
Package inbox is the cross-Goal/Scheduler inbox read model: it owns the two candidate queries (blocked/failed goals and failed scheduler runs), merges them, applies a stable recency sort, and paginates, returning transport-neutral domain items.
|
Package inbox is the cross-Goal/Scheduler inbox read model: it owns the two candidate queries (blocked/failed goals and failed scheduler runs), merges them, applies a stable recency sort, and paginates, returning transport-neutral domain items. |
|
Package library is the document library: raw storage, format detection, text derivation, retrieval, and the management tools over them.
|
Package library is the document library: raw storage, format detection, text derivation, retrieval, and the management tools over them. |
|
recally
Package recally provides file operations for article storage.
|
Package recally provides file operations for article storage. |
|
Package mcp is an MCP (Model Context Protocol) client for Stella.
|
Package mcp is an MCP (Model Context Protocol) client for Stella. |
|
Package memory defines the pluggable memory provider contract.
|
Package memory defines the pluggable memory provider contract. |
|
memorytest
Package memorytest provides test doubles and conformance testing for memory.Provider implementations.
|
Package memorytest provides test doubles and conformance testing for memory.Provider implementations. |
|
memorywrite
Package memorywrite provides shared transactional write helpers for durable memory surfaces.
|
Package memorywrite provides shared transactional write helpers for durable memory surfaces. |
|
profile
Package profile is the application boundary for per-(user, agent) memory: the profile blob, agent soul, hard constraints, reset, and the change history.
|
Package profile is the application boundary for per-(user, agent) memory: the profile blob, agent soul, hard constraints, reset, and the change history. |
|
Package model groups everything about which LLM runs, what it costs, and what it embeds.
|
Package model groups everything about which LLM runs, what it costs, and what it embeds. |
|
catalog
Package catalog provides the embedded and optionally synchronized models.dev provider/model directory.
|
Package catalog provides the embedded and optionally synchronized models.dev provider/model directory. |
|
embedding
Package embedding turns text into vectors for semantic search.
|
Package embedding turns text into vectors for semantic search. |
|
usage
Package usage persists provider-reported LLM usage outside the turn path.
|
Package usage persists provider-reported LLM usage outside the turn path. |
|
Package notify routes a notification to the channels that should receive it.
|
Package notify routes a notification to the channels that should receive it. |
|
Package oauth is Stella's OAuth2 authorization server (issue #613).
|
Package oauth is Stella's OAuth2 authorization server (issue #613). |
|
Package platform groups the infrastructure packages that do not know agents exist: process/CLI plumbing, configuration, the STELLA_HOME layout, blob storage, observability, the bundled xberg CLI, build version, diagnostics.
|
Package platform groups the infrastructure packages that do not know agents exist: process/CLI plumbing, configuration, the STELLA_HOME layout, blob storage, observability, the bundled xberg CLI, build version, diagnostics. |
|
blob
Package blob stores opaque bytes behind one interface, backed by S3-compatible object storage.
|
Package blob stores opaque bytes behind one interface, backed by S3-compatible object storage. |
|
blob/blobtest
Package blobtest provides a filesystem-backed blob.Store for tests.
|
Package blobtest provides a filesystem-backed blob.Store for tests. |
|
cli
Package cli is shared command plumbing for the stellad binary: dotenv loading and log-level parsing.
|
Package cli is shared command plumbing for the stellad binary: dotenv loading and log-level parsing. |
|
config
Package config currently holds two distinct concepts that share a package only for historical reasons (it is a leaf package everything can import without cycles).
|
Package config currently holds two distinct concepts that share a package only for historical reasons (it is a leaf package everything can import without cycles). |
|
diagnostic
Package diagnostic renders potentially sensitive values for operator output.
|
Package diagnostic renders potentially sensitive values for operator output. |
|
home
Package home owns the single-replica POSIX workspace layout beneath STELLA_HOME.
|
Package home owns the single-replica POSIX workspace layout beneath STELLA_HOME. |
|
observability
Package observability owns the process-global OpenTelemetry providers (tracer and logger).
|
Package observability owns the process-global OpenTelemetry providers (tracer and logger). |
|
observability/metrichook
Package metrichook records bounded agent-loop metrics from the core hook payloads.
|
Package metrichook records bounded agent-loop metrics from the core hook payloads. |
|
version
Package version exposes the stella binary version.
|
Package version exposes the stella binary version. |
|
xberg
Package xberg owns how Stella invokes the bundled Xberg CLI.
|
Package xberg owns how Stella invokes the bundled Xberg CLI. |
|
Package plugin groups the plugin machinery.
|
Package plugin groups the plugin machinery. |
|
host
Package host is the process-wide plugin platform.
|
Package host is the process-wide plugin platform. |
|
host/catalogimports
Package catalogimports registers every plugin included in Stella's default catalog.
|
Package catalogimports registers every plugin included in Stella's default catalog. |
|
manifest
Package manifest owns manifest-declared plugins: loading the builtin manifest, applying operator overrides, validating a plugin's shape, and reconciling its mise-installed runtime against what the manifest asks for.
|
Package manifest owns manifest-declared plugins: loading the builtin manifest, applying operator overrides, validating a plugin's shape, and reconciling its mise-installed runtime against what the manifest asks for. |
|
Package provisioning owns the provisioned-user lifecycle.
|
Package provisioning owns the provisioned-user lifecycle. |
|
Package reflect is Stella's self-improvement loop: it reviews finished conversations on a scheduler builtin, gates candidates, reconciles the skills it owns, and curates skill usage.
|
Package reflect is Stella's self-improvement loop: it reviews finished conversations on a scheduler builtin, gates candidates, reconciles the skills it owns, and curates skill usage. |
|
Package scheduler is the durable job service backed by River: cron and one-shot jobs created from the Web UI or from agent tools, executed under the owner's reconstructed Authority.
|
Package scheduler is the durable job service backed by River: cron and one-shot jobs created from the Web UI or from agent tools, executed under the owner's reconstructed Authority. |
|
Package searchrank ranks documents by weighted text fields, so a domain can make (say) a skill name count for more than its body without each caller reimplementing scoring.
|
Package searchrank ranks documents by weighted text fields, so a domain can make (say) a skill name count for more than its body without each caller reimplementing scoring. |
|
Package server is the HTTP surface: the REST API generated from api/spec, SSE streaming, and the embedded React SPA.
|
Package server is the HTTP surface: the REST API generated from api/spec, SSE streaming, and the embedded React SPA. |
|
Package sessionmedia persists immutable, owner-scoped bytes for session history.
|
Package sessionmedia persists immutable, owner-scoped bytes for session history. |
|
Package share turns an article or artifact into a public link with its own lifecycle: create, list, revoke.
|
Package share turns an article or artifact into a public link with its own lifecycle: create, list, revoke. |
|
Package skill is the managed Skill authority: the durable store of installed skills at exact revisions, project and system skills merged read-only from the filesystem, search and loading for a turn, and the management tools.
|
Package skill is the managed Skill authority: the durable store of installed skills at exact revisions, project and system skills merged read-only from the filesystem, search and loading for a turn, and the management tools. |
|
access
Package access owns the direct authorization rules for DB-backed Skill resources.
|
Package access owns the direct authorization rules for DB-backed Skill resources. |
|
policy
Package policy owns the versioned Agent Skill activation setting.
|
Package policy owns the versioned Agent Skill activation setting. |
|
Package tools holds the code generators run by mise tasks, not anything the server links.
|
Package tools holds the code generators run by mise tasks, not anything the server links. |
|
generatebuiltinmanifest
command
|
|
|
syncembeddedbinaries
command
Command syncembeddedbinaries downloads the third-party runtimes that get compiled into stellad and writes them to resources/binaries/binaries/<platform>/.
|
Command syncembeddedbinaries downloads the third-party runtimes that get compiled into stellad and writes them to resources/binaries/binaries/<platform>/. |
|
syncmodelcatalog
command
Command syncmodelcatalog refreshes the compact models.dev snapshot embedded in stellad.
|
Command syncmodelcatalog refreshes the compact models.dev snapshot embedded in stellad. |
|
toolgen
command
|
|
|
Package vault stores per-user secrets encrypted at rest and hands them to the agent runtime as session environment variables.
|
Package vault stores per-user secrets encrypted at rest and hands them to the agent runtime as session environment variables. |
|
Package vision turns verified image bytes into bounded text.
|
Package vision turns verified image bytes into bounded text. |
|
Package webhook owns personal webhook resources, their opaque credentials, and the admission boundary from inbound HTTP to a fixed Agent invocation.
|
Package webhook owns personal webhook resources, their opaque credentials, and the admission boundary from inbound HTTP to a fixed Agent invocation. |
|
Package workflow stores and runs saved multi-step workflows: the durable definition, the run use case, and the agent tools over them.
|
Package workflow stores and runs saved multi-step workflows: the durable definition, the run use case, and the agent tools over them. |
Click to show internal directories.
Click to hide internal directories.