@cluesmith/codev 3.2.3 → 3.3.0

package/dist/agent-farm/commands/whoami.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Whoami command — report this terminal's agent identity (Spec 1134).
+ *
+ * Answers "who am I, from Tower/global.db's perspective?" for any terminal:
+ * builders resolve from their worktree cwd against global.db, architects from
+ * the Tower-injected CODEV_ARCHITECT_NAME env var. Identity precedence is
+ * fixed by the spec: builder-worktree cwd match → CODEV_ARCHITECT_NAME →
+ * unknown (exit non-zero). There is deliberately NO implicit fallback to
+ * 'main' — an unverified identity misroutes downstream consumers (issue
+ * #1094), so unknown must fail loud.
+ *
+ * Read-only invariant: this command never opens global.db read-write. Builder
+ * resolution reuses detectCurrentBuilderId() (its own read-only connection);
+ * all whoami-specific queries share one read-only connection opened here.
+ *
+ * The identity helpers are imported from ./send.js rather than relocated:
+ * they are already exported and tested there, and whoami is only their second
+ * consumer (extraction deferred until a third appears).
+ */
+export interface WhoamiOptions {
+    json?: boolean;
+}
+/**
+ * Resolved identity. `architect` (builder) is omitted when the row's
+ * `spawned_by_architect` is NULL (legacy) or missing. `rowMissing`
+ * (architect) marks a best-effort diagnostic: the env var named an architect
+ * but no matching `architect` table row exists — surfaced as a stderr
+ * warning, never a failure (rows are legitimately absent after crashes).
+ */
+export type WhoamiIdentity = {
+    type: 'builder';
+    workspace: string;
+    name: string;
+    architect?: string;
+} | {
+    type: 'architect';
+    workspace: string;
+    name: string;
+    rowMissing?: boolean;
+};
+/** Thrown when no identity signal resolves. Message is the user-facing text. */
+export declare class WhoamiError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolve the current terminal's identity per the spec precedence.
+ *
+ * Throws `BuilderIdResolutionError` when cwd IS a builder worktree whose
+ * identity cannot be verified (no fallthrough to the env check — #1094), and
+ * `WhoamiError` when no identity signal resolves at all.
+ */
+export declare function resolveIdentity(env?: NodeJS.ProcessEnv): WhoamiIdentity;
+/** Format an identity as the human-readable `key: value` lines. */
+export declare function formatIdentity(identity: WhoamiIdentity): string;
+/** Format an identity as the JSON payload (`architect` omitted when unknown). */
+export declare function identityToJson(identity: WhoamiIdentity): Record<string, string>;
+/**
+ * `afx whoami` — print this terminal's identity.
+ *
+ * Success: identity to stdout (text or --json), exit 0.
+ * Unknown identity: explanation to stderr (always), `{ "error": ... }` to
+ * stdout under --json, exit 1 via process.exitCode (streams flush).
+ */
+export declare function whoami(options?: WhoamiOptions): Promise<void>;
+//# sourceMappingURL=whoami.d.ts.map

package/dist/agent-farm/commands/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/whoami.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,gFAAgF;AAChF,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAsCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CA+DpF;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAM/D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BvE"}

package/dist/agent-farm/commands/whoami.js

@@ -0,0 +1,196 @@
+/**
+ * Whoami command — report this terminal's agent identity (Spec 1134).
+ *
+ * Answers "who am I, from Tower/global.db's perspective?" for any terminal:
+ * builders resolve from their worktree cwd against global.db, architects from
+ * the Tower-injected CODEV_ARCHITECT_NAME env var. Identity precedence is
+ * fixed by the spec: builder-worktree cwd match → CODEV_ARCHITECT_NAME →
+ * unknown (exit non-zero). There is deliberately NO implicit fallback to
+ * 'main' — an unverified identity misroutes downstream consumers (issue
+ * #1094), so unknown must fail loud.
+ *
+ * Read-only invariant: this command never opens global.db read-write. Builder
+ * resolution reuses detectCurrentBuilderId() (its own read-only connection);
+ * all whoami-specific queries share one read-only connection opened here.
+ *
+ * The identity helpers are imported from ./send.js rather than relocated:
+ * they are already exported and tested there, and whoami is only their second
+ * consumer (extraction deferred until a third appears).
+ */
+import { basename } from 'node:path';
+import Database from 'better-sqlite3';
+import { detectCurrentBuilderId, detectWorkspaceRoot, BuilderIdResolutionError } from './send.js';
+import { lookupBuilderSpawningArchitect } from '../state.js';
+import { getGlobalDbPath } from '../db/index.js';
+import { normalizeWorkspacePath } from '../utils/workspace-path.js';
+/** Thrown when no identity signal resolves. Message is the user-facing text. */
+export class WhoamiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WhoamiError';
+    }
+}
+/**
+ * Open global.db read-only, or return null when it is missing/unopenable.
+ * Null degrades gracefully: the informational lookups (workspace display
+ * name, spawning architect, architect-row cross-check) are skipped. Identity
+ * itself never depends on this handle — the builder path already verified
+ * against the db inside detectCurrentBuilderId(), and the architect path is
+ * env-based.
+ */
+function openReadonlyGlobalDb() {
+    try {
+        return new Database(getGlobalDbPath(), { readonly: true });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Display name for the workspace: the `known_workspaces` registry entry when
+ * present, else the directory basename. Informational context only — the
+ * spec's fail-loud rule applies to type/name, not this field.
+ */
+function workspaceDisplayName(workspaceRoot, db) {
+    const root = workspaceRoot ?? process.cwd();
+    if (db) {
+        try {
+            const row = db
+                .prepare('SELECT name FROM known_workspaces WHERE workspace_path = ?')
+                .get(normalizeWorkspacePath(root));
+            if (row?.name)
+                return row.name;
+        }
+        catch {
+            // Table missing or query failure — informational field, fall through.
+        }
+    }
+    return basename(root);
+}
+/**
+ * Resolve the current terminal's identity per the spec precedence.
+ *
+ * Throws `BuilderIdResolutionError` when cwd IS a builder worktree whose
+ * identity cannot be verified (no fallthrough to the env check — #1094), and
+ * `WhoamiError` when no identity signal resolves at all.
+ */
+export function resolveIdentity(env = process.env) {
+    // 1. Builder-worktree cwd match. A BuilderIdResolutionError propagates
+    //    verbatim: inside a confirmed worktree, an unverifiable identity is an
+    //    error, never a reason to consult the env var.
+    const builderId = detectCurrentBuilderId();
+    const workspaceRoot = detectWorkspaceRoot();
+    const db = openReadonlyGlobalDb();
+    try {
+        if (builderId) {
+            const identity = {
+                type: 'builder',
+                workspace: workspaceDisplayName(workspaceRoot, db),
+                name: builderId,
+            };
+            if (db) {
+                try {
+                    const spawnedBy = lookupBuilderSpawningArchitect(builderId, workspaceRoot ?? undefined, db);
+                    if (spawnedBy)
+                        identity.architect = spawnedBy;
+                }
+                catch {
+                    // Enrichment only — the identity is already verified; a lookup
+                    // failure means "not recorded", not "unknown identity".
+                }
+            }
+            return identity;
+        }
+        // 2. Tower-injected architect env var. Read directly, NOT via
+        //    currentArchitectName() — its default of 'main' is exactly the
+        //    implicit fallback whoami must not have.
+        const architectName = env.CODEV_ARCHITECT_NAME?.trim();
+        if (architectName) {
+            const identity = {
+                type: 'architect',
+                workspace: workspaceDisplayName(workspaceRoot, db),
+                name: architectName,
+            };
+            // Best-effort cross-check against the architect table (diagnostics
+            // only): a missing row is a warning, never a failure — rows are
+            // legitimately absent in the crash-recovery scenarios whoami serves.
+            if (db && workspaceRoot) {
+                try {
+                    const row = db
+                        .prepare('SELECT 1 AS present FROM architect WHERE workspace_path = ? AND id = ?')
+                        .get(normalizeWorkspacePath(workspaceRoot), architectName);
+                    if (!row)
+                        identity.rowMissing = true;
+                }
+                catch {
+                    // Swallowed by design — this check never affects output or exit code.
+                }
+            }
+            return identity;
+        }
+    }
+    finally {
+        db?.close();
+    }
+    // 3. Fail loud. No implicit 'main'.
+    throw new WhoamiError('Cannot determine agent identity: the current directory is not inside a ' +
+        '.builders/<id>/ worktree and CODEV_ARCHITECT_NAME is not set. ' +
+        'Likely causes: a plain shell, a terminal not started by Tower, or a ' +
+        'pre-#786 architect terminal. Refusing to guess (issue #1094) — ' +
+        'identity must come from a verified signal, never a default.');
+}
+/** Format an identity as the human-readable `key: value` lines. */
+export function formatIdentity(identity) {
+    const lines = [`workspace: ${identity.workspace}`, `type: ${identity.type}`, `name: ${identity.name}`];
+    if (identity.type === 'builder' && identity.architect) {
+        lines.push(`architect: ${identity.architect}`);
+    }
+    return lines.join('\n');
+}
+/** Format an identity as the JSON payload (`architect` omitted when unknown). */
+export function identityToJson(identity) {
+    const payload = {
+        workspace: identity.workspace,
+        type: identity.type,
+        name: identity.name,
+    };
+    if (identity.type === 'builder' && identity.architect) {
+        payload.architect = identity.architect;
+    }
+    return payload;
+}
+/**
+ * `afx whoami` — print this terminal's identity.
+ *
+ * Success: identity to stdout (text or --json), exit 0.
+ * Unknown identity: explanation to stderr (always), `{ "error": ... }` to
+ * stdout under --json, exit 1 via process.exitCode (streams flush).
+ */
+export async function whoami(options = {}) {
+    let identity;
+    try {
+        identity = resolveIdentity();
+    }
+    catch (err) {
+        if (!(err instanceof WhoamiError) && !(err instanceof BuilderIdResolutionError))
+            throw err;
+        process.stderr.write(`${err.message}\n`);
+        if (options.json) {
+            process.stdout.write(`${JSON.stringify({ error: err.message })}\n`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (identity.type === 'architect' && identity.rowMissing) {
+        process.stderr.write(`warning: CODEV_ARCHITECT_NAME='${identity.name}' but no matching architect row ` +
+            `in global.db for this workspace (Tower may not have registered this terminal, ` +
+            `or it predates a crash). Identity is reported from the env signal.\n`);
+    }
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(identityToJson(identity))}\n`);
+    }
+    else {
+        process.stdout.write(`${formatIdentity(identity)}\n`);
+    }
+}
+//# sourceMappingURL=whoami.js.map

package/dist/agent-farm/commands/whoami.js.map

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

package/dist/agent-farm/db/index.d.ts

@@ -50,5 +50,5 @@ export declare function getDbPath(): string;
 export declare function getGlobalDbPath(): string;
 export { LOCAL_SCHEMA, GLOBAL_SCHEMA } from './schema.js';
 export { withRetry } from './errors.js';
-export type { DbArchitect, DbBuilder, DbUtil, DbAnnotation, } from './types.js';
+export type { DbArchitect, DbBuilder, DbUtil, DbAnnotation, DbMailbox, MailboxStatus, MailboxReason, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent-farm/db/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+CtC;;;;;;;;;GASG;AACH,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAEzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AA8ZD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+CtC;;;;;;;;;GASG;AACH,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAEzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAgfD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/agent-farm/db/index.js

@@ -124,7 +124,7 @@ function ensureGlobalDatabase() {
     const db = new Database(dbPath);
     configurePragmas(db);
     // Current migration version — bump when adding new migrations
-    const GLOBAL_CURRENT_VERSION = 14;
+    const GLOBAL_CURRENT_VERSION = 17;
     // Detect fresh vs existing database by checking if content tables exist.
     // On existing databases, GLOBAL_SCHEMA must NOT run because it references column names
     // (workspace_path) that don't exist until migration v9 renames them from project_path.
@@ -502,6 +502,85 @@ function ensureGlobalDatabase() {
         db.prepare('INSERT INTO _migrations (version) VALUES (14)').run();
         console.log('[info] Absorbed state.db tables into global.db (Issue #1118)');
     }
+    // Migration v15: Add mailbox table (Spec 1313 — mailbox-first delivery).
+    // Additive new table: every `afx send` is persisted here before the send
+    // response returns, so nothing is lost to a Tower crash/restart/shutdown.
+    // Rows address AGENTS (to_agent), not PTYs, so a respawned terminal drains its
+    // predecessor's mail. No rows to migrate — the retired SendBuffer was in-memory.
+    // Idempotent via CREATE TABLE / CREATE INDEX IF NOT EXISTS (fresh installs
+    // already created it from GLOBAL_SCHEMA and reach the marker as a no-op).
+    const v15 = db.prepare('SELECT version FROM _migrations WHERE version = 15').get();
+    if (!v15) {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS mailbox (
+        id TEXT PRIMARY KEY,
+        workspace_path TEXT NOT NULL,
+        to_agent TEXT NOT NULL,
+        terminal_id TEXT,
+        from_agent TEXT,
+        from_workspace TEXT,
+        body TEXT NOT NULL,
+        formatted_message TEXT NOT NULL,
+        no_enter INTEGER NOT NULL DEFAULT 0,
+        status TEXT NOT NULL DEFAULT 'held'
+          CHECK(status IN ('held', 'delivered', 'superseded', 'dismissed')),
+        reason TEXT CHECK(reason IN ('busy', 'no-profile', 'no-live-pty')),
+        supersede_key TEXT,
+        escalated INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        resolved_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_mailbox_workspace_status ON mailbox(workspace_path, status);
+      CREATE INDEX IF NOT EXISTS idx_mailbox_agent_drain ON mailbox(workspace_path, to_agent, status);
+      CREATE INDEX IF NOT EXISTS idx_mailbox_supersede ON mailbox(supersede_key);
+    `);
+        db.prepare('INSERT INTO _migrations (version) VALUES (15)').run();
+        console.log('[info] Created mailbox table (Spec 1313)');
+    }
+    // Migration v16: Add command column to terminal_sessions (Spec 1313).
+    // The render-gate resolves an agent's classifier profile from its launch
+    // command (PtySession.command). Shellper-backed sessions were created with
+    // command: '' and the profile fell back to reading `.builder-start.sh` —
+    // which only builder worktrees have. Architects run in the workspace root
+    // (no launch script), so they never resolved and every `afx send architect`
+    // held `no-profile`. Persisting the command lets the reconcile/reconnect
+    // paths restore identity after a Tower restart, so architects resolve
+    // directly and survive restart (builders keep the launch-script backstop).
+    // Mirrors the label (v11) / cwd (v12) column adds.
+    const v16 = db.prepare('SELECT version FROM _migrations WHERE version = 16').get();
+    if (!v16) {
+        // Only skip the ALTER when the column genuinely exists already (fresh install
+        // ran GLOBAL_SCHEMA). A blanket try/catch would let a REAL alter failure be
+        // recorded as "migrated" — and since saveTerminalSession's INSERT now names
+        // `command`, every future write would then fail against a table missing it.
+        const hasCommand = db.prepare(`PRAGMA table_info(terminal_sessions)`).all()
+            .some((c) => c.name === 'command');
+        if (!hasCommand) {
+            db.exec(`ALTER TABLE terminal_sessions ADD COLUMN command TEXT`);
+        }
+        db.prepare('INSERT INTO _migrations (version) VALUES (16)').run();
+        console.log('[info] Added command column to terminal_sessions (Spec 1313 restart-safe render-gate identity)');
+    }
+    // Migration v17: Add not_before column to mailbox (Spec 1313 round 3 — durable `--delay`).
+    // `afx send --delay` now persists its row at REQUEST time with not_before = now + delay*1000
+    // and defers delivery through the render gate, so a delayed send survives a Tower restart
+    // (the conscious reversal of Spec 1307's drop-on-restart semantics). A row is deliverable
+    // only when `not_before IS NULL OR not_before <= now`; null means deliver-ASAP (every
+    // pre-round-3 row). PRAGMA-gated ADD COLUMN mirroring v16 — a blanket try/catch would let a
+    // real ALTER failure be recorded as "migrated" and every subsequent mailbox insert (which
+    // now names not_before) would then fail against a table missing it. Do NOT edit v15 in place:
+    // dev machines on this branch already applied it, so the column must arrive as its own step.
+    const v17 = db.prepare('SELECT version FROM _migrations WHERE version = 17').get();
+    if (!v17) {
+        const hasNotBefore = db.prepare(`PRAGMA table_info(mailbox)`).all()
+            .some((c) => c.name === 'not_before');
+        if (!hasNotBefore) {
+            db.exec(`ALTER TABLE mailbox ADD COLUMN not_before INTEGER`);
+        }
+        db.prepare('INSERT INTO _migrations (version) VALUES (17)').run();
+        console.log('[info] Added not_before column to mailbox (Spec 1313 durable --delay)');
+    }
     return db;
 }
 // Re-export types and utilities

package/dist/agent-farm/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"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"}

package/dist/agent-farm/db/mailbox.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Mailbox repository (Spec 1313 — mailbox-first delivery).
+ *
+ * Pure, unit-testable data operations over the `mailbox` table. Every `afx send`
+ * is persisted here *before* the send response returns, so nothing is lost to a
+ * Tower crash, restart, or shutdown. This module is deliberately decoupled from
+ * delivery: it never writes to a PTY and never runs the render-gate. The delivery
+ * orchestration (Phase 4) wires against these proven operations.
+ *
+ * Design notes:
+ * - Functions take an explicit `db` handle first (matching `db/consolidate.ts`),
+ *   which keeps them trivially testable against any better-sqlite3 database.
+ * - Timestamps are epoch-ms integers supplied by the caller (defaulting to
+ *   `Date.now()`), so ordering and age math are deterministic and test-injectable.
+ * - `workspace_path` is treated as an opaque addressing key: callers pass a
+ *   canonical path (the send boundary canonicalizes in Phase 4), mirroring how
+ *   `cron_tasks` scopes by workspace. This module does not canonicalize.
+ * - The lifecycle state machine (`held → delivered | superseded | dismissed`) is
+ *   enforced here: every transition targets only `held` rows, so a terminal row
+ *   can never revert (no `delivered → held`) and `supersede` only replaces a row
+ *   that is still `held`.
+ */
+import type Database from 'better-sqlite3';
+import type { DbMailbox, MailboxReason } from './types.js';
+/**
+ * Fields a caller supplies to persist a new held row. The repository fills in the
+ * id, `held` status, `escalated=0`, and the timestamps.
+ */
+export interface EnqueueInput {
+    workspacePath: string;
+    toAgent: string;
+    /** Raw message body (never logged). */
+    body: string;
+    /** Exact bytes written to the PTY on delivery. */
+    formattedMessage: string;
+    /** Last-known PTY hint; the recipient is the agent, not this terminal. */
+    terminalId?: string | null;
+    fromAgent?: string | null;
+    fromWorkspace?: string | null;
+    /** Stage the text without submitting (no trailing Enter). */
+    noEnter?: boolean;
+    /** Initial why-held reason; null if it will be delivered immediately. */
+    reason?: MailboxReason | null;
+    /** Cron-only coalescing key; null for direct sends. */
+    supersedeKey?: string | null;
+    /**
+     * Delayed-send due time in epoch-ms (Spec 1313 round 3 — `--delay`). null means
+     * deliver-ASAP (every non-delayed send). A row is deliverable only once
+     * `not_before IS NULL OR not_before <= now`; a delayed send persists this at REQUEST
+     * time so the delay is durable across a Tower restart.
+     */
+    notBefore?: number | null;
+}
+/**
+ * Persist a new `held` row and return it. This is the persist-first step: the row
+ * exists (and survives a crash) before any delivery is attempted.
+ */
+export declare function enqueue(db: Database.Database, input: EnqueueInput, now?: number): DbMailbox;
+/** Fetch a single row by id, or null if it does not exist. */
+export declare function getById(db: Database.Database, id: string): DbMailbox | null;
+/**
+ * List all currently-held rows, oldest first. Scoped to `workspacePath` when
+ * provided, else workspace-wide (for `afx inbox`). `id` breaks created_at ties
+ * for deterministic ordering.
+ */
+export declare function listHeld(db: Database.Database, workspacePath?: string): DbMailbox[];
+/**
+ * ELIGIBLE held rows addressed to a specific agent, in enqueue order (`created_at ASC`).
+ * This is the per-agent drain order a delivery pass walks.
+ *
+ * Spec 1313 round 3 (`--delay`): a row is deliverable only when
+ * `not_before IS NULL OR not_before <= now` — a pre-due delayed send is EXCLUDED here, so it
+ * neither delivers early nor blocks a later normal message (the drainer picks `held[0]`, the
+ * oldest ELIGIBLE row). It becomes eligible on the first pass at/after its due time. `now`
+ * defaults to `Date.now()` and is injectable for deterministic tests.
+ */
+export declare function findHeldForAgent(db: Database.Database, workspacePath: string, toAgent: string, now?: number): DbMailbox[];
+/**
+ * Held rows whose escalation age ({@link ESCALATION_START_SQL} → now) has crossed `maxAgeMs`
+ * and that have NOT yet been escalated. Tower-global (every workspace) — the drainer's
+ * escalation pass walks these once per tick to flip `escalated` and emit the visibility
+ * broadcast. Bounded by the (small) held set, so a full scan is fine. Oldest effective-start
+ * escalates first.
+ *
+ * Spec 1313 round 3: a PRE-DUE delayed row never escalates — its effective start is its
+ * future `not_before`, which cannot be `< cutoff` (cutoff = now − maxAgeMs ≤ now), so the
+ * age filter excludes it by construction. A delayed row escalates only after it has been
+ * deliverable-but-stuck (past its due time) for the window.
+ */
+export declare function findEscalatable(db: Database.Database, maxAgeMs: number, now?: number): DbMailbox[];
+/** Per-agent held tally within a workspace (drives the overview's live indicator). */
+export interface HeldAgentCount {
+    toAgent: string;
+    count: number;
+    /** True if any of this agent's held rows has crossed the escalation age. */
+    escalated: boolean;
+}
+/** Workspace-level held summary: total, whether any row is escalated, and the per-agent split. */
+export interface WorkspaceHeldSummary {
+    total: number;
+    escalated: boolean;
+    byAgent: HeldAgentCount[];
+}
+/**
+ * Count currently-held rows for a workspace, grouped by recipient agent, with an
+ * escalation flag. Counts only — **no message bodies** are read or returned, so this is
+ * safe to fold into the overview payload that the dashboard/VSCode indicator renders
+ * (spec: the indicator is count-only; bodies live only in `afx inbox`). Aggregated in
+ * SQL so cost is bounded by the (small) held set, not the row bodies.
+ *
+ * ELIGIBLE rows only (Spec 1313 round 3): a PRE-DUE delayed send (`not_before` in the
+ * future) is "scheduled, not stuck" and must NOT inflate the attention count/indicator —
+ * this is the same `not_before IS NULL OR not_before <= now` eligibility every other
+ * count/alarm surface uses (`findHeldForAgent`, `findEscalatable`, `findStarvingAgents`),
+ * so `afx status` / the dashboard badge report deliverable-but-stuck mail, not scheduled
+ * sends. (Pre-due rows are still visible in `afx inbox`, which lists ALL held rows and
+ * labels these "scheduled" — only the count/alarm surfaces exclude them.) The `escalated`
+ * flag was already pre-due-safe (a pre-due row never escalates); this aligns the raw count.
+ */
+export declare function heldSummaryForWorkspace(db: Database.Database, workspacePath: string, now?: number): WorkspaceHeldSummary;
+/**
+ * Transition a held row to `delivered` (clearing its why-held reason and stamping
+ * `resolved_at`). Returns true if it transitioned; false if the row was already
+ * terminal or does not exist — so a re-delivery attempt (backstop racing a submit
+ * trigger) is a safe no-op and can never revert or double-deliver a row.
+ */
+export declare function markDelivered(db: Database.Database, id: string, now?: number): boolean;
+/**
+ * Refresh the why-held `reason` on a still-held row (informational — the value
+ * `afx inbox` shows and the send response reports). Only touches `held` rows, so
+ * it can never relabel or resurrect a terminal row. Returns true if a held row was
+ * updated. The delivery pass calls this so a held row's reason tracks the current
+ * gate verdict (e.g. `busy` → `no-live-pty` when the terminal dies).
+ */
+export declare function setHeldReason(db: Database.Database, id: string, reason: MailboxReason | null, now?: number): boolean;
+/**
+ * Flag a still-held row as escalated — **visibility only, NEVER affects delivery**. The
+ * drainer's escalation pass calls this when a row crosses the escalation age, then emits
+ * the escalation broadcast; the row still delivers only on a later clean gate pass.
+ * Held-only and idempotent (the `escalated = 0` guard), so a terminal or already-escalated
+ * row is untouched. Returns true if it flipped.
+ */
+export declare function markEscalated(db: Database.Database, id: string, now?: number): boolean;
+/**
+ * Supersede-key prefix for architect starvation notices (Spec 1313 round 3, change 3). A
+ * notice row carries `${NOTICE_SUPERSEDE_PREFIX}<starving-agent>` so (a) one pending notice
+ * per starving agent coalesces via {@link supersede}, and (b) notice rows are recognizable by
+ * prefix and EXCLUDED from {@link findStarvingAgents} — a notice can never itself trigger a
+ * notice ("no notice about a notice"). Cron uses bare task names as keys, which never collide
+ * with this prefix.
+ */
+export declare const NOTICE_SUPERSEDE_PREFIX = "mailbox-notice:";
+/** Per-agent aggregate over an agent's ELIGIBLE, non-notice held rows (Spec 1313 round 3). */
+export interface StarvingAgent {
+    workspacePath: string;
+    toAgent: string;
+    /**
+     * Escalation-start ({@link ESCALATION_START_SQL}) of the OLDEST eligible held row — the
+     * moment this agent's oldest deliverable mail became stuck. Its age is `now - stuckSince`.
+     */
+    stuckSince: number;
+    /** How many eligible non-notice rows are held for this agent. */
+    count: number;
+    /** Representative why-held reason (held rows for one agent share the gate's verdict). */
+    reason: MailboxReason | null;
+}
+/**
+ * Per-agent view of currently-STARVING mail (Spec 1313 round 3, change 3): agents with at
+ * least one ELIGIBLE (`not_before IS NULL OR not_before <= now`) held row that is NOT itself a
+ * notice ({@link NOTICE_SUPERSEDE_PREFIX}). Tower-global (every workspace), aggregated in SQL
+ * so cost is bounded by the (small) held set. The drainer's notice pass compares each agent's
+ * `stuckSince` against the owner-notice threshold to decide whether to alarm, and uses the
+ * membership of the returned set to decide when a prior notice can be cleared (agent no longer
+ * has any eligible non-notice held row → drained). PRE-DUE delayed rows are excluded (not
+ * stuck), so a scheduled send never trips the alarm nor keeps one alive.
+ */
+export declare function findStarvingAgents(db: Database.Database, now?: number): StarvingAgent[];
+/**
+ * Dismiss every still-`held` row matching `(workspacePath, supersedeKey)` (Spec 1313 round 3).
+ * Used to clear a pending architect notice once its starving agent recovers (the notice is
+ * moot). Audit-preserving (soft transition), and a no-op on an already-delivered notice.
+ * Returns the number of rows dismissed.
+ */
+export declare function dismissHeldWithKey(db: Database.Database, workspacePath: string, supersedeKey: string, now?: number): number;
+/**
+ * Dismiss every still-`held` row addressed to an agent (Spec 1313 round 3, take-now B). Called
+ * when an agent is cleaned up (`afx cleanup`) so its orphaned held rows stop pinning
+ * `heldCount`/escalated forever — the terminal-row prune only removes delivered/superseded/
+ * dismissed rows, never held ones. Audit-preserving. Returns the number of rows dismissed.
+ */
+export declare function dismissHeldForAgent(db: Database.Database, workspacePath: string, toAgent: string, now?: number): number;
+/**
+ * Transition a held row to `dismissed` (operator-cleared via `afx inbox dismiss`).
+ * The why-held reason is preserved for audit. Returns true if it transitioned;
+ * a dismissed row is never delivered.
+ */
+export declare function dismiss(db: Database.Database, id: string, now?: number): boolean;
+/**
+ * Count currently-`held` rows sharing `(workspacePath, supersedeKey)`. Cron reads
+ * this immediately before {@link supersede} — with no `await` between the two calls,
+ * so on better-sqlite3's synchronous, single-threaded handle the pair cannot
+ * interleave with another run — to log an honest outcome: a newer run that finds a
+ * prior held row of the same task reports `superseded`, otherwise `held`. The
+ * `(supersede_key)` index keeps this cheap.
+ */
+export declare function countHeldWithKey(db: Database.Database, workspacePath: string, supersedeKey: string): number;
+/**
+ * Replace the held row sharing `(workspacePath, supersedeKey)` — if any — with a
+ * fresh held row carrying the same key, atomically. Only `held` rows are
+ * superseded (a delivered/dismissed row is untouched), so a newer cron run
+ * collapses a stale backlog without disturbing history. When no held row matches,
+ * this is just an enqueue. Returns the newly-enqueued replacement row.
+ */
+export declare function supersede(db: Database.Database, workspacePath: string, supersedeKey: string, input: EnqueueInput, now?: number): DbMailbox;
+/**
+ * Delete terminal rows (delivered/superseded/dismissed) whose `resolved_at` is
+ * older than `retentionDays`. Held rows are never removed — the `status != 'held'`
+ * and `resolved_at IS NOT NULL` guards make that impossible even if a held row
+ * somehow carried a stale timestamp. Returns the number of rows deleted.
+ */
+export declare function pruneTerminal(db: Database.Database, retentionDays: number, now?: number): number;
+//# sourceMappingURL=mailbox.d.ts.map