Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
agent_trigger
What it is
Part of agent sessions: decides whether a posted channel message, task assignment, or project assignment should start an agent session, and assembles the prompt context (thread history, people, discussion) for the session that results.
Start here
src/domain/service.rs: orchestration for evaluating one posted message — mention detection, admission, and dispatch.src/domain/sources.rs: the trigger sources (explicit mention, implicit reply, task/project assignment).src/domain/broker_events.rs: the events, andNewAgentSessionEvent::origin, which says what opened the session (trigger_context::TriggerOrigin). OnlyNewevents tell it: a runtime already has the sessions it is following up in.src/domain/context.rs: structured context assembled for the agent prompt (thread history, people, discussion). Message attachments travel on eachContextMessageso the prompt XML and ACP file links can see files that were not on the mentioning message.src/domain/task_assignment.rs/src/domain/project_assignment.rs: non-message trigger paths.src/outbound/jev_judge.rs: the Jev implicit-trigger judge — one yes/no question per live agent in the thread; the domain routes to the single agent at or above the threshold.
Scope
- Owns: trigger detection/admission and prompt-context assembly for all trigger sources.
- Not here: running the agent session once triggered →
agent_harness; session state →agent_session.
Boundaries
- Depends on:
agent_session,ai_billing(admission,admissionfeature),messages,bots,jev(outbound). - Used by:
agent_trigger_service(its primary host) andagent_harness(routes triggers it receives viaagent_harness'strigger_router).
Recipes
- Add a trigger source:
src/domain/sources.rs→src/domain/service.rs(admission + dispatch) →src/domain/context.rsif it needs new context. - Change implicit-reply detection:
src/outbound/jev_judge.rs→src/outbound/lexical_explicit_reply_extractor.rs.
Checks
cargo test -p agent_trigger(SQLX_OFFLINEunset).
Gotchas
- Implicit replies need
TYPESAFE_API_KEYin the host (agent_trigger_service,agent_harness_service); while it is unset only mentions and explicit replies reach agents. Image captions still use the fast vision model, since Jev reads text only. - A new trigger variant must also be taught to
crates/webhookingestion and the SSE fan-out, or it will be silently dropped end to end. - Attributed bot messages (
MessagePostedMetadata::invoking_user) trigger exactly like human ones: explicit, reply-target and inferred. The agent hop limit (messages::domain::agent_hops) is the loop guard and runs before any routing or judge call; a bot's message never targets its own bot's session. Unattributed bot posts trigger nothing.
Related
- Rules:
.agents/rules/rust/architecture.md