@aitne/daemon 0.1.8 → 0.1.9

package/dist/core/backends/opencode-core.js

@@ -23,6 +23,7 @@ import { randomUUID } from "node:crypto";
 import { defaultApiKeyProvider, isAutonomousProcessKey, isMessageEvent, } from "@aitne/shared";
 import { getContextDir } from "../../config.js";
 import { cleanupSessionWorkdir, createSessionWorkdir, } from "../workdir.js";
+import { resolveUserSkillsRoot } from "../user-skills-root.js";
 import { auditStreamObservation, extractOpencodeToolUseTarget, } from "../../safety/subprocess-block-scanner.js";
 import { BackendDecisiveFailure, DelegatedToolUnsupportedError, LiveProbeUnsupportedError, TaskModeUnsupportedError, classifyAbortReason, } from "../agent-core.js";
 import { matchRunAllowedToolPattern } from "@aitne/shared";
@@ -459,7 +460,7 @@ export class OpencodeCore {
             throw new Error("runTurn(resumeSessionId): sessionDir is required when resuming");
         }
         const startMs = Date.now();
-        const sessionDir = params.sessionDir ?? createSessionWorkdir(this.config.workspaceDir, params.event.type, `${this.config.dataDir}/skills`, {
+        const sessionDir = params.sessionDir ?? createSessionWorkdir(this.config.workspaceDir, params.event.type, resolveUserSkillsRoot(this.config), {
             backendId: this.backendId,
             ...(params.processKey ? { processKey: params.processKey } : {}),
             character: this.config.character,
@@ -471,6 +472,12 @@ export class OpencodeCore {
             // have no DB rows AND no trigger phrase.
             ...(this.mcpContext?.db ? { db: this.mcpContext.db } : {}),
             ...(isMessageEvent(params.event) ? { messageText: params.event.content } : {}),
+            // AGENT_DEFINITIONS_DESIGN.md §4.2 — see ClaudeCodeCore. No-op for
+            // non-Agent executes (`OpencodeTurnParams` extends AgentExecuteParams).
+            ...(params.extraSkills && params.extraSkills.length > 0
+                ? { extraSkills: params.extraSkills }
+                : {}),
+            ...(params.skillsReplace ? { skillsReplace: true } : {}),
         });
         const ownsSessionDir = !params.sessionDir;
         // NOTE: opencode SDK runs the server in-process (createOpencode does
@@ -1499,4 +1506,3 @@ function formatForProcessKey(processKey) {
     }
     return null;
 }
-//# sourceMappingURL=opencode-core.js.map

package/dist/core/backends/opencode-event-mapper.d.ts

@@ -130,4 +130,3 @@ export interface ExtractedToolUse {
  * unknown input.
  */
 export declare function extractToolUsesFromParts(parts: unknown): ExtractedToolUse[];
-//# sourceMappingURL=opencode-event-mapper.d.ts.map

package/dist/core/backends/opencode-event-mapper.js

@@ -195,4 +195,3 @@ export function extractToolUsesFromParts(parts) {
     }
     return tools;
 }
-//# sourceMappingURL=opencode-event-mapper.js.map

package/dist/core/backends/opencode-mcp.d.ts

@@ -79,4 +79,3 @@ export declare function isAcceptableOpencodeServerName(id: string): boolean;
  * fail-soft posture as the Claude / Codex / Gemini generators.
  */
 export declare function renderOpencodeMcp(input: OpencodeMcpRenderInput): OpencodeMcpRenderResult;
-//# sourceMappingURL=opencode-mcp.d.ts.map

package/dist/core/backends/opencode-mcp.js

@@ -128,26 +128,19 @@ export function renderOpencodeMcp(input) {
             mcp[server.id] = local;
             continue;
         }
-        /* c8 ignore start — McpTransport is closed-set; the http/sse branch
-           always covers the remaining transports after the stdio early-return
-           above, so the false-branch + unknown fallthrough below are
-           unreachable unless a future transport ships without updating the
-           renderer. */
-        if (server.transport === "http" || server.transport === "sse") {
-            /* c8 ignore stop */
-            const remote = renderRemote(server, input.secrets, input.defaultTimeoutMs);
-            if (!remote) {
-                warnings.push(`opencode-mcp: ${server.transport} server '${server.id}' has no 'url'; skipped`);
-                continue;
-            }
-            mcp[server.id] = remote;
+        // `McpTransport` is the closed set { stdio, http, sse } (see
+        // services/mcp/types.ts). After the stdio branch above, only http
+        // and sse remain — both go through `renderRemote`. Extending
+        // `McpTransport` without updating this branch is caught by the
+        // probe / dashboard layers, which won't ever ask opencode to
+        // materialize an unknown transport.
+        const remote = renderRemote(server, input.secrets, input.defaultTimeoutMs);
+        if (!remote) {
+            warnings.push(`opencode-mcp: ${server.transport} server '${server.id}' has no 'url'; skipped`);
             continue;
         }
-        /* c8 ignore start — see note above. */
-        const unknown = server.transport;
-        warnings.push(`opencode-mcp: unsupported transport '${String(unknown)}' for server '${server.id}'`);
+        mcp[server.id] = remote;
     }
-    /* c8 ignore stop */
     if (Object.keys(mcp).length > 0) {
         logger.debug({ serverIds: Object.keys(mcp), warningCount: warnings.length }, "rendered opencode mcp map");
     }
@@ -162,4 +155,3 @@ export function renderOpencodeMcp(input) {
         warnings,
     };
 }
-//# sourceMappingURL=opencode-mcp.js.map

package/dist/core/backends/opencode-server-manager.d.ts

@@ -111,4 +111,3 @@ export declare class ManagedOpencodeServerManager implements OpencodeServerManag
  * The factory contract keeps callers backend-shape-agnostic.
  */
 export declare function createOpencodeServerManager(options?: ManagedOpencodeServerManagerOptions): OpencodeServerManager;
-//# sourceMappingURL=opencode-server-manager.d.ts.map

package/dist/core/backends/opencode-server-manager.js

@@ -219,4 +219,3 @@ export class ManagedOpencodeServerManager {
 export function createOpencodeServerManager(options = {}) {
     return new ManagedOpencodeServerManager(options);
 }
-//# sourceMappingURL=opencode-server-manager.js.map

package/dist/core/backends/opencode-types.d.ts

@@ -43,4 +43,3 @@ export type RawOpencodeEvent = {
  * (V4). Pass the resulting object to the SDK call via a single cast.
  */
 export type OpencodeAugmentedPromptBody = import("@opencode-ai/sdk").SessionPromptData["body"] & Partial<import("@opencode-ai/sdk").SessionPromptBodyAugmented>;
-//# sourceMappingURL=opencode-types.d.ts.map

package/dist/core/backends/opencode-types.js

@@ -11,4 +11,3 @@
  * incomplete `EventSubscribeResponse`.
  */
 export {};
-//# sourceMappingURL=opencode-types.js.map

package/dist/core/backends/plan-presets.d.ts

@@ -135,4 +135,3 @@ export declare function previewMainSwitchImpact(db: Database.Database, targetBac
  * next to a pinned row. Returns `null` when the model is unknown.
  */
 export declare function inferTierForModel(backendId: BackendId, modelId: string): ProcessModelTier | null;
-//# sourceMappingURL=plan-presets.d.ts.map

package/dist/core/backends/plan-presets.js

@@ -108,9 +108,25 @@ export function applyBackendBudgetFactor(backendId, tier, baseBudgetUsd) {
  * Inclusion rule: a process key needs an entry here iff its schema-seed
  * envelope differs from `ENVELOPE_BY_TIER[<its default tier>]`. Process
  * keys whose schema seed matches the bare tier envelope (e.g.
- * `message.dm` = medium 50/$1.00) do not need an entry.
+ * `message.mention` / `dashboard.chat` = medium 50/$1.00) do not need
+ * an entry. (`message.dm` USED to be such a key, but now carries a
+ * wider $5.00 ceiling — see its entry below.)
  */
 const ENVELOPE_OVERRIDES_BY_PROCESS_KEY = {
+    // ── Medium-tier WIDER envelope ────────────────────────────────────────
+    //
+    // `message.dm` is the operator's primary conversational surface. Each
+    // turn re-processes the full DM history (which can carry prior
+    // browser-task reports + screenshots) and routinely runs $0.70-0.80 on
+    // Sonnet, hugging the old $1.00 medium nominal. Legitimate multi-step
+    // turns (dispatch a browser task, answer a follow-up, do real tool
+    // work) tipped over $1.00 mid-turn and surfaced a
+    // BackendQuotaError(max_budget_usd) to the user even when the work
+    // itself succeeded. $5.00 is a per-turn CEILING, not a target. Kept in
+    // lock-step with the schema-seed row; bumped for upgrading installs by
+    // migration 0006. (message.mention / dashboard.chat stay on the bare
+    // medium nominal and need no entry.)
+    "message.dm": { maxTurns: 50, maxBudgetUsd: 5.0 },
     // ── Medium-tier tighter envelopes ────────────────────────────────────
     //
     // `routine.today_refresh` is drift-triggered. A typical refresh on
@@ -138,11 +154,19 @@ const ENVELOPE_OVERRIDES_BY_PROCESS_KEY = {
     // Keep in lock-step with the corresponding schema-seed row.
     "routine.morning_routine_today": { maxTurns: 50, maxBudgetUsd: 1.5 },
     // morning-routine-optimization.md Phase 5 — Stage B is template-
-    // driven daily-journal authoring on lite tier. ~15 KB prompt + skill
-    // payload fits comfortably under a 20-turn / $0.10 envelope; the
-    // lite-tier $0.20 nominal would over-provision by 2x. Keep this in
+    // driven daily-journal authoring on lite tier. The original $0.10 cap
+    // was sized to a 15 KB prompt projection; production showed Stage B's
+    // assembled prompt at ~21 KB and Haiku cache_creation alone (charged
+    // at 1.25x input) consumes ~$0.06 on cold start. A single Bash
+    // tool round-trip then tipped over $0.10 mid-turn, producing
+    // BackendQuotaError(max_budget_usd) before Stage B could PUT
+    // `daily/<yesterday>.md` — the user-facing journal was silently
+    // missing for every recurring run. Realigned to $0.30: 3x the
+    // observed typical spend (matching the headroom convention also
+    // used by routine.today_refresh) and below the lite-tier nominal
+    // ceiling so the cap still binds in pathological cases. Keep in
     // lock-step with the corresponding schema-seed row.
-    "routine.morning_routine_journal": { maxTurns: 20, maxBudgetUsd: 0.1 },
+    "routine.morning_routine_journal": { maxTurns: 20, maxBudgetUsd: 0.3 },
     // `dashboard.docs_qa` is a focused QA panel, hard-clamped to medium
     // tier per §10.1. INHERITOR_DEFAULTS in process-config-cascade.ts
     // mirrors this envelope so cascade writes from message.dm don't bleed
@@ -202,6 +226,29 @@ const ENVELOPE_OVERRIDES_BY_PROCESS_KEY = {
     // worst-case fan-out. 20-turn turn count is unchanged. Keep in
     // lock-step with the corresponding schema-seed row.
     "routine.fetch_window": { maxTurns: 20, maxBudgetUsd: 0.5 },
+    // BROWSER_HISTORY_INTEGRATION_PLAN P3 — keep these in lock-step with
+    // the schema seed rows. cluster_update is a tiny dispatcher (1 PUT
+    // + a list call), so the absolute floor of 5/$0.05 is the right
+    // envelope. research_offer_dm is even tighter — a single DM
+    // composition (GET /research-clusters/<slug> + POST /api/notify),
+    // 5/$0.02 leaves no room for runaway. research_dispatch carries the
+    // WebFetch fan-out; mirrors evening_review (50/$1.00).
+    // research_wiki_summary is tighter (30/$0.50) — it reads the cluster
+    // journal the agent already wrote and composes from it, with
+    // bounded external work.
+    "routine.research_cluster_update": { maxTurns: 5, maxBudgetUsd: 0.05 },
+    "routine.research_offer_dm": { maxTurns: 5, maxBudgetUsd: 0.02 },
+    "routine.research_dispatch": { maxTurns: 50, maxBudgetUsd: 1.0 },
+    "routine.research_wiki_summary": { maxTurns: 30, maxBudgetUsd: 0.5 },
+    // BROWSER_TASK_REDESIGN_PLAN.md §5 — open-ended browser sub-agent.
+    // Medium-tier nominal is 50/$1.00; the §5 envelope picks a tighter
+    // 30-turn cap because the per-turn cost rises with multimodal
+    // screenshot input (one PNG ≤ 1MB per visual confirmation, and the
+    // typical sub-agent loop captures 4-5 over its lifetime). 30 turns
+    // keeps the upper bound bounded while $1.00 absorbs the screenshot
+    // cost without tripping BackendQuotaError. Lock-step with the
+    // schema-seed row.
+    "browser_task": { maxTurns: 30, maxBudgetUsd: 1.0 },
 };
 /**
  * Resolve the seed `(model, envelope)` for a configurable process key on
@@ -393,4 +440,3 @@ function highModelFor(backendId) {
         return DEFAULT_CLAUDE_HIGH_MODEL;
     return defaultModelForTier(backendId, "high");
 }
-//# sourceMappingURL=plan-presets.js.map

package/dist/core/backends/price-fetcher.d.ts

@@ -45,4 +45,3 @@ export declare class PriceFetcher {
     private writeStatus;
 }
 export {};
-//# sourceMappingURL=price-fetcher.d.ts.map

package/dist/core/backends/price-fetcher.js

@@ -245,4 +245,3 @@ function isUsageFullyCoveredByPriceEntry(entry, usage) {
 function readOptionalNumber(value) {
     return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
-//# sourceMappingURL=price-fetcher.js.map

package/dist/core/backends/process-config-cascade.d.ts

@@ -100,4 +100,3 @@ export declare const _internals: {
     readUpdatedBy: typeof readUpdatedBy;
 };
 export {};
-//# sourceMappingURL=process-config-cascade.d.ts.map

package/dist/core/backends/process-config-cascade.js

@@ -204,4 +204,3 @@ export const _internals = {
     readDefaults,
     readUpdatedBy,
 };
-//# sourceMappingURL=process-config-cascade.js.map

package/dist/core/backends/prompt-utils.d.ts

@@ -4,4 +4,3 @@ export declare function buildSummaryPrompt(conversationText: string): string;
 export declare function sanitizeUntrustedTemplateValue(value: string): string;
 export declare function resolveTemplate(template: string, context: string, eventData: Record<string, string>): string;
 export declare function extractEventData(event: Event): Record<string, string>;
-//# sourceMappingURL=prompt-utils.d.ts.map

package/dist/core/backends/prompt-utils.js

@@ -132,4 +132,3 @@ export function extractEventData(event) {
     }
     return data;
 }
-//# sourceMappingURL=prompt-utils.js.map

package/dist/core/backends/proxy-model-registry.d.ts

@@ -107,4 +107,3 @@ export interface ProxyModelOption {
     usdPer1kOut: number | null;
 }
 export declare function listProxyModelOptions(backendId: BackendId): ProxyModelOption[];
-//# sourceMappingURL=proxy-model-registry.d.ts.map

package/dist/core/backends/proxy-model-registry.js

@@ -192,4 +192,3 @@ export function listProxyModelOptions(backendId) {
         /* c8 ignore stop */
     }));
 }
-//# sourceMappingURL=proxy-model-registry.js.map

package/dist/core/backends/quota-reset-hints.d.ts

@@ -41,4 +41,3 @@ export declare function buildAgentDayBoundaryHint(dayBoundaryHour: number, timez
  * a reset time is detectable. Pure: callers may inject `now` for tests.
  */
 export declare function extractGenericQuotaResetHint(message: string, now?: () => Date): BackendQuotaResetHint | null;
-//# sourceMappingURL=quota-reset-hints.d.ts.map

package/dist/core/backends/quota-reset-hints.js

@@ -114,4 +114,3 @@ export function extractGenericQuotaResetHint(message, now = () => new Date()) {
     }
     return null;
 }
-//# sourceMappingURL=quota-reset-hints.js.map

package/dist/core/backends/silent-api-error-detector.d.ts

@@ -28,4 +28,3 @@ export declare function logSilentApiErrors(log: Logger, errors: SilentApiError[]
     sessionId?: string | null;
     eventType?: string;
 }): void;
-//# sourceMappingURL=silent-api-error-detector.d.ts.map

package/dist/core/backends/silent-api-error-detector.js

@@ -41,4 +41,3 @@ export function logSilentApiErrors(log, errors, context) {
         }, "Daemon API returned error to agent (silent API error)");
     }
 }
