# Condukt v1.5.1 - Table of Contents

A framework for building AI agents in Elixir

## Pages

- Introduction
  - [Overview](overview.md)
  - [Installation](installation.md)
  - [Getting Started](getting_started.md)

- Agents
  - [Agents](agents.md)
  - [Anonymous Workflows](anonymous_workflows.md)
  - [Tools](tools.md)
  - [Sub-agents](subagents.md)

- Workflows
  - [Workflows](workflows.md)

- Integrations
  - [MCP](mcp.md)
  - [HTTP Routes](http_routes.md)

- Guides
  - [Sandbox](sandbox.md)
  - [Network Policy](network_policy.md)
  - [Streaming and Events](streaming_and_events.md)
  - [Sessions and Persistence](sessions_and_persistence.md)
  - [Compaction](compaction.md)
  - [Redaction](redaction.md)
  - [Secrets](secrets.md)
  - [Project Instructions](project_instructions.md)
  - [Telemetry](telemetry.md)
  - [Providers](providers.md)

- Reference
  - [Changelog](changelog.md)

## Modules

- [Condukt.Agent](Condukt.Agent.md): Macro for defining Condukt agents with explicit agent options.
- [Condukt.AgentRuntime](Condukt.AgentRuntime.md): Behaviour for runtimes that own an agent's inner execution loop.
- [Condukt.AgentRuntimes.Claude](Condukt.AgentRuntimes.Claude.md): Runtime adapter for Claude Code non-interactive SDK mode.
- [Condukt.AgentRuntimes.Codex](Condukt.AgentRuntimes.Codex.md): Runtime adapter for the Codex CLI non-interactive SDK mode.
- [Condukt.AgentRuntimes.Native](Condukt.AgentRuntimes.Native.md): Marker module for the built-in Condukt agent loop.
- [Condukt.Sandbox.NetworkPolicy.Hosts](Condukt.Sandbox.NetworkPolicy.Hosts.md): Host glob matching shared by the `AllowHosts` and `DenyHosts` rules.
- [Condukt.Sandbox.NetworkPolicy.K8s](Condukt.Sandbox.NetworkPolicy.K8s.md): Kubernetes-specific glue for the `Condukt.Sandbox.NetworkPolicy`
egress layer.
- [Condukt.SessionID](Condukt.SessionID.md): Generates UUIDv7 identifiers for `Condukt.Session` instances.

- Core
  - [Condukt](Condukt.md): A framework for building AI agents in Elixir.
  - [Condukt.Message](Condukt.Message.md): Represents a message in the conversation history.
  - [Condukt.Operation](Condukt.Operation.md): Typed, named entrypoints on an agent module.
  - [Condukt.Plug](Condukt.Plug.md): Exposes Condukt agents and typed operations as HTTP routes.
  - [Condukt.Session](Condukt.Session.md): GenServer that manages an agent session.
  - [Condukt.Telemetry](Condukt.Telemetry.md): Telemetry integration for Condukt.

- Project Context
  - [Condukt.Context](Condukt.Context.md): Loads project instructions and local skills from the active sandbox.
  - [Condukt.Context.Skill](Condukt.Context.Skill.md): Metadata for a project skill discovered from `.agents/skills`.

- Engine
  - [Condukt.Engine.CLI](Condukt.Engine.CLI.md): Command-line entrypoint for the standalone Condukt engine.

- Tools
  - [Condukt.Tool](Condukt.Tool.md): Behaviour for defining tools that agents can use.
  - [Condukt.Tool.Inline](Condukt.Tool.Inline.md): Struct returned by `Condukt.tool/1`.
  - [Condukt.Tools](Condukt.Tools.md): Built-in tools for Condukt.
  - [Condukt.Tools.Bash](Condukt.Tools.Bash.md): Tool for executing bash commands.
  - [Condukt.Tools.Command](Condukt.Tools.Command.md): Tool for executing one trusted command without shell parsing.
  - [Condukt.Tools.Edit](Condukt.Tools.Edit.md): Tool for making surgical edits to files.
  - [Condukt.Tools.Glob](Condukt.Tools.Glob.md): Tool for finding files by glob pattern.
  - [Condukt.Tools.Grep](Condukt.Tools.Grep.md): Tool for searching file contents by regular expression.
  - [Condukt.Tools.Read](Condukt.Tools.Read.md): Tool for reading file contents.
  - [Condukt.Tools.Subagent](Condukt.Tools.Subagent.md): Tool for delegating a task to a registered sub-agent role.
  - [Condukt.Tools.Write](Condukt.Tools.Write.md): Tool for writing content to files.

- Workflows
  - [Condukt.Workflows](Condukt.Workflows.md): Public facade for Condukt workflows.
  - [Condukt.Workflows.Compiler](Condukt.Workflows.Compiler.md): Normalizes `.exs` workflow files to workflow documents.
  - [Condukt.Workflows.Document](Condukt.Workflows.Document.md): Loaded representation of a workflow document.
  - [Condukt.Workflows.Executor](Condukt.Workflows.Executor.md): Executes a validated workflow document.
  - [Condukt.Workflows.Expr](Condukt.Workflows.Expr.md): Expression sub-language for Condukt workflows.
  - [Condukt.Workflows.HCLCompiler](Condukt.Workflows.HCLCompiler.md): Normalizes HCL workflow files to canonical workflow documents.
  - [Condukt.Workflows.ToolRegistry](Condukt.Workflows.ToolRegistry.md): Resolves the `id` field of a `tool` workflow step to a tool module
(or inline tool spec) suitable for `Condukt.Tool.execute/3`.

