Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent wires the conductor together: its own store, a Podium API client, the profile directory, the sources, and one HTTP server for the AgentService, health and metrics.
|
Package agent wires the conductor together: its own store, a Podium API client, the profile directory, the sources, and one HTTP server for the AgentService, health and metrics. |
|
api
Package api is the conductor's own HTTP surface: the AgentService handlers, the bearer that guards them, and the health and metrics endpoints.
|
Package api is the conductor's own HTTP surface: the AgentService handlers, the bearer that guards them, and the health and metrics endpoints. |
|
chat
Package chat is the web chat: the third conductor.Source, and the only one whose conversation Podium itself holds.
|
Package chat is the web chat: the third conductor.Source, and the only one whose conversation Podium itself holds. |
|
conductor
Package conductor is the turn loop: an inbound message becomes one Podium task running the agent runtime image, what the task says is relayed back to where the message came from, and the turn is recorded.
|
Package conductor is the turn loop: an inbound message becomes one Podium task running the agent runtime image, what the task says is relayed back to where the message came from, and the turn is recorded. |
|
conductor/fakesource
Package fakesource is an in-memory conductor.Source: a channel of inbound events and an ordered record of everything the conductor said back.
|
Package fakesource is an in-memory conductor.Source: a channel of inbound events and an ordered record of everything the conductor said back. |
|
config
Package config is the whole of podium-agent's configuration.
|
Package config is the whole of podium-agent's configuration. |
|
github
Package github is the conductor's client of a GitHub App: it turns an App id and a private key into the short-lived installation tokens a turn clones, fetches and pushes with.
|
Package github is the conductor's client of a GitHub App: it turns an App id and a private key into the short-lived installation tokens a turn clones, fetches and pushes with. |
|
linear
Package linear is the bot's Linear identity: assigned issues polled into inbound events, and the five ways the conductor talks back.
|
Package linear is the bot's Linear identity: assigned issues polled into inbound events, and the five ways the conductor talks back. |
|
mcp
Package mcp is the conductor's registry of MCP servers: what one is, what a name may be, and which Podium secret and environment variable a server's credential travels in.
|
Package mcp is the conductor's registry of MCP servers: what one is, what a name may be, and which Podium secret and environment variable a server's credential travels in. |
|
memory
Package memory is the conductor's client of Hindsight, the agents' shared memory.
|
Package memory is the conductor's client of Hindsight, the agents' shared memory. |
|
podium
Package podium is the conductor's client of the Podium API.
|
Package podium is the conductor's client of the Podium API. |
|
profiles
Package profiles is the bot's identity and its playbooks: what a playbook is, how one is validated, and how the directory on disk (PODIUM_AGENT_PROFILE_DIR) is loaded.
|
Package profiles is the bot's identity and its playbooks: what a playbook is, how one is validated, and how the directory on disk (PODIUM_AGENT_PROFILE_DIR) is loaded. |
|
skills
Package skills is a third-party Agent Skill on its way into a task container: what a bundle is, how one is read off the conductor's own disk, and the guards it has to pass before any of it reaches a turn.
|
Package skills is a third-party Agent Skill on its way into a task container: what a bundle is, how one is read off the conductor's own disk, and the guards it has to pass before any of it reaches a turn. |
|
slack
Package slack holds the bot's Slack identity: a Socket Mode connection, mentions turned into inbound events, and the four ways the conductor talks back.
|
Package slack holds the bot's Slack identity: a Socket Mode connection, mentions turned into inbound events, and the four ways the conductor talks back. |
|
store
Package store is the conductor's own Postgres database (podium_agent): sessions, turns, the relay ledger and its settings.
|
Package store is the conductor's own Postgres database (podium_agent): sessions, turns, the relay ledger and its settings. |
|
Package cli is the podium command-line client.
|
Package cli is the podium command-line client. |
|
Package ids mints the lowercase, prefixed ULIDs Podium uses for every entity.
|
Package ids mints the lowercase, prefixed ULIDs Podium uses for every entity. |
|
Package node is the podium-node daemon: it holds the node's identity, keeps one bidirectional stream to the control plane, and turns each Assign into a container run whose events are batched, buffered and replayed until the server acks them.
|
Package node is the podium-node daemon: it holds the node's identity, keeps one bidirectional stream to the control plane, and turns each Assign into a container run whose events are batched, buffered and replayed until the server acks them. |
|
docker
Package docker runs Podium tasks as containers on a local Docker engine and streams ordered lifecycle events for them.
|
Package docker runs Podium tasks as containers on a local Docker engine and streams ordered lifecycle events for them. |
|
proto
|
|
|
podium/v1
Package podiumv1 holds the generated podium.v1 wire types plus the hand-written log redaction helper below.
|
Package podiumv1 holds the generated podium.v1 wire types plus the hand-written log redaction helper below. |
|
Package runner is podium-runner: PID 1 of every Podium task container.
|
Package runner is podium-runner: PID 1 of every Podium task container. |
|
Package server wires the control plane together: store, transport, Connect handlers, the scheduler and the log fan-out, behind one HTTP server.
|
Package server wires the control plane together: store, transport, Connect handlers, the scheduler and the log fan-out, behind one HTTP server. |
|
api
Package api holds the operator-facing Connect handlers: tasks and node administration.
|
Package api holds the operator-facing Connect handlers: tasks and node administration. |
|
artifacts
Package artifacts is the control plane's half of the object store: the S3 client, the key layout, presigned URLs, and the service that records what has been stored.
|
Package artifacts is the control plane's half of the object store: the S3 client, the key layout, presigned URLs, and the service that records what has been stored. |
|
artifacts/fakes3
Package fakes3 is an in-process S3-compatible endpoint for Podium's own tests.
|
Package fakes3 is an in-process S3-compatible endpoint for Podium's own tests. |
|
logs
Package logs owns the write side of a task's event history: it turns a node's event batch into rows, applies the status transitions those events imply, and fans the result out to live subscribers.
|
Package logs owns the write side of a task's event history: it turns a node's event batch into rows, applies the status transitions those events imply, and fans the result out to live subscribers. |
|
nodes
Package nodes owns node identity and the node stream: enrollment, the in-memory session registry, heartbeat bookkeeping and the event batches nodes push back.
|
Package nodes owns node identity and the node stream: enrollment, the in-memory session registry, heartbeat bookkeeping and the event batches nodes push back. |
|
scheduler
Package scheduler decides which node runs which task, and keeps the promises that decision makes: a lease per assignment, a deadline for accepting one, the spec's own timeout, and the node-health policy that turns a machine going away into either a new attempt or an honest `lost`.
|
Package scheduler decides which node runs which task, and keeps the promises that decision makes: a lease per assignment, a deadline for accepting one, the spec's own timeout, and the node-health policy that turns a machine going away into either a new attempt or an honest `lost`. |
|
secrets
Package secrets is the control plane's encrypted secret store: the master key, the AES-256-GCM envelope around every stored value, and the resolution step that turns a task's SecretRefs into the plaintext an Assign carries to a node.
|
Package secrets is the control plane's encrypted secret store: the master key, the AES-256-GCM envelope around every stored value, and the resolution step that turns a task's SecretRefs into the plaintext an Assign carries to a node. |
|
store
Package store is the only place SQL lives.
|
Package store is the only place SQL lives. |
|
Package transport is the seam between how a request reaches the server and who the server thinks made it.
|
Package transport is the seam between how a request reaches the server and who the server thinks made it. |
|
local
Package local is the single-machine transport: no Tailscale, no mTLS, one shared bearer token.
|
Package local is the single-machine transport: no Tailscale, no mTLS, one shared bearer token. |
|
tailnet
Package tailnet is the Tailscale transport.
|
Package tailnet is the Tailscale transport. |
|
Package version carries the build identity of every Podium binary.
|
Package version carries the build identity of every Podium binary. |
Click to show internal directories.
Click to hide internal directories.