agentix-cli 0.131.0 → 0.132.0

package/dist/index.d.ts

@@ -5526,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. */
@@ -8520,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;
@@ -9525,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;
@@ -10202,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;
@@ -10435,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?;
@@ -10525,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;
     /**
@@ -11024,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. */
@@ -11119,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 {
@@ -13231,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;
@@ -13311,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?;
@@ -13585,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
@@ -14566,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>;

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a as St,b as kt,c as vt,d as xt,e as $t,f as Ct,g as Pt,h as bt,la as Tt,ma as Mt}from"./chunk-L4ZS4HGJ.js";import"./chunk-CL33CRH5.js";import"./chunk-GTJIKXDB.js";import"./chunk-E2VDBT3T.js";import"./chunk-S2GAEH2F.js";import"./chunk-7LN4VKDU.js";import"./chunk-IMLAPB7G.js";import"./chunk-ZVP6GB4G.js";import"./chunk-XGOBZCYC.js";import"./chunk-WCXXXAHV.js";import"./chunk-LQE73AZR.js";import"./chunk-2D3RYIDU.js";import"./chunk-MRIVENBY.js";import"./chunk-WEPON4FP.js";import"./chunk-AKLZ4YO2.js";import"./chunk-PPUN7YHA.js";import"./chunk-VZLIBDLH.js";import"./chunk-EKJG63EJ.js";import"./chunk-L4ALHWII.js";import"./chunk-2AXFYDWF.js";import"./chunk-AQASR6KR.js";import"./chunk-EMGB23H5.js";import"./chunk-JWDJMFU6.js";import"./chunk-GRMCAO3Q.js";import"./chunk-KZKDVIOE.js";import{ca as yt,m as lt,n as ct,o as dt,p as mt,q as pt}from"./chunk-VSL2SSBH.js";import"./chunk-YPCZ5TNK.js";import"./chunk-GLQLCBJS.js";import"./chunk-MEFPXHQJ.js";import{a as L}from"./chunk-UG2OF2EI.js";import{A as D,B as z,C as V,a as ye,b as we,c as Se,d as Ae,e as Ie,f as Oe,g as Ne,h as He,i as je,j as Ue,k as _e,l as I,m as q,n as Be,o as qe,p as Ye,q as O,r as ze,s as Ve,t as Xe,u as x,v as Y,w as Qe,x as Ze,y as et,z as wt}from"./chunk-B2Q3PTPS.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import"./chunk-Y4CYQV7G.js";import"./chunk-LLNPKE7H.js";import"./chunk-SHEUCITK.js";import"./chunk-6O6NW3ZG.js";import"./chunk-AFRHKA7B.js";import{s as ut}from"./chunk-KRK7OOTK.js";import"./chunk-YQRWUF4Y.js";import"./chunk-3UOTLMXD.js";import"./chunk-KA2UIZXG.js";import"./chunk-GQ76J72O.js";import"./chunk-J3SOEFRE.js";import"./chunk-SIU6STB2.js";import"./chunk-X5C5W3E4.js";import"./chunk-GV7S5BAX.js";import"./chunk-GSX4NK2N.js";import"./chunk-SZDACK6O.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-VWTBHLMX.js";import"./chunk-AKOXTIJS.js";import{a as ht}from"./chunk-YVR6652A.js";import"./chunk-JP5OAMWQ.js";import"./chunk-4VVHGR7H.js";import"./chunk-2SXF66O6.js";import"./chunk-2ZDV3DCT.js";import{f as gt,g as ft}from"./chunk-CSWGYSC4.js";import"./chunk-WPNRDEHW.js";import"./chunk-7VLLZQ3N.js";import"./chunk-BIJHMWXK.js";import"./chunk-36AXN6ZB.js";import"./chunk-ILEC3IAV.js";import"./chunk-ERNBJLIQ.js";import{j as it,k as rt,l as at}from"./chunk-IA7INHXY.js";import"./chunk-72SZI2UW.js";import"./chunk-FCPTN6NF.js";import"./chunk-MCI3DIWW.js";import"./chunk-MYVHVJWZ.js";import"./chunk-6TURWSMN.js";import"./chunk-AV7T3SYT.js";import"./chunk-Y5MFVVTM.js";import"./chunk-QD6IICK7.js";import"./chunk-QOYAX2FT.js";import{a as ke,b as ve,c as xe,d as $e,e as Ce,f as Pe,g as be,h as Te,i as Me,j as Re,l as Ee,m as Ge,o as T,p as W}from"./chunk-2PJKGZWP.js";import{a as m,b as G}from"./chunk-7I7IEX4S.js";import{b as Fe,c as Le,d as A,e as De}from"./chunk-JHCI6XCJ.js";import{a as Ke,b as Je,e as We}from"./chunk-DSYKYZMT.js";import{ma as tt,oa as st,pa as ot,wa as nt}from"./chunk-CBFBGN7J.js";import"./chunk-BRK6M6LA.js";import"./chunk-UIBUZ2N3.js";import"./chunk-2QNT5JDS.js";import"./chunk-RGDKHYY2.js";import"./chunk-QIJLFPWE.js";W();G();import{execa as Rt}from"execa";import{existsSync as se,promises as X}from"fs";import S from"path";import ie from"node-fetch";async function Et(o,e){let t=o.split("/");if(t.length<2)throw new Error(`Invalid skill package ID: ${o}. Expected format: owner/repo`);let s=t[0],i=t[1],n=t[2];try{let a=n?`${s}/${i}/${n}`:`${s}/${i}`;await Rt("npx",["-y","skills","add",a],{cwd:e,stdio:"pipe"}),m.success(`Installed skill package: ${o}`);let r=S.resolve(e,".skills",`${s}_${i}`);if(se(r))return await ne(r,o);let d=S.resolve(e,".skills");return se(d)?await ne(d,o):[]}catch{return m.info(`Fetching skills directly from GitHub: ${s}/${i}`),await Gt(s,i,n,e)}}async function Gt(o,e,t,s){let i=[];try{let n=`https://api.github.com/repos/${o}/${e}/git/trees/main?recursive=1`,a=await ie(n);if(!a.ok)throw new Error(`GitHub API error: ${a.status}`);let d=(await a.json()).tree.filter(p=>p.type==="blob"&&p.path.endsWith("SKILL.md"));if(t){let p=d.find(f=>f.path.includes(`/${t}/`)||f.path===`${t}/SKILL.md`);if(p){let f=await oe(o,e,p.path,s);f&&i.push(f)}}else for(let p of d){let f=await oe(o,e,p.path,s);f&&i.push(f)}}catch(n){m.error(`Failed to fetch skills from GitHub: ${n.message}`)}return i}async function oe(o,e,t,s){try{let i=`https://raw.githubusercontent.com/${o}/${e}/main/${t}`,n=await ie(i);if(!n.ok)return null;let a=await n.text(),r=A(a);if(r){r.source="remote",r.packageId=`${o}/${e}`;let d=S.dirname(t),p=S.resolve(s,".skills",`${o}_${e}`,d);await X.mkdir(p,{recursive:!0}),await X.writeFile(S.resolve(p,"SKILL.md"),a),r.path=S.resolve(p,"SKILL.md")}return r}catch{return null}}async function ne(o,e){let t=[],{default:s}=await import("fast-glob"),i=await s.glob("**/SKILL.md",{cwd:o,deep:5});for(let n of i)try{let a=S.resolve(o,n),r=await X.readFile(a,"utf8"),d=A(r);d&&(d.source="remote",d.path=a,d.packageId=e,t.push(d))}catch{}return t}async function At(o,e,t,s,i){let n=["---",`name: ${o}`,`description: ${e}`];if(s?.length){n.push("tags:");for(let a of s)n.push(`  - ${a}`)}if(i?.length){n.push("globs:");for(let a of i)n.push(`  - ${a}`)}return n.push("---"),`${n.join(`
+import{a as St,b as kt,c as vt,d as xt,e as $t,f as Ct,g as Pt,h as bt,la as Tt,ma as Mt}from"./chunk-62NXS7PT.js";import"./chunk-3K35L73A.js";import"./chunk-GTJIKXDB.js";import"./chunk-UDMI4TYM.js";import"./chunk-S2GAEH2F.js";import"./chunk-7LN4VKDU.js";import"./chunk-IMLAPB7G.js";import"./chunk-ZVP6GB4G.js";import"./chunk-XGOBZCYC.js";import"./chunk-WCXXXAHV.js";import"./chunk-LQE73AZR.js";import"./chunk-2D3RYIDU.js";import"./chunk-MRIVENBY.js";import"./chunk-WEPON4FP.js";import"./chunk-AKLZ4YO2.js";import"./chunk-PPUN7YHA.js";import"./chunk-VZLIBDLH.js";import"./chunk-EKJG63EJ.js";import"./chunk-3WYLK3SX.js";import"./chunk-2AXFYDWF.js";import"./chunk-AQASR6KR.js";import"./chunk-EMGB23H5.js";import"./chunk-JWDJMFU6.js";import"./chunk-GRMCAO3Q.js";import"./chunk-KZKDVIOE.js";import{ca as yt,m as lt,n as ct,o as dt,p as mt,q as pt}from"./chunk-7D3RJSN4.js";import"./chunk-RH3J4LCP.js";import"./chunk-QSKG754X.js";import"./chunk-MEFPXHQJ.js";import{a as L}from"./chunk-UG2OF2EI.js";import{A as D,B as z,C as V,a as ye,b as we,c as Se,d as Ae,e as Ie,f as Oe,g as Ne,h as He,i as je,j as Ue,k as _e,l as I,m as q,n as Be,o as qe,p as Ye,q as O,r as ze,s as Ve,t as Xe,u as x,v as Y,w as Qe,x as Ze,y as et,z as wt}from"./chunk-XWVBLISN.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import"./chunk-Y4CYQV7G.js";import"./chunk-LLNPKE7H.js";import"./chunk-SHEUCITK.js";import"./chunk-QNKSRROH.js";import"./chunk-AFRHKA7B.js";import{s as ut}from"./chunk-MDGYSHO5.js";import"./chunk-KDQI5S7F.js";import"./chunk-3UOTLMXD.js";import"./chunk-KA2UIZXG.js";import"./chunk-GQ76J72O.js";import"./chunk-J3SOEFRE.js";import"./chunk-SIU6STB2.js";import"./chunk-X5C5W3E4.js";import"./chunk-GV7S5BAX.js";import"./chunk-GSX4NK2N.js";import"./chunk-SZDACK6O.js";import"./chunk-HF5EF335.js";import"./chunk-W4YR2RO2.js";import"./chunk-VWTBHLMX.js";import"./chunk-VCQVF44A.js";import{a as ht}from"./chunk-74LPAKQY.js";import"./chunk-JP5OAMWQ.js";import"./chunk-4VVHGR7H.js";import"./chunk-EQ33PFXP.js";import"./chunk-2ZDV3DCT.js";import{f as gt,g as ft}from"./chunk-ZG4G6BFP.js";import"./chunk-WPNRDEHW.js";import"./chunk-7VLLZQ3N.js";import"./chunk-BIJHMWXK.js";import"./chunk-36AXN6ZB.js";import"./chunk-ILEC3IAV.js";import"./chunk-KQH4LPYC.js";import{j as it,k as rt,l as at}from"./chunk-724IBN5Y.js";import"./chunk-72SZI2UW.js";import"./chunk-FCPTN6NF.js";import"./chunk-MCI3DIWW.js";import"./chunk-MYVHVJWZ.js";import"./chunk-6TURWSMN.js";import"./chunk-AV7T3SYT.js";import"./chunk-Y5MFVVTM.js";import"./chunk-QD6IICK7.js";import"./chunk-QOYAX2FT.js";import{a as ke,b as ve,c as xe,d as $e,e as Ce,f as Pe,g as be,h as Te,i as Me,j as Re,l as Ee,m as Ge,o as T,p as W}from"./chunk-2PJKGZWP.js";import{a as m,b as G}from"./chunk-7I7IEX4S.js";import{b as Fe,c as Le,d as A,e as De}from"./chunk-JHCI6XCJ.js";import{a as Ke,b as Je,e as We}from"./chunk-DSYKYZMT.js";import{ma as tt,oa as st,pa as ot,wa as nt}from"./chunk-S2RRPTS3.js";import"./chunk-BRK6M6LA.js";import"./chunk-UIBUZ2N3.js";import"./chunk-2QNT5JDS.js";import"./chunk-RGDKHYY2.js";import"./chunk-QIJLFPWE.js";W();G();import{execa as Rt}from"execa";import{existsSync as se,promises as X}from"fs";import S from"path";import ie from"node-fetch";async function Et(o,e){let t=o.split("/");if(t.length<2)throw new Error(`Invalid skill package ID: ${o}. Expected format: owner/repo`);let s=t[0],i=t[1],n=t[2];try{let a=n?`${s}/${i}/${n}`:`${s}/${i}`;await Rt("npx",["-y","skills","add",a],{cwd:e,stdio:"pipe"}),m.success(`Installed skill package: ${o}`);let r=S.resolve(e,".skills",`${s}_${i}`);if(se(r))return await ne(r,o);let d=S.resolve(e,".skills");return se(d)?await ne(d,o):[]}catch{return m.info(`Fetching skills directly from GitHub: ${s}/${i}`),await Gt(s,i,n,e)}}async function Gt(o,e,t,s){let i=[];try{let n=`https://api.github.com/repos/${o}/${e}/git/trees/main?recursive=1`,a=await ie(n);if(!a.ok)throw new Error(`GitHub API error: ${a.status}`);let d=(await a.json()).tree.filter(p=>p.type==="blob"&&p.path.endsWith("SKILL.md"));if(t){let p=d.find(f=>f.path.includes(`/${t}/`)||f.path===`${t}/SKILL.md`);if(p){let f=await oe(o,e,p.path,s);f&&i.push(f)}}else for(let p of d){let f=await oe(o,e,p.path,s);f&&i.push(f)}}catch(n){m.error(`Failed to fetch skills from GitHub: ${n.message}`)}return i}async function oe(o,e,t,s){try{let i=`https://raw.githubusercontent.com/${o}/${e}/main/${t}`,n=await ie(i);if(!n.ok)return null;let a=await n.text(),r=A(a);if(r){r.source="remote",r.packageId=`${o}/${e}`;let d=S.dirname(t),p=S.resolve(s,".skills",`${o}_${e}`,d);await X.mkdir(p,{recursive:!0}),await X.writeFile(S.resolve(p,"SKILL.md"),a),r.path=S.resolve(p,"SKILL.md")}return r}catch{return null}}async function ne(o,e){let t=[],{default:s}=await import("fast-glob"),i=await s.glob("**/SKILL.md",{cwd:o,deep:5});for(let n of i)try{let a=S.resolve(o,n),r=await X.readFile(a,"utf8"),d=A(r);d&&(d.source="remote",d.path=a,d.packageId=e,t.push(d))}catch{}return t}async function At(o,e,t,s,i){let n=["---",`name: ${o}`,`description: ${e}`];if(s?.length){n.push("tags:");for(let a of s)n.push(`  - ${a}`)}if(i?.length){n.push("globs:");for(let a of i)n.push(`  - ${a}`)}return n.push("---"),`${n.join(`
 `)}
 
 ${t}`}async function It(o){let{loadLocalSkills:e}=await import("./loader-YFVSSYSL.js");return e(o)}async function Ot(o,e,t,s,i){let a=[{role:"system",content:`You are a skill author for the Agent Skills ecosystem (skills.sh).