Directories
¶
| Path | Synopsis |
|---|---|
|
Chronos CLI entry point.
|
Chronos CLI entry point. |
|
cmd
Package cmd provides the Chronos CLI command tree.
|
Package cmd provides the Chronos CLI command tree. |
|
repl
Package repl provides an interactive REPL for the Chronos CLI.
|
Package repl provides an interactive REPL for the Chronos CLI. |
|
engine
|
|
|
graph
Package graph provides the StateGraph durable execution runtime.
|
Package graph provides the StateGraph durable execution runtime. |
|
guardrails
Package guardrails provides input/output validation for agent execution.
|
Package guardrails provides input/output validation for agent execution. |
|
hooks
Package hooks provides a middleware system for intercepting agent execution events.
|
Package hooks provides a middleware system for intercepting agent execution events. |
|
interop/mcpserver
Package mcpserver exposes Chronos tools to any Model Context Protocol (MCP) host — Claude Desktop, IDEs, and other agent frameworks — over JSON-RPC 2.0.
|
Package mcpserver exposes Chronos tools to any Model Context Protocol (MCP) host — Claude Desktop, IDEs, and other agent frameworks — over JSON-RPC 2.0. |
|
mcp
Package mcp implements the Model Context Protocol (MCP) client.
|
Package mcp implements the Model Context Protocol (MCP) client. |
|
model
Package model defines pluggable LLM provider interfaces.
|
Package model defines pluggable LLM provider interfaces. |
|
queue
Package queue provides a durable, distributed work queue for Chronos graph runs.
|
Package queue provides a durable, distributed work queue for Chronos graph runs. |
|
stream
Package stream provides event streaming for real-time observability.
|
Package stream provides event streaming for real-time observability. |
|
tool
Package tool provides the tool registry with permissions and approval hooks.
|
Package tool provides the tool registry with permissions and approval hooks. |
|
tool/builtins
Package builtins provides ready-to-use tool implementations.
|
Package builtins provides ready-to-use tool implementations. |
|
Package evals provides an evaluation framework for testing agent quality.
|
Package evals provides an evaluation framework for testing agent quality. |
|
examples
|
|
|
a2a_interop
command
Example: a2a_interop shows Chronos interoperating over the Agent-to-Agent (A2A) protocol (WC-B-001).
|
Example: a2a_interop shows Chronos interoperating over the Agent-to-Agent (A2A) protocol (WC-B-001). |
|
agui_stream
command
Example: agui_stream shows Chronos runs surfaced as a standard AG-UI event stream (WC-B-003).
|
Example: agui_stream shows Chronos runs surfaced as a standard AG-UI event stream (WC-B-003). |
|
azure
command
Azure OpenAI example for Chronos.
|
Azure OpenAI example for Chronos. |
|
azure_rag
command
Azure OpenAI RAG (retrieval-augmented generation) example for Chronos.
|
Azure OpenAI RAG (retrieval-augmented generation) example for Chronos. |
|
azure_tools
command
Azure OpenAI tool-calling example for Chronos.
|
Azure OpenAI tool-calling example for Chronos. |
|
chat_with_tools
command
Example: chat_with_tools demonstrates an agent that uses tools during chat.
|
Example: chat_with_tools demonstrates an agent that uses tools during chat. |
|
cli_agent
command
Command custom_tool shows how to give a Chronos agent a CUSTOM tool with a real Go handler.
|
Command custom_tool shows how to give a Chronos agent a CUSTOM tool with a real Go handler. |
|
coding_agent
command
Example: coding_agent — A full-featured autonomous coding agent.
|
Example: coding_agent — A full-featured autonomous coding agent. |
|
context_compaction
command
Example: context_compaction demonstrates automatic context compaction (WC-A-004).
|
Example: context_compaction demonstrates automatic context compaction (WC-A-004). |
|
data_residency
command
Data residency example for Chronos.
|
Data residency example for Chronos. |
|
deep_agent
command
Example: deep_agent demonstrates the batteries-included "deep agent" harness preset (WC-A-005).
|
Example: deep_agent demonstrates the batteries-included "deep agent" harness preset (WC-A-005). |
|
durable_hitl
command
Example: durable_hitl demonstrates a durable, human-in-the-loop (HITL) StateGraph.
|
Example: durable_hitl demonstrates a durable, human-in-the-loop (HITL) StateGraph. |
|
durable_llm_graph
command
Example: durable_llm_graph — where LLM calls happen, and how the StateGraph runtime makes them durable.
|
Example: durable_llm_graph — where LLM calls happen, and how the StateGraph runtime makes them durable. |
|
durable_queue
command
Command durable_queue demonstrates the Chronos durable, distributed execution plane (engine/queue) delivered in Phase P1.
|
Command durable_queue demonstrates the Chronos durable, distributed execution plane (engine/queue) delivered in Phase P1. |
|
enterprise_sso
command
Enterprise SSO example for Chronos.
|
Enterprise SSO example for Chronos. |
|
eval_loop
command
Example: eval_loop demonstrates the eval-driven development loop (WC-C-001): capture a dataset from a real run, run it against an agent target, score it, and gate on regressions — the trace → dataset → eval → gate cycle.
|
Example: eval_loop demonstrates the eval-driven development loop (WC-C-001): capture a dataset from a real run, run it against an agent target, score it, and gate on regressions — the trace → dataset → eval → gate cycle. |
|
fallback_provider
command
Example: fallback_provider demonstrates automatic failover between model providers.
|
Example: fallback_provider demonstrates automatic failover between model providers. |
|
graph_patterns
command
Example: graph_patterns demonstrates the StateGraph durable execution engine.
|
Example: graph_patterns demonstrates the StateGraph durable execution engine. |
|
graph_with_llm
command
Example: graph_with_llm — StateGraph with real LLM calls inside nodes.
|
Example: graph_with_llm — StateGraph with real LLM calls inside nodes. |
|
hooks_observability
command
Example: hooks_observability demonstrates all Chronos hooks for production observability.
|
Example: hooks_observability demonstrates all Chronos hooks for production observability. |
|
internal/exampletest
Package exampletest provides helpers for tests under examples/.
|
Package exampletest provides helpers for tests under examples/. |
|
internal/providers
Package providers is a shared helper used by the runnable examples to pick an LLM provider from the environment.
|
Package providers is a shared helper used by the runnable examples to pick an LLM provider from the environment. |
|
k8s_sandbox
command
Example: k8s_sandbox runs an untrusted command as a one-shot Kubernetes Job using the K8s sandbox backend.
|
Example: k8s_sandbox runs an untrusted command as a one-shot Kubernetes Job using the K8s sandbox backend. |
|
mcp_agent
command
Example: mcp_agent demonstrates connecting an agent to a Model Context Protocol (MCP) server and importing its tools into the agent's registry.
|
Example: mcp_agent demonstrates connecting an agent to a Model Context Protocol (MCP) server and importing its tools into the agent's registry. |
|
mcp_server
command
Example: mcp_server exposes Chronos tools to any MCP host (Claude Desktop, an IDE, another agent framework) over stdio (WC-B-002).
|
Example: mcp_server exposes Chronos tools to any MCP host (Claude Desktop, an IDE, another agent framework) over stdio (WC-B-002). |
|
mcp_sse
command
Example: mcp_sse connects an MCP client to a server over the HTTP+SSE transport (MCP 2024-11-05).
|
Example: mcp_sse connects an MCP client to a server over the HTTP+SSE transport (MCP 2024-11-05). |
|
memory_and_sessions
command
Example: memory_and_sessions demonstrates persistent multi-turn sessions and the memory system (short-term + long-term).
|
Example: memory_and_sessions demonstrates persistent multi-turn sessions and the memory system (short-term + long-term). |
|
multi_agent
command
Example: multi_agent demonstrates all four team strategies and agent communication.
|
Example: multi_agent demonstrates all four team strategies and agent communication. |
|
multi_provider
command
Example: multi_provider demonstrates connecting agents to different LLM providers.
|
Example: multi_provider demonstrates connecting agents to different LLM providers. |
|
multi_round_tools
command
Example: multi_round_tools demonstrates an agent performing MULTIPLE sequential tool-calling rounds, where the result of tool A feeds the arguments of tool B.
|
Example: multi_round_tools demonstrates an agent performing MULTIPLE sequential tool-calling rounds, where the result of tool A feeds the arguments of tool B. |
|
multitenancy
command
Example: multitenancy demonstrates storage-level tenant isolation using storage.WithTenant.
|
Example: multitenancy demonstrates storage-level tenant isolation using storage.WithTenant. |
|
multitenant_memory
command
Example: multitenant_memory demonstrates per-user long-term memory isolation — two different users served by one logical agent, whose memories never leak across tenants.
|
Example: multitenant_memory demonstrates per-user long-term memory isolation — two different users served by one logical agent, whose memories never leak across tenants. |
|
planning_agent
command
Example: planning_agent demonstrates the built-in planning ("todo") tool (WC-A-001).
|
Example: planning_agent demonstrates the built-in planning ("todo") tool (WC-A-001). |
|
quickstart
command
Chronos Quickstart — a minimal agent with SQLite storage and a durable StateGraph.
|
Chronos Quickstart — a minimal agent with SQLite storage and a durable StateGraph. |
|
rag_knowledge
command
Example: rag_knowledge — Retrieval-Augmented Generation with the Knowledge API.
|
Example: rag_knowledge — Retrieval-Augmented Generation with the Knowledge API. |
|
sandbox_execution
command
Example: sandbox_execution demonstrates the process sandbox for running untrusted commands with timeouts and output capture.
|
Example: sandbox_execution demonstrates the process sandbox for running untrusted commands with timeouts and output capture. |
|
semantic_recall
command
Example: semantic_recall — automatic semantic long-term recall (WC-D-001).
|
Example: semantic_recall — automatic semantic long-term recall (WC-D-001). |
|
server_embedded
command
Example: server_embedded — running the ChronosOS control plane as a library.
|
Example: server_embedded — running the ChronosOS control plane as a library. |
|
skills
command
Example: skills — registering, listing, and resolving skills.
|
Example: skills — registering, listing, and resolving skills. |
|
streaming_sse
command
Example: streaming_sse demonstrates the event streaming broker for real-time observability.
|
Example: streaming_sse demonstrates the event streaming broker for real-time observability. |
|
structured_output
command
Example: structured_output — asking an LLM for strict JSON and decoding it.
|
Example: structured_output — asking an LLM for strict JSON and decoding it. |
|
subagents
command
Example: subagents demonstrates context-isolated delegation (WC-A-003).
|
Example: subagents demonstrates context-isolated delegation (WC-A-003). |
|
team_deploy
command
Example: team_deploy — Deploy multi-agent teams from YAML with sandbox isolation.
|
Example: team_deploy — Deploy multi-agent teams from YAML with sandbox isolation. |
|
tools_and_guardrails
command
Example: tools_and_guardrails demonstrates the tool registry with permission levels and guardrail engine for input/output validation.
|
Example: tools_and_guardrails demonstrates the tool registry with permission levels and guardrail engine for input/output validation. |
|
vertex
command
Google Cloud Vertex AI example for Chronos.
|
Google Cloud Vertex AI example for Chronos. |
|
vfs_agent
command
Example: vfs_agent demonstrates the virtual filesystem for context offloading (WC-A-002).
|
Example: vfs_agent demonstrates the virtual filesystem for context offloading (WC-A-002). |
|
wasm_sandbox
command
Example: wasm_sandbox runs an untrusted WebAssembly (WASI) module inside the pure-Go wazero-backed sandbox.
|
Example: wasm_sandbox runs an untrusted WebAssembly (WASI) module inside the pure-Go wazero-backed sandbox. |
|
Package chronosos provides the ChronosOS control plane server.
|
Package chronosos provides the ChronosOS control plane server. |
|
apidocs
Package apidocs Code generated by swaggo/swag.
|
Package apidocs Code generated by swaggo/swag. |
|
approval
Package approval provides human-in-the-loop approval workflows for the ChronosOS control plane.
|
Package approval provides human-in-the-loop approval workflows for the ChronosOS control plane. |
|
auth
Package auth provides authentication and RBAC for ChronosOS.
|
Package auth provides authentication and RBAC for ChronosOS. |
|
interfaces/discord
Package discord provides a Discord bot interface for Chronos agents.
|
Package discord provides a Discord bot interface for Chronos agents. |
|
interfaces/slack
Package slack provides a Slack bot interface for Chronos agents.
|
Package slack provides a Slack bot interface for Chronos agents. |
|
interfaces/telegram
Package telegram provides a Telegram bot interface for Chronos agents.
|
Package telegram provides a Telegram bot interface for Chronos agents. |
|
interop/agui
Package agui exposes Chronos runs as a standard AG-UI event stream, so any AG-UI-compatible frontend can render an agent run (steps, tool calls, plan updates, state snapshots, interrupts, completion) without Chronos-specific glue.
|
Package agui exposes Chronos runs as a standard AG-UI event stream, so any AG-UI-compatible frontend can render an agent run (steps, tool calls, plan updates, state snapshots, interrupts, completion) without Chronos-specific glue. |
|
logging
Package logging provides structured JSON-line logging with correlation and tenant identifiers carried through context.
|
Package logging provides structured JSON-line logging with correlation and tenant identifiers carried through context. |
|
metrics
Package metrics provides Prometheus-format metrics collection and export.
|
Package metrics provides Prometheus-format metrics collection and export. |
|
middleware
Package middleware provides HTTP middleware for ChronosOS.
|
Package middleware provides HTTP middleware for ChronosOS. |
|
scheduler
Package scheduler provides cron-based scheduling for agent runs.
|
Package scheduler provides cron-based scheduling for agent runs. |
|
trace
Package trace provides execution tracing and audit logging.
|
Package trace provides execution tracing and audit logging. |
|
webhook
Package webhook provides a generic webhook interface for receiving external events.
|
Package webhook provides a generic webhook interface for receiving external events. |
|
Package sandbox provides isolation for untrusted tool/skill execution.
|
Package sandbox provides isolation for untrusted tool/skill execution. |
|
sdk
|
|
|
agent
Package agent provides the agent definition and builder API.
|
Package agent provides the agent definition and builder API. |
|
harness
Package harness provides agent-harness orchestration primitives that compose over the SDK agent loop — context-isolated and dynamic subagents, and the "deep agent" preset that assembles them with planning (WC-A-001) and the virtual filesystem (WC-A-002).
|
Package harness provides agent-harness orchestration primitives that compose over the SDK agent loop — context-isolated and dynamic subagents, and the "deep agent" preset that assembles them with planning (WC-A-001) and the virtual filesystem (WC-A-002). |
|
knowledge
Package knowledge provides a RAG knowledge base abstraction inspired by Agno's Knowledge protocol.
|
Package knowledge provides a RAG knowledge base abstraction inspired by Agno's Knowledge protocol. |
|
knowledge/loaders
Package loaders provides document loaders for different file formats.
|
Package loaders provides document loaders for different file formats. |
|
memory
Package memory — manager.go provides an LLM-powered memory manager inspired by Agno's MemoryManager.
|
Package memory — manager.go provides an LLM-powered memory manager inspired by Agno's MemoryManager. |
|
protocol
Package protocol defines the agent-to-agent communication protocol.
|
Package protocol defines the agent-to-agent communication protocol. |
|
protocol/a2a
Package a2a implements the Agent-to-Agent (A2A) protocol for cross-framework agent communication.
|
Package a2a implements the Agent-to-Agent (A2A) protocol for cross-framework agent communication. |
|
skill
Package skill provides the skill/plugin system for Chronos agents.
|
Package skill provides the skill/plugin system for Chronos agents. |
|
team
Package team provides multi-agent orchestration with inter-agent communication.
|
Package team provides multi-agent orchestration with inter-agent communication. |
|
skills
|
|
|
examples
Package examples provides example skill definitions.
|
Package examples provides example skill definitions. |
|
Package storage defines the core persistence interfaces for Chronos.
|
Package storage defines the core persistence interfaces for Chronos. |
|
adapters/chromadb
Package chromadb provides a ChromaDB-backed VectorStore adapter for Chronos.
|
Package chromadb provides a ChromaDB-backed VectorStore adapter for Chronos. |
|
adapters/dynamo
Package dynamo provides a DynamoDB-backed Storage adapter for Chronos.
|
Package dynamo provides a DynamoDB-backed Storage adapter for Chronos. |
|
adapters/lancedb
Package lancedb provides a LanceDB-backed VectorStore adapter for Chronos.
|
Package lancedb provides a LanceDB-backed VectorStore adapter for Chronos. |
|
adapters/memory
Package memory provides an in-memory Storage adapter for Chronos.
|
Package memory provides an in-memory Storage adapter for Chronos. |
|
adapters/milvus
Package milvus provides a Milvus-backed VectorStore adapter for Chronos.
|
Package milvus provides a Milvus-backed VectorStore adapter for Chronos. |
|
adapters/mongo
Package mongo provides a MongoDB-backed Storage adapter for Chronos.
|
Package mongo provides a MongoDB-backed Storage adapter for Chronos. |
|
adapters/pgvector
Package pgvector provides a PostgreSQL+pgvector-backed VectorStore adapter for Chronos.
|
Package pgvector provides a PostgreSQL+pgvector-backed VectorStore adapter for Chronos. |
|
adapters/pinecone
Package pinecone provides a Pinecone-backed VectorStore adapter for Chronos.
|
Package pinecone provides a Pinecone-backed VectorStore adapter for Chronos. |
|
adapters/postgres
Package postgres provides a PostgreSQL-backed Storage adapter for Chronos.
|
Package postgres provides a PostgreSQL-backed Storage adapter for Chronos. |
|
adapters/qdrant
Package qdrant provides a Qdrant-backed VectorStore adapter for Chronos.
|
Package qdrant provides a Qdrant-backed VectorStore adapter for Chronos. |
|
adapters/redis
Package redis provides a Redis-backed Storage adapter for Chronos.
|
Package redis provides a Redis-backed Storage adapter for Chronos. |
|
adapters/redisvector
Package redisvector provides a Redis-backed VectorStore adapter using the RediSearch module (Redis Stack) for KNN vector similarity search.
|
Package redisvector provides a Redis-backed VectorStore adapter using the RediSearch module (Redis Stack) for KNN vector similarity search. |
|
adapters/sqlite
Package sqlite provides a SQLite-backed Storage adapter for Chronos.
|
Package sqlite provides a SQLite-backed Storage adapter for Chronos. |
|
adapters/weaviate
Package weaviate provides a Weaviate-backed VectorStore adapter for Chronos.
|
Package weaviate provides a Weaviate-backed VectorStore adapter for Chronos. |
|
migrate
Package migrate provides versioned database migrations for SQL backends.
|
Package migrate provides versioned database migrations for SQL backends. |
Click to show internal directories.
Click to hide internal directories.