# Condukt v0.16.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)
  - [Workflow Starlark API](workflow_starlark_api.md)

- Guides
  - [Sandbox](sandbox.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

- 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.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 a project root.
  - [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 Starlark-defined Condukt workflows.
  - [Condukt.Workflows.AgentShim](Condukt.Workflows.AgentShim.md): Minimal Condukt agent used for materialized workflow runs.

  - [Condukt.Workflows.Error](Condukt.Workflows.Error.md): Exception raised for workflow loading and runtime errors.

  - [Condukt.Workflows.Eval](Condukt.Workflows.Eval.md): Starlark parsing and evaluation bridge for workflow files.

  - [Condukt.Workflows.Fetcher](Condukt.Workflows.Fetcher.md): Behaviour for workflow package fetchers.

  - [Condukt.Workflows.Fetcher.Git](Condukt.Workflows.Fetcher.Git.md): Git-backed workflow package fetcher.

  - [Condukt.Workflows.Lockfile](Condukt.Workflows.Lockfile.md): Workflow dependency lockfile loaded from `condukt.lock`.

  - [Condukt.Workflows.Manifest](Condukt.Workflows.Manifest.md): Workflow package manifest loaded from `condukt.toml`.

  - [Condukt.Workflows.Project](Condukt.Workflows.Project.md): Materialized workflow project.
  - [Condukt.Workflows.Resolver](Condukt.Workflows.Resolver.md): PubGrub-backed dependency resolver for workflow packages.

  - [Condukt.Workflows.Resolver.Requirement](Condukt.Workflows.Resolver.Requirement.md): Dependency requirement extracted from a Starlark `load()` string.

  - [Condukt.Workflows.Runtime](Condukt.Workflows.Runtime.md): Caller-owned supervisor for workflow workers and triggers.

  - [Condukt.Workflows.Runtime.Cron](Condukt.Workflows.Runtime.Cron.md): Cron trigger process for workflow runtimes.

  - [Condukt.Workflows.Runtime.WebhookListener](Condukt.Workflows.Runtime.WebhookListener.md): Optional Bandit listener for workflow webhook triggers.

  - [Condukt.Workflows.Runtime.WebhookRouter](Condukt.Workflows.Runtime.WebhookRouter.md): Plug-compatible router for workflow webhook triggers.

  - [Condukt.Workflows.Runtime.Worker](Condukt.Workflows.Runtime.Worker.md): Runtime worker responsible for invoking one materialized workflow.

  - [Condukt.Workflows.Store](Condukt.Workflows.Store.md): Content-addressed local store for resolved workflow packages.

  - [Condukt.Workflows.ToolRegistry](Condukt.Workflows.ToolRegistry.md): Resolves Starlark workflow tool references to Condukt tool modules.

  - [Condukt.Workflows.Workflow](Condukt.Workflows.Workflow.md): Materialized workflow declaration.

- Sandbox
  - [Condukt.Sandbox](Condukt.Sandbox.md): Filesystem and process-execution capabilities exposed to tools.
  - [Condukt.Sandbox.Local](Condukt.Sandbox.Local.md): Sandbox that operates against the host filesystem and host shell.
  - [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.workflows.check](Mix.Tasks.Condukt.Workflows.Check.md): Validates a Condukt workflows project.

- [mix condukt.workflows.lock](Mix.Tasks.Condukt.Workflows.Lock.md): Resolves workflow dependencies and writes condukt.lock.

- [mix condukt.workflows.run](Mix.Tasks.Condukt.Workflows.Run.md): Runs one Condukt workflow from a project.

- [mix condukt.workflows.serve](Mix.Tasks.Condukt.Workflows.Serve.md): Starts a Condukt workflow runtime and blocks.

