@aitne/daemon 0.1.3 → 0.1.6

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

@@ -3,16 +3,20 @@
  *
  * Spec: docs/design/backlog/messaging-bang-commands.md
  */
-export { BangCommandRegistry, buildPausedNotice, buildUnknownCommandReply, makeNotify, tryHandle, } from "./registry.js";
+export { BangCommandRegistry, BangArgError, buildPausedNotice, buildUnknownCommandReply, getBangCommandName, makeNotify, normalizeBangCommandText, tryHandle, } from "./registry.js";
 export { stopCommand, startCommand } from "./commands-stop-start.js";
 export { costAllCommand, costBackendCommands, formatCostAll, formatCostFiltered, } from "./commands-cost.js";
 export { reportCommand, formatReport } from "./commands-report.js";
+export { helpCommand, formatHelp } from "./commands-help.js";
+export { askCommand, connectCommand, compileCommand, lintCommand, parseConnectArgs, traceCommand, ingestCommand, wikiHelpCommand, wikiStatusCommand, } from "./commands-wiki.js";
 export { buildSystemMarker, ensureSystemMarker, formatLocalLong, formatLocalShort, formatMoney, MOBILE_REPLY_BUDGET, truncateForMobile, } from "./format-utils.js";
 export { CUSTOM_BANG_COMMAND_SOURCE, DEFAULT_USER_BANG_COMMAND_SKILLS, USER_BANG_COMMAND_NAME_PATTERN, buildUserBangCommandPrompt, createUserBangCommand, createUserBangCommandEvent, deleteUserBangCommand, getEnabledUserBangCommandByCommand, getUserBangCommandByCommand, getUserBangCommandById, listUserBangCommands, normalizeBangCommandName, parseEnabledSkills, resolveCommandSkillSlugs, serializeEnabledSkills, updateUserBangCommand, } from "./user-commands.js";
 import { BangCommandRegistry } from "./registry.js";
 import { startCommand, stopCommand } from "./commands-stop-start.js";
 import { costAllCommand, costBackendCommands, } from "./commands-cost.js";
 import { reportCommand } from "./commands-report.js";
+import { helpCommand } from "./commands-help.js";
+import { askCommand, connectCommand, compileCommand, lintCommand, traceCommand, ingestCommand, wikiHelpCommand, wikiStatusCommand, } from "./commands-wiki.js";
 /**
  * Build a registry preloaded with the v1 built-in commands. The registry
  * is mutable — callers can `.register(...)` more commands afterwards.
@@ -26,6 +30,16 @@ export function createDefaultBangCommandRegistry() {
         registry.register(cmd);
     }
     registry.register(reportCommand);
+    registry.register(helpCommand);
+    registry.register(wikiStatusCommand);
+    registry.register(wikiHelpCommand);
+    registry.register(ingestCommand);
+    registry.register(compileCommand);
+    registry.register(askCommand);
+    // WIKI_BUILDER_DESIGN.md Phase 3 — operational triad.
+    registry.register(lintCommand);
+    registry.register(traceCommand);
+    registry.register(connectCommand);
     return registry;
 }
 //# sourceMappingURL=index.js.map

package/dist/core/bang-commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/bang-commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,UAAU,EACV,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/bang-commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,SAAS,GACV,MAAM,eAAe,CAAC;AAQvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -6,7 +6,7 @@
  * Spec: docs/design/backlog/messaging-bang-commands.md
  */
 import type Database from "better-sqlite3";
-import type { MessageEvent } from "@aitne/shared";
+import type { Event, MessageEvent } from "@aitne/shared";
 import type { AgentConfig } from "../../config.js";
 import type { IAuditLogger } from "../dispatcher.js";
 import { type UserBangCommand } from "./user-commands.js";
