agentix-cli 0.29.0 → 0.31.0

package/dist/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import{a as s}from"./chunk-LNWX4MPX.js";import"./chunk-DI7FMCDK.js";import"./chunk-JKYMXLYL.js";import"./chunk-6F2IKJ2F.js";import"./chunk-UCQ2N3KO.js";import"./chunk-52ZPELD2.js";import"./chunk-GV7S5BAX.js";import"./chunk-GSX4NK2N.js";import"./chunk-SZDACK6O.js";import"./chunk-OTXDKKEU.js";import"./chunk-F6CNF7V3.js";import"./chunk-3QVOWDHZ.js";import"./chunk-IWMW5432.js";import"./chunk-ZVP6GB4G.js";import"./chunk-XPXO5K4L.js";import"./chunk-Z2Y24ETP.js";import"./chunk-4BR7D2OU.js";import"./chunk-M4AMWP3H.js";import"./chunk-UYSNGBDT.js";import"./chunk-SFQUP3BP.js";import"./chunk-3SCPRYJB.js";import"./chunk-I3SIXTJO.js";import"./chunk-67Q4DCPS.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import"./chunk-4KXBUORV.js";import"./chunk-SC5DIKBB.js";import"./chunk-AE2LDMZU.js";import"./chunk-77OV7346.js";import"./chunk-VWTBHLMX.js";import"./chunk-SBCZLZG3.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-JIOLJIBM.js";import"./chunk-AJ5RMU7X.js";import"./chunk-EVWEG3VD.js";import"./chunk-F5AEXRPR.js";import"./chunk-AJONZWLT.js";import"./chunk-F4HZTZHW.js";import"./chunk-ZTEU5JVQ.js";import"./chunk-QOYAX2FT.js";import"./chunk-WPMX3VGI.js";import"./chunk-LCIREYTD.js";import"./chunk-L2WSPY6S.js";import"./chunk-VDMYBPYB.js";import"./chunk-DSYKYZMT.js";import"./chunk-GMNKJXTR.js";import"./chunk-BH3GTCZ6.js";import"./chunk-FIOB3MEX.js";process.on("SIGINT",()=>process.exit(0));process.on("SIGTERM",()=>process.exit(0));async function o(){let r=await s();if(process.argv.slice(2).length===0){r.outputHelp();return}r.parse()}o();
+import{a as s}from"./chunk-ZZQMR526.js";import"./chunk-2J3NV6RZ.js";import"./chunk-DLOYTMYZ.js";import"./chunk-NZ346QCV.js";import"./chunk-2TJ5L7CB.js";import"./chunk-7CVJ4JOE.js";import"./chunk-GV7S5BAX.js";import"./chunk-GSX4NK2N.js";import"./chunk-SZDACK6O.js";import"./chunk-7MNXKITO.js";import"./chunk-F6CNF7V3.js";import"./chunk-JV52UMCI.js";import"./chunk-V7FYSZSV.js";import"./chunk-ZVP6GB4G.js";import"./chunk-COOJI5SR.js";import"./chunk-7JWYLSFF.js";import"./chunk-VMDA2SX2.js";import"./chunk-QLTM3F7M.js";import"./chunk-R7WLFEW3.js";import"./chunk-JJIYFBDH.js";import"./chunk-SFQUP3BP.js";import"./chunk-3SCPRYJB.js";import"./chunk-WPMX3VGI.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import"./chunk-FFDXDUVQ.js";import"./chunk-UOGDSRG3.js";import"./chunk-DWADWDMU.js";import"./chunk-77OV7346.js";import"./chunk-VWTBHLMX.js";import"./chunk-6DD4DA2L.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-W6HKWISZ.js";import"./chunk-AJ5RMU7X.js";import"./chunk-EVWEG3VD.js";import"./chunk-JC6ZHSTY.js";import"./chunk-ZTEU5JVQ.js";import"./chunk-AJONZWLT.js";import"./chunk-F4HZTZHW.js";import"./chunk-QOYAX2FT.js";import"./chunk-LCIREYTD.js";import"./chunk-L2WSPY6S.js";import"./chunk-VDMYBPYB.js";import"./chunk-DSYKYZMT.js";import"./chunk-Z3RKXKE2.js";import"./chunk-BH3GTCZ6.js";import"./chunk-FIOB3MEX.js";process.on("SIGINT",()=>process.exit(0));process.on("SIGTERM",()=>process.exit(0));async function o(){let r=await s();if(process.argv.slice(2).length===0){r.outputHelp();return}r.parse()}o();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { buildProgram } from \"@/program\"\n\nprocess.on(\"SIGINT\", () => process.exit(0))\nprocess.on(\"SIGTERM\", () => process.exit(0))\n\nasync function main() {\n  const program = await buildProgram()\n\n  const args = process.argv.slice(2)\n  if (args.length === 0) {\n    program.outputHelp()\n    return\n  }\n\n  program.parse()\n}\n\nmain()\n"],"mappings":";g6CAGA,QAAQ,GAAG,SAAU,IAAM,QAAQ,KAAK,CAAC,CAAC,EAC1C,QAAQ,GAAG,UAAW,IAAM,QAAQ,KAAK,CAAC,CAAC,EAE3C,eAAeA,GAAO,CACpB,IAAMC,EAAU,MAAMC,EAAa,EAGnC,GADa,QAAQ,KAAK,MAAM,CAAC,EACxB,SAAW,EAAG,CACrBD,EAAQ,WAAW,EACnB,OAGFA,EAAQ,MAAM,CAChB,CAEAD,EAAK","names":["main","program","buildProgram"]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { buildProgram } from \"@/program\"\n\nprocess.on(\"SIGINT\", () => process.exit(0))\nprocess.on(\"SIGTERM\", () => process.exit(0))\n\nasync function main() {\n  const program = await buildProgram()\n\n  const args = process.argv.slice(2)\n  if (args.length === 0) {\n    program.outputHelp()\n    return\n  }\n\n  program.parse()\n}\n\nmain()\n"],"mappings":";o4CAGA,QAAQ,GAAG,SAAU,IAAM,QAAQ,KAAK,CAAC,CAAC,EAC1C,QAAQ,GAAG,UAAW,IAAM,QAAQ,KAAK,CAAC,CAAC,EAE3C,eAAeA,GAAO,CACpB,IAAMC,EAAU,MAAMC,EAAa,EAGnC,GADa,QAAQ,KAAK,MAAM,CAAC,EACxB,SAAW,EAAG,CACrBD,EAAQ,WAAW,EACnB,OAGFA,EAAQ,MAAM,CAChB,CAEAD,EAAK","names":["main","program","buildProgram"]}

