Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
/**
* Protected job names — side-effect-free constant module.
*
* Names in this set require an explicit `trusted.allowProtectedSubmit: true` opt-in
* when passed to `MinionQueue.add()`. The CLI path and the `submit_job` operation
* (when `ctx.remote === false`) set the flag; MCP callers never do. Defense-in-depth
* against in-process handlers that programmatically submit a shell child via
* `queue.add('shell', ...)`.
*
* This file must stay pure — no imports from handlers, no filesystem, no env reads.
* Queue core imports it; if this module grew side effects, every queue user would
* pay them at module load.
*/
/**
* The queue of drain-lease holder records (persistence/sync-lease.ts): an active row per held sync lease that no worker
* claims and that the lease renews and deletes itself. It is not a job, so the stall, timeout and wall-clock sweeps
* skip it (#7261): dead-lettering it counted an attempt it never started and broke chk_attempts_order.
*/
export const LEASE_BEACON_QUEUE = 'gbrain-drain-lease';
export const PROTECTED_JOB_NAMES: ReadonlySet<string> = new Set([
'shell',
// v0.15: subagent + aggregator are protected because they call the
// Anthropic API. MCP callers can't submit them directly; only the
// `gbrain agent run` CLI path (which sets allowProtectedSubmit) or a
// trusted local `submit_job` (ctx.remote=false) can insert these rows.
'subagent',
'subagent_aggregator',
// v0.36+ brain-health-100 wave (D11 from outside-voice review):
// synthesize, patterns, consolidate are cycle phases that internally
// submit `subagent` children with allowProtectedSubmit=true. Treating
// them as "data-quality maintenance" was a misread — they CAN run
// Sonnet loops costing user money. Protected ensures only trusted
// local callers (CLI, autopilot, doctor --remediate) can submit them;
// an OAuth-scoped MCP client can't burn the user's API budget by
// submitting a synthesize job over HTTP.
'synthesize',
'patterns',
'consolidate',
// Temporal typed edges: the contradiction phase calls the chat model.
'edge_contradictions',
// C4 pinned questions: each refresh is a paid chat call.
'standing_questions',
// v0.40.3.0 — per-chunk Haiku contextual retrieval backfill. Each job
// potentially calls Haiku 1-50 times per page; an MCP/OAuth-scoped
// caller submitting this in bulk could drain the user's Anthropic
// budget. Only trusted local callers (the mode-switch hook in
// commands/config.ts, reindex sweep, doctor --remediate) can submit.
'contextual_reindex_per_chunk',
// v0.41.18.0 (A12, T9) — takes-bootstrap. Per-page Haiku classifier
// call over concept/atom/lore/briefing/writing/originals. Two-gate
// consent (takes.bootstrap_enabled + --yes) AND PROTECTED ensures
// no remote / MCP / autopilot path can bulk-extract takes without
// explicit operator intent.
'extract-takes-from-pages',
// v0.42 type-unification (T11, plan D17). Pack-upgrade migration that
// retypes 25K+ pages, creates 5K+ alias rows, converts edge-shaped
// pages to link rows, AND flips the active schema pack. One-time
// consenting user decision. PROTECTED + manual-only
// (src/core/remediation/manual-only.ts) ensures no automatic run submits
// it; the user submits it explicitly via `gbrain jobs submit unify-types`
// (the local CLI submit path sets allowProtectedSubmit for protected names
// itself).
'unify-types',
// v0.42.0.0 — SkillOpt: optimizer Sonnet/Opus loops over a benchmark.
// Preemptive register entry (v1 is CLI-only foreground; future Minion
// handler must reject MCP submission). Costs user money (optimizer +
// judge + rollouts) so PROTECTED is the right posture.
'skillopt',
// v0.42.x (#1685 GAP D, CODEX #1) — extract_atoms backlog drain. Each run
// calls Haiku to extract atoms (~$0.30/source/run), so it MUST NOT be
// submittable by an MCP/OAuth-scoped caller — same posture as the protected
// `extract-takes-from-pages`. Only trusted local callers (the autopilot
// auto-drain branch, an explicit `gbrain jobs submit extract-atoms-drain`
// from the CLI — which sets allowProtectedSubmit for protected names itself;
// no submit flag exists or is needed) can insert it.
'extract-atoms-drain',
]);
/** Check a job name against the protected set. Normalizes whitespace first. */
export function isProtectedJobName(name: string): boolean {
return PROTECTED_JOB_NAMES.has(name.trim());
}