@@ -24,6 +24,22 @@ export interface BangCommandContext {
     audit: IAuditLogger;
     registry: BangCommandRegistry;
     enqueueUserBangCommand?: (command: UserBangCommand, event: MessageEvent) => Promise<void>;
+    enqueueWikiEvent?: (event: Event) => Promise<void>;
+    /**
+     * Approval handoff for `!compile full` when the cost estimate exceeds
+     * the per-workspace threshold (WIKI_BUILDER_DESIGN.md §5.5). Inserts
+     * an `agent_schedule` row with `task_type='approval'`; the dashboard
+     * `/approvals` queue and DM approval bot consume from there. The
+     * registry passes the cost estimate + git pre-compile outcome through
+     * so the approval card can show the same numbers the bang DM did.
+     */
+    enqueueWikiApproval?: (input: {
+        workspace: string;
+        processKey: "wiki.compile";
+        sourceEvent: MessageEvent;
+        estimate: import("@aitne/shared").WikiCostEstimate;
+        gitOutcome: import("../wiki/git-precompile.js").GitPreCompilePreview | import("../wiki/git-precompile.js").GitPreCompileOutcome;
+    }) => Promise<void>;
 }
 export interface BangCommand {
     /** Exact-match key, including any positional argument variant. */
@@ -36,13 +52,40 @@ export interface BangCommand {
     details?: readonly string[];
     handler: (ctx: BangCommandContext) => Promise<void>;
 }
+export declare class BangArgError extends Error {
+    constructor(message: string);
+}
+export interface BangPrefixCommand {
+    /** Prefix key. Matches exact prefix or prefix followed by ASCII space. */
+    prefix: string;
+    /** Human-facing title for dashboard/settings surfaces. */
+    title?: string;
+    /** Short description for the unknown-command help list. */
+    describe: string;
+    /** Longer dashboard-facing details. */
+    details?: readonly string[];
+    parseArgs?: (rest: string, ctx: BangCommandContext) => unknown | Promise<unknown>;
+    handler: (ctx: BangCommandContext, args: unknown) => Promise<void>;
+}
+export type RegisteredBangCommand = BangCommand | BangPrefixCommand;
+export interface BangCommandMatch {
+    command: RegisteredBangCommand;
+    commandName: string;
+    rest: string;
+    kind: "exact" | "prefix";
+}
 export declare class BangCommandRegistry {
     private readonly byName;
-    register(cmd: BangCommand): void;
+    private readonly prefixes;
+    register(cmd: RegisteredBangCommand): void;
     /** Stable, registration-ordered list of registered commands. */
-    list(): BangCommand[];
+    list(): RegisteredBangCommand[];
     match(text: string): BangCommand | undefined;
+    resolve(text: string): BangCommandMatch | undefined;
 }
+export declare function normalizeBangCommandText(text: string): string;
+export declare function normalizeBangCommandRestText(text: string): string;
+export declare function getBangCommandName(cmd: RegisteredBangCommand): string;
 /**
  * Reply text for the §5.1 paused-decline path. Used when the user types any
  * DM (bang or non-bang) while the agent is paused.
@@ -52,7 +95,7 @@ export declare function buildPausedNotice(): string;
  * Reply for an unrecognised bang while NOT paused. Lists up to 6 known
  * commands so the user can recover without checking the docs.
  */
-export declare function buildUnknownCommandReply(commands: BangCommand[]): string;
+export declare function buildUnknownCommandReply(commands: RegisteredBangCommand[]): string;
 /**
  * Build a `notify` wrapper that owns marker injection + mobile truncation.
  * Pure factory so the dispatcher can construct contexts without creating a

package/dist/core/bang-commands/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/bang-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,CACvB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,YAAY,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAchC,gEAAgE;IAChE,IAAI,IAAI,WAAW,EAAE;IAIrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EAAE,GACtB,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACxC,cAAc,EAAE,MAAM,GACrB,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAKjC;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;IACrD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,GACA,OAAO,CAAC,OAAO,CAAC,CA0GlB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/bang-commands/registry.ts"],"names":[],"mappings":"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"}

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

@@ -2,25 +2,70 @@ import { isDocsQAMessage } from "@aitne/shared";
 import { isUserPaused } from "../../db/runtime-state.js";
 import { CUSTOM_BANG_COMMAND_SOURCE, getEnabledUserBangCommandByCommand, listUserBangCommands, } from "./user-commands.js";
 import { ensureSystemMarker, buildSystemMarker, truncateForMobile, } from "./format-utils.js";
+export class BangArgError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BangArgError";
+    }
+}
 export class BangCommandRegistry {
     byName = new Map();
+    prefixes = [];
     register(cmd) {
-        if (cmd.name !== cmd.name.toLowerCase()) {
-            throw new Error(`BangCommand.name must be lowercase: ${cmd.name}`);
+        const key = getBangCommandName(cmd);
+        if (key !== key.toLowerCase()) {
+            throw new Error(`BangCommand key must be lowercase: ${key}`);
+        }
+        if (!key.startsWith("!")) {
+            throw new Error(`BangCommand key must start with "!": ${key}`);
         }
-        if (!cmd.name.startsWith("!")) {
-            throw new Error(`BangCommand.name must start with "!": ${cmd.name}`);
+        if ("name" in cmd) {
+            this.byName.set(cmd.name, cmd);
+        }
+        else {
+            this.prefixes.push(cmd);
+            this.prefixes.sort((a, b) => b.prefix.length - a.prefix.length);
         }
-        this.byName.set(cmd.name, cmd);
     }
     /** Stable, registration-ordered list of registered commands. */
     list() {
-        return [...this.byName.values()];
+        return [...this.byName.values(), ...this.prefixes];
     }
     match(text) {
-        return this.byName.get(text.trim().toLowerCase());
+        return this.byName.get(normalizeBangCommandText(text));
+    }
+    resolve(text) {
+        const compact = normalizeBangCommandRestText(text);
+        const normalized = compact.toLowerCase();
+        const exact = this.byName.get(normalized);
+        if (exact) {
+            return { command: exact, commandName: exact.name, rest: "", kind: "exact" };
+        }
+        for (const cmd of this.prefixes) {
+            if (normalized === cmd.prefix) {
+                return { command: cmd, commandName: cmd.prefix, rest: "", kind: "prefix" };
+            }
+            if (normalized.startsWith(`${cmd.prefix} `)) {
+                return {
+                    command: cmd,
+                    commandName: cmd.prefix,
+                    rest: compact.slice(cmd.prefix.length + 1).trim(),
+                    kind: "prefix",
+                };
+            }
+        }
+        return undefined;
     }
 }
