agentix-cli 0.47.1 → 0.49.0

package/dist/failure-candidates-ARRMFXRY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wiki/failure-candidates.ts"],"sourcesContent":["import { createHash } from \"crypto\"\nimport type Database from \"better-sqlite3\"\nimport { getTrace, listTraces, type TraceRecord, type TraceStepRecord } from \"@/storage/traces\"\nimport type { MemoryCandidate } from \"./promote\"\n\n// Failed traces → wiki promotion candidates.\n//\n// Every other learning pass reads successes: the procedure miner loads\n// `status: ok` traces, and promotion reads memories an agent chose to\n// write. A tool that keeps failing, or the same wrong turn taken in\n// session after session, never reaches either — nothing in a failed run\n// is written down as a memory, and the miner never looks at it.\n//\n// This groups failed and timed-out traces by a failure signature (agent\n// + tool + outcome + error class) and offers only the signatures that recur across\n// several sessions to `wiki promote`. They join the same pool as memories\n// and monitor findings, so the judge, the ledger and the proposal review\n// are shared rather than rebuilt. One failure is session state; the same\n// failure in five sessions is something the fleet should know.\n\nexport const FAILURE_STAMP_PREFIX = \"failure:\"\nexport const DEFAULT_MIN_SESSIONS = 3\n/** Example runs kept per signature; the counts carry the rest. */\nexport const MAX_FAILURE_EXAMPLES = 5\n\n/** Trace statuses that count as a failure. `cancelled` does not: an\n *  operator or a daemon restart stopped the run, the agent did not fail. */\nconst FAILED_STATUSES = [\"error\", \"timeout\"]\n\n/** Chats a learning pass itself runs in. Learning from those would make\n *  the system learn from itself (same rule as the procedure miner). */\nconst SELF_CHAT_PREFIXES = [\"memory-promote\", \"procedure-miner\"]\n\nexport interface FailedTrace {\n  taskId: string\n  agentId: string\n  chatId: string | null\n  /** The session the run belongs to — the provider session when one is\n   *  known, else the run itself. See sessionOf(). */\n  sessionId: string\n  status: string\n  startedAt: number\n  error: string | null\n  messagePreview: string | null\n  /** The failing tool — see failingTool(); null when the run failed\n   *  before or outside any tool. */\n  tool: string | null\n}\n\nexport interface FailureCandidate extends MemoryCandidate {\n  /** Distinct sessions that hit this signature. */\n  occurrences: number\n  /** Some of those sessions, newest first. */\n  sessions: string[]\n  /** Some of the failed runs (task ids), newest first. */\n  tasks: string[]\n  failure: { tool: string; errorClass: string; runs: number }\n}\n\n/**\n * Reduce an error message to its class: the words that stay the same\n * when the same thing breaks again. Ids, numbers, paths, URLs and quoted\n * values change every time and would split one failure into many.\n */\nexport function errorClass(status: string, error: string | null): string {\n  const text = (error ?? \"\")\n    .toLowerCase()\n    .replace(/https?:\\/\\/\\S+/g, \"<url>\")\n    .replace(/([\"'`]).*?\\1/g, \"<v>\")\n    .replace(/(?:~|\\.{0,2})?\\/[\\w.@-]+(?:\\/[\\w.@-]+)*/g, \"<path>\")\n    .replace(/\\b[0-9a-z]*\\d[0-9a-z]*\\b/g, \"<n>\")\n    .replace(/[^a-z<>\\s]+/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim()\n  const words = text.split(\" \").filter(Boolean).slice(0, 8).join(\" \")\n  return words || status\n}\n\n/** Agent + tool + outcome + error class. A timeout and an error in the\n *  same tool are different failures with different fixes. */\nexport function failureSignature(t: Pick<FailedTrace, \"agentId\" | \"tool\" | \"status\" | \"error\">): string {\n  return `${t.agentId}|${t.tool ?? \"no-tool\"}|${t.status}|${errorClass(t.status, t.error)}`\n}\n\nfunction digest(signature: string): string {\n  return createHash(\"sha1\").update(signature).digest(\"hex\").slice(0, 10)\n}\n\n/**\n * The stamp changes only when recurrence doubles (2–3 → 4–7 → 8–15 …).\n * A lesson skipped or rejected at three sessions is offered again once\n * it has been seen in four, and next at eight; it is not re-offered every\n * night because one more session hit it.\n */\nexport function failureStamp(signature: string, sessions: number): string {\n  return `${FAILURE_STAMP_PREFIX}${digest(signature)}@${Math.floor(Math.log2(Math.max(1, sessions)))}`\n}\n\n/**\n * Which session a run belongs to. The provider session is the honest\n * unit: two failures inside one continuing conversation are one session\n * going wrong, not two. A run that never got a session is its own. The\n * chat id is deliberately not used — a scheduled job reuses one chat id\n * forever, which would count a job failing every night as one session.\n */\nexport function sessionOf(t: Pick<TraceRecord, \"taskId\" | \"finalSessionId\" | \"resumeSessionId\">): string {\n  return t.finalSessionId ?? t.resumeSessionId ?? t.taskId\n}\n\n/** Load failed and timed-out traces in the window, with their failing tool. */\nexport function loadFailedTraces(db: Database.Database, opts: { since?: number } = {}): FailedTrace[] {\n  const traces = FAILED_STATUSES.flatMap((status) =>\n    listTraces(db, { status, since: opts.since, limit: 1000 }))\n  return traces\n    .filter((t) => !SELF_CHAT_PREFIXES.some((p) => (t.chatId ?? \"\").startsWith(p)))\n    .map((t) => {\n      const { tool, error } = failingTool(getTrace(db, t.taskId)?.steps ?? [])\n      return {\n        taskId: t.taskId,\n        agentId: t.agentId,\n        chatId: t.chatId,\n        sessionId: sessionOf(t),\n        status: t.status,\n        startedAt: t.startedAt,\n        error: error ?? t.error,\n        messagePreview: t.messagePreview,\n        tool,\n      }\n    })\n}\n\n/**\n * The tool a run failed in, and that tool's error. The stream records a\n * call as a `tool_use` step (named, status in-flight) and its outcome as\n * a separate `tool_result` step that carries no tool name, so an errored\n * result is paired with the call before it. The last error wins; with no\n * errored call the run is attributed to the last tool it used, keeping\n * the run's own error.\n */\nexport function failingTool(\n  steps: Array<Pick<TraceStepRecord, \"name\" | \"action\" | \"status\" | \"error\" | \"outputSummary\">>,\n): { tool: string | null; error: string | null } {\n  let last: string | null = null\n  let failing: { tool: string | null; error: string | null } | null = null\n  for (const s of steps) {\n    if (s.name === \"tool_use\" && s.action) {\n      last = s.action\n      if (s.status === \"error\") failing = { tool: s.action, error: s.error ?? s.outputSummary }\n    } else if (s.name === \"tool_result\" && s.status === \"error\") {\n      failing = { tool: s.action ?? last, error: s.error ?? s.outputSummary }\n    }\n  }\n  return failing ?? { tool: last, error: null }\n}\n\n/** Group failures by signature; keep those seen in at least `minSessions`\n *  distinct sessions (never fewer than 2 — one session is not a pattern).\n *  Most recurrent first. */\nexport function failuresToCandidates(\n  traces: FailedTrace[],\n  opts: { minSessions?: number } = {},\n): FailureCandidate[] {\n  const minSessions = Math.max(2, opts.minSessions ?? DEFAULT_MIN_SESSIONS)\n  const groups = new Map<string, FailedTrace[]>()\n  for (const t of traces) {\n    const sig = failureSignature(t)\n    groups.set(sig, [...(groups.get(sig) ?? []), t])\n  }\n\n  const out: FailureCandidate[] = []\n  for (const [signature, list] of groups) {\n    const sessions = [...new Set([...list].sort((a, b) => b.startedAt - a.startedAt).map((t) => t.sessionId))]\n    if (sessions.length < minSessions) continue\n    list.sort((a, b) => b.startedAt - a.startedAt)\n    const latest = list[0]\n    const tool = latest.tool ?? \"no tool\"\n    const cls = errorClass(latest.status, latest.error)\n    const name = `failure-${digest(signature)}`\n    out.push({\n      occurrences: sessions.length,\n      sessions: sessions.slice(0, MAX_FAILURE_EXAMPLES),\n      tasks: list.slice(0, MAX_FAILURE_EXAMPLES).map((t) => t.taskId),\n      failure: { tool, errorClass: cls, runs: list.length },\n      agentId: latest.agentId,\n      key: `${latest.agentId}/feedback_${name}`,\n      stamp: failureStamp(signature, sessions.length),\n      memory: {\n        name,\n        type: \"feedback\",\n        description: `${latest.agentId}: ${tool} keeps failing (${cls}) in ${sessions.length} sessions`.slice(0, 200),\n        body: renderBody(latest.agentId, tool, cls, sessions.length, list),\n        createdAt: new Date(list[list.length - 1].startedAt).toISOString(),\n        updatedAt: new Date(latest.startedAt).toISOString(),\n      },\n    })\n  }\n  return out.sort((a, b) => b.occurrences - a.occurrences)\n}\n\nfunction renderBody(agent: string, tool: string, cls: string, sessions: number, list: FailedTrace[]): string {\n  const examples = list.slice(0, MAX_FAILURE_EXAMPLES).map((t) => {\n    const task = (t.messagePreview ?? \"\").replace(/\\s+/g, \" \").trim().slice(0, 120)\n    const error = (t.error ?? t.status).replace(/\\s+/g, \" \").trim().slice(0, 160)\n    return `- ${new Date(t.startedAt).toISOString().slice(0, 10)} \\`${t.taskId}\\` (${t.status})${task ? ` — task: ${task}` : \"\"}\\n  error: ${error}`\n  })\n  return [\n    `**${agent}** hit the same failure in ${sessions} separate sessions (${list.length} runs).`,\n    `- Tool: \\`${tool}\\`\\n- Error class: \\`${cls}\\``,\n    \"Recurrence across sessions is the finding: any one of these runs is session state. \" +\n      \"Propose the fix that stops it recurring — what fails, the likely cause, and what to do instead \" +\n      \"(a missing fact, a better approach, or a tool or configuration change to make) — \" +\n      \"or skip it if the examples do not share a cause.\",\n    `**Examples (newest first):**\\n${examples.join(\"\\n\")}`,\n  ].join(\"\\n\\n\")\n}\n"],"mappings":"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","names":["createHash","FAILURE_STAMP_PREFIX","DEFAULT_MIN_SESSIONS","MAX_FAILURE_EXAMPLES","FAILED_STATUSES","SELF_CHAT_PREFIXES","errorClass","status","error","failureSignature","digest","signature","createHash","failureStamp","sessions","sessionOf","loadFailedTraces","db","opts","listTraces","t","p","tool","failingTool","getTrace","steps","last","failing","s","failuresToCandidates","traces","minSessions","groups","sig","out","list","a","b","latest","cls","name","renderBody","agent","examples","task"]}