-//# sourceMappingURL=silent-api-error-detector.js.map

package/dist/core/bang-commands/commands-checks.d.ts

@@ -0,0 +1,16 @@
+import type { BangCommand } from "./registry.js";
+interface ChecksRow {
+    urlPattern: string;
+    reloadCount: number;
+}
+/**
+ * Pure formatter — same shape as `formatCostAll`, kept exported so the
+ * test suite can pin output shape without standing up a DB.
+ *
+ * The "neutral observation, never recommendation" rule lives in
+ * §5.F4 (Explicit non-action). This formatter renders the count and
+ * nothing else: no "you should…", no "consider…", no rate per hour.
+ */
+export declare function formatChecks(date: string, rows: ChecksRow[]): string;
+export declare const checksCommand: BangCommand;
+export {};

package/dist/core/bang-commands/commands-checks.js

@@ -0,0 +1,58 @@
+import { getAgentDayDateStr } from "@aitne/shared";
+import { listReloadsForDate } from "../../db/browser-history-store.js";
+const DEFAULT_LIMIT = 10;
+function resolveTodayKey(config, nowMs) {
+    return getAgentDayDateStr(config.timezone && config.timezone.length > 0 ? config.timezone : undefined, config.dayBoundaryHour ?? 4, new Date(nowMs));
+}
+/**
+ * Pure formatter — same shape as `formatCostAll`, kept exported so the
+ * test suite can pin output shape without standing up a DB.
+ *
+ * The "neutral observation, never recommendation" rule lives in
+ * §5.F4 (Explicit non-action). This formatter renders the count and
+ * nothing else: no "you should…", no "consider…", no rate per hour.
+ */
+export function formatChecks(date, rows) {
+    const header = `[SYSTEM · !checks · ${date}]`;
+    if (rows.length === 0) {
+        return [
+            header,
+            "No reload patterns recorded for today's agent-day yet.",
+        ].join("\n");
+    }
+    const lines = [
+        header,
+        `Top reload patterns (${rows.length}):`,
+    ];
+    for (const row of rows) {
+        lines.push(`- ${row.urlPattern}: ${row.reloadCount}`);
+    }
+    return lines.join("\n");
+}
+function queryChecks(db, date) {
+    return listReloadsForDate(db, date, DEFAULT_LIMIT);
+}
+export const checksCommand = {
+    name: "!checks",
+    title: "Reload tally",
+    // describe kept tight so the !help mobile-reply budget (1500 chars)
+    // still has headroom for user-defined bang commands when the default
+    // registry already runs ~20 entries deep. Full F4 context belongs in
+    // `details:` below, not in the one-line describe.
+    describe: "Today's browser reload tally.",
+    details: [
+        "Returns today's top reload patterns per URL (domain + first path segment).",
+        "Day boundary is the daemon's `dayBoundaryHour` (default 04:00 local), not UTC midnight.",
+        "Does not invoke an LLM. Safe to call while paused.",
+    ],
+    // Pure DB read with no agent dispatch — same posture as `!cost` /
+    // `!report`. Critically, the user can still ask "what was I refreshing
+    // today?" with the agent paused, which is when a quiet self-check is
+    // most useful.
+    runsWhilePaused: true,
+    handler: async (ctx) => {
+        const date = resolveTodayKey(ctx.config, Date.now());
+        const rows = queryChecks(ctx.db, date);
+        await ctx.notify(formatChecks(date, rows));
+    },
+};