+export function normalizeBangCommandText(text) {
+    return normalizeBangCommandRestText(text).toLowerCase();
+}
+export function normalizeBangCommandRestText(text) {
+    return text.trim().replace(/[ \t\f\v]+/g, " ");
+}
+export function getBangCommandName(cmd) {
+    return "name" in cmd ? cmd.name : cmd.prefix;
+}
 /**
  * Reply text for the §5.1 paused-decline path. Used when the user types any
  * DM (bang or non-bang) while the agent is paused.
@@ -46,7 +91,7 @@ export function buildUnknownCommandReply(commands) {
         "Unknown command. Try one of:",
     ];
     for (const cmd of commands.slice(0, 6)) {
-        lines.push(`- ${cmd.name} — ${cmd.describe}`);
+        lines.push(`- ${getBangCommandName(cmd)} — ${cmd.describe}`);
     }
     return lines.join("\n");
 }
@@ -81,7 +126,7 @@ export async function tryHandle(registry, ctx) {
     if (isDocsQAMessage(event))
         return false;
     const text = event.content.trim();
-    const lowered = text.toLowerCase();
+    const lowered = normalizeBangCommandText(text);
     const isBang = lowered.startsWith("!");
     const paused = isUserPaused(db);
     // §6.3 pause branch — runs BEFORE the bang-prefix check so ANY DM while
@@ -100,6 +145,8 @@ export async function tryHandle(registry, ctx) {
                     audit,
                     registry,
                     enqueueUserBangCommand: ctx.enqueueUserBangCommand,
+                    enqueueWikiEvent: ctx.enqueueWikiEvent,
+                    enqueueWikiApproval: ctx.enqueueWikiApproval,
                 });
                 return true;
             }
@@ -127,11 +174,10 @@ export async function tryHandle(registry, ctx) {
     // `!stop ...` inside larger prose".
     if (text.includes("\n"))
         return false;
-    const cmd = registry.match(lowered);
-    if (cmd) {
-        const notify = makeNotify(rawSend, buildSystemMarker(cmd.name));
-        audit.logBangCommand(event, { command: cmd.name, status: "ok" });
-        await cmd.handler({
+    const match = registry.resolve(text);
+    if (match) {
+        const notify = makeNotify(rawSend, buildSystemMarker(match.commandName));
+        const commandCtx = {
             event,
             db,
             config: ctx.config,
@@ -139,7 +185,31 @@ export async function tryHandle(registry, ctx) {
             audit,
             registry,
             enqueueUserBangCommand: ctx.enqueueUserBangCommand,
-        });
+            enqueueWikiEvent: ctx.enqueueWikiEvent,
+            enqueueWikiApproval: ctx.enqueueWikiApproval,
+        };
+        try {
+            const args = match.kind === "prefix" && "prefix" in match.command
+                ? await match.command.parseArgs?.(match.rest, commandCtx)
+                : undefined;
+            audit.logBangCommand(event, { command: match.commandName, status: "ok" });
+            if ("name" in match.command) {
+                await match.command.handler(commandCtx);
+            }
+            else {
+                await match.command.handler(commandCtx, args);
+            }
+        }
+        catch (err) {
+            if (!(err instanceof BangArgError))
+                throw err;
+            audit.logBangCommand(event, {
+                command: match.commandName,
+                status: "invalid_args",
+                message: err.message,
+            });
+            await notify(err.message);
+        }
         return true;
     }
     const userCommand = getEnabledUserBangCommandByCommand(db, lowered);

package/dist/core/bang-commands/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/bang-commands/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/bang-commands/registry.ts"],"names":[],"mappings":"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"}

package/dist/core/context-builder.d.ts

@@ -25,23 +25,64 @@ export declare class ContextBuilder implements IContextBuilder {
      */
     private computeCalendarWindow;
     /**
-     * Build a `<calendar_events_…>` context block, honouring Google Calendar
-     * integration mode:
+     * Build a `<calendar_events_…>` context block honouring every active
+     * calendar provider × mode cell.
      *
-     * - **direct + service available** → embed the formatted event list (prior
-     *   behaviour).
-     * - **delegated** → the daemon has no local CalendarService to call. Emit
-     *   a structured directive telling the task-flow agent to fetch the same
-     *   window itself via its backend's Google Calendar MCP tool and treat the
-     *   response as the contents of this block.
-     * - **direct but service broken / disabled** → emit the legacy
-     *   `<calendar_status>` unavailable line so the flow degrades gracefully.
+     * ROUTINE_DATA_ACQUISITION_DESIGN.md §6.6 — the block wraps one
+     * `<provider key="…" mode="…">…</provider>` sub-block per active
+     * provider so the parent routine sees a uniform shape regardless of
+     * which provider(s) the operator has configured. Per-provider body:
+     *
+     *  - **direct + matching service available** → inline formatted event
+     *    list fetched by the daemon's `services.calendar` (Google today;
+     *    Outlook gets the same path once a dedicated `services.outlookCalendar`
+     *    lands — for now Outlook direct mode emits a service-unavailable
+     *    note so the flow degrades gracefully).
+     *  - **delegated** → a structured directive instructing the agent to
+     *    call the relevant MCP tool (same-backend) or the daemon's
+     *    `/api/integrations/<key>/exec` proxy (cross-backend). For
+     *    `userManagedConnector` providers (Outlook today) the proxy
+     *    branch is suppressed — same-backend and cross-backend collapse
+     *    onto the session's MCP.
+     *  - **native** → directive that points at the session backend's MCP
+     *    only. No daemon proxy: native bindings never fall back to the
+     *    daemon (R7 from the design doc).
+     *  - **disabled** → provider sub-block omitted entirely.
+     *
+     * When no provider is active, emit the legacy
+     * `<calendar_status>not available</calendar_status>` so routine flows
+     * that branch on the unavailable marker keep working.
      *
      * All callers funnel through this method so the three surfaces
-     * (morning / evening / weekly+monthly and the agent-task path) stay in
-     * lock-step when delegated-mode handling changes.
+     * (morning / evening / weekly+monthly and the agent-task path) stay
+     * in lock-step when integration handling changes.
+     */
+    /**
+     * Build a `<calendar_events_*>` context block honouring every active
+     * provider's mode.
+     *
+     * `prepassCovers` — A8 / Finding 5. When `true`, the caller's
+     * `ROUTINE_WINDOWS` entry includes a calendar row, so the
+     * `routine.fetch_window` pre-pass has already POSTed events to
+     * `/api/observations` for every non-direct provider. Non-direct
+     * provider sub-blocks then emit a "read observations" hint instead
+     * of the legacy "fetch yourself" directive. Direct providers are
+     * unchanged — ContextBuilder still pre-fetches inline events via
+     * `services.calendar` (Google) and emits the fallback hint for
+     * Outlook (no daemon-side service yet). The flag has no effect on
+     * direct-mode sub-blocks. Default `false` for callers that don't
+     * have pre-pass coverage (today_refresh, weekly/monthly_review,
+     * roadmap_refresh).
      */
     private buildCalendarBlock;