package/dist/client-QALLJG62.js

@@ -0,0 +1,2 @@
+import{a,b,c,d,e,f,g}from"./chunk-2J3NV6RZ.js";import"./chunk-Z3RKXKE2.js";import"./chunk-FIOB3MEX.js";export{b as fetchAgents,d as fetchCrons,c as fetchProcesses,e as killProcess,a as resolveConn,f as sendTask,g as streamTask};
+//# sourceMappingURL=client-QALLJG62.js.map

package/dist/config-TNNODULV.js

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

package/dist/config-mutator-RI77M5YT.js

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

package/dist/doctor-DW27MR2T.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-DLOYTMYZ.js";import"./chunk-Z3RKXKE2.js";import"./chunk-FIOB3MEX.js";export{b as doctor,a as runDoctorChecks};
+//# sourceMappingURL=doctor-DW27MR2T.js.map

package/dist/index.d.ts

@@ -4244,6 +4244,10 @@ declare const daemonConfigSchema: z.ZodObject<{
              *  Setting this to 0 in active mode means the calibration report stops
              *  being trustworthy the day you promote the seat. */
             explore: z.ZodDefault<z.ZodNumber>;
+            /** Fraction of turns that bypass the seat as a randomized control group.
+             *  Unset lets the seat pick its own default; only seats that run an
+             *  experiment read it (today: request-gate, default 0.1). */
+            holdout: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             temperature: number;
             mode: "active" | "off" | "shadow";
@@ -4251,6 +4255,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             explore: number;
             model?: string | undefined;
             backend?: string | undefined;
+            holdout?: number | undefined;
         }, {
             model?: string | undefined;
             temperature?: number | undefined;
@@ -4258,6 +4263,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             mode?: "active" | "off" | "shadow" | undefined;
             timeoutMs?: number | undefined;
             explore?: number | undefined;
+            holdout?: number | undefined;
         }>>>>;
         /** Model routing driven by the task-tier seat. Models are scoped to their
          *  CLI engine; the legacy cheapModel applies only to Claude Code. */