package/dist/index.d.ts

@@ -2894,6 +2894,10 @@ declare const daemonConfigSchema: z.ZodObject<{
                 keywords?: string[] | undefined;
                 node?: string | undefined;
             }>, "many">>;
+            /** Extra GitLab usernames each agent answers to, as prefixes. With
+             *  ["team-"], an agent with no agentMappings row answers to @<id> and
+             *  @team-<id>. Default: only @<id>. */
+            agentUsernamePrefixes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             enabled: boolean;
             host: string;
@@ -2910,6 +2914,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 token?: string | undefined;
                 node?: string | undefined;
             }[];
+            agentUsernamePrefixes: string[];
             token?: string | undefined;
             webhookSecret?: string | undefined;
         }, {
@@ -2930,6 +2935,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 keywords?: string[] | undefined;
                 node?: string | undefined;
             }[] | undefined;
+            agentUsernamePrefixes?: string[] | undefined;
         }>>;
         github: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -3225,6 +3231,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 token?: string | undefined;
                 node?: string | undefined;
             }[];
+            agentUsernamePrefixes: string[];
             token?: string | undefined;
             webhookSecret?: string | undefined;
         };
@@ -3348,6 +3355,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 keywords?: string[] | undefined;
                 node?: string | undefined;
             }[] | undefined;
