agentix-cli 0.14.0 → 0.15.0

package/dist/{compaction-7I3E5QUO.js → compaction-JBZZ7I7Y.js}

@@ -1,4 +1,4 @@
-import{a as h}from"./chunk-QOYAX2FT.js";import"./chunk-4YCH6IZV.js";import{readFileSync as O,writeFileSync as k,existsSync as S,mkdirSync as E}from"fs";import{resolve as g}from"path";function f(t,o){let n=new Map;for(let r of t){if(r.role!=="agent")continue;let s=h(r.content);for(let a of s)n.set(a,(n.get(a)||0)+1)}let e=[...n.entries()].sort((r,s)=>s[1]-r[1]).slice(0,50).map(([r])=>r);return{lexicon:n,toolCalls:o||[],topKeywords:e,capturedAt:new Date().toISOString(),messageCount:t.length}}function y(t,o){let n=D(t,o),{distance:e,newTools:r,missingTools:s}=T(t,o),a=b(t,o),c=Math.min(1,n*.4+e*.3+a*.3),m=t.topKeywords.filter(l=>!o.lexicon.has(l)||(o.lexicon.get(l)||0)===0).slice(0,10);return{overallScore:Math.round(c*100)/100,lexiconDecay:Math.round(n*100)/100,toolShift:Math.round(e*100)/100,semanticDrift:Math.round(a*100)/100,lostWords:m,newTools:r,missingTools:s}}function D(t,o){if(t.topKeywords.length===0)return 0;let n=0;for(let e of t.topKeywords)o.lexicon.has(e)||n++;return n/t.topKeywords.length}function T(t,o){let n=new Set(t.toolCalls),e=new Set(o.toolCalls);if(n.size===0&&e.size===0)return{distance:0,newTools:[],missingTools:[]};let r=[...n].filter(u=>e.has(u)),s=new Set([...n,...e]),c=1-r.length/s.size,m=[...e].filter(u=>!n.has(u)),l=[...n].filter(u=>!e.has(u));return{distance:c,newTools:m,missingTools:l}}function b(t,o){if(t.topKeywords.length===0)return 0;let n=new Set(o.topKeywords),e=0;for(let r of t.topKeywords)n.has(r)&&e++;return 1-e/t.topKeywords.length}var w=".agentx/drift";function C(t,o,n=process.cwd()){let e=g(n,w);S(e)||E(e,{recursive:!0});let r={...o,lexicon:Object.fromEntries(o.lexicon)};k(g(e,`${t}.json`),JSON.stringify(r,null,2))}function M(t,o=process.cwd()){let n=g(o,w,`${t}.json`);if(!S(n))return null;try{let e=JSON.parse(O(n,"utf-8"));return{...e,lexicon:new Map(Object.entries(e.lexicon))}}catch{return null}}var I="claude-haiku-4-20250514";var R=1e4,A=6,v=8,K=`You are a conversation summarizer. Given a conversation history between a user and an AI agent, produce a concise summary that preserves:
+import{a as h}from"./chunk-QOYAX2FT.js";import"./chunk-FIOB3MEX.js";import{readFileSync as O,writeFileSync as k,existsSync as S,mkdirSync as E}from"fs";import{resolve as g}from"path";function f(t,o){let n=new Map;for(let r of t){if(r.role!=="agent")continue;let s=h(r.content);for(let a of s)n.set(a,(n.get(a)||0)+1)}let e=[...n.entries()].sort((r,s)=>s[1]-r[1]).slice(0,50).map(([r])=>r);return{lexicon:n,toolCalls:o||[],topKeywords:e,capturedAt:new Date().toISOString(),messageCount:t.length}}function y(t,o){let n=D(t,o),{distance:e,newTools:r,missingTools:s}=T(t,o),a=b(t,o),c=Math.min(1,n*.4+e*.3+a*.3),m=t.topKeywords.filter(l=>!o.lexicon.has(l)||(o.lexicon.get(l)||0)===0).slice(0,10);return{overallScore:Math.round(c*100)/100,lexiconDecay:Math.round(n*100)/100,toolShift:Math.round(e*100)/100,semanticDrift:Math.round(a*100)/100,lostWords:m,newTools:r,missingTools:s}}function D(t,o){if(t.topKeywords.length===0)return 0;let n=0;for(let e of t.topKeywords)o.lexicon.has(e)||n++;return n/t.topKeywords.length}function T(t,o){let n=new Set(t.toolCalls),e=new Set(o.toolCalls);if(n.size===0&&e.size===0)return{distance:0,newTools:[],missingTools:[]};let r=[...n].filter(u=>e.has(u)),s=new Set([...n,...e]),c=1-r.length/s.size,m=[...e].filter(u=>!n.has(u)),l=[...n].filter(u=>!e.has(u));return{distance:c,newTools:m,missingTools:l}}function b(t,o){if(t.topKeywords.length===0)return 0;let n=new Set(o.topKeywords),e=0;for(let r of t.topKeywords)n.has(r)&&e++;return 1-e/t.topKeywords.length}var w=".agentx/drift";function C(t,o,n=process.cwd()){let e=g(n,w);S(e)||E(e,{recursive:!0});let r={...o,lexicon:Object.fromEntries(o.lexicon)};k(g(e,`${t}.json`),JSON.stringify(r,null,2))}function M(t,o=process.cwd()){let n=g(o,w,`${t}.json`);if(!S(n))return null;try{let e=JSON.parse(O(n,"utf-8"));return{...e,lexicon:new Map(Object.entries(e.lexicon))}}catch{return null}}var I="claude-haiku-4-20250514";var R=1e4,A=6,v=8,K=`You are a conversation summarizer. Given a conversation history between a user and an AI agent, produce a concise summary that preserves:
 
 1. Key decisions made and their reasoning
 2. Important facts learned (names, IDs, paths, URLs, credentials shared)
