Append an event to the shared event log with optional metadata.

Use this to record agent actions, decisions, and state changes. All events are append-only with stable UUIDv7 ordering, enabling deterministic replay.

Side effects: Creates a new event in the SQLite event log. Triggers an automatic snapshot when the event threshold is reached. This is the primary write operation for the event-sourced architecture.

Query and filter recorded events from the append-only event log.

Use this to inspect the history of agent actions and system state changes. Events are ordered by stable UUIDv7 timestamps for consistent replay.

Side effects: Read-only operation; no data is modified.

Retrieve git repository context, working tree status, or recent changes.

Consolidated tool replacing the previous get_git_context, get_git_status, and get_recent_changes tools. Use info_type to select what subset to return.

"all" returns branch, remote, recent commits, working tree status, and staged/ modified/untracked file lists in a single response. Use this when you need the full picture before making changes.

Side effects: Read-only operation; queries git repository.

Semantic search over stored memories to find similar workflows and patterns.

Use this to discover relevant past work when facing a new task. Returns both similar workflows and common failure patterns that match the query.

Side effects: Reads from the semantic memory store built by build_memory. Use build_memory first to ensure the index is up-to-date.

Build a complete orchestration view of the project with tasks, agents, and state.

Use this to get a holistic view of the project's current state, including all tasks, agent assignments, performance metrics, and session information. More comprehensive than get_task_graph which focuses only on task dependencies.

Side effects: Read-only operation; uses snapshot resume for efficiency.

Run a multi-stage decision pipeline with configurable reasoning stages.

Orchestrates counterfactual reasoning, scenario generation, foresight planning, meta-reasoning, uncertainty estimation, and information-need detection into a single pipeline run. The pipeline evaluates the provided objective and returns a ranked recommendation with evidence.

Use this for high-stakes decisions where multiple perspectives add value. For simpler individual analyses, use the standalone tools (evaluate_plan, generate_scenarios, etc.) instead.

Side effects: Records decision events; if execute_mode='queued_runtime', may enqueue follow-up tasks for runtime execution.

Resume project state from the latest snapshot or event history.

Use this to reconstruct the full project state including tasks, sessions, and memory after a restart or for multi-agent collaboration.

Side effects: Reads from the event log and/or snapshot store. Does not modify data.

Create a point-in-time snapshot of project state for fast resume.

Use this to explicitly create a checkpoint before major operations or for backup purposes. Snapshots enable fast project reconstruction via resume_project with use_snapshot=True.

Side effects: Creates a snapshot entry in the snapshot repository. This is a write operation that stores a compressed representation of current state.

Create a new task in the event-sourced task graph for multi-agent orchestration.

Use this to add work items before assigning them to agents. For updating an existing task's priority, use change_task_priority instead. This appends a TASK_CREATED event to the append-only SQLite event log with stable UUIDv7 ordering.

Side effects: Creates a TASK_CREATED event in the project's event log. Triggers an automatic snapshot when the event threshold is reached. Does NOT assign the task.

Build and return the full task dependency graph.

Use this to visualize and analyze task dependencies, detect cycles, and understand the current state of work items in the project. Returns the raw task graph structure with agent assignments and state.

For execution flow traces with state transitions, use get_workflow_graph instead.