@aitne/daemon 0.1.0

package/dist/core/bang-commands/format-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Reply-formatting helpers for messaging bang-commands. Mobile-first: short
+ * lines, vertical bullets, no fixed-width tables, no markdown code blocks.
+ * See docs/design/backlog/messaging-bang-commands.md §6.5.
+ */
+import type { AgentConfig } from "../../config.js";
+/**
+ * Hard reply length budget — sized to fit on a phone screen and well below
+ * WhatsApp/Telegram/Discord/Slack message caps. See §6.5 rule 8.
+ */
+export declare const MOBILE_REPLY_BUDGET = 1500;
+/** First-line marker (I-10). */
+export declare function buildSystemMarker(command: string, window?: string): string;
+/**
+ * Inject the `[SYSTEM · …]` marker as the first line if the supplied text
+ * does not already lead with `[SYSTEM`. Defensive backup so handlers that
+ * forget to prepend the marker still produce well-formed output.
+ */
+export declare function ensureSystemMarker(text: string, marker: string): string;
+/** Truncate a reply that exceeds the mobile budget, appending a footer. */
+export declare function truncateForMobile(text: string): string;
+/** Compact USD formatter — `$1.42`, `$0.08`, `<$0.01`. */
+export declare function formatMoney(usd: number): string;
+/**
+ * Render a `started_at` UTC string (SQLite `datetime('now')` format or ISO)
+ * as `MM-DD HH:MM` in the user's configured timezone.
+ */
+export declare function formatLocalShort(isoOrSqlite: string, config: AgentConfig): string;
+/**
+ * Render a `since` ISO timestamp as `YYYY-MM-DD HH:MM` in the user's
+ * timezone — used by `!stop`/`!start` where the calendar year matters.
+ */
+export declare function formatLocalLong(iso: string, config: AgentConfig): string;
+//# sourceMappingURL=format-utils.d.ts.map

package/dist/core/bang-commands/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../../src/core/bang-commands/format-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,gCAAgC;AAChC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,GAClB,MAAM,CA4BR"}

package/dist/core/bang-commands/format-utils.js