+    /**
+     * Emit one provider sub-block for `buildCalendarBlock`. Returns null
+     * when the provider is disabled (or, for native mode, the binding
+     * does not apply to a meaningful path — the agent reads
+     * `<integration_modes>` to decide whether its session backend is the
+     * native one).
+     */
+    private buildCalendarProviderBlock;
     /**
      * Fetch calendar events for the next N days and format as markdown.
      * Groups events by date with day-of-week and Today/Tomorrow labels.

package/dist/core/context-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,KAAK,EAEN,MAAM,eAAe,CAAC;AAiBvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAYhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAiBvE,qBAAa,cAAe,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,eAAe;IAG5C;;;;;;;OAOG;IACH,OAAO,KAAK,kBAAkB,GAK7B;IAEK,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAsa1C;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;;;;;;;;;;;;;OAgBG;YACW,kBAAkB;IAkDhC;;;;OAIG;YACW,mBAAmB;IAsBjC,6CAA6C;IAC7C,OAAO,CAAC,oBAAoB;IAwD5B,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;IAKvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,+BAA+B;IAsCvC,OAAO,CAAC,sBAAsB;IAkH9B,OAAO,CAAC,4BAA4B;IAmGpC,OAAO,CAAC,2BAA2B;YAuCrB,QAAQ;YAYR,0BAA0B;IAmDxC;;;;;;;;;OASG;IACH,OAAO,CAAC,4BAA4B;YAsDtB,2BAA2B;IA+GzC;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;CA8E/B"}
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,KAAK,EAEN,MAAM,eAAe,CAAC;AAkBvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAahD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAoBvE,qBAAa,cAAe,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,eAAe;IAG5C;;;;;;;OAOG;IACH,OAAO,KAAK,kBAAkB,GAK7B;IAEK,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAud1C;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH;;;;;;;;;;;;;;;;OAgBG;YACW,kBAAkB;IA0ChC;;;;;;OAMG;YACW,0BAA0B;IAmHxC;;;;OAIG;YACW,mBAAmB;IAsBjC,6CAA6C;IAC7C,OAAO,CAAC,oBAAoB;IAwD5B,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;IAKvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,+BAA+B;IAsCvC,OAAO,CAAC,sBAAsB;IAkH9B,OAAO,CAAC,4BAA4B;IAmGpC,OAAO,CAAC,2BAA2B;YAuCrB,QAAQ;YAYR,0BAA0B;IAmDxC;;;;;;;;;OASG;IACH,OAAO,CAAC,4BAA4B;YAsDtB,2BAA2B;IA+GzC;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;CA8E/B"}