@@ -17,12 +17,12 @@ Format as a structured summary:
 Keep it under 500 words. Prioritize actionable information over conversational flow.
 Do NOT include greetings, acknowledgments, or meta-commentary about the conversation.`;function U(t){return t.length<v?!1:t.reduce((n,e)=>n+e.content.length,0)>R}async function G(t,o,n){if(t.length<v)return{summary:"",compactedCount:0,keptCount:t.length,memoryFlushed:!1};let e=Math.max(0,t.length-A),r=t.slice(0,e),s=t.slice(e);if(r.length===0)return{summary:"",compactedCount:0,keptCount:s.length,memoryFlushed:!1};let a=f(r);C(o,a);let c=!1;if(n)try{await $(o,r,n),c=!0}catch{}let m=j(r),l=await z(m),{qualityScore:u,lostEntities:i}=P(m,l),p,F=[{role:"agent",content:l,timestamp:new Date().toISOString()}],x=f(F),d=M(o);return d&&(p=y(d,x)),{summary:l,compactedCount:r.length,keptCount:s.length,memoryFlushed:c,qualityScore:u,lostEntities:i.length>0?i:void 0,drift:p&&p.overallScore>.1?p:void 0}}function P(t,o){let n=B(t);if(n.length===0)return{qualityScore:100,lostEntities:[]};let e=o.toLowerCase(),r=[],s=[];for(let c of n)e.includes(c.toLowerCase())?r.push(c):s.push(c);return{qualityScore:Math.round(r.length/n.length*100),lostEntities:s}}function B(t){let o=[],n=new Set,e=i=>{let p=i.toLowerCase().trim();p.length<3||n.has(p)||(n.add(p),o.push(i.trim()))},r=t.match(/https?:\/\/[^\s<>)"]+/g)||[];for(let i of r)e(i.slice(0,80));let s=t.match(/(?:\/[\w.-]+){2,}/g)||[];for(let i of s)e(i);let a=t.match(/[#!]\d{2,}/g)||[];for(let i of a)e(i);let c=t.match(/[\w.-]+@[\w.-]+\.\w+/g)||[];for(let i of c)e(i);let m=t.match(/"([^"]{3,40})"/g)||[];for(let i of m)e(i.slice(1,-1));let l=t.match(/[A-Z][a-z]+(?:\s+[A-Z][a-z]+)+/g)||[];for(let i of l)e(i);let u=t.match(/[a-f0-9]{8,}/gi)||[];for(let i of u.slice(0,5))e(i);return o.slice(0,30)}function J(t,o){if(o.compactedCount===0)return t;let n=t.slice(-o.keptCount);return[{role:"agent",name:"system",content:`[Compacted conversation summary \u2014 ${o.compactedCount} earlier messages]
 