@@ -0,0 +1,118 @@
+/**
+ * Hard reply length budget — sized to fit on a phone screen and well below
+ * WhatsApp/Telegram/Discord/Slack message caps. See §6.5 rule 8.
+ */
+export const MOBILE_REPLY_BUDGET = 1500;
+/** First-line marker (I-10). */
+export function buildSystemMarker(command, window) {
+    return window
+        ? `[SYSTEM · ${command} · ${window}]`
+        : `[SYSTEM · ${command}]`;
+}
+/**
+ * Inject the `[SYSTEM · …]` marker as the first line if the supplied text
+ * does not already lead with `[SYSTEM`. Defensive backup so handlers that
+ * forget to prepend the marker still produce well-formed output.
+ */
+export function ensureSystemMarker(text, marker) {
+    if (text.startsWith("[SYSTEM"))
+        return text;
+    return `${marker}\n${text}`;
+}
+/** Truncate a reply that exceeds the mobile budget, appending a footer. */
+export function truncateForMobile(text) {
+    if (text.length <= MOBILE_REPLY_BUDGET)
+        return text;
+    const footer = "\n… (truncated)";
+    return text.slice(0, MOBILE_REPLY_BUDGET - footer.length) + footer;
+}
+/** Compact USD formatter — `$1.42`, `$0.08`, `<$0.01`. */
+export function formatMoney(usd) {
+    if (!Number.isFinite(usd) || usd <= 0)
+        return "$0.00";
+    if (usd < 0.01)
+        return "<$0.01";
+    return `$${usd.toFixed(2)}`;
+}
+/**
+ * Render a `started_at` UTC string (SQLite `datetime('now')` format or ISO)
+ * as `MM-DD HH:MM` in the user's configured timezone.
+ */
+export function formatLocalShort(isoOrSqlite, config) {
+    const ms = parseTimestampMs(isoOrSqlite);
+    if (ms === null)
+        return isoOrSqlite;
+    // Empty `config.timezone` is the "no timezone configured" sentinel — fall
+    // back to UTC so reply text is reproducible across environments instead of
+    // tracking the host timezone.
+    const tz = config.timezone && config.timezone.length > 0
+        ? config.timezone
+        : "UTC";
+    const fmt = new Intl.DateTimeFormat("en-CA", {
+        timeZone: tz,
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+    const parts = fmt.formatToParts(new Date(ms));
+    // Intl.DateTimeFormat is guaranteed to emit each requested field — the
+    // `?? ""` is a defensive fallback for unreachable null cases that never
+    // fire in practice across supported Node runtimes.
+    /* c8 ignore next 2 */
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    // Some Node builds render UTC midnight as "24:00"; coerce to "00:00" so
+    // the display is stable. The "24" branch is host-platform-dependent and
+    // not consistently reproducible in tests.
+    /* c8 ignore next */
+    const hour = get("hour") === "24" ? "00" : get("hour");
+    return `${get("month")}-${get("day")} ${hour}:${get("minute")}`;
+}
+/**
+ * Render a `since` ISO timestamp as `YYYY-MM-DD HH:MM` in the user's
+ * timezone — used by `!stop`/`!start` where the calendar year matters.
+ */
+export function formatLocalLong(iso, config) {
+    const ms = parseTimestampMs(iso);
+    if (ms === null)
+        return iso;
+    const tz = config.timezone && config.timezone.length > 0
+        ? config.timezone
+        : "UTC";
+    const fmt = new Intl.DateTimeFormat("en-CA", {
+        timeZone: tz,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+    const parts = fmt.formatToParts(new Date(ms));
+    // Intl.DateTimeFormat is guaranteed to emit each requested field — the
+    // `?? ""` is a defensive fallback for unreachable null cases that never
+    // fire in practice across supported Node runtimes.
+    /* c8 ignore next 2 */
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    // Some Node builds render UTC midnight as "24:00"; coerce to "00:00" so
+    // the display is stable. The "24" branch is host-platform-dependent and
+    // not consistently reproducible in tests.
+    /* c8 ignore next */
+    const hour = get("hour") === "24" ? "00" : get("hour");
+    return `${get("year")}-${get("month")}-${get("day")} ${hour}:${get("minute")}`;
+}
+function parseTimestampMs(value) {
+    // SQLite `datetime('now')` produces `YYYY-MM-DD HH:MM:SS` (UTC, no `T`,
+    // no zone). Normalize to ISO so `Date.parse` reads it as UTC instead of
+    // local time, which would shift `formatLocalShort` by the local offset
+    // when the column is consumed verbatim.
+    const trimmed = value.trim();
+    const sqliteMatch = /^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})$/.exec(trimmed);
+    const candidate = sqliteMatch
+        ? `${sqliteMatch[1]}-${sqliteMatch[2]}-${sqliteMatch[3]}T${sqliteMatch[4]}:${sqliteMatch[5]}:${sqliteMatch[6]}Z`
+        : trimmed;
+    const ms = Date.parse(candidate);
+    return Number.isFinite(ms) ? ms : null;
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/core/bang-commands/format-utils.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * Public surface for the messaging bang-commands module.
+ *
+ * Spec: docs/design/backlog/messaging-bang-commands.md
+ */
+export { BangCommandRegistry, buildPausedNotice, buildUnknownCommandReply, makeNotify, tryHandle, } from "./registry.js";
+export type { BangCommand, BangCommandContext } 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 { 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";
+export type { NormalizeBangCommandNameResult, UserBangCommand, UserBangCommandInput, } from "./user-commands.js";
+import { BangCommandRegistry } from "./registry.js";
+/**
+ * Build a registry preloaded with the v1 built-in commands. The registry
+ * is mutable — callers can `.register(...)` more commands afterwards.
+ */
+export declare function createDefaultBangCommandRegistry(): BangCommandRegistry;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AACvB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,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;AAC5B,YAAY,EACV,8BAA8B,EAC9B,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQpD;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,mBAAmB,CAUtE"}

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

@@ -0,0 +1,31 @@
+/**
+ * Public surface for the messaging bang-commands module.
+ *
+ * Spec: docs/design/backlog/messaging-bang-commands.md
+ */
+export { BangCommandRegistry, buildPausedNotice, buildUnknownCommandReply, makeNotify, 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 { 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";
+/**
+ * Build a registry preloaded with the v1 built-in commands. The registry
+ * is mutable — callers can `.register(...)` more commands afterwards.
+ */
+export function createDefaultBangCommandRegistry() {
+    const registry = new BangCommandRegistry();
+    registry.register(stopCommand);
+    registry.register(startCommand);
+    registry.register(costAllCommand);
+    for (const cmd of costBackendCommands) {
+        registry.register(cmd);
+    }
+    registry.register(reportCommand);
+    return registry;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,72 @@
+/**
+ * Messaging bang-commands registry — short, exact-match owner controls
+ * (`!stop`, `!start`, `!cost`, `!report`) intercepted in the dispatcher
+ * before any agent backend is invoked.
+ *
+ * Spec: docs/design/backlog/messaging-bang-commands.md
+ */
+import type Database from "better-sqlite3";
+import type { MessageEvent } from "@aitne/shared";
+import type { AgentConfig } from "../../config.js";
+import type { IAuditLogger } from "../dispatcher.js";
+import { type UserBangCommand } from "./user-commands.js";
+export interface BangCommandContext {
+    event: MessageEvent;
+    db: Database.Database;
+    config: AgentConfig;
+    /**
+     * Reply path for the command. Wraps `notificationMgr.send(text, event)` so
+     * the reply lands back on the same platform/channel/thread (I-9). Injects
+     * the `[SYSTEM · …]` marker if the handler-supplied text does not already
+     * lead with one (I-10), and truncates to the mobile budget (I-11).
+     */
+    notify(text: string): Promise<void>;
+    audit: IAuditLogger;
+    registry: BangCommandRegistry;
+    enqueueUserBangCommand?: (command: UserBangCommand, event: MessageEvent) => Promise<void>;
+}
+export interface BangCommand {
+    /** Exact-match key, including any positional argument variant. */
+    name: 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[];
+    handler: (ctx: BangCommandContext) => Promise<void>;
+}
+export declare class BangCommandRegistry {
+    private readonly byName;
+    register(cmd: BangCommand): void;
+    /** Stable, registration-ordered list of registered commands. */
+    list(): BangCommand[];
+    match(text: string): BangCommand | undefined;
+}
+/**
+ * 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.
+ */
+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;
+/**
+ * Build a `notify` wrapper that owns marker injection + mobile truncation.
+ * Pure factory so the dispatcher can construct contexts without creating a
+ * fresh closure per registry method.
+ */
+export declare function makeNotify(rawSend: (text: string) => Promise<void>, fallbackMarker: string): (text: string) => Promise<void>;
+/**
+ * Decision tree for incoming owner DMs. Runs at the very top of
+ * `EventDispatcher.handleMessage` (§6.2). Returns `true` when the message
+ * was handled — recognised, paused-decline, or unknown bang — so the caller
+ * short-circuits the rest of dispatch. Returns `false` when the message
+ * should fall through to the agent path.
+ */
+export declare function tryHandle(registry: BangCommandRegistry, ctx: Omit<BangCommandContext, "notify" | "registry"> & {
+    rawSend: (text: string) => Promise<void>;
+}): Promise<boolean>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,174 @@
+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 BangCommandRegistry {
+    byName = new Map();
+    register(cmd) {
+        if (cmd.name !== cmd.name.toLowerCase()) {
+            throw new Error(`BangCommand.name must be lowercase: ${cmd.name}`);
+        }
+        if (!cmd.name.startsWith("!")) {
+            throw new Error(`BangCommand.name must start with "!": ${cmd.name}`);
+        }
+        this.byName.set(cmd.name, cmd);
+    }
+    /** Stable, registration-ordered list of registered commands. */
+    list() {
+        return [...this.byName.values()];
+    }
+    match(text) {
+        return this.byName.get(text.trim().toLowerCase());
+    }
+}
+/**
+ * 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.
+ */
+export function buildPausedNotice() {
+    return [
+        buildSystemMarker("paused"),
+        "Agent is paused — message not processed.",
+        "",
+        "Available commands:",
+        "- !start to resume",
+        "- !cost (or !cost claude / codex / gemini)",
+        "- !report",
+    ].join("\n");
+}
+/**
+ * Reply for an unrecognised bang while NOT paused. Lists up to 6 known
+ * commands so the user can recover without checking the docs.
+ */
+export function buildUnknownCommandReply(commands) {
+    const lines = [
+        buildSystemMarker("unknown"),
+        "Unknown command. Try one of:",
+    ];
+    for (const cmd of commands.slice(0, 6)) {
+        lines.push(`- ${cmd.name} — ${cmd.describe}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Build a `notify` wrapper that owns marker injection + mobile truncation.
+ * Pure factory so the dispatcher can construct contexts without creating a
+ * fresh closure per registry method.
+ */
+export function makeNotify(rawSend, fallbackMarker) {
+    return async (text) => {
+        const withMarker = ensureSystemMarker(text, fallbackMarker);
+        await rawSend(truncateForMobile(withMarker));
+    };
+}
+/**
+ * Decision tree for incoming owner DMs. Runs at the very top of
+ * `EventDispatcher.handleMessage` (§6.2). Returns `true` when the message
+ * was handled — recognised, paused-decline, or unknown bang — so the caller
+ * short-circuits the rest of dispatch. Returns `false` when the message
+ * should fall through to the agent path.
+ */
+export async function tryHandle(registry, ctx) {
+    const { event, db, audit, rawSend } = ctx;
+    if (event.source === CUSTOM_BANG_COMMAND_SOURCE)
+        return false;
+    // I-1: only DMs participate. Adapter-side owner gating is the single
+    // source of truth (matches the `/auth` precedent — see design §6.3).
+    if (!event.isDm)
+        return false;
+    // §5.1 docs-QA exemption: docs-QA traffic is a side-channel and bypasses
+    // pause entirely.
+    if (isDocsQAMessage(event))
+        return false;
+    const text = event.content.trim();
+    const lowered = text.toLowerCase();
+    const isBang = lowered.startsWith("!");
+    const paused = isUserPaused(db);
+    // §6.3 pause branch — runs BEFORE the bang-prefix check so ANY DM while
+    // paused short-circuits without reaching the agent backend (I-3).
+    if (paused) {
+        if (isBang) {
+            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({
+                    event,
+                    db,
+                    config: ctx.config,
+                    notify,
+                    audit,
+                    registry,
+                    enqueueUserBangCommand: ctx.enqueueUserBangCommand,
+                });
+                return true;
+            }
+            // Unknown bang while paused — falls through to the pause notice
+            // (NOT the unknown-bang help). Rationale: §7 — the paused user's
+            // mental model is "the system is quiet"; surfacing help would
+            // surprise.
+        }
+        audit.logBangCommand(event, {
+            command: isBang ? lowered : "(non-command)",
+            status: "paused_decline",
+        });
+        const notify = makeNotify(rawSend, buildSystemMarker("paused"));
+        await notify(buildPausedNotice());
+        return true;
+    }
+    // Not paused: only bang-prefixed messages are intercepted.
+    if (!isBang)
+        return false;
+    // §7 spoof guard: a multi-line message that happens to start with `!stop`
+    // is "treated as agent input" — bang-command parsing is exact-match (I-2),
+    // so anything spanning newlines never produces a registry hit and must
+    // fall through to the agent path instead of emitting the unknown-bang
+    // help. Mirrors the intent of "Avoids spoofing by users embedding
+    // `!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({
+            event,
+            db,
+            config: ctx.config,
+            notify,
+            audit,
+            registry,
+            enqueueUserBangCommand: ctx.enqueueUserBangCommand,
+        });
+        return true;
+    }
+    const userCommand = getEnabledUserBangCommandByCommand(db, lowered);
+    if (userCommand) {
+        audit.logBangCommand(event, {
+            command: userCommand.command,
+            status: "ok",
+            kind: "user",
+            userCommandId: userCommand.id,
+            backendId: userCommand.backendId,
+            modelId: userCommand.modelId,
+        });
+        await ctx.enqueueUserBangCommand?.(userCommand, event);
+        return true;
+    }
+    // Bang-prefixed but not registered — exact-match argument validation
+    // (e.g. `!cost foo`) lands here.
+    audit.logBangCommand(event, { command: lowered, status: "unknown" });
+    const notify = makeNotify(rawSend, buildSystemMarker("unknown"));
+    await notify(buildUnknownCommandReply([
+        ...registry.list(),
+        ...listUserBangCommands(db)
+            .filter((cmd) => cmd.enabled)
+            .map((cmd) => ({
+            name: cmd.command,
+            describe: cmd.description || `${cmd.backendId} · ${cmd.modelId}`,
+            handler: async () => { },
+        })),
+    ]));
+    return true;
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,86 @@
+import type Database from "better-sqlite3";
+import { type BackendId, type MessageEvent } from "@aitne/shared";
+export declare const CUSTOM_BANG_COMMAND_SOURCE = "bang-command";
+export declare const USER_BANG_COMMAND_NAME_PATTERN: RegExp;
+/**
+ * Default skill set for legacy commands (no enabled_skills_json column set).
+ * Single-skill default: only `notify` is needed for the agent to send a
+ * well-formed DM reply (awareness gate, no-ceremony rule, no-readback). Any
+ * additional capability — context reads, schedule, mail, etc. — is opt-in
+ * per command via the dashboard.
+ */
+export declare const DEFAULT_USER_BANG_COMMAND_SKILLS: readonly string[];
+export interface UserBangCommand {
+    id: number;
+    command: string;
+    name: string;
+    description: string;
+    prompt: string;
+    backendId: BackendId;
+    modelId: string;
+    enabled: boolean;
+    /**
+     * Skill slugs to materialize into the per-turn workdir. `null` means the
+     * row was created before the feature shipped — runtime treats it as
+     * `DEFAULT_USER_BANG_COMMAND_SKILLS` for backward compatibility. An empty
+     * array means "no skills" (the agent gets only safety + character + custom
+     * instructions).
+     */
+    enabledSkills: string[] | null;
+    /**
+     * Custom CLAUDE.md / AGENTS.md / GEMINI.md profile body. `null` keeps the
+     * default conversational profile; non-null replaces the profile body
+     * while safety preamble + character block + skills section are still
+     * rendered around it.
+     */
+    instructionMd: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UserBangCommandInput {
+    name: string;
+    description?: string;
+    prompt: string;
+    backendId: BackendId;
+    modelId: string;
+    enabled?: boolean;
+    enabledSkills?: string[] | null;
+    instructionMd?: string | null;
+}
+export type NormalizeBangCommandNameResult = {
+    ok: true;
+    name: string;
+    command: string;
+} | {
+    ok: false;
+    reason: "empty" | "invalid";
+};
+export declare function normalizeBangCommandName(raw: string): NormalizeBangCommandNameResult;
+export declare function listUserBangCommands(db: Database.Database): UserBangCommand[];
+export declare function getEnabledUserBangCommandByCommand(db: Database.Database, command: string): UserBangCommand | null;
+export declare function getUserBangCommandByCommand(db: Database.Database, command: string): UserBangCommand | null;
+export declare function getUserBangCommandById(db: Database.Database, id: number): UserBangCommand | null;
+export declare function createUserBangCommand(db: Database.Database, input: UserBangCommandInput): UserBangCommand;
+export declare function updateUserBangCommand(db: Database.Database, id: number, input: UserBangCommandInput): UserBangCommand | null;
+export declare function deleteUserBangCommand(db: Database.Database, id: number): boolean;
+export declare function buildUserBangCommandPrompt(command: UserBangCommand, event: MessageEvent): string;
+export declare function createUserBangCommandEvent(event: MessageEvent, command: UserBangCommand): MessageEvent;
+/**
+ * Resolve the effective skill slug list for a command at materialize time.
+ * Legacy NULL → `DEFAULT_USER_BANG_COMMAND_SKILLS` (just `notify`); empty
+ * array → no skills; non-empty → caller-specified set.
+ */
+export declare function resolveCommandSkillSlugs(command: Pick<UserBangCommand, "enabledSkills">): readonly string[];
+/**
+ * Round-trip the enabled skills array as compact JSON. `null` (or an
+ * undefined input) maps to a literal SQL NULL so legacy rows are
+ * indistinguishable from new rows the user has not customised.
+ */
+export declare function serializeEnabledSkills(skills: readonly string[] | null | undefined): string | null;
+/**
+ * Inverse of `serializeEnabledSkills` — null DB → null model. Malformed JSON
+ * is treated as null so a legacy/corrupt row doesn't crash the materializer
+ * (it falls back to the default skill set).
+ */
+export declare function parseEnabledSkills(raw: string | null): string[] | null;
+//# sourceMappingURL=user-commands.d.ts.map

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

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