agentix-cli 0.154.2 → 0.155.0

package/dist/index.d.ts

@@ -3382,15 +3382,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types: string[];
                 candidates: number;
             };
-            shared: boolean;
-            candidates: number;
-            sharedCandidates: number;
-            maxPages: number;
-            pageChars: number;
-            linkedPages: number;
-            linkedChars: number;
-            navigatorModel: string;
-            answerModel: string;
             live: {
                 enabled: boolean;
                 timeoutMs: number;
@@ -3420,6 +3411,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     url?: string | undefined;
                 })[];
             };
+            shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
+            navigatorModel: string;
+            answerModel: string;
         }, {
             method?: "auto" | "summaries" | "catalog" | undefined;
             notes?: {
@@ -3427,15 +3427,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types?: string[] | undefined;
                 candidates?: number | undefined;
             } | undefined;
-            shared?: boolean | undefined;
-            candidates?: number | undefined;
-            sharedCandidates?: number | undefined;
-            maxPages?: number | undefined;
-            pageChars?: number | undefined;
-            linkedPages?: number | undefined;
-            linkedChars?: number | undefined;
-            navigatorModel?: string | undefined;
-            answerModel?: string | undefined;
             live?: {
                 enabled?: boolean | undefined;
                 timeoutMs?: number | undefined;
@@ -3465,6 +3456,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     peers?: boolean | undefined;
                 })[] | undefined;
             } | undefined;
+            shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
         }>>;
         /** One-line page summaries `wiki query` picks pages from (#855). */
         summaries: z.ZodDefault<z.ZodObject<{
@@ -3516,15 +3516,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types: string[];
                 candidates: number;
             };
-            shared: boolean;
-            candidates: number;
-            sharedCandidates: number;
-            maxPages: number;
-            pageChars: number;
-            linkedPages: number;
-            linkedChars: number;
-            navigatorModel: string;
-            answerModel: string;
             live: {
                 enabled: boolean;
                 timeoutMs: number;
@@ -3554,6 +3545,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     url?: string | undefined;
                 })[];
             };
+            shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
+            navigatorModel: string;
+            answerModel: string;
         };
         contributions: {
             model: string;
@@ -3582,15 +3582,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types?: string[] | undefined;
                 candidates?: number | undefined;
             } | undefined;
-            shared?: boolean | undefined;
-            candidates?: number | undefined;
-            sharedCandidates?: number | undefined;
-            maxPages?: number | undefined;
-            pageChars?: number | undefined;
-            linkedPages?: number | undefined;
-            linkedChars?: number | undefined;
-            navigatorModel?: string | undefined;
-            answerModel?: string | undefined;
             live?: {
                 enabled?: boolean | undefined;
                 timeoutMs?: number | undefined;
@@ -3620,6 +3611,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     peers?: boolean | undefined;
                 })[] | undefined;
             } | undefined;