+            agentUsernamePrefixes?: string[] | undefined;
         } | undefined;
         whatsapp?: {
             enabled?: boolean | undefined;
@@ -3828,6 +3836,86 @@ declare const daemonConfigSchema: z.ZodObject<{
             accountId?: string | undefined;
         } | undefined;
     }>>;
+    approvals: z.ZodDefault<z.ZodObject<{
+        /** A card without an `expires` gets this many days. */
+        defaultExpiryDays: z.ZodDefault<z.ZodNumber>;
+        /** No card waits longer than this, whatever the agent asked for. */
+        maxExpiryDays: z.ZodDefault<z.ZodNumber>;
+        /** How long "later" hides an item. */
+        laterHours: z.ZodDefault<z.ZodNumber>;
+        /** Tell the agent that raised a card when it is decided or expires. */
+        notifyAgent: z.ZodDefault<z.ZodBoolean>;
+        /** At most one message a day: how many are waiting, and the most urgent. */
+        digest: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            /** Local time, 24-hour HH:MM. */
+            time: z.ZodDefault<z.ZodString>;
+            /** IANA timezone for `time`. Unset: this machine's. */
+            timezone: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            /** Where it goes. Unset: notifications.destination. */
+            destination: z.ZodOptional<z.ZodObject<{
+                channel: z.ZodString;
+                chatId: z.ZodString;
+                accountId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            }, {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            time: string;
+            timezone?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            timezone?: string | undefined;
+            time?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        defaultExpiryDays: number;
+        maxExpiryDays: number;
+        laterHours: number;
+        notifyAgent: boolean;
+        digest: {
+            enabled: boolean;
+            time: string;
+            timezone?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        };
+    }, {
+        defaultExpiryDays?: number | undefined;
+        maxExpiryDays?: number | undefined;
+        laterHours?: number | undefined;
+        notifyAgent?: boolean | undefined;
+        digest?: {
+            enabled?: boolean | undefined;
+            timezone?: string | undefined;
+            time?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        } | undefined;
+    }>>;
     /** What happens to runs a restart cuts off (agents/resume). Chat messages
      *  are resumed in their chat; scheduled jobs never are (the next run
      *  covers them); everything else is reported unless its channel is in
@@ -3876,6 +3964,95 @@ declare const daemonConfigSchema: z.ZodObject<{
             windowMinutes?: number | undefined;
         } | undefined;
     }>>;
+    screen: z.ZodDefault<z.ZodObject<{
+        /** Pixel budget for a captured frame; larger captures are downscaled. */
+        maxPixels: z.ZodDefault<z.ZodNumber>;
+        /** Longest a capture waits for a change or for the screen to settle. */
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        /** Time between samples while waiting. */
+        intervalMs: z.ZodDefault<z.ZodNumber>;
+        /** Mean difference (0–1) above which two samples count as different. */
+        changeThreshold: z.ZodDefault<z.ZodNumber>;
+        /** How long a region must stay unchanged to count as stable. */
+        stableMs: z.ZodDefault<z.ZodNumber>;
+        /** Named regions in screen points, e.g. { "chat": { x, y, width, height } }.
+         *  A name here overrides the built-in region of the same name. */
+        regions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>>>;
+        /** The last few seconds of a region, kept in memory by the daemon. Off
+         *  unless enabled; frames are written out only when asked for. */
+        buffer: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            seconds: z.ZodDefault<z.ZodNumber>;
+            fps: z.ZodDefault<z.ZodNumber>;
+            region: z.ZodDefault<z.ZodString>;
+            maxPixels: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            maxPixels: number;
+            seconds: number;
+            fps: number;
+            region: string;
+        }, {
+            enabled?: boolean | undefined;
+            maxPixels?: number | undefined;
+            seconds?: number | undefined;
+            fps?: number | undefined;
+            region?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        timeoutMs: number;
+        maxPixels: number;
+        intervalMs: number;
+        changeThreshold: number;
+        stableMs: number;
+        regions: Record<string, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        buffer: {
+            enabled: boolean;
+            maxPixels: number;
+            seconds: number;
+            fps: number;
+            region: string;
+        };
+    }, {
+        timeoutMs?: number | undefined;
+        maxPixels?: number | undefined;
+        intervalMs?: number | undefined;
+        changeThreshold?: number | undefined;
+        stableMs?: number | undefined;
+        regions?: Record<string, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }> | undefined;
+        buffer?: {
+            enabled?: boolean | undefined;
+            maxPixels?: number | undefined;
+            seconds?: number | undefined;
+            fps?: number | undefined;
+            region?: string | undefined;
+        } | undefined;
+    }>>;
     mesh: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         peers: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -5417,6 +5594,26 @@ declare const daemonConfigSchema: z.ZodObject<{
         draftAgent?: string | undefined;
         reviewAgent?: string | undefined;
     };
