agentix-cli 0.130.0 → 0.132.0

package/dist/index.d.ts

@@ -3111,14 +3111,338 @@ declare const daemonConfigSchema: z.ZodObject<{
             /** `wiki query` also searches other agents' readable pages and the
              *  root wiki's own pages. */
             shared: z.ZodDefault<z.ZodBoolean>;
+            /** How pages are picked (#855). `summaries`: from the one-line page
+             *  summaries `agentx wiki summarize` writes, then a live read.
+             *  `catalog`: from titles, then a walk along the pages' links.
+             *  `auto`: `summaries` once summaries exist, `catalog` until then. */
+            method: z.ZodDefault<z.ZodEnum<["auto", "summaries", "catalog"]>>;
+            /** The agent's own pages shown to the model that picks. */
+            candidates: z.ZodDefault<z.ZodNumber>;
+            /** Other agents' pages shown beside them. */
+            sharedCandidates: z.ZodDefault<z.ZodNumber>;
+            /** Most pages opened for one answer. */
+            maxPages: z.ZodDefault<z.ZodNumber>;
+            /** Characters of each opened page given to the answer. */
+            pageChars: z.ZodDefault<z.ZodNumber>;
+            /** Model that picks pages from the summary lines. */
+            navigatorModel: z.ZodDefault<z.ZodString>;
+            /** Model that writes the answer. */
+            answerModel: z.ZodDefault<z.ZodString>;
+            /** Before the answer, confirm at the source what may have changed
+             *  since the pages were written. A model names the reads; code runs
+             *  them, and each is one HTTP GET. Nothing runs until `sources`
+             *  lists where to read. */
+            live: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                /** Most reads for one question. */
+                maxReads: z.ZodDefault<z.ZodNumber>;
+                /** Timeout of one read, in milliseconds. */
+                timeoutMs: z.ZodDefault<z.ZodNumber>;
+                /** Model that names the reads. */
+                plannerModel: z.ZodDefault<z.ZodString>;
+                sources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                    repos: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                        repo: z.ZodString;
+                        /** What lives there, shown to the model so it names the right one. */
+                        about: z.ZodOptional<z.ZodString>;
+                    }, "strip", z.ZodTypeAny, {
+                        repo: string;
+                        about?: string | undefined;
+                    }, {
+                        repo: string;
+                        about?: string | undefined;
+                    }>]>, "many">;
+                    /** Name of the environment variable that holds the token. */
+                    tokenEnv: z.ZodOptional<z.ZodString>;
+                    /** File whose first line is the token. */
+                    tokenFile: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"github">;
+                    apiUrl: z.ZodDefault<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "github";
+                    apiUrl: string;
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                }, {
+                    type: "github";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                    apiUrl?: string | undefined;
+                }>, z.ZodObject<{
+                    repos: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                        repo: z.ZodString;
+                        /** What lives there, shown to the model so it names the right one. */
+                        about: z.ZodOptional<z.ZodString>;
+                    }, "strip", z.ZodTypeAny, {
+                        repo: string;
+                        about?: string | undefined;
+                    }, {
+                        repo: string;
+                        about?: string | undefined;
+                    }>]>, "many">;
+                    /** Name of the environment variable that holds the token. */
+                    tokenEnv: z.ZodOptional<z.ZodString>;
+                    /** File whose first line is the token. */
+                    tokenFile: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"gitlab">;
+                    /** The GitLab host. Unset: `channels.gitlab.host`. */
+                    url: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                }, {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"agentx">;
+                    /** The daemon to ask. Unset: this node. */
+                    url: z.ZodOptional<z.ZodString>;
+                    /** Also ask each mesh peer the daemon lists. */
+                    peers: z.ZodDefault<z.ZodBoolean>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "agentx";
+                    peers: boolean;
+                    url?: string | undefined;
+                }, {
+                    type: "agentx";
+                    url?: string | undefined;
+                    peers?: boolean | undefined;
+                }>]>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                timeoutMs: number;
+                maxReads: number;
+                plannerModel: string;
+                sources: ({
+                    type: "github";
+                    apiUrl: string;
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    peers: boolean;
+                    url?: string | undefined;
+                })[];
+            }, {
+                enabled?: boolean | undefined;
+                timeoutMs?: number | undefined;
+                maxReads?: number | undefined;
+                plannerModel?: string | undefined;
+                sources?: ({
+                    type: "github";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                    apiUrl?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    url?: string | undefined;
+                    peers?: boolean | undefined;
+                })[] | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
+            method: "auto" | "summaries" | "catalog";
             shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            navigatorModel: string;
+            answerModel: string;
+            live: {
+                enabled: boolean;
+                timeoutMs: number;
+                maxReads: number;
+                plannerModel: string;
+                sources: ({
+                    type: "github";
+                    apiUrl: string;
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    peers: boolean;
+                    url?: string | undefined;
+                })[];
+            };
         }, {
+            method?: "auto" | "summaries" | "catalog" | undefined;
             shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
+            live?: {
+                enabled?: boolean | undefined;
+                timeoutMs?: number | undefined;
+                maxReads?: number | undefined;
+                plannerModel?: string | undefined;
+                sources?: ({
+                    type: "github";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                    apiUrl?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    url?: string | undefined;
+                    peers?: boolean | undefined;
+                })[] | undefined;
+            } | undefined;
+        }>>;
+        /** One-line page summaries `wiki query` picks pages from (#855). */
+        summaries: z.ZodDefault<z.ZodObject<{
+            model: z.ZodDefault<z.ZodString>;
+            /** Pages per model call. */
+            batchSize: z.ZodDefault<z.ZodNumber>;
+            /** Longest summary, in words. */
+            maxWords: z.ZodDefault<z.ZodNumber>;
+            /** When `agentx wiki summarize` runs on its own (cron, 5 fields).
+             *  Unset: no job is added. */
+            schedule: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodDefault<z.ZodString>;
+            /** Agent the job is filed under. Unset: `node.defaultAgent`, else
+             *  the first agent. */
+            agent: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model: string;
+            timezone: string;
+            batchSize: number;
+            maxWords: number;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+        }, {
+            model?: string | undefined;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+            timezone?: string | undefined;
+            batchSize?: number | undefined;
+            maxWords?: number | undefined;
+        }>>;
+        /** The chat bubble on every wiki page: the owner types an instruction and
+         *  an agent researches it and edits the open page. */
+        curator: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            /** Agent that answers. Unset: the page's owner agent. */
+            agent: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            agent?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            agent?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         query: {
+            method: "auto" | "summaries" | "catalog";
             shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            navigatorModel: string;
+            answerModel: string;
+            live: {
+                enabled: boolean;
+                timeoutMs: number;
+                maxReads: number;
+                plannerModel: string;
+                sources: ({
+                    type: "github";
+                    apiUrl: string;
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    peers: boolean;
+                    url?: string | undefined;
+                })[];
+            };
         };
         contributions: {
             model: string;
@@ -3127,9 +3451,57 @@ declare const daemonConfigSchema: z.ZodObject<{
             maxCostUsd: number;
             mergeSchedule: string;
         };
+        summaries: {
+            model: string;
+            timezone: string;
+            batchSize: number;
+            maxWords: number;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+        };
+        curator: {
+            enabled: boolean;
+            agent?: string | undefined;
+        };
     }, {
         query?: {
+            method?: "auto" | "summaries" | "catalog" | undefined;
             shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
+            live?: {
+                enabled?: boolean | undefined;
+                timeoutMs?: number | undefined;
+                maxReads?: number | undefined;
+                plannerModel?: string | undefined;
+                sources?: ({
+                    type: "github";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                    apiUrl?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    url?: string | undefined;
+                    peers?: boolean | undefined;
+                })[] | undefined;
+            } | undefined;
         } | undefined;
         contributions?: {
             model?: string | undefined;
@@ -3138,6 +3510,18 @@ declare const daemonConfigSchema: z.ZodObject<{
             maxCostUsd?: number | undefined;
             mergeSchedule?: string | undefined;
         } | undefined;
+        summaries?: {
+            model?: string | undefined;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+            timezone?: string | undefined;
+            batchSize?: number | undefined;
+            maxWords?: number | undefined;
+        } | undefined;
+        curator?: {
+            enabled?: boolean | undefined;
+            agent?: string | undefined;
+        } | undefined;
     }>>;
     channels: z.ZodDefault<z.ZodObject<{
         telegram: z.ZodDefault<z.ZodObject<{
@@ -5142,6 +5526,34 @@ declare const daemonConfigSchema: z.ZodObject<{
             windowMinutes?: number | undefined;
         } | undefined;
     }>>;
+    /** Stop and resume signals (agents/signals, #857): stop a running task
+     *  cleanly, keep the agent's resume plan, resume it later. The owner may
+     *  always signal; an agent may signal tasks it dispatched, or any task
+     *  when listed in allowAgents; a mesh peer only when listed in allowPeers. */
+    signals: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        /** How long the stopped agent gets to write its resume plan. Past it,
+         *  the wind-down is stopped and a plan is built from the trace. */
+        windDownSeconds: z.ZodDefault<z.ZodNumber>;
+        /** Agents that may stop or resume any agent's task here ("*" for all). */
+        allowAgents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Mesh peers (node names) whose stop and resume signals are accepted. */
+        allowPeers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Loop brake: most signals one root id may carry in a day. */
+        maxPerRoot: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        windDownSeconds: number;
+        allowAgents: string[];
+        allowPeers: string[];
+        maxPerRoot: number;
+    }, {
+        enabled?: boolean | undefined;
+        windDownSeconds?: number | undefined;
+        allowAgents?: string[] | undefined;
+        allowPeers?: string[] | undefined;
+        maxPerRoot?: number | undefined;
+    }>>;
     /** Open requests (src/requests, #356): what a person asked an agent for
      *  is recorded and followed until it is done, declined or dropped. Off
      *  by default. */
@@ -7641,7 +8053,43 @@ declare const daemonConfigSchema: z.ZodObject<{
     };
     wiki: {
         query: {
+            method: "auto" | "summaries" | "catalog";
             shared: boolean;
+            candidates: number;
+            sharedCandidates: number;
+            maxPages: number;
+            pageChars: number;
+            navigatorModel: string;
+            answerModel: string;
+            live: {
+                enabled: boolean;
+                timeoutMs: number;
+                maxReads: number;
+                plannerModel: string;
+                sources: ({
+                    type: "github";
+                    apiUrl: string;
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    peers: boolean;
+                    url?: string | undefined;
+                })[];
+            };
         };
         contributions: {
             model: string;
@@ -7650,6 +8098,18 @@ declare const daemonConfigSchema: z.ZodObject<{
             maxCostUsd: number;
             mergeSchedule: string;
         };
+        summaries: {
+            model: string;
+            timezone: string;
+            batchSize: number;
+            maxWords: number;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+        };
+        curator: {
+            enabled: boolean;
+            agent?: string | undefined;
+        };
     };
     app: {
         android: {
@@ -8088,6 +8548,13 @@ declare const daemonConfigSchema: z.ZodObject<{
         };
         drainTimeoutSeconds?: number | undefined;
     };
+    signals: {
+        enabled: boolean;
+        windDownSeconds: number;
+        allowAgents: string[];
+        allowPeers: string[];
+        maxPerRoot: number;
+    };
     people: {
         agents: string[];
         id: string;
@@ -8536,7 +9003,43 @@ declare const daemonConfigSchema: z.ZodObject<{
     } | undefined;
     wiki?: {
         query?: {
+            method?: "auto" | "summaries" | "catalog" | undefined;
             shared?: boolean | undefined;
+            candidates?: number | undefined;
+            sharedCandidates?: number | undefined;
+            maxPages?: number | undefined;
+            pageChars?: number | undefined;
+            navigatorModel?: string | undefined;
+            answerModel?: string | undefined;
+            live?: {
+                enabled?: boolean | undefined;
+                timeoutMs?: number | undefined;
+                maxReads?: number | undefined;
+                plannerModel?: string | undefined;
+                sources?: ({
+                    type: "github";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                    apiUrl?: string | undefined;
+                } | {
+                    type: "gitlab";
+                    repos: (string | {
+                        repo: string;
+                        about?: string | undefined;
+                    })[];
+                    url?: string | undefined;
+                    tokenEnv?: string | undefined;
+                    tokenFile?: string | undefined;
+                } | {
+                    type: "agentx";
+                    url?: string | undefined;
+                    peers?: boolean | undefined;
+                })[] | undefined;
+            } | undefined;
         } | undefined;
         contributions?: {
             model?: string | undefined;
@@ -8545,6 +9048,18 @@ declare const daemonConfigSchema: z.ZodObject<{
             maxCostUsd?: number | undefined;
             mergeSchedule?: string | undefined;
         } | undefined;
+        summaries?: {
+            model?: string | undefined;
+            agent?: string | undefined;
+            schedule?: string | undefined;
+            timezone?: string | undefined;
+            batchSize?: number | undefined;
+            maxWords?: number | undefined;
+        } | undefined;
+        curator?: {
+            enabled?: boolean | undefined;
+            agent?: string | undefined;
+        } | undefined;
     } | undefined;
     app?: {
         android?: {
@@ -9045,6 +9560,13 @@ declare const daemonConfigSchema: z.ZodObject<{
         } | undefined;
         drainTimeoutSeconds?: number | undefined;
     } | undefined;
+    signals?: {
+        enabled?: boolean | undefined;
+        windDownSeconds?: number | undefined;
+        allowAgents?: string[] | undefined;
+        allowPeers?: string[] | undefined;
+        maxPerRoot?: number | undefined;
+    } | undefined;
     people?: {
         id: string;
         name: string;
@@ -9722,6 +10244,8 @@ interface AgentXEvents {
         /** A daemon shutdown stopped the run. Its trace stays in flight so the
          *  next boot can resume it. */
         interrupted?: boolean;
+        /** Ended by a stop signal (agents/signals, #857): status `stopped`. */
+        stopped?: boolean;
         inputTokens?: number;
         outputTokens?: number;
         cacheReadTokens?: number;
@@ -9955,6 +10479,8 @@ declare class AgentXDaemon {
     private landscape;
     private heartbeat;
     private stopEventWaker?;
+    /** Stop and resume signals (agents/signals, #857). */
+    private signals;
     private business?;
     private httpServer?;
     private attachSweep?;
@@ -9977,6 +10503,8 @@ declare class AgentXDaemon {
     /** Watched WhatsApp chats (src/whatsapp-triage). Null without SQLite. */
     private waTriage;
     private assistantStore;
+    /** The chat bubble on wiki pages (#818). */
+    private wikiCurate;
     /** Workflow health for the monitor. Cached for a minute: the dashboard
      *  polls every 15s and dormancy does not change on that timescale. */
     private workflowHealth;
@@ -10043,6 +10571,12 @@ declare class AgentXDaemon {
     private bootTimes;
     /** Every start on record with who stopped the one before (boot-record.ts). */
     private bootLog;
+    /** The resumers that re-enter a run where it came from: used by the boot
+     *  resume pass and by resume signals (agents/signals, #857). */
+    private resumeCoordinatorInstance?;
+    private resumeCoordinator;
+    /** Stop a running task with a resume plan, and resume it later (#857). */
+    private createSignalService;
     /** Resume, report or skip each run the last restart cut off. Never throws. */
     private resumeInterruptedRuns;
     /**
@@ -10542,7 +11076,9 @@ interface FriendlyError {
     /** Optional next step the user can take. */
     fix?: string;
     /** Machine-readable error category for routing / retries. */
-    kind: "out_of_credits" | "overage_disabled" | "usage_cap" | "auth" | "permission" | "rate_limit" | "overloaded" | "context_too_large" | "invalid_request" | "upstream_api" | "timeout" | "cancelled" | "interrupted" | "unknown";
+    kind: "out_of_credits" | "overage_disabled" | "usage_cap" | "auth" | "permission" | "rate_limit" | "overloaded" | "context_too_large" | "invalid_request" | "upstream_api" | "timeout" | "cancelled" | "interrupted"
+    /** Ended by a stop signal; its resume plan is saved (#857). */
+     | "stopped" | "unknown";
     /** Whether this error is transient — a retry has a reasonable chance of succeeding. */
     retryable: boolean;
     /** Source error text retained for logs / debugging. */
@@ -10637,10 +11173,12 @@ interface IncomingMessage {
     runbookFiles?: string[];
     /** Set when this message re-runs one a restart cut off (agents/resume):
      *  the note for the agent, the attempt number, and the run it continues. */
+    /** `rootId`: a task resumed after a stop signal keeps its root (#857). */
     resume?: {
         note: string;
         attempt: number;
         resumedFrom: string;
+        rootId?: string;
     };
 }
 interface OutgoingMessage {
@@ -11501,6 +12039,8 @@ interface WikiStatement {
     status?: "proposed" | "confirmed";
     confirmed_by?: string;
     checked_at?: string;
+    /** The job that wrote it, e.g. "wiki-enrich"; its next run replaces it. */
+    by?: string;
     note?: string;
 }
 
@@ -12747,8 +13287,9 @@ interface TaskRecord {
     durationMs: number;
     ok: boolean;
     error?: string;
-    /** Set when a deadline ended the run: `timeout`, with the step it was in. */
-    status?: "timeout";
+    /** Set when a deadline ended the run: `timeout`, with the step it was in;
+     *  `stopped` when a stop signal ended it (#857). */
+    status?: "timeout" | "stopped";
     step?: string;
     /** Final agent text (one-shot, may be empty if streaming captured it). */
     responseText: string;
@@ -12827,6 +13368,10 @@ declare class AgentRegistry {
     private taskAborts;
     /** Runs a daemon shutdown stopped, with the reason each one reports. */
     private interruptedRuns;
+    /** Runs a stop signal ended, with the reason each one reports (#857). */
+    private stoppedRuns;
+    /** Callers waiting for a run to let go of its slot (whenRunEnds). */
+    private runEndWaiters;
     /** Claude cloud sessions this node launched (#622), by issue. Created on
      *  first use so a fleet with the setting off never touches the file. */
     private cloudSessions?;
@@ -13101,6 +13646,34 @@ declare class AgentRegistry {
         channel: string;
         chatId: string;
     } | null;
+    /**
+     * Stop signal (#857). Aborts the run like an operator stop, but it ends
+     * with status `stopped` and errorKind "stopped" instead of cancelled, so
+     * nothing reports it as a failure. False when no live run matches.
+     */
+    stopRunningTask(taskId: string, reason: string): boolean;
+    /** Resolves once the run `taskId` has let go of its slot (at once when it
+     *  is not running), or after `timeoutMs`. */
+    whenRunEnds(taskId: string, timeoutMs: number): Promise<void>;
+    /** A running task a stop signal can address: by its id, or the only run
+     *  of `agentId` on a chat. Null when none (or several) match. */
+    signalTarget(by: {
+        taskId?: string;
+        agentId?: string;
+        channel?: string;
+        chatId?: string;
+    }): {
+        taskId: string;
+        traceId?: string;
+        agentId: string;
+        channel: string;
+        chatId: string;
+        sender?: string;
+        rootId?: string;
+        originalMessage: string;
+        origin: RunOrigin | null;
+        workflowRunId?: string;
+    } | null;
     /**
      * Daemon shutdown: stop every run still going once the drain limit is
      * spent. Each one ends as `interrupted` with `reason` rather than as a
@@ -14082,6 +14655,7 @@ interface Resumer {
         run: InterruptedRun;
         note: string;
         attempt: number;
+        rootId?: string;
     }): Promise<void>;
     /** One line to the chat the run came from. */
     tell?(origin: RunOrigin, text: string): Promise<void>;