@@ -4335,6 +4341,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             explore: number;
             model?: string | undefined;
             backend?: string | undefined;
+            holdout?: number | undefined;
         }>;
         routing: {
             cheapModel?: string | undefined;
@@ -4392,6 +4399,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             mode?: "active" | "off" | "shadow" | undefined;
             timeoutMs?: number | undefined;
             explore?: number | undefined;
+            holdout?: number | undefined;
         } | undefined> | undefined;
         routing?: {
             cheapModel?: string | undefined;
@@ -5061,6 +5069,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             explore: number;
             model?: string | undefined;
             backend?: string | undefined;
+            holdout?: number | undefined;
         }>;
         routing: {
             cheapModel?: string | undefined;
@@ -5628,6 +5637,7 @@ declare const daemonConfigSchema: z.ZodObject<{
             mode?: "active" | "off" | "shadow" | undefined;
             timeoutMs?: number | undefined;
             explore?: number | undefined;
+            holdout?: number | undefined;
         } | undefined> | undefined;
         routing?: {
             cheapModel?: string | undefined;
@@ -6079,6 +6089,13 @@ declare class AgentXDaemon {
      *  board-dashboard routes), but no transitions fire. */
     private bootWorkflowEngine;
     private startHttpApi;
+    /**
+     * Record an inbound dispatch in the intent ledger so the activity graph
+     * sees it. Shared by /task, /ask and /send/agent; `context.channel` is
+     * what the graph shows as the origin. Never throws — the legacy path
+     * stays authoritative, so a ledger failure only costs visibility.
+     */
+    private recordInboundDispatch;
     /**
      * Broadcast an SSE event to all connected clients.
      */
@@ -6375,6 +6392,159 @@ interface FriendlyError {
     raw?: string;
 }
 
+/**
+ * Verified channel context — facts the channel adapter knows for certain.
+ * Prevents agents from hallucinating about their environment.
+ */
+interface ChannelMeta {
+    /** Channel name */
+    channel: string;
+    /** Verified agents/bots present in this chat/group/project */
+    agents?: Array<{
+        id: string;
+        name: string;
+        handle?: string;
+    }>;
+    /** Project path (GitLab) or group topic */
+    project?: string;
+    /** Issue/MR context (GitLab) */
+    issue?: {
+        type: string;
+        iid: string;
+        title: string;
+    };
+    /** Channel-specific facts (e.g., pipeline status, group description) */
+    facts?: string[];
+}
+interface IncomingMessage {
+    id: string;
+    channel: string;
+    accountId: string;
+    sender: {
+        id: string;
+        name: string;
+        username?: string;
+        /** True when the origin is another bot account (Telegram `from.is_bot`).
+         *  Used by the router to apply strict @-mention-only routing — prevents
+         *  cross-daemon cascades from bare-word matches in bot replies. */
+        isBot?: boolean;
+    };
+    group?: {
+        id: string;
+        name: string;
+    };
+    text: string;
+    replyTo?: string;
+    replyToText?: string;
+    timestamp: Date;
+    media?: {
+        path: string;
+        type: string;
+        fileName?: string;
+    };
+    raw?: unknown;
+    resolvedAgent?: string;
+    preferNode?: string;
+    channelMeta?: ChannelMeta;
+    /** Correlator threaded by the workflow engine. When a workflow dispatches
+     *  an agent, this carries the run id through the pipeline so post:response
+     *  can re-enter the engine with `kind: agentResult` transitions. Opaque
+     *  everywhere outside src/workflows/. */
+    workflowRunId?: string;
+    /** Phase 1 / 6 — when set, identifies the intent-ledger decision row
+     *  this message corresponds to. The agent registry calls
+     *  `ledger.recordResolution(...)` when the dispatched task completes,
+     *  so Inv-ActiveTaskSafety's "decision in flight" check can clear.
+     *  Set by the channel adapter (gitlab, router) right after
+     *  recordGitLabTargetDispatch / recordRouterDispatch returns the
+     *  decision row. Undefined when the dispatch was deduped/halted by
+     *  the ledger (no resolution to write) or when the source is in
+     *  mode=off. */
+    intentRef?: {
+        eventId: string;
+        decidedBy: string;
+    };
+    /** Path to the project root whose runbook (CLAUDE.md / AGENTS.md / etc.)
+     *  the agent should consult for this task. Set by the gitlab/github
+     *  adapters when a project rule resolves a `runbook:` path. The agent
+     *  registry reads the file set into the cacheable system prefix.
+     *  Undefined when no rule matched — agent uses its own workspace's
+     *  CLAUDE.md as before. */
+    runbookPath?: string;
+    /** Override list of files the registry should read from runbookPath.
+     *  Carried alongside the path so per-project customisation applies
+     *  without the registry re-reading the rule. */
+    runbookFiles?: string[];
+}
+interface OutgoingMessage {
+    channel: string;
+    chatId: string;
+    text: string;
+    replyTo?: string;
+    parseMode?: "markdown" | "html" | "plain";
+    agentId?: string;
+    poll?: {
+        name: string;
+        values: string[];
+        selectableCount?: number;
+    };
+    media?: {
+        type: "image" | "document" | "audio" | "video";
+        url: string;
+        caption?: string;
+        mimetype?: string;
+        fileName?: string;
+    };
+    /** URL inline buttons (Phase 1). Telegram renders an inline_keyboard;
+     *  channels without button support ignore them. */
+    buttons?: Array<{
+        label: string;
+        url: string;
+    }>;
+}
+interface ChannelAdapter {
+    readonly name: string;
+    /** Start polling or webhook listener */
+    start(): Promise<void>;
+    /** Stop the adapter gracefully */
+    stop(): Promise<void>;
+    /** Send a message back to a chat */
+    send(msg: OutgoingMessage): Promise<string | void>;
+    /** Edit an existing message (returns false if not supported) */
+    editMessage?(chatId: string, messageId: string, text: string, parseMode?: string): Promise<boolean>;
+    /** Send typing/action indicator */
+    sendTyping?(chatId: string): Promise<void>;
+    /** React to a message with an emoji (e.g., 👀 for seen) */
+    react?(chatId: string, messageId: string, emoji?: string): Promise<void>;
+    /** Register handler for incoming messages */
+    onMessage(handler: (msg: IncomingMessage) => Promise<void>): void;
+    /** 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
+     *  session seeding. Called once per (agent, channel, chatId, day) when a
+     *  fresh session is created — never on warm cache hits. Bounded by
+     *  maxMessages and maxChars (enforced by the caller). Channels return their
+     *  own externalId so SessionStore can dedup against re-seeds. */
+    seedHistory?(chatId: string, opts: {
+        sinceISO?: string;
+        maxMessages: number;
+        maxChars: number;
+    }): Promise<Array<SeededMessage>>;
+}
+/** A message returned by seedHistory — flat, channel-agnostic. */
+interface SeededMessage {
+    role: "user" | "agent";
+    name: string;
+    content: string;
+    timestamp: string;
+    externalId?: string;
+    /** Optional channel-side account/bot identity that handled this message
+     *  (e.g., Telegram accountId "acme_cx_bot"). Captured by adapters that
+     *  shadow-log outbound, so seeded history preserves the audit trail of
+     *  which bot identity actually sent each line. Renderers may ignore it. */
+    accountId?: string;
+}
+
 interface AgentPeer {
     id: string;
     name: string;
@@ -6439,6 +6609,10 @@ interface AgentTask {
      *  that pattern without requiring callers to invent unique
      *  chatIds. */
     freshSession?: boolean;
+    /** Transcript held by a client that owns the conversation (OpenCode).
+     *  Seeds an empty AgentX session the same way a channel adapter's
+     *  seedHistory does, so a new or rotated session starts with it. */
+    seedHistory?: SeededMessage[];
     context?: {
         channel?: string;
         sender?: string;
@@ -6645,159 +6819,6 @@ declare class MemoryStore {
     prune(agentId: string): void;
 }
 
-/**
- * Verified channel context — facts the channel adapter knows for certain.
- * Prevents agents from hallucinating about their environment.
- */
-interface ChannelMeta {
-    /** Channel name */
-    channel: string;
-    /** Verified agents/bots present in this chat/group/project */
-    agents?: Array<{
-        id: string;
-        name: string;
-        handle?: string;
-    }>;
-    /** Project path (GitLab) or group topic */
-    project?: string;
-    /** Issue/MR context (GitLab) */
-    issue?: {
-        type: string;
-        iid: string;
-        title: string;
-    };
-    /** Channel-specific facts (e.g., pipeline status, group description) */
-    facts?: string[];
-}
-interface IncomingMessage {
-    id: string;
-    channel: string;
-    accountId: string;
-    sender: {
-        id: string;
-        name: string;
-        username?: string;
-        /** True when the origin is another bot account (Telegram `from.is_bot`).
-         *  Used by the router to apply strict @-mention-only routing — prevents
-         *  cross-daemon cascades from bare-word matches in bot replies. */
-        isBot?: boolean;
-    };
-    group?: {
-        id: string;
-        name: string;
-    };
-    text: string;
-    replyTo?: string;
-    replyToText?: string;
-    timestamp: Date;
-    media?: {
-        path: string;
-        type: string;
-        fileName?: string;
-    };
-    raw?: unknown;
-    resolvedAgent?: string;
-    preferNode?: string;
-    channelMeta?: ChannelMeta;
-    /** Correlator threaded by the workflow engine. When a workflow dispatches
-     *  an agent, this carries the run id through the pipeline so post:response
-     *  can re-enter the engine with `kind: agentResult` transitions. Opaque
-     *  everywhere outside src/workflows/. */
-    workflowRunId?: string;
-    /** Phase 1 / 6 — when set, identifies the intent-ledger decision row
-     *  this message corresponds to. The agent registry calls
-     *  `ledger.recordResolution(...)` when the dispatched task completes,
-     *  so Inv-ActiveTaskSafety's "decision in flight" check can clear.
-     *  Set by the channel adapter (gitlab, router) right after
-     *  recordGitLabTargetDispatch / recordRouterDispatch returns the
-     *  decision row. Undefined when the dispatch was deduped/halted by
-     *  the ledger (no resolution to write) or when the source is in
-     *  mode=off. */
-    intentRef?: {
-        eventId: string;
-        decidedBy: string;
-    };
-    /** Path to the project root whose runbook (CLAUDE.md / AGENTS.md / etc.)
-     *  the agent should consult for this task. Set by the gitlab/github
-     *  adapters when a project rule resolves a `runbook:` path. The agent
-     *  registry reads the file set into the cacheable system prefix.
-     *  Undefined when no rule matched — agent uses its own workspace's
-     *  CLAUDE.md as before. */
-    runbookPath?: string;
-    /** Override list of files the registry should read from runbookPath.
-     *  Carried alongside the path so per-project customisation applies
-     *  without the registry re-reading the rule. */
-    runbookFiles?: string[];
-}
-interface OutgoingMessage {
-    channel: string;
-    chatId: string;
-    text: string;
-    replyTo?: string;
-    parseMode?: "markdown" | "html" | "plain";
-    agentId?: string;
-    poll?: {
-        name: string;
-        values: string[];
-        selectableCount?: number;
-    };
-    media?: {
-        type: "image" | "document" | "audio" | "video";
-        url: string;
-        caption?: string;
-        mimetype?: string;
-        fileName?: string;
-    };
-    /** URL inline buttons (Phase 1). Telegram renders an inline_keyboard;
-     *  channels without button support ignore them. */
-    buttons?: Array<{
-        label: string;
-        url: string;
-    }>;
-}
-interface ChannelAdapter {
-    readonly name: string;
-    /** Start polling or webhook listener */
-    start(): Promise<void>;
-    /** Stop the adapter gracefully */
-    stop(): Promise<void>;
-    /** Send a message back to a chat */
-    send(msg: OutgoingMessage): Promise<string | void>;
-    /** Edit an existing message (returns false if not supported) */
-    editMessage?(chatId: string, messageId: string, text: string, parseMode?: string): Promise<boolean>;
-    /** Send typing/action indicator */
-    sendTyping?(chatId: string): Promise<void>;
-    /** React to a message with an emoji (e.g., 👀 for seen) */
-    react?(chatId: string, messageId: string, emoji?: string): Promise<void>;
-    /** Register handler for incoming messages */
-    onMessage(handler: (msg: IncomingMessage) => Promise<void>): void;
-    /** 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
-     *  session seeding. Called once per (agent, channel, chatId, day) when a
-     *  fresh session is created — never on warm cache hits. Bounded by
-     *  maxMessages and maxChars (enforced by the caller). Channels return their
-     *  own externalId so SessionStore can dedup against re-seeds. */
-    seedHistory?(chatId: string, opts: {
-        sinceISO?: string;
-        maxMessages: number;
-        maxChars: number;
-    }): Promise<Array<SeededMessage>>;
-}
-/** A message returned by seedHistory — flat, channel-agnostic. */
-interface SeededMessage {
-    role: "user" | "agent";
-    name: string;
-    content: string;
-    timestamp: string;
-    externalId?: string;
-    /** Optional channel-side account/bot identity that handled this message
-     *  (e.g., Telegram accountId "acme_cx_bot"). Captured by adapters that
-     *  shadow-log outbound, so seeded history preserves the audit trail of
-     *  which bot identity actually sent each line. Renderers may ignore it. */
-    accountId?: string;
-}
-
 interface SessionMessage {
     role: "user" | "agent";
     name?: string;
@@ -6880,10 +6901,12 @@ declare class SessionStore {
      *    - the session already has messages (warm cache or partially loaded)
      *    - no adapter resolver is installed
      *    - the channel adapter has no seedHistory method
+     *  Caller-supplied seeds (from a client that owns the transcript, such
+     *  as OpenCode) take the adapter's place.
      *  Concurrent calls against the same key share one in-flight promise so
      *  the channel API is hit exactly once per cold create. Errors are
      *  swallowed — a seeding failure should never block a turn. */
-    seedIfEmpty(agentId: string, channel: string, chatId: string): Promise<void>;
+    seedIfEmpty(agentId: string, channel: string, chatId: string, callerSeeds?: SeededMessage[]): Promise<void>;
     /** Append seeded messages to a session in chronological order, deduping
      *  by externalId against anything already present. Marks each entry with
      *  `seeded: true` so observers can distinguish them; the model's prompt
@@ -8493,7 +8516,7 @@ declare class AgentRegistry {
         byChannel: Record<string, {
             tasks: number;
             cost: number;
-        }>;
+        }>; /** Runtime handover store — shared with MessageRouter via file on disk. */
         sessionStats: Record<string, {
             sessions: number;
             avgTasksPerSession: number;

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a as L}from"./chunk-W5C2GDNC.js";import{B as bt,C as Tt,D as Mt,a as St,b as kt,c as vt,d as xt,e as $t,f as Ct,g as Pt}from"./chunk-OTXDKKEU.js";import"./chunk-F6CNF7V3.js";import"./chunk-3QVOWDHZ.js";import"./chunk-IWMW5432.js";import"./chunk-ZVP6GB4G.js";import{H as yt,f as lt,g as ct,h as dt,i as mt,j as pt}from"./chunk-XPXO5K4L.js";import"./chunk-Z2Y24ETP.js";import"./chunk-4BR7D2OU.js";import"./chunk-M4AMWP3H.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-UYSNGBDT.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import"./chunk-3SCPRYJB.js";import"./chunk-I3SIXTJO.js";import"./chunk-67Q4DCPS.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import{h as ut}from"./chunk-4KXBUORV.js";import"./chunk-SC5DIKBB.js";import"./chunk-AE2LDMZU.js";import"./chunk-77OV7346.js";import"./chunk-VWTBHLMX.js";import{a as gt,b as ft,e as ht}from"./chunk-SBCZLZG3.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-JIOLJIBM.js";import"./chunk-AJ5RMU7X.js";import"./chunk-EVWEG3VD.js";import{j as it,k as rt,l as at}from"./chunk-F5AEXRPR.js";import"./chunk-AJONZWLT.js";import"./chunk-F4HZTZHW.js";import"./chunk-ZTEU5JVQ.js";import"./chunk-QOYAX2FT.js";import"./chunk-WPMX3VGI.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-LCIREYTD.js";import{a as m,b as G}from"./chunk-L2WSPY6S.js";import{a as Fe,b as Le,c as A,d as De}from"./chunk-VDMYBPYB.js";import{a as Ke,b as Je,e as We}from"./chunk-DSYKYZMT.js";import{e as tt,g as st,h as ot,j as nt}from"./chunk-GMNKJXTR.js";import"./chunk-BH3GTCZ6.js";import"./chunk-FIOB3MEX.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 L}from"./chunk-W5C2GDNC.js";import{B as bt,C as Tt,D as Mt,a as St,b as kt,c as vt,d as xt,e as $t,f as Ct,g as Pt}from"./chunk-7MNXKITO.js";import"./chunk-F6CNF7V3.js";import"./chunk-JV52UMCI.js";import"./chunk-V7FYSZSV.js";import"./chunk-ZVP6GB4G.js";import{J as yt,h as lt,i as ct,j as dt,k as mt,l as pt}from"./chunk-COOJI5SR.js";import"./chunk-7JWYLSFF.js";import"./chunk-VMDA2SX2.js";import"./chunk-QLTM3F7M.js";import{h as ut}from"./chunk-R7WLFEW3.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-JJIYFBDH.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import"./chunk-3SCPRYJB.js";import"./chunk-WPMX3VGI.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import"./chunk-FFDXDUVQ.js";import"./chunk-UOGDSRG3.js";import"./chunk-DWADWDMU.js";import"./chunk-77OV7346.js";import"./chunk-VWTBHLMX.js";import{a as gt,b as ft,e as ht}from"./chunk-6DD4DA2L.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-W6HKWISZ.js";import"./chunk-AJ5RMU7X.js";import"./chunk-EVWEG3VD.js";import{j as it,k as rt,l as at}from"./chunk-JC6ZHSTY.js";import"./chunk-ZTEU5JVQ.js";import"./chunk-AJONZWLT.js";import"./chunk-F4HZTZHW.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-LCIREYTD.js";import{a as m,b as G}from"./chunk-L2WSPY6S.js";import{a as Fe,b as Le,c as A,d as De}from"./chunk-VDMYBPYB.js";import{a as Ke,b as Je,e as We}from"./chunk-DSYKYZMT.js";import{e as tt,g as st,h as ot,j as nt}from"./chunk-Z3RKXKE2.js";import"./chunk-BH3GTCZ6.js";import"./chunk-FIOB3MEX.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-BOKE5M5S.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).