package/dist/core/bang-commands/commands-close.d.ts

@@ -21,4 +21,3 @@
  */
 import type { BangCommand } from "./registry.js";
 export declare const closeCommand: BangCommand;
-//# sourceMappingURL=commands-close.d.ts.map

package/dist/core/bang-commands/commands-close.js

@@ -21,4 +21,3 @@ export const closeCommand = {
         await ctx.notify("Session closed.");
     },
 };
-//# sourceMappingURL=commands-close.js.map

package/dist/core/bang-commands/commands-cost.d.ts

@@ -10,4 +10,3 @@ export declare function formatCostFiltered(backend: BackendId, rows: CostRow[]):
 export declare const costAllCommand: BangCommand;
 export declare const costBackendCommands: BangCommand[];
 export {};
-//# sourceMappingURL=commands-cost.d.ts.map

package/dist/core/bang-commands/commands-cost.js

@@ -101,4 +101,3 @@ function makeCostBackendCommand(backend) {
     };
 }
 export const costBackendCommands = BACKEND_IDS.map(makeCostBackendCommand);
-//# sourceMappingURL=commands-cost.js.map

package/dist/core/bang-commands/commands-help.d.ts

@@ -2,4 +2,3 @@ import type { BangCommand, RegisteredBangCommand } from "./registry.js";
 import { type UserBangCommand } from "./user-commands.js";
 export declare function formatHelp(builtIns: RegisteredBangCommand[], userCommands: UserBangCommand[]): string;
 export declare const helpCommand: BangCommand;