-${o.summary}`,timestamp:new Date().toISOString()},...n]}async function $(t,o,n){let e=[],r=[];for(let a of o)a.role==="user"?e.push(`${a.name||"User"}: ${a.content}`):r.push(a.content);if(e.length===0||r.length===0)return;let{extractMemories:s}=await import("./memory-extract-RGPUPMKU.js");await s(t,e.join(`
+${o.summary}`,timestamp:new Date().toISOString()},...n]}async function $(t,o,n){let e=[],r=[];for(let a of o)a.role==="user"?e.push(`${a.name||"User"}: ${a.content}`):r.push(a.content);if(e.length===0||r.length===0)return;let{extractMemories:s}=await import("./memory-extract-AD7KMRPC.js");await s(t,e.join(`
 `),r.join(`
 `),{channel:"compaction",chatId:"flush",sender:"compaction"},n)}function j(t){return t.map(o=>{let n=o.timestamp.slice(11,16),e=o.role==="user"?o.name||"User":o.name||"Agent";return`[${n}] ${e}: ${o.content}`}).join(`
 
-`)}async function z(t){let n=t.length>2e4?t.slice(-2e4):t;try{let{createProvider:e}=await import("./providers-G3WZ4RVJ.js");return(await e("claude").generate([{role:"system",content:K},{role:"user",content:n}],{model:I,maxTokens:1024})).content.trim()}catch{let s=t.split(`
+`)}async function z(t){let n=t.length>2e4?t.slice(-2e4):t;try{let{createProvider:e}=await import("./providers-VUIWO3ZK.js");return(await e("claude").generate([{role:"system",content:K},{role:"user",content:n}],{model:I,maxTokens:1024})).content.trim()}catch{let s=t.split(`
 `).slice(-20);return`[Summary unavailable \u2014 keeping last ${s.length} lines]
 ${s.join(`
 `)}`}}export{J as applyCompaction,G as compactSession,U as needsCompaction};
-//# sourceMappingURL=compaction-7I3E5QUO.js.map
+//# sourceMappingURL=compaction-JBZZ7I7Y.js.map

package/dist/config-DCJYECL4.js

@@ -0,0 +1,2 @@
+import{d as a,e as b,f as c,g as d,i as e}from"./chunk-B4Q4X7D5.js";import"./chunk-FIOB3MEX.js";e();export{a as daemonConfigSchema,b as expandEnvVars,c as loadDaemonConfig,d as validateWorkspaces};
+//# sourceMappingURL=config-DCJYECL4.js.map

package/dist/config-mutator-6EJHSP3Y.js

@@ -0,0 +1,2 @@
+import{a,b,c,d}from"./chunk-HLRVDCNH.js";import"./chunk-B4Q4X7D5.js";import"./chunk-FIOB3MEX.js";export{a as applyConfigMutation,c as getAtPath,b as setAtPath,d as unsetAtPath};
+//# sourceMappingURL=config-mutator-6EJHSP3Y.js.map

package/dist/debug-3MEUO2P2.js

@@ -0,0 +1,2 @@
+import{a,b,c,d,e}from"./chunk-DSYKYZMT.js";import"./chunk-FIOB3MEX.js";export{e as debug,d as getDebugLogs,c as getDebugState,b as isDebug,a as setDebug};
+//# sourceMappingURL=debug-3MEUO2P2.js.map

package/dist/{heal-OTGT5HHJ.js → heal-WKY5I4KB.js}

@@ -1,2 +1,2 @@
-import{a}from"./chunk-6MKAXEE5.js";import"./chunk-SFQUP3BP.js";import"./chunk-KXZMYLHQ.js";import"./chunk-M7HKBG3V.js";import"./chunk-4YCH6IZV.js";export{a as HealEngine};
-//# sourceMappingURL=heal-OTGT5HHJ.js.map
+import{a}from"./chunk-6MKAXEE5.js";import"./chunk-SFQUP3BP.js";import"./chunk-KXZMYLHQ.js";import"./chunk-M7HKBG3V.js";import"./chunk-FIOB3MEX.js";export{a as HealEngine};
+//# sourceMappingURL=heal-WKY5I4KB.js.map

package/dist/index.d.ts

@@ -1311,6 +1311,11 @@ declare const agentConfigSchema: z.ZodObject<{
         channel?: string | undefined;
         intervalMinutes?: number | undefined;
     }>>;
+    /** Reachability via the external public API.
+     *   - "private" (default): this agent is daemon-internal + channel-bound only.
+     *   - "public": external apps can POST /api/public/agents/<id>/messages
+     *     with a scoped token (agent:<id> or agent:*). */
+    access: z.ZodDefault<z.ZodEnum<["private", "public"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     workspace: string;
@@ -1326,6 +1331,7 @@ declare const agentConfigSchema: z.ZodObject<{
         channel: string;
         intervalMinutes: number;
     };
+    access: "private" | "public";
     provider?: string | undefined;
     model?: string | undefined;
     systemPrompt?: string | undefined;
@@ -1347,6 +1353,7 @@ declare const agentConfigSchema: z.ZodObject<{
         channel?: string | undefined;
         intervalMinutes?: number | undefined;
     } | undefined;
+    access?: "private" | "public" | undefined;
 }>;
 declare const cronJobSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1480,6 +1487,11 @@ declare const daemonConfigSchema: z.ZodObject<{
             channel?: string | undefined;
             intervalMinutes?: number | undefined;
         }>>;
+        /** Reachability via the external public API.
+         *   - "private" (default): this agent is daemon-internal + channel-bound only.
+         *   - "public": external apps can POST /api/public/agents/<id>/messages
+         *     with a scoped token (agent:<id> or agent:*). */
+        access: z.ZodDefault<z.ZodEnum<["private", "public"]>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         workspace: string;
@@ -1495,6 +1507,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             channel: string;
             intervalMinutes: number;
         };
+        access: "private" | "public";
         provider?: string | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
@@ -1516,6 +1529,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             channel?: string | undefined;
             intervalMinutes?: number | undefined;
         } | undefined;
+        access?: "private" | "public" | undefined;
     }>>>;
     channels: z.ZodDefault<z.ZodObject<{
         telegram: z.ZodDefault<z.ZodObject<{
@@ -1613,6 +1627,24 @@ declare const daemonConfigSchema: z.ZodObject<{
             token?: string | undefined;
             agentBinding?: string | undefined;
         }>>;
+        slack: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            /** xoxb-... — bot user OAuth token from the Slack app's "OAuth & Permissions" tab. */
+            botToken: z.ZodOptional<z.ZodString>;
+            /** xapp-... — app-level token with connections:write scope (for Socket Mode). */
+            appToken: z.ZodOptional<z.ZodString>;
+            agentBinding: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        }>>;
         gitlab: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             webhookPort: z.ZodDefault<z.ZodNumber>;
@@ -1733,6 +1765,12 @@ declare const daemonConfigSchema: z.ZodObject<{
             token?: string | undefined;
             agentBinding?: string | undefined;
         };
+        slack: {
+            enabled: boolean;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        };
     }, {
         gitlab?: {
             enabled?: boolean | undefined;
@@ -1779,6 +1817,12 @@ declare const daemonConfigSchema: z.ZodObject<{
             token?: string | undefined;
             agentBinding?: string | undefined;
         } | undefined;
+        slack?: {
+            enabled?: boolean | undefined;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        } | undefined;
     }>>;
     crons: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -2362,15 +2406,21 @@ declare const daemonConfigSchema: z.ZodObject<{
         daemons: z.ZodDefault<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             url: z.ZodString;
+            dashboardUrl: z.ZodOptional<z.ZodString>;
             token: z.ZodOptional<z.ZodString>;
+            dashboardToken: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }, {
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }>, "many">>;
         draftAgent: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -2382,6 +2432,8 @@ declare const daemonConfigSchema: z.ZodObject<{
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }[];
         token?: string | undefined;
         draftAgent?: string | undefined;
@@ -2395,9 +2447,36 @@ declare const daemonConfigSchema: z.ZodObject<{
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }[] | undefined;
         draftAgent?: string | undefined;
     }>>;
+    /** Registered inbound webhooks — an inventory the dashboard manages. Each
+     *  entry binds an (agent, source) pair to an optional signing secret. The
+     *  actual inbound URL is always POST /webhook/<agentId>/<source>. */
+    webhooks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<["gitlab", "github", "sentry", "stripe", "discord", "slack", "custom"]>;
+        agentId: z.ZodString;
+        secretEnv: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        id: string;
+        source: "custom" | "gitlab" | "discord" | "slack" | "github" | "sentry" | "stripe";
+        agentId: string;
+        description?: string | undefined;
+        secretEnv?: string | undefined;
+    }, {
+        id: string;
+        source: "custom" | "gitlab" | "discord" | "slack" | "github" | "sentry" | "stripe";
+        agentId: string;
+        enabled?: boolean | undefined;
+        description?: string | undefined;
+        secretEnv?: string | undefined;
+    }>, "many">>;
     /** Session cache-reuse policy. `staleMinutes` controls how long a Claude
      *  session can idle before we rebuild the prompt from scratch (paying the
      *  full cache-create tax again). Longer is cheaper at Opus rates but means
@@ -2425,6 +2504,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             channel: string;
             intervalMinutes: number;
         };
+        access: "private" | "public";
         provider?: string | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
@@ -2499,6 +2579,12 @@ declare const daemonConfigSchema: z.ZodObject<{
             token?: string | undefined;
             agentBinding?: string | undefined;
         };
+        slack: {
+            enabled: boolean;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        };
     };
     crons: Record<string, {
         enabled: boolean;
@@ -2587,10 +2673,20 @@ declare const daemonConfigSchema: z.ZodObject<{
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }[];
         token?: string | undefined;
         draftAgent?: string | undefined;
     };
+    webhooks: {
+        enabled: boolean;
+        id: string;
+        source: "custom" | "gitlab" | "discord" | "slack" | "github" | "sentry" | "stripe";
+        agentId: string;
+        description?: string | undefined;
+        secretEnv?: string | undefined;
+    }[];
     session: {
         staleMinutes: number;
     };
@@ -2661,6 +2757,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             channel?: string | undefined;
             intervalMinutes?: number | undefined;
         } | undefined;
+        access?: "private" | "public" | undefined;
     }> | undefined;
     mesh?: {
         enabled?: boolean | undefined;
@@ -2726,6 +2823,12 @@ declare const daemonConfigSchema: z.ZodObject<{
             token?: string | undefined;
             agentBinding?: string | undefined;
         } | undefined;
+        slack?: {
+            enabled?: boolean | undefined;
+            agentBinding?: string | undefined;
+            botToken?: string | undefined;
+            appToken?: string | undefined;
+        } | undefined;
     } | undefined;
     crons?: Record<string, {
         agent: string;
@@ -2857,9 +2960,19 @@ declare const daemonConfigSchema: z.ZodObject<{
             name: string;
             url: string;
             token?: string | undefined;
+            dashboardUrl?: string | undefined;
+            dashboardToken?: string | undefined;
         }[] | undefined;
         draftAgent?: string | undefined;
     } | undefined;
+    webhooks?: {
+        id: string;
+        source: "custom" | "gitlab" | "discord" | "slack" | "github" | "sentry" | "stripe";
+        agentId: string;
+        enabled?: boolean | undefined;
+        description?: string | undefined;
+        secretEnv?: string | undefined;
+    }[] | undefined;
     session?: {
         staleMinutes?: number | undefined;
     } | undefined;
@@ -2974,6 +3087,12 @@ declare class AgentXDaemon {
      * GET /events — streams daemon logs in real-time.
      */
     private handleSSE;
+    /**
+     * Stream a single running task's live output as SSE.
+     * Sends a `start` event with the existing buffer (so a late opener catches up),
+     * then `chunk` events for every new delta, and `end` when the task finishes.
+     */
+    private handleTaskStream;
     private handleHttp;
     /**
      * OpenAI-compatible chat completions endpoint.
@@ -3245,7 +3364,7 @@ declare function executeOrchestrator(agent: AgentDef, task: AgentTask, apiKey?:
  */
 declare function executeTask(agent: AgentDef, task: AgentTask, providers: Record<string, {
     apiKey?: string;
-}>, onDelta?: StreamCallback, historyContext?: string, resumeSessionId?: string): Promise<AgentResponse>;
+}>, onDelta?: StreamCallback, historyContext?: string, resumeSessionId?: string, onEvent?: (event: any) => void): Promise<AgentResponse>;
 
 type WikiAccess = "private" | "shared" | "public";
 /**
@@ -3555,6 +3674,25 @@ interface RunningTask {
     /** Wall-clock start. */
     startedAt: Date;
 }
+type TaskOutputSubscriber = (chunk: string) => void;
+/** Persisted record of a finished task, written to .agentx/task-history. */
+interface TaskRecord {
+    id: string;
+    agentId: string;
+    channel: string;
+    chatId?: string;
+    sender?: string;
+    message: string;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    ok: boolean;
+    error?: string;
+    /** Final agent text (one-shot, may be empty if streaming captured it). */
+    responseText: string;
+    /** Terminal-style transcript captured from stream-json events. */
+    transcript: string;
+}
 declare class AgentRegistry {
     private agents;
     private config;
@@ -3569,6 +3707,12 @@ declare class AgentRegistry {
     private messageQueue;
     /** Active soul profile per agent+chat session: "agentId:channel:chatId" → profile name */
     private activeSouls;
+    /** Live output captured per running task id — drives the dashboard streaming modal. */
+    private taskOutputs;
+    /** Last completed task summary per agent — single-line blurb for the dashboard card. */
+    private lastSummaries;
+    /** 24-hour sparkline cache per agent — recomputed from disk at most once a minute. */
+    private sparklineCache;
     private log;
     constructor(config: DaemonConfig, log?: (...args: unknown[]) => void);
     /**
@@ -3625,7 +3769,57 @@ declare class AgentRegistry {
         errors: number;
         lastActive?: Date;
         runningTasks: RunningTask[];
+        lastSummary?: {
+            text: string;
+            at: string;
+            ok: boolean;
+        };
+        hourlyTasks?: number[];
     }>;
+    /**
+     * Write a finished task record to disk under .agentx/task-history/<agent>/<yyyy-mm-dd>/.
+     * Side-effects only — call sites should treat failure as best-effort.
+     */
+    private persistTaskRecord;
+    /**
+     * Compute a 24-hour hourly task-count sparkline for an agent from persisted
+     * history. Returns an array of 24 numbers: buckets[0] = 23-24h ago,
+     * buckets[23] = now-hour. Cached per-agent for 60s to keep snapshot load
+     * reasonable when the dashboard polls every 2s.
+     */
+    getHourlySparkline(agentId: string, hours?: number): number[];
+    /**
+     * Rebuild the in-memory lastSummaries cache from disk so dashboard cards
+     * show the most recent "what did they do" line even right after a restart.
+     * Called once on daemon startup — one file read per agent.
+     */
+    hydrateLastSummariesFromDisk(): number;
+    /**
+     * Drop history folders older than retention window. Cheap startup-time
+     * sweep — once a day is plenty, but doing it on every daemon boot is fine.
+     */
+    pruneTaskHistory(retentionDays?: number): number;
+    /**
+     * Newest-first list of task records for one agent, capped at `limit`.
+     * Walks at most the last few day folders so this is O(limit), not O(history).
+     */
+    listTaskHistory(agentId: string, limit?: number): Array<Omit<TaskRecord, "transcript" | "responseText">>;
+    /**
+     * Look up one task's full record (transcript included) across the retention window.
+     */
+    getTaskRecord(agentId: string, taskId: string): TaskRecord | null;
+    private safe;
+    /**
+     * Subscribe to live output for a running task. Returns the buffer that has
+     * accumulated so far plus an unsubscribe handle. If the task is unknown,
+     * returns null. If the task already finished, the subscriber is given the
+     * tail buffer and immediately ended.
+     */
+    subscribeToTaskOutput(taskId: string, sub: TaskOutputSubscriber): {
+        initial: string;
+        done: boolean;
+        unsubscribe: () => void;
+    } | null;
     /**
      * Get token usage summary.
      */
@@ -4359,6 +4553,8 @@ declare class MessageRouter {
     private readonly DEDUP_STORE_PATH;
     private dedupDirtyCount;
     private dedupSaveTimer?;
+    /** Crash-safe inflight log (see InflightLog class above). */
+    private inflight;
     constructor(registry: AgentRegistry, config: DaemonConfig, hooks?: HookRegistry, log?: (...args: unknown[]) => void);
     private loadDedupFromDisk;
     private scheduleDedupSave;
@@ -4381,6 +4577,12 @@ declare class MessageRouter {
     /** List registered channel names. */
     getChannelNames(): string[];
     startAll(): Promise<void>;
+    /**
+     * On startup, re-run any incoming message that was recorded as `start` but
+     * never got a matching `done` in the inflight log. Those are tasks the
+     * previous process committed to handling but crashed before completing.
+     */
+    private replayInflight;
     stopAll(): Promise<void>;
     /**
      * Returns true if this message id was processed within MESSAGE_ID_TTL_MS.
@@ -4388,6 +4590,9 @@ declare class MessageRouter {
      */
     private isDuplicateMessage;
     private handleMessage;
+    /** The actual processing body — split out so handleMessage can wrap it in
+     *  the inflight try/finally without drowning the happy path in indentation. */
+    private processResolvedMessage;
     private static readonly MAX_BOT_CHAIN_DEPTH;
     /**
      * Bot-to-bot conversation chain.
@@ -4502,11 +4707,18 @@ declare class WhatsAppAdapter implements ChannelAdapter {
     private generation;
     private sentMessageIds;
     private log;
+    /** Fires whenever the underlying WhatsApp socket emits a new QR or clears it.
+     *  Passing null means the session is now connected. */
+    private onQR?;
+    /** Fires whenever the connection state changes (connecting / open / close). */
+    private onStatus?;
     constructor(config: {
         sessionDir: string;
         defaultAgent?: string;
         allowFrom?: string[];
         routes?: WhatsAppRoute[];
+        onQR?: (qr: string | null) => void;
+        onStatus?: (status: "connecting" | "open" | "close", detail?: string) => void;
     }, log?: (...args: unknown[]) => void);
     /**
      * Resolve which agent handles a message based on routes.
@@ -4666,6 +4878,17 @@ declare const logger: {
 
 declare function handleError(error: unknown): void;
 
+/**
+ * Read the agentx-cli package.json so commands like --version work.
+ *
+ * Looks in three places, in order:
+ *   1. A package.json beside the compiled entry (dist/cli.js → ../package.json),
+ *      which is how npm-installed usage finds it.
+ *   2. A package.json in the CWD, which is what `pnpm dev` / `tsx src/cli.ts`
+ *      implicitly relies on.
+ *   3. A safe fallback so the CLI never crashes on a truly bare environment
+ *      (e.g. a fresh user running `agentx setup` from an empty temp dir).
+ */
 declare function getPackageInfo(): PackageJson;
 
 export { A2AClient, A2AMesh, A2AServer, A2AServerConfig, ALL_TOOL_NAMES, AgentCard, AgentConfig, AgentContext, AgentDef, AgentProvider, AgentRegistry, AgentResponse, AgentTask, AgentXDaemon, AgentXRuntime, AnthropicMessage, AuthConfig, BLOCKING_EVENTS, ChannelAdapter, ClaudeCodeProvider, ClaudeProvider, ContentBlock, ContextBuilder, CronJobDef, CronJobState, CronRunResult, CronScheduler, DaemonConfig, EnhanceConfig, EnhanceEngine, EnhanceResult, GenerateOptions, GenerateResult, GenerateStreamEvent, GeneratedFile, GenerationMessage, GenerationResult, GitCommitResult, GitDiffFile, GitLogEntry, GitManager, GitStatus, HOOK_EVENTS, HealConfig, HealEngine, HealResult, HookContext, HookDefinition, HookEvent, HookHandler, HookRegistry, HookResult, IncomingMessage, Memory, MemoryEntry, MemoryHierarchy, MemoryStore, MeshPeer, MessageRouter, MiddlewareFn, ModelUsage, OUTPUT_CONFIGS, OUTPUT_TYPES, OutgoingMessage, OutputConfig, OutputType, PERMISSION_MODES, PROVIDER_CAPABILITIES, PermissionAction, PermissionConfig, PermissionManager, PermissionMode, PermissionRule, Pipeline, PipelineRequest, PipelineResponse, ProjectSchemas, ProviderCapabilities, ProviderName, ProviderOptions, RawGenerationResult, ReplEngine, ReplOptions, RuntimeConfig, Session, StepUsage, StreamEvent, Task, TaskArtifact, TaskMessage, TaskState, TaskStatusUpdate, TechStack, TelegramAdapter, ToolCallInput, ToolExecutor, ToolExecutorOptions, ToolResult, UsageSummary, UsageTracker, WhatsAppAdapter, WikiAccess, WikiArticle, WikiArticleMeta, WikiEntry, WikiIndex, WikiStore, agentConfigSchema$1 as agentConfigSchema, checkCapabilities, createAgentContext, createProvider, createSession, daemonConfigSchema, debug, detectSchemas, detectTechStack, ensureCredentials, executeClaudeCode, executeOrchestrator, executeSdk, executeTask, exportSession, formatSchemas, formatTechStack, formatToolsForSystemPrompt, gatherContext7Docs, generate, generateSkill, generateSkillMd, generateStream, getAnthropicTools, getCommand, getLegacyTools, getPackageInfo, globalHooks, globalPermissions, globalTracker, handleError, installSkillPackage, isCommand, isDebug, listInstalledSkills, listSessions, loadAuthConfig, loadDaemonConfig, loadHooks, loadLatestSession, loadLocalSkills, loadProjectInstructions, loadSession, logger, matchSkillsToTask, outputTypeDescriptions, parseCommand, parseSkillContent, parseSkillFile, permissionConfigSchema, permissionModeSchema, registerCommand, resolveAtImports, resolveOutputType, resolveToken, runModelSetup, saveAuthConfig, saveSession, setDebug, startMcpServer, validateWorkspaces };