Module advisor 

Advisor subsystem — read-only reviewer that shadows the primary agent. Advisor subsystem — a read-only reviewer agent that shadows the primary agent and surfaces advice (nit/concern/blocker) via an advise tool.

Ported from omp packages/coding-agent/src/advisor/. The engine lives here (in oxicode-agent) so the SDK can expose it; host wiring — AgentSession integration, the file-backed transcript recorder, WATCHDOG.md discovery, and the /advisor slash command — lives in the product (oxicode-cli).

Attribution

Translated to Rust from omp (oh-my-pi), which is MIT licensed (Copyright (c) 2025 Mario Zechner; Copyright (c) 2025-2026 Can Bölük). oxicode’s translation remains under oxicode’s own MIT license.

Re-exports

pub use advise_tool::AdviseTool;

pub use advise_tool::EnqueueAdviceFn;

pub use agent_advisor::AgentAdvisor;

pub use channels::format_advisory_batch;

pub use channels::is_immune_turn_active;

pub use channels::is_interrupting_severity;

pub use channels::resolve_delivery_channel;

pub use emission_guard::AdvisorEmissionGuard;

pub use emission_guard::normalize_advisor_note;

pub use runtime::AdvisorAgent;

pub use runtime::AdvisorRuntime;

pub use runtime::AdvisorRuntimeHost;

pub use types::ADVISOR_GUIDANCE;

pub use types::AdvisorDeliveryChannel;

pub use types::AdvisorNote;

pub use types::AdvisorSeverity;

pub use types::DeliveryOpts;

Modules

advise_tool

The advise agent tool — ported from omp AdviseTool (advise-tool.ts).

agent_advisor

Concrete AdvisorAgent adapter over crate::Agent.

channels

Delivery-channel resolution + <advisory> rendering — pure functions ported from omp advise-tool.ts.

emission_guard

Per-session policy gate for advisor advise() calls — ported from omp emission-guard.ts.

runtime

The advisor runtime — drives the advisor agent from primary transcript deltas. Ported from omp AdvisorRuntime (runtime.ts).

types

Advisor core types — ported from omp advise-tool.ts.

Constants

ADVISOR_READONLY_TOOL_NAMES

Tool names handed to the advisor agent — side-effect-free investigation only. omp ADVISOR_READONLY_TOOL_NAMES is read/grep/glob; oxicode’s glob equivalent is find.

ADVISOR_SYSTEM_PROMPT

The advisor agent’s system prompt (omp prompts/advisor/system.md). The host assembles the full advisor system prompt from this + optional context-files/watchdog blocks.