+    screen: {
+        timeoutMs: number;
+        maxPixels: number;
+        intervalMs: number;
+        changeThreshold: number;
+        stableMs: number;
+        regions: Record<string, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        buffer: {
+            enabled: boolean;
+            maxPixels: number;
+            seconds: number;
+            fps: number;
+            region: string;
+        };
+    };
     providers: Record<string, {
         apiKey?: string | undefined;
         thinking?: boolean | undefined;
@@ -5440,6 +5637,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 token?: string | undefined;
                 node?: string | undefined;
             }[];
+            agentUsernamePrefixes: string[];
             token?: string | undefined;
             webhookSecret?: string | undefined;
         };
@@ -5607,6 +5805,22 @@ declare const daemonConfigSchema: z.ZodObject<{
             accountId?: string | undefined;
         } | undefined;
     };
+    approvals: {
+        defaultExpiryDays: number;
+        maxExpiryDays: number;
+        laterHours: number;
+        notifyAgent: boolean;
+        digest: {
+            enabled: boolean;
+            time: string;
+            timezone?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        };
+    };
     meshVoices: Record<string, {
         system?: string | Record<string, string> | undefined;
         provider?: "system" | "elevenlabs" | undefined;
@@ -5977,6 +6191,26 @@ declare const daemonConfigSchema: z.ZodObject<{
             bm25?: number | undefined;
         } | undefined;
     } | undefined;