-//# sourceMappingURL=commands-help.d.ts.map

package/dist/core/bang-commands/commands-help.js

@@ -35,11 +35,11 @@ export function formatHelp(builtIns, userCommands) {
         .sort((a, b) => a.command.localeCompare(b.command));
     const sortedBuiltIns = [...builtIns].sort((a, b) => getBangCommandName(a).localeCompare(getBangCommandName(b)));
     const totalCommands = sortedBuiltIns.length + enabledUserCommands.length;
-    // P2-22: lead with the total count so the operator can detect at a
-    // glance whether truncation hid entries. The full body still renders
-    // below — `truncateForMobile` (via `makeNotify`) only cuts when the
-    // assembled text exceeds MOBILE_REPLY_BUDGET, and the count line
-    // survives because it precedes any truncation point.
+    // Lead with the total count so the operator can detect at a glance
+    // whether truncation hid entries. The full body still renders below —
+    // `truncateForMobile` (via `makeNotify`) only cuts when the assembled
+    // text exceeds MOBILE_REPLY_BUDGET, and the count line survives
+    // because it precedes any truncation point.
     const lines = [
         "[SYSTEM · !help]",
         `${totalCommands} command${totalCommands === 1 ? "" : "s"} total`,
@@ -59,8 +59,8 @@ export function formatHelp(builtIns, userCommands) {
             lines.push("", ...renderEntry(cmd.command, desc));
         }
     }
-    // P2-22: when we know the body will overflow the mobile budget, append
-    // a dashboard-pointer footer BEFORE `truncateForMobile` snips the tail.
+    // When the body will overflow the mobile budget, append a
+    // dashboard-pointer footer BEFORE `truncateForMobile` snips the tail.
     // The generic `… (truncated)` marker doesn't tell the operator that the
     // dashboard has the rest; this footer does. `ensureSystemMarker` is a
     // no-op here because the body already starts with `[SYSTEM · !help]`,
@@ -79,7 +79,7 @@ export function formatHelp(builtIns, userCommands) {
             return body;
         }
         // Avoid splitting a surrogate pair at the boundary, mirroring
-        // truncateForMobile (P2-03).
+        // truncateForMobile.
         if (room > 0
             && body.charCodeAt(room - 1) >= 0xd800
             && body.charCodeAt(room - 1) <= 0xdbff) {
@@ -105,4 +105,3 @@ export const helpCommand = {
         await ctx.notify(formatHelp(builtIns, userCommands));
     },
 };
-//# sourceMappingURL=commands-help.js.map

package/dist/core/bang-commands/commands-report.d.ts

@@ -15,4 +15,3 @@ export declare function formatReport(data: {
 }, config: AgentConfig): string;
 export declare const reportCommand: BangCommand;
 export {};
-//# sourceMappingURL=commands-report.d.ts.map

package/dist/core/bang-commands/commands-report.js

@@ -103,4 +103,3 @@ export const reportCommand = {
         await ctx.notify(formatReport(data, ctx.config));
     },
 };