- MCP
  - [Condukt.MCP](Condukt.MCP.md): Client-side support for the [Model Context Protocol](https://modelcontextprotocol.io).
  - [Condukt.MCP.Client](Condukt.MCP.Client.md): GenServer that owns the protocol state for a single MCP server
connection.
  - [Condukt.MCP.Registry](Condukt.MCP.Registry.md): Lifecycle helper for connecting to a list of MCP servers as part of
starting a session or executing a workflow.
  - [Condukt.MCP.Server](Condukt.MCP.Server.md): Declarative configuration for a connected MCP server.

- Sandbox
  - [Condukt.Sandbox](Condukt.Sandbox.md): Filesystem and process-execution capabilities exposed to tools.
  - [Condukt.Sandbox.Kubernetes](Condukt.Sandbox.Kubernetes.md): Sandbox that runs each session inside a dedicated Kubernetes Pod.
  - [Condukt.Sandbox.Local](Condukt.Sandbox.Local.md): Sandbox that operates against the host filesystem and host shell.
  - [Condukt.Sandbox.NetworkPolicy](Condukt.Sandbox.NetworkPolicy.md): Per-session network policy for sandbox egress.
  - [Condukt.Sandbox.NetworkPolicy.AgentDecider](Condukt.Sandbox.NetworkPolicy.AgentDecider.md): `Condukt.Sandbox.NetworkPolicy.Decider` implementation that delegates to a
`Condukt`-defined agent module.
  - [Condukt.Sandbox.NetworkPolicy.CA](Condukt.Sandbox.NetworkPolicy.CA.md): Per-session ephemeral Certificate Authority used by the egress sidecar
for TLS interception.
  - [Condukt.Sandbox.NetworkPolicy.Context](Condukt.Sandbox.NetworkPolicy.Context.md): Snapshot of session state handed to a `Condukt.Sandbox.NetworkPolicy`
`:decide` callback per outbound request.
  - [Condukt.Sandbox.NetworkPolicy.Decider](Condukt.Sandbox.NetworkPolicy.Decider.md): Behaviour and runtime for the `:decide` rule on a
`Condukt.Sandbox.NetworkPolicy`.
  - [Condukt.Sandbox.NetworkPolicy.Event](Condukt.Sandbox.NetworkPolicy.Event.md): An event the egress runtime emits as telemetry per request lifecycle.
  - [Condukt.Sandbox.NetworkPolicy.Request](Condukt.Sandbox.NetworkPolicy.Request.md): A single outbound network request observed by the sandbox egress layer.
  - [Condukt.Sandbox.Virtual](Condukt.Sandbox.Virtual.md): Sandbox that runs against an in-memory virtual filesystem and a
Rust-implemented bash interpreter via the bashkit NIF.
  - [Condukt.Sandbox.Virtual.Tools.Mount](Condukt.Sandbox.Virtual.Tools.Mount.md): Sandbox-specific tool for `Condukt.Sandbox.Virtual` that lets the agent
mount a host directory into the virtual filesystem at runtime.

- Session Stores
  - [Condukt.SessionStore](Condukt.SessionStore.md): Behaviour for persisting and restoring Condukt sessions.
  - [Condukt.SessionStore.Disk](Condukt.SessionStore.Disk.md): Disk-backed session store using Erlang term serialization.
  - [Condukt.SessionStore.Memory](Condukt.SessionStore.Memory.md): ETS-backed session store for restoring sessions within the current VM.

  - [Condukt.SessionStore.Snapshot](Condukt.SessionStore.Snapshot.md): Serializable session snapshot persisted by session stores.

- Compaction
  - [Condukt.Compactor](Condukt.Compactor.md): Behaviour for compacting a session's conversation history.
  - [Condukt.Compactor.Sliding](Condukt.Compactor.Sliding.md): Keeps the last N messages of the conversation.
  - [Condukt.Compactor.ToolResultPrune](Condukt.Compactor.ToolResultPrune.md): Replaces the content of old tool result messages with a small placeholder,
preserving the message structure (and the assistant's tool call reasoning)
so the model still sees that the tool was invoked.

- Redaction
  - [Condukt.Redactor](Condukt.Redactor.md): Behaviour for redacting sensitive data before it is sent to an LLM provider.
  - [Condukt.Redactors.Regex](Condukt.Redactors.Regex.md): Default regex-based redactor for common high-precision secret patterns.
  - [Condukt.Redactors.Secrets](Condukt.Redactors.Secrets.md): Exact-match redactor for resolved session secrets.

- Secrets
  - [Condukt.SecretProvider](Condukt.SecretProvider.md): Behaviour for loading session secrets from trusted providers.
  - [Condukt.Secrets](Condukt.Secrets.md): Session-scoped secrets for agent tool execution.
  - [Condukt.Secrets.Providers.Env](Condukt.Secrets.Providers.Env.md): Loads a session secret from the host process environment.
  - [Condukt.Secrets.Providers.OnePassword](Condukt.Secrets.Providers.OnePassword.md): Loads a session secret from 1Password CLI secret references.
  - [Condukt.Secrets.Providers.Static](Condukt.Secrets.Providers.Static.md): Loads a plaintext value from trusted application configuration.

- Providers
  - [Condukt.Providers.Ollama](Condukt.Providers.Ollama.md): Ollama provider – self-hosted OpenAI-compatible Chat Completions API.

## Mix Tasks

- [mix condukt.check](Mix.Tasks.Condukt.Check.md): Validates a Condukt workflow file without executing it.
- [mix condukt.run](Mix.Tasks.Condukt.Run.md): Runs a Condukt workflow file.