+            shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
         } | undefined;
         contributions?: {
             model?: string | undefined;
@@ -5165,6 +5165,27 @@ declare const daemonConfigSchema: z.ZodObject<{
             addresses?: string[] | undefined;
             digestNags?: boolean | undefined;
         }>>;
+        /** Reach (src/notify/reach.ts, #1138 step B): an urgent item goes to
+         *  where the owner was last seen and, unseen after
+         *  `escalateAfterMinutes`, once to the next address on the ladder.
+         *  Seen/answered marks, presence and channel health are always on;
+         *  this switches the ladder only. Off by default: it sends a second
+         *  message, and seen relies on the phone app's read mark. */
+        reach: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            escalateAfterMinutes: z.ZodDefault<z.ZodNumber>;
+            /** Owner addresses in order, as "channel:chatId". Empty: the told
+             *  channels (chat "default") and then the told addresses. */
+            ladder: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            escalateAfterMinutes: number;
+            ladder: string[];
+        }, {
+            enabled?: boolean | undefined;
+            escalateAfterMinutes?: number | undefined;
+            ladder?: string[] | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         local: {
             sound: boolean;
@@ -5187,6 +5208,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             addresses: string[];
             digestNags: boolean;
         };
+        reach: {
+            enabled: boolean;
+            escalateAfterMinutes: number;
+            ladder: string[];
+        };
         channel?: string | undefined;
         destination?: {
             channel: string;
@@ -5221,6 +5247,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             addresses?: string[] | undefined;
             digestNags?: boolean | undefined;
         } | undefined;
+        reach?: {
+            enabled?: boolean | undefined;
+            escalateAfterMinutes?: number | undefined;
+            ladder?: string[] | undefined;
+        } | undefined;
     }>>;
     calls: z.ZodDefault<z.ZodObject<{
         /** Agents allowed to call: ids, or "*" for every agent on this node.
@@ -6155,6 +6186,111 @@ declare const daemonConfigSchema: z.ZodObject<{
             repos?: Record<string, string> | undefined;
             checkEveryMinutes?: number | undefined;
         }>>;
+        /** Status follows the work (src/requests/drift, #1138 step F): merged
+         *  merge requests are mapped to the issues they close, and an issue
+         *  whose status label no longer says what happened (merged but still
+         *  Doing, live but still Review, Done but not live) is reported to the
+         *  owner once. Only the projects listed are read. Writing the label
+         *  back is a second switch, off by default. */
+        statusDrift: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            /** Minutes between two checks. Each one reads the forges. */
+            checkEveryMinutes: z.ZodDefault<z.ZodNumber>;
+            /** How far back merged merge requests are read. */
+            lookbackDays: z.ZodDefault<z.ZodNumber>;
+            projects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                provider: z.ZodEnum<["gitlab", "github"]>;
+                /** "group/project" on GitLab, "owner/repo" on GitHub. */
+                project: z.ZodEffects<z.ZodString, string, string>;
+                /** Where the running commit is read: "self" (this node's own build)
+                 *  or a health URL whose JSON has it under `liveField`. Every one
+                 *  must run a commit for it to count as live. Empty: live is not
+                 *  known, and only merged-but-not-in-Review is reported. */
+                live: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"self">, z.ZodString]>, "many">>;
+                /** A clone named in requests.checkers.repos: the live check runs
+                 *  git there instead of asking the forge. */
+                repo: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                provider: "gitlab" | "github";
+                project: string;
+                live: string[];
+                repo?: string | undefined;
+            }, {
+                provider: "gitlab" | "github";
+                project: string;
+                repo?: string | undefined;
+                live?: string[] | undefined;
+            }>, "many">>;
+            /** The JSON field of a health URL that holds the running commit. */
+            liveField: z.ZodDefault<z.ZodString>;
+            /** The status labels, any case. The first label of a status is the
+             *  one written. */
+            labels: z.ZodDefault<z.ZodObject<{
+                todo: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                doing: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                review: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                done: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                done: string[];
+                todo: string[];
+                doing: string[];
+                review: string[];
+            }, {
+                done?: string[] | undefined;
+                todo?: string[] | undefined;
+                doing?: string[] | undefined;
+                review?: string[] | undefined;
+            }>>;
+            /** Done but not live is told only once a merge has waited this many
+             *  hours to go live: forges close the issue at merge, before a deploy. */
+            doneNotLiveAfterHours: z.ZodDefault<z.ZodNumber>;
+            /** Write mode: an issue whose work is live gets its Done label (its
+             *  other status labels removed) and a note quoting the proof. Never
+             *  closes an issue. Needs the project in `writeProjects` too. */
+            write: z.ZodDefault<z.ZodBoolean>;
+            /** Projects write mode may change, as listed under `projects`. */
+            writeProjects: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            projects: {
+                provider: "gitlab" | "github";
+                project: string;
+                live: string[];
+                repo?: string | undefined;
+            }[];
+            labels: {
+                done: string[];
+                todo: string[];
+                doing: string[];
+                review: string[];
+            };
+            write: boolean;
+            checkEveryMinutes: number;
+            lookbackDays: number;
+            liveField: string;
+            doneNotLiveAfterHours: number;
+            writeProjects: string[];
+        }, {
+            enabled?: boolean | undefined;
+            projects?: {
+                provider: "gitlab" | "github";
+                project: string;
+                repo?: string | undefined;
+                live?: string[] | undefined;
+            }[] | undefined;
+            labels?: {
+                done?: string[] | undefined;
+                todo?: string[] | undefined;
+                doing?: string[] | undefined;
+                review?: string[] | undefined;
+            } | undefined;
+            write?: boolean | undefined;
+            checkEveryMinutes?: number | undefined;
+            lookbackDays?: number | undefined;
+            liveField?: string | undefined;
+            doneNotLiveAfterHours?: number | undefined;
+            writeProjects?: string[] | undefined;
+        }>>;
         /** Headlines (src/requests/headline.ts, #1126): a request the agent did
          *  not describe gets a few words saying what it is, written once by one
          *  small model call, so its card, push and Desk line are not titled with
@@ -6212,6 +6348,27 @@ declare const daemonConfigSchema: z.ZodObject<{
             timeoutSeconds: number;
         };
         settleHandedBack: boolean;
+        statusDrift: {
+            enabled: boolean;
+            projects: {
+                provider: "gitlab" | "github";
+                project: string;
+                live: string[];
+                repo?: string | undefined;
+            }[];
+            labels: {
+                done: string[];
+                todo: string[];
+                doing: string[];
+                review: string[];
+            };
+            write: boolean;
+            checkEveryMinutes: number;
+            lookbackDays: number;
+            liveField: string;
+            doneNotLiveAfterHours: number;
+            writeProjects: string[];
+        };
     }, {
         enabled?: boolean | undefined;
         from?: string[] | undefined;
@@ -6247,6 +6404,27 @@ declare const daemonConfigSchema: z.ZodObject<{
             timeoutSeconds?: number | undefined;
         } | undefined;
         settleHandedBack?: boolean | undefined;
+        statusDrift?: {
+            enabled?: boolean | undefined;
+            projects?: {
+                provider: "gitlab" | "github";
+                project: string;
+                repo?: string | undefined;
+                live?: string[] | undefined;
+            }[] | undefined;
+            labels?: {
+                done?: string[] | undefined;
+                todo?: string[] | undefined;
+                doing?: string[] | undefined;
+                review?: string[] | undefined;
+            } | undefined;
+            write?: boolean | undefined;
+            checkEveryMinutes?: number | undefined;
+            lookbackDays?: number | undefined;
+            liveField?: string | undefined;
+            doneNotLiveAfterHours?: number | undefined;
+            writeProjects?: string[] | undefined;
+        } | undefined;
     }>>;
     /** Task watchers (src/watchers, #1030): every task start decides whether
      *  the task needs a watcher and attaches one. Off by default. */