-//# sourceMappingURL=commands-report.js.map

package/dist/core/bang-commands/commands-research.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `!research` family — owner-facing bang commands for the browser
+ * history research cluster surface (BROWSER_HISTORY_INTEGRATION_PLAN
+ * §5.F1, P3 phasing).
+ *
+ * Subcommand grammar:
+ *   !research                            list active + dormant clusters
+ *   !research <slug>                     show cluster detail
+ *   !research accept <slug>              dispatch routine.research_dispatch
+ *   !research wiki <slug>                dispatch routine.research_wiki_summary
+ *   !research decline <slug>             silence offers for 14 days
+ *   !research mute <slug>                mark status=muted (offers off)
+ *   !research unmute <slug>              restore status=active
+ *   !research rename <slug> <new name>   rename display_name
+ *   !research conclude <slug>            mark status=concluded
+ *
+ * All dispatch paths route through the EventBus via
+ * `enqueueBrowserResearchEvent` on `BangCommandContext` so the bang
+ * handler stays narrow (parse → DB stamp → enqueue). The handler does
+ * NOT compose DM prose; the agent or the templated offer DM owns
+ * messaging.
+ */
+import type { BangPrefixCommand } from "./registry.js";
+type Subcommand = "list" | "show" | "accept" | "wiki" | "decline" | "mute" | "unmute" | "rename" | "conclude";
+type ResearchArgs = {
+    subcommand: "list";
+    slug: null;
+    payload: "";
+} | {
+    subcommand: Exclude<Subcommand, "list">;
+    slug: string;
+    payload: string;
+};
+export declare function parseResearchArgs(rest: string): ResearchArgs;
+export declare const researchCommand: BangPrefixCommand;
+export {};