Skip to content
MSO CloudDocumentation

Signals and decisions

On this page

Signals, alerts, the morning brief, actions, playbooks, memos and the decision ledger.

The routers read and advance decision lifecycle state; the scoring math and every ledger write live in packages/metrics (offtake.ts, offtake-loop.ts). Every approve or record mutation requires an owner or admin, a weak signal abstains, and every decision is traceable to its rule version, signal values and model version.

alerts#

Source: apps/web/src/server/routers/alerts.ts

Procedure Type Access Description
alerts.list query orgProcedure —
alerts.preferences query orgProcedure —
alerts.briefRulePacks query orgProcedure —
alerts.upsertPreference mutation rateLimitedOrgProcedure —
alerts.acknowledge mutation rateLimitedOrgProcedure, owner or admin Someone has seen the incident; it stays active until it clears or is resolved.
alerts.resolve mutation rateLimitedOrgProcedure, owner or admin Close an active incident by hand; the next true evaluation opens a new one.
alerts.snoozeIncident mutation rateLimitedOrgProcedure Hide one active incident from the caller until until (at most 30 days out); other members still see it.
alerts.incidentStates query orgProcedure The live state of the incidents a bell page names, behind the same fence the mutations use, plus whether the caller may acknowledge/resolve them.
alerts.datasetRuleCatalog query rateLimitedOrgProcedure, manage_org_settings Everything the authoring form offers, in one round trip:
alerts.datasetRules query orgProcedure, manage_org_settings The org's authored dataset rules, newest first.
alerts.createDatasetRule mutation rateLimitedOrgProcedure, owner or admin —
alerts.setDatasetRuleEnabled mutation rateLimitedOrgProcedure, owner or admin Pause or resume one authored rule.
alerts.setRuleEnabled mutation rateLimitedOrgProcedure, manage_org_settings The org's on/off for one rule (pack or reminder).
alerts.deleteDatasetRule mutation rateLimitedOrgProcedure, owner or admin —
alerts.runNow mutation authedProcedure, owner or admin —

alertWorkflows#

Source: apps/web/src/server/routers/alert-workflows.ts

Procedure Type Access Description
alertWorkflows.list query orgProcedure —
alertWorkflows.get query orgProcedure —
alertWorkflows.catalog query orgProcedure —
alertWorkflows.templates query orgProcedure —
alertWorkflows.templateCatalog query orgProcedure The catalog by data type for this org: which groups it has data for, and where each evaluable template can be created.
alertWorkflows.create mutation rateLimitedOrgProcedure, owner or admin —
alertWorkflows.saveDraft mutation rateLimitedOrgProcedure —
alertWorkflows.simulate mutation authedProcedure —
alertWorkflows.publish mutation rateLimitedOrgProcedure —
alertWorkflows.setStatus mutation rateLimitedOrgProcedure —
alertWorkflows.runs query orgProcedure —
alertWorkflows.versions query orgProcedure —

briefing#

Source: apps/web/src/server/routers/briefing.ts

Procedure Type Access Description
briefing.byUser query brandProcedure —
briefing.latestGeneratedAt query brandProcedure The button polls this until the worker's run lands (ISO or null).
briefing.alertsForReader query orgProcedure — the page's alert card reads the brief's own fenced read for this reader, so the card and the bullets can never show two alert sets.
briefing.lastRun query orgProcedure Why there is no brief: the worker's last recorded run for this cadence, as a closed notice kind (never the raw reason code).
briefing.cadence query orgProcedure —
briefing.refresh mutation rateLimitedBrandProcedurePerUser A durable intent for the worker's briefing job, never an in-request rebuild.

actions#

Source: apps/web/src/server/routers/actions.ts

Procedure Type Access Description
actions.queue query orgProcedure, manage_ai, manage_actions —
actions.propose mutation authedProcedure, manage_actions —
actions.approve mutation authedProcedure, manage_actions —
actions.reject mutation authedProcedure, manage_actions —
actions.rollback mutation authedProcedure, manage_actions —
actions.monthlyApprovalRate query orgProcedure —
actions.experiments query orgProcedure —

memos#

Source: apps/web/src/server/routers/memos.ts

Weekly Action Memo router.

Procedure Type Access Description
memos.list query orgProcedure —
memos.get query orgProcedure —
memos.publish mutation rateLimitedOrgProcedure, manage_decisions —
memos.archive mutation rateLimitedOrgProcedure, manage_decisions —
memos.generate mutation rateLimitedOrgProcedure, manage_decisions Generate (or refresh) the memo for an explicit period.