@@ -6316,11 +6494,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts: string[];
         }>;
         retentionDays: number;
+        escalateAfterMinutes: number;
         skipChannels: string[];
         defaultDueMinutes: number;
         noBelow: number;
         yesAt: number;
-        escalateAfterMinutes: number;
         doneSignal: "result" | "explicit";
     }, {
         enabled?: boolean | undefined;
@@ -6334,11 +6512,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts?: string[] | undefined;
         }> | undefined;
         retentionDays?: number | undefined;
+        escalateAfterMinutes?: number | undefined;
         skipChannels?: string[] | undefined;
         defaultDueMinutes?: number | undefined;
         noBelow?: number | undefined;
         yesAt?: number | undefined;
-        escalateAfterMinutes?: number | undefined;
         doneSignal?: "result" | "explicit" | undefined;
     }>>, {
         enabled: boolean;
@@ -6352,11 +6530,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts: string[];
         }>;
         retentionDays: number;
+        escalateAfterMinutes: number;
         skipChannels: string[];
         defaultDueMinutes: number;
         noBelow: number;
         yesAt: number;
-        escalateAfterMinutes: number;
         doneSignal: "result" | "explicit";
     }, {
         enabled?: boolean | undefined;
@@ -6370,11 +6548,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts?: string[] | undefined;
         }> | undefined;
         retentionDays?: number | undefined;
+        escalateAfterMinutes?: number | undefined;
         skipChannels?: string[] | undefined;
         defaultDueMinutes?: number | undefined;
         noBelow?: number | undefined;
         yesAt?: number | undefined;