+    screen?: {
+        timeoutMs?: number | undefined;
+        maxPixels?: number | undefined;
+        intervalMs?: number | undefined;
+        changeThreshold?: number | undefined;
+        stableMs?: number | undefined;
+        regions?: Record<string, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }> | undefined;
+        buffer?: {
+            enabled?: boolean | undefined;
+            maxPixels?: number | undefined;
+            seconds?: number | undefined;
+            fps?: number | undefined;
+            region?: string | undefined;
+        } | undefined;
+    } | undefined;
     providers?: Record<string, {
         apiKey?: string | undefined;
         thinking?: boolean | undefined;
@@ -6002,6 +6236,7 @@ declare const daemonConfigSchema: z.ZodObject<{
                 keywords?: string[] | undefined;
                 node?: string | undefined;
             }[] | undefined;
+            agentUsernamePrefixes?: string[] | undefined;
         } | undefined;
         whatsapp?: {
             enabled?: boolean | undefined;
@@ -6167,6 +6402,22 @@ declare const daemonConfigSchema: z.ZodObject<{
             accountId?: string | undefined;
         } | undefined;
     } | undefined;
+    approvals?: {
+        defaultExpiryDays?: number | undefined;
+        maxExpiryDays?: number | undefined;
+        laterHours?: number | undefined;
+        notifyAgent?: boolean | undefined;
+        digest?: {
+            enabled?: boolean | undefined;
+            timezone?: string | undefined;
+            time?: string | undefined;
+            destination?: {
+                channel: string;
+                chatId: string;
+                accountId?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
     meshVoices?: Record<string, {
         system?: string | Record<string, string> | undefined;
         provider?: "system" | "elevenlabs" | undefined;
@@ -6753,6 +7004,7 @@ declare class AgentXDaemon {
     private voiceIntros;
     /** Talk mode and task narration: see src/daemon/voice-talk-api.ts. */
     private voiceTalk;
+    private screenBuffer?;
     /** Voice for agents on mesh peers: see src/daemon/voice-mesh-proxy.ts. */
     private voiceMesh;
     /** Persistent-claude process registry. Null when no agent has
@@ -6772,6 +7024,17 @@ declare class AgentXDaemon {
     constructor(configPath?: string);
     start(): Promise<void>;
     stop(): Promise<void>;
+    /** In-flight work the drain waits for: local agent tasks + mesh forwards. */
+    private inflightCounts;
+    /** Set by start(): the same graceful path a SIGTERM takes. */
+    private requestShutdown?;
+    /** Exit code stop() ends with; a self-restart may need a non-zero one. */
+    private exitCode;
+    private selfRestartInfo?;
+    /** "Restart when idle" (dashboard button / POST /daemon/restart). */
+    private idleRestart;
+    /** What runs this daemon, detected once (it can't change while it runs). */
+    private restartService;
     private midnightTimer?;
     /** Set on the first stop signal: new work is refused while tasks drain. */
     private shuttingDown;
@@ -6802,6 +7065,11 @@ declare class AgentXDaemon {
         restartRequired: string[];
         error?: string;
     }>;
+    private approvalsTimer?;
+    private approvalsSweeping;
+    /** Every minute: expire decision cards, tell agents their results, and
+     *  send the day's digest when due (src/approvals/sweep.ts). */
+    private startApprovalsSweep;
     private scheduleMidnightHook;
     private runDailyCostReport;
     private startChannels;
@@ -7591,6 +7859,10 @@ declare class MemoryStore {
     getAll(agentId: string): MemoryFact[];
     findRelevant(message: string, agentId: string, limit?: number): MemoryFact[];
     buildContext(memories: MemoryFact[]): string;
+    /** The facts buildContext actually renders — the rest fall past its
+     *  character budget. Trace capture records these ids, not the candidates. */
+    contextFacts(memories: MemoryFact[]): MemoryFact[];
+    private contextLines;
     /**
      * Record that memories were accessed (for spaced repetition tracking).
      */

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a as L}from"./chunk-W5C2GDNC.js";import{Y as bt,Z as Tt,_ 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-YIXQDOPN.js";import"./chunk-FQBPSL36.js";import"./chunk-FNLGY4UV.js";import"./chunk-V7FYSZSV.js";import"./chunk-ZVP6GB4G.js";import"./chunk-7L6M3P2N.js";import"./chunk-VZDKE2EZ.js";import"./chunk-3SCPRYJB.js";import"./chunk-FRHSQVFN.js";import"./chunk-L53FTKEP.js";import{O as yt,l as lt,m as ct,n as dt,o as mt,p as pt}from"./chunk-XMRI32CY.js";import"./chunk-FXGSSZAP.js";import"./chunk-DJQA2CWD.js";import"./chunk-WZGABQ72.js";import"./chunk-DP7RTNDM.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-XMWOV2D5.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import{m as ut}from"./chunk-LYOXXD4T.js";import"./chunk-WPMX3VGI.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import"./chunk-J63MRNXF.js";import"./chunk-NXJBAKBR.js";import"./chunk-DWADWDMU.js";import"./chunk-CQR6C5FU.js";import"./chunk-VWTBHLMX.js";import"./chunk-BJWK7FPT.js";import{a as gt,b as ft,e as ht}from"./chunk-KTM7HSEB.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-MDTKQZC6.js";import"./chunk-AJ5RMU7X.js";import"./chunk-2GIDVZ4H.js";import{j as it,k as rt,l as at}from"./chunk-BZLHS3VF.js";import"./chunk-F4HZTZHW.js";import"./chunk-AJONZWLT.js";import"./chunk-ZTEU5JVQ.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{j as tt,l as st,m as ot,o as nt}from"./chunk-ANLKBCYH.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{a as St,b as kt,c as vt,d as xt,e as $t,f as Ct,g as Pt,ia as bt,ja as Tt,ka as Mt}from"./chunk-HGT4AKOH.js";import"./chunk-DTJKN5VT.js";import"./chunk-PZCTCCC5.js";import"./chunk-LQRBGQIR.js";import"./chunk-ZVP6GB4G.js";import"./chunk-FULEQYM6.js";import"./chunk-OHA3J5ZV.js";import"./chunk-3SCPRYJB.js";import"./chunk-AQASR6KR.js";import"./chunk-L53FTKEP.js";import{N as yt,l as lt,m as ct,n as dt,o as mt,p as pt}from"./chunk-HVQJIROJ.js";import"./chunk-3L2FKVR6.js";import"./chunk-N6EWZGIX.js";import"./chunk-Q7C3X3R6.js";import"./chunk-DP7RTNDM.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-MWUJOAAW.js";import{a as B,b as M,c as F}from"./chunk-SFQUP3BP.js";import"./chunk-5XQCGPQJ.js";import{m as ut}from"./chunk-B5XHX44Y.js";import"./chunk-WPMX3VGI.js";import"./chunk-K33GIBSE.js";import"./chunk-76Z4VHDX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import"./chunk-NLZD2QKF.js";import"./chunk-5ALS7SVV.js";import"./chunk-DWADWDMU.js";import"./chunk-DVNIFP7S.js";import"./chunk-7DXE264B.js";import"./chunk-VWTBHLMX.js";import"./chunk-IXUEJBHD.js";import{a as gt,b as ft,e as ht}from"./chunk-JVNFRS26.js";import"./chunk-PNWNVOEZ.js";import"./chunk-64P4QHSZ.js";import"./chunk-QDE75R4U.js";import"./chunk-AJ5RMU7X.js";import"./chunk-2GIDVZ4H.js";import{j as it,k as rt,l as at}from"./chunk-4NBWF4TL.js";import"./chunk-F4HZTZHW.js";import"./chunk-AJONZWLT.js";import"./chunk-ZTEU5JVQ.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{k as tt,m as st,n as ot,p as nt}from"./chunk-P2ZYT5D6.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).