playbooks#

Source: apps/web/src/server/routers/playbooks.ts

Playbooks router — backing store for the React-Flow canvas at /automations.

Procedure Type Access Description
playbooks.list query orgProcedure —
playbooks.get query orgProcedure —
playbooks.create mutation rateLimitedOrgProcedure, manage_playbooks —
playbooks.saveGraph mutation rateLimitedOrgProcedure, manage_playbooks —
playbooks.run mutation authedProcedure, manage_playbooks —
playbooks.toggle mutation rateLimitedOrgProcedure, manage_playbooks —
playbooks.nodeCatalog query orgProcedure Canvas palette.

offtake#

Source: apps/web/src/server/routers/offtake.ts

Procedure Type Access Description
offtake.signals query orgProcedure —
offtake.decisions query orgProcedure Decision Memory (historical) + Inbox (proposed) + outcomes, all brands.
offtake.trackRecord query orgProcedure Track record (calibration): hit-rate by confidence bucket.
offtake.experimentsList query orgProcedure —
offtake.episodes query orgProcedure —
offtake.playbookStats query orgProcedure —
offtake.confirmOutcome mutation rateLimitedOrgProcedure, owner or admin —
offtake.approveLesson mutation rateLimitedOrgProcedure, owner or admin —
offtake.approve mutation rateLimitedOrgProcedure, owner or admin Govern gate → approve a proposed decision (1-click) + emit action_commands.
offtake.reject mutation rateLimitedOrgProcedure, owner or admin —
offtake.markExecuted mutation rateLimitedOrgProcedure, owner or admin —
offtake.cancel mutation rateLimitedOrgProcedure, owner or admin Owner/admin un-RUNs an approved/activated decision — returns it to the Decision Inbox ('proposed') so it can be re-decided or skipped.
offtake.settings query orgProcedure —
offtake.updateSettings mutation rateLimitedOrgProcedure, owner or admin —
offtake.policyRecommend query orgProcedure —
offtake.governanceStatus query orgProcedure —
offtake.replayEpisodes query orgProcedure, owner or admin —
offtake.memoryCitations query orgProcedure —
offtake.loopStatus query orgProcedure —
offtake.loopBand query orgProcedure —
offtake.registerExperiment mutation rateLimitedOrgProcedure, owner or admin —
offtake.experimentReadout mutation rateLimitedOrgProcedure, owner or admin Read out a registered experiment.
offtake.opeReport mutation rateLimitedOrgProcedure, owner or admin Produce — and record — an off-policy evaluation of a candidate ranking policy.
offtake.policyVersions query orgProcedure The champion/challenger board: every version, its alias and its evidence.
offtake.promotePolicy mutation rateLimitedOrgProcedure, owner or admin —
offtake.rollbackPolicy mutation rateLimitedOrgProcedure, owner or admin Roll the champion back to its parent.

msoPlaybooks#

Source: apps/web/src/server/routers/mso-playbooks.ts

Procedure Type Access Description
msoPlaybooks.list query orgProcedure —
msoPlaybooks.upsert mutation rateLimitedOrgProcedure, owner or admin —
msoPlaybooks.remove mutation rateLimitedOrgProcedure, owner or admin —
msoPlaybooks.suggestRule mutation authedProcedure, owner or admin —
msoPlaybooks.saveRuleDraft mutation rateLimitedOrgProcedure, owner or admin —
msoPlaybooks.activateRule mutation rateLimitedOrgProcedure, owner or admin —
msoPlaybooks.rulePreview query orgProcedure, owner or admin —
msoPlaybooks.simulateDraft query orgProcedure, owner or admin —
msoPlaybooks.simulate query orgProcedure, owner or admin —
msoPlaybooks.scanAndPropose mutation rateLimitedOrgProcedure, owner or admin —
msoPlaybooks.seedDefaults mutation rateLimitedOrgProcedure, owner or admin One-click: materialise the code defaults into editable DB rows for this org.

signals#

Source: apps/web/src/server/routers/signal-events.ts

Procedure Type Access Description
signals.ledger query orgProcedure —
signals.dismiss mutation rateLimitedOrgProcedure, owner or admin "Stop telling me this." Records who, when and why on the instance, and the collector reads it back at the next brief:
signals.markActed mutation rateLimitedOrgProcedure, owner or admin — "acted on" feeds signal_stats ranking for the whole org, so it is an owner/admin verdict like dismiss.