-        escalateAfterMinutes?: number | undefined;
         doneSignal?: "result" | "explicit" | undefined;
     } | undefined>;
     people: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -9128,15 +9306,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types: string[];
                 candidates: number;
             };
-            shared: boolean;
-            candidates: number;
-            sharedCandidates: number;
-            maxPages: number;
-            pageChars: number;
-            linkedPages: number;
-            linkedChars: number;
-            navigatorModel: string;
-            answerModel: string;
             live: {
                 enabled: boolean;
                 timeoutMs: number;
@@ -9166,6 +9335,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     url?: string | undefined;
                 })[];
             };
+            shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
+            navigatorModel: string;
+            answerModel: string;
         };
         contributions: {
             model: string;
@@ -9307,6 +9485,27 @@ declare const daemonConfigSchema: z.ZodObject<{
             timeoutSeconds: number;
         };
         settleHandedBack: boolean;
+        statusDrift: {
+            enabled: boolean;
+            projects: {
+                provider: "gitlab" | "github";
+                project: string;
+                live: string[];
+                repo?: string | undefined;
+            }[];
+            labels: {
+                done: string[];
+                todo: string[];
+                doing: string[];
+                review: string[];
+            };
+            write: boolean;
+            checkEveryMinutes: number;
+            lookbackDays: number;
+            liveField: string;
+            doneNotLiveAfterHours: number;
+            writeProjects: string[];
+        };
     };
     channels: {
         push: {
@@ -9625,6 +9824,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             addresses: string[];
             digestNags: boolean;
         };
+        reach: {
+            enabled: boolean;
+            escalateAfterMinutes: number;
+            ladder: string[];
+        };
         channel?: string | undefined;
         destination?: {
             channel: string;
@@ -9738,11 +9942,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts: string[];
         }>;
         retentionDays: number;
+        escalateAfterMinutes: number;
         skipChannels: string[];
         defaultDueMinutes: number;
         noBelow: number;
         yesAt: number;
-        escalateAfterMinutes: number;
         doneSignal: "result" | "explicit";
     };
     people: {
@@ -10242,15 +10446,6 @@ declare const daemonConfigSchema: z.ZodObject<{
                 types?: string[] | undefined;
                 candidates?: number | undefined;
             } | undefined;
-            shared?: boolean | undefined;
-            candidates?: number | undefined;
-            sharedCandidates?: number | undefined;
-            maxPages?: number | undefined;
-            pageChars?: number | undefined;
-            linkedPages?: number | undefined;
-            linkedChars?: number | undefined;
-            navigatorModel?: string | undefined;
-            answerModel?: string | undefined;
             live?: {
                 enabled?: boolean | undefined;
                 timeoutMs?: number | undefined;
@@ -10280,6 +10475,15 @@ declare const daemonConfigSchema: z.ZodObject<{
                     peers?: boolean | undefined;
                 })[] | undefined;
             } | undefined;
+            shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
         } | undefined;
         contributions?: {
             model?: string | undefined;
@@ -10489,6 +10693,27 @@ declare const daemonConfigSchema: z.ZodObject<{
             timeoutSeconds?: number | undefined;
         } | undefined;
         settleHandedBack?: boolean | undefined;
+        statusDrift?: {
+            enabled?: boolean | undefined;
+            projects?: {
+                provider: "gitlab" | "github";
+                project: string;
+                repo?: string | undefined;
+                live?: string[] | undefined;
+            }[] | undefined;
+            labels?: {
+                done?: string[] | undefined;
+                todo?: string[] | undefined;
+                doing?: string[] | undefined;
+                review?: string[] | undefined;
+            } | undefined;
+            write?: boolean | undefined;
+            checkEveryMinutes?: number | undefined;
+            lookbackDays?: number | undefined;
+            liveField?: string | undefined;
+            doneNotLiveAfterHours?: number | undefined;
+            writeProjects?: string[] | undefined;
+        } | undefined;
     } | undefined;
     channels?: {
         push?: {
@@ -10806,6 +11031,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             addresses?: string[] | undefined;
             digestNags?: boolean | undefined;
         } | undefined;
+        reach?: {
+            enabled?: boolean | undefined;
+            escalateAfterMinutes?: number | undefined;
+            ladder?: string[] | undefined;
+        } | undefined;
     } | undefined;
     calls?: {
         summary?: boolean | undefined;
@@ -10913,11 +11143,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             linkHosts?: string[] | undefined;
         }> | undefined;
         retentionDays?: number | undefined;
+        escalateAfterMinutes?: number | undefined;
         skipChannels?: string[] | undefined;
         defaultDueMinutes?: number | undefined;
         noBelow?: number | undefined;
         yesAt?: number | undefined;
-        escalateAfterMinutes?: number | undefined;
         doneSignal?: "result" | "explicit" | undefined;
     } | undefined;
     people?: {
@@ -12039,6 +12269,9 @@ declare class AgentXDaemon {
     private requests;
     /** The told-the-owner gate (#1126). Null without a database. */
     private ownerGate;
+    /** Where the owner is and did it land (#1138 step B). Null without a database. */
+    private reach;
+    private reachTimer?;
     private toldPrunedAt;
     /** Guest meshes (#380): the grants this node opened, and the join limiter. */
     private guestStore;
@@ -12047,6 +12280,10 @@ declare class AgentXDaemon {
      *  is the owner's (requests/operator, #393). */
     private operatorKey;
     private requestsSweeping;
+    /** Status drift (#1138 step F): its last check, and one at a time. */
+    private driftAt;
+    private driftSweeping;
+    private readonly driftLiveCache;
     /** Task watchers (src/watchers, #1030). */
     private watchers;
     private watchersSweeping;
@@ -12109,6 +12346,10 @@ declare class AgentXDaemon {
      *  approved messages sent, the owner told at the end or on a block
      *  (src/requests/plan-sweep.ts, #788). One check at a time. */
     private sweepPlans;
+    /** Status follows the work (src/requests/drift, #1138 step F): beside
+     *  the requests check, at its own pace, since each check reads the
+     *  forges. Reports drift to the owner; writes a label only in write mode. */
+    private statusDriftTick;
     /** What the loop checkers read (#1039): the forges through the
      *  configured connectors, the local clones under requests.checkers.repos,
      *  and this node's own record of inbound turns. Built per check, so a
@@ -12128,6 +12369,9 @@ declare class AgentXDaemon {
     private waitForChat;
     /** The watcher checkpoint at every task start (src/watchers, #1030). */
     private attachTaskWatchers;
+    /** Reach (#1138 step B): presence, seen/answered marks, the urgent
+     *  ladder and channel health, checked once a minute. */
+    private attachReach;
     /** Tell the owner through the notify path: a push to the default
      *  channel, the Mac banner where there is one (#788). */
     private notifyOwner;
@@ -12714,6 +12958,13 @@ interface ChannelAdapter {
     react?(chatId: string, messageId: string, emoji?: string): Promise<void>;
     /** Register handler for incoming messages */
     onMessage(handler: (msg: IncomingMessage) => Promise<void>): void;
+    /** Can a send go out now (#1138 step B)? A channel that can tell it is
+     *  down says so, and the router refuses sends to it with the reason
+     *  instead of reporting them sent. Absent: taken as up. */
+    health?(): {
+        up: boolean;
+        reason?: string;
+    };
     /** Get verified context for a chat (optional — channels implement what they can) */
     getChannelMeta?(chatId: string): Promise<ChannelMeta | undefined>;
     /** Fetch the most recent messages from the live channel for cold-start
@@ -17547,6 +17798,8 @@ declare class BusinessLayer {
 
 type TellKind = "notice" | "nag";
 type TellOutcome = "sent" | "held" | "digest" | "repeat" | "failed";
+/** Where a row that went out stands: sent, seen by the owner, answered. */
+type TellState = "sent" | "seen" | "answered";
 /** What a caller says about a message to the owner. All optional: a bare
  *  message on an owner channel is a notice keyed by its text. */
 interface TellMeta {
@@ -17577,6 +17830,20 @@ interface ToldRow {
     text: string;
     outcome: TellOutcome;
     digestedAt: number | null;
+    /** Sent as urgent: the reach ladder may send it once more (reach.ts). */
+    urgent: boolean;
+    /** When the owner saw it, and how ("phone", "desk", "reply"). */
+    seenAt: number | null;
+    seenVia: string | null;
+    /** When the owner answered it, and how ("reply", "desk", "card"). */
+    answeredAt: number | null;
+    answeredVia: string | null;
+    /** When it was sent on to the next channel, unseen. */
+    escalatedAt: number | null;
+    /** On an escalation: the row it carries on. */
+    escalationOf: number | null;
+    /** sent → seen → answered, for a row that went out. */
+    state: TellState;
 }
 interface TellSettings {
     enabled: boolean;
@@ -17588,10 +17855,16 @@ interface TellSettings {
      *  sent at once, or it would never reach anyone. Unset: true. */
     digestAvailable?: boolean;
 }
+/** The fields a new row is written with. */
+type NewToldRow = Omit<ToldRow, "id" | "digestedAt" | "urgent" | "seenAt" | "seenVia" | "answeredAt" | "answeredVia" | "escalatedAt" | "escalationOf" | "state"> & {
+    urgent?: boolean;
+    escalationOf?: number | null;
+};
 declare class ToldLedger {
     private db;
     constructor(db: Database.Database);
-    add(row: Omit<ToldRow, "id" | "digestedAt">): number;
+    add(row: NewToldRow): number;
+    get(id: number): ToldRow | null;
     setOutcome(id: number, outcome: TellOutcome): void;
     /** The last time this item reached the owner, or was put in the digest
      *  (unless `digest` is false: no digest will carry it), since `since`.
@@ -17605,6 +17878,9 @@ declare class ToldLedger {
     since(since: number, limit?: number): ToldRow[];
     /** How many of each outcome since `since`: the before/after figure. */
     counts(since: number): Record<TellOutcome, number>;
+    /** Of the rows that went out since `since` (sent, or held and sent
+     *  later): how many are still only sent, seen, answered (#1138 step B). */
+    states(since: number): Record<TellState, number>;
     /** Delete rows older than `before`. */
     prune(before: number): number;
 }
@@ -17642,6 +17918,7 @@ declare class OwnerGate {
      *  newest rows. */
     report(since: number, limit?: number): {
         counts: Record<TellOutcome, number>;
+        landed: Record<TellState, number>;
         waitingForDigest: number;
         items: ToldRow[];
     };
@@ -17808,6 +18085,21 @@ declare class MessageRouter {
          *  reply to a turn the registry just ran (A2A callbacks, #277). */
         recordInSession?: boolean;
     }): Promise<string | void>;
+    /** Channels switched off at runtime (POST /channels/<name>/switch),
+     *  with the reason. Until switched on or the daemon restarts. */
+    private switchedOff;
+    /** Switch a channel off (refused like a down one) or back on. */
+    setChannelSwitch(name: string, on: boolean, reason?: string): void;
+    /** Can a send to this channel go out now? */
+    channelHealth(name: string): {
+        up: boolean;
+        reason?: string;
+    };
+    /** Every registered channel's health, by name. */
+    channelsHealth(): Record<string, {
+        up: boolean;
+        reason?: string;
+    }>;
     /** List registered channel names. */
     getChannelNames(): string[];
     startAll(): Promise<void>;
@@ -18320,6 +18612,8 @@ declare class WhatsAppAdapter implements ChannelAdapter {
     private onStatus?;
     /** Fires once when the adapter stops reconnecting, so the owner hears about a silent channel. */
     private onGiveUp?;
+    /** The last connection update of the current socket. */
+    private connection;
     constructor(config: {
         sessionDir: string;
         defaultAgent?: string;
@@ -18350,6 +18644,13 @@ declare class WhatsAppAdapter implements ChannelAdapter {
     stop(): Promise<void>;
     private clearStableTimer;
     private resetReconnect;
+    /** Down without a socket, or once the connection closed and was not
+     *  reopened (#1138 step B). Connecting counts as up: a reconnect takes
+     *  seconds, and the watch only reports a channel down on two checks. */
+    health(): {
+        up: boolean;
+        reason?: string;
+    };
     send(msg: OutgoingMessage): Promise<string>;
     editMessage(chatId: string, messageId: string, text: string): Promise<boolean>;
     sendTyping(chatId: string): Promise<void>;