agentix-cli 0.133.0 → 0.134.0

package/dist/index.d.ts

@@ -1619,6 +1619,17 @@ declare const agentConfigSchema: z.ZodObject<{
         }, {
             enabled?: boolean | undefined;
         }>>;
+        /** Where this agent's notes are, for `wiki query` when
+         *  `wiki.query.notes.enabled` (#862). Unset: the AgentX note store,
+         *  `.agentx/agent-memory/<agent>/`. A relative path is read from the
+         *  folder AgentX runs in. */
+        notes: z.ZodDefault<z.ZodObject<{
+            dir: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            dir?: string | undefined;
+        }, {
+            dir?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         contribute: {
             enabled: boolean;
@@ -1629,6 +1640,9 @@ declare const agentConfigSchema: z.ZodObject<{
         absorb: {
             enabled: boolean;
         };
+        notes: {
+            dir?: string | undefined;
+        };
     }, {
         contribute?: {
             model?: string | undefined;
@@ -1639,6 +1653,9 @@ declare const agentConfigSchema: z.ZodObject<{
         absorb?: {
             enabled?: boolean | undefined;
         } | undefined;
+        notes?: {
+            dir?: string | undefined;
+        } | undefined;
     }>>;
     permissionMode: z.ZodDefault<z.ZodString>;
     /** How this agent's `claude` CLI is billed (claude-code tier). Default
@@ -2001,6 +2018,9 @@ declare const agentConfigSchema: z.ZodObject<{
         absorb: {
             enabled: boolean;
         };
+        notes: {
+            dir?: string | undefined;
+        };
     } | undefined;
     voice?: {
         system?: string | Record<string, string> | undefined;
@@ -2052,6 +2072,9 @@ declare const agentConfigSchema: z.ZodObject<{
         absorb?: {
             enabled?: boolean | undefined;
         } | undefined;
+        notes?: {
+            dir?: string | undefined;
+        } | undefined;
     } | undefined;
     voice?: {
         system?: string | Record<string, string> | undefined;
@@ -2557,6 +2580,17 @@ declare const daemonConfigSchema: z.ZodObject<{
             }, {
                 enabled?: boolean | undefined;
             }>>;
+            /** Where this agent's notes are, for `wiki query` when
+             *  `wiki.query.notes.enabled` (#862). Unset: the AgentX note store,
+             *  `.agentx/agent-memory/<agent>/`. A relative path is read from the
+             *  folder AgentX runs in. */
+            notes: z.ZodDefault<z.ZodObject<{
+                dir: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                dir?: string | undefined;
+            }, {
+                dir?: string | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             contribute: {
                 enabled: boolean;
@@ -2567,6 +2601,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb: {
                 enabled: boolean;
             };
+            notes: {
+                dir?: string | undefined;
+            };
         }, {
             contribute?: {
                 model?: string | undefined;
@@ -2577,6 +2614,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb?: {
                 enabled?: boolean | undefined;
             } | undefined;
+            notes?: {
+                dir?: string | undefined;
+            } | undefined;
         }>>;
         permissionMode: z.ZodDefault<z.ZodString>;
         /** How this agent's `claude` CLI is billed (claude-code tier). Default
@@ -2939,6 +2979,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb: {
                 enabled: boolean;
             };
+            notes: {
+                dir?: string | undefined;
+            };
         } | undefined;
         voice?: {
             system?: string | Record<string, string> | undefined;
@@ -2990,6 +3033,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb?: {
                 enabled?: boolean | undefined;
             } | undefined;
+            notes?: {
+                dir?: string | undefined;
+            } | undefined;
         } | undefined;
         voice?: {
             system?: string | Record<string, string> | undefined;
@@ -3122,13 +3168,35 @@ declare const daemonConfigSchema: z.ZodObject<{
             candidates: z.ZodDefault<z.ZodNumber>;
             /** Other agents' pages shown beside them. */
             sharedCandidates: z.ZodDefault<z.ZodNumber>;
+            /** The asking agent's own notes, searched beside its pages by the
+             *  summaries method (#862). A note's `description` is its summary
+             *  line. Only the agent's own notes: a note is private to the agent
+             *  that wrote it. Off by default. */
+            notes: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                /** Note types searched. `user` and `feedback` notes describe a
+                 *  person or the agent's own working rules and stay out. */
+                types: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                /** Notes shown to the model that picks. */
+                candidates: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                types: string[];
+                candidates: number;
+            }, {
+                enabled?: boolean | undefined;
+                types?: string[] | undefined;
+                candidates?: number | undefined;
+            }>>;
             /** Most pages opened for one answer. */
             maxPages: z.ZodDefault<z.ZodNumber>;
-            /** Pages also opened along the `related` links of the picked pages
-             *  (summaries method), in total. 0: none. */
-            linkedPages: z.ZodDefault<z.ZodNumber>;
             /** Characters of each opened page given to the answer. */
             pageChars: z.ZodDefault<z.ZodNumber>;
+            /** Pages linked from the picked ones also opened (#863), best
+             *  summary line against the question first. 0: none. */
+            linkedPages: z.ZodDefault<z.ZodNumber>;
+            /** Characters all linked pages together give to the answer. */
+            linkedChars: z.ZodDefault<z.ZodNumber>;
             /** Model that picks pages from the summary lines. */
             navigatorModel: z.ZodDefault<z.ZodString>;
             /** Model that writes the answer. */
@@ -3292,12 +3360,18 @@ declare const daemonConfigSchema: z.ZodObject<{
             }>>;
         }, "strip", z.ZodTypeAny, {
             method: "auto" | "summaries" | "catalog";
+            notes: {
+                enabled: boolean;
+                types: string[];
+                candidates: number;
+            };
             shared: boolean;
             candidates: number;
             sharedCandidates: number;
             maxPages: number;
-            linkedPages: number;
             pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
             navigatorModel: string;
             answerModel: string;
             live: {
@@ -3331,12 +3405,18 @@ declare const daemonConfigSchema: z.ZodObject<{
             };
         }, {
             method?: "auto" | "summaries" | "catalog" | undefined;
+            notes?: {
+                enabled?: boolean | undefined;
+                types?: string[] | undefined;
+                candidates?: number | undefined;
+            } | undefined;
             shared?: boolean | undefined;
             candidates?: number | undefined;
             sharedCandidates?: number | undefined;
             maxPages?: number | undefined;
-            linkedPages?: number | undefined;
             pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
             navigatorModel?: string | undefined;
             answerModel?: string | undefined;
             live?: {
@@ -3414,12 +3494,18 @@ declare const daemonConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         query: {
             method: "auto" | "summaries" | "catalog";
+            notes: {
+                enabled: boolean;
+                types: string[];
+                candidates: number;
+            };
             shared: boolean;
             candidates: number;
             sharedCandidates: number;
             maxPages: number;
-            linkedPages: number;
             pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
             navigatorModel: string;
             answerModel: string;
             live: {
@@ -3474,12 +3560,18 @@ declare const daemonConfigSchema: z.ZodObject<{
     }, {
         query?: {
             method?: "auto" | "summaries" | "catalog" | undefined;
+            notes?: {
+                enabled?: boolean | undefined;
+                types?: string[] | undefined;
+                candidates?: number | undefined;
+            } | undefined;
             shared?: boolean | undefined;
             candidates?: number | undefined;
             sharedCandidates?: number | undefined;
             maxPages?: number | undefined;
-            linkedPages?: number | undefined;
             pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
             navigatorModel?: string | undefined;
             answerModel?: string | undefined;
             live?: {
@@ -7394,13 +7486,18 @@ declare const daemonConfigSchema: z.ZodObject<{
              *  that change nothing, leaves no run. On by default: such a turn has
              *  nothing to follow up. */
             exemptQuestions: z.ZodDefault<z.ZodBoolean>;
+            /** Task runs that ended are removed after this many days (#883),
+             *  at boot and every few hours. 0 keeps them all. */
+            retentionDays: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             enabled: boolean;
             agents: Record<string, boolean>;
+            retentionDays: number;
             exemptQuestions: boolean;
         }, {
             enabled?: boolean | undefined;
             agents?: Record<string, boolean> | undefined;
+            retentionDays?: number | undefined;
             exemptQuestions?: boolean | undefined;
         }>>;
         /** Controls whether the dashboard exposes the visual editor. "readonly"
@@ -7413,6 +7510,7 @@ declare const daemonConfigSchema: z.ZodObject<{
         required: {
             enabled: boolean;
             agents: Record<string, boolean>;
+            retentionDays: number;
             exemptQuestions: boolean;
         };
         followUp: {
@@ -7439,6 +7537,7 @@ declare const daemonConfigSchema: z.ZodObject<{
         required?: {
             enabled?: boolean | undefined;
             agents?: Record<string, boolean> | undefined;
+            retentionDays?: number | undefined;
             exemptQuestions?: boolean | undefined;
         } | undefined;
         followUp?: {
@@ -8015,6 +8114,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb: {
                 enabled: boolean;
             };
+            notes: {
+                dir?: string | undefined;
+            };
         } | undefined;
         voice?: {
             system?: string | Record<string, string> | undefined;
@@ -8093,12 +8195,18 @@ declare const daemonConfigSchema: z.ZodObject<{
     wiki: {
         query: {
             method: "auto" | "summaries" | "catalog";
+            notes: {
+                enabled: boolean;
+                types: string[];
+                candidates: number;
+            };
             shared: boolean;
             candidates: number;
             sharedCandidates: number;
             maxPages: number;
-            linkedPages: number;
             pageChars: number;
+            linkedPages: number;
+            linkedChars: number;
             navigatorModel: string;
             answerModel: string;
             live: {
@@ -8728,6 +8836,7 @@ declare const daemonConfigSchema: z.ZodObject<{
         required: {
             enabled: boolean;
             agents: Record<string, boolean>;
+            retentionDays: number;
             exemptQuestions: boolean;
         };
         followUp: {
@@ -8919,6 +9028,9 @@ declare const daemonConfigSchema: z.ZodObject<{
             absorb?: {
                 enabled?: boolean | undefined;
             } | undefined;
+            notes?: {
+                dir?: string | undefined;
+            } | undefined;
         } | undefined;
         voice?: {
             system?: string | Record<string, string> | undefined;
@@ -9049,12 +9161,18 @@ declare const daemonConfigSchema: z.ZodObject<{
     wiki?: {
         query?: {
             method?: "auto" | "summaries" | "catalog" | undefined;
+            notes?: {
+                enabled?: boolean | undefined;
+                types?: string[] | undefined;
+                candidates?: number | undefined;
+            } | undefined;
             shared?: boolean | undefined;
             candidates?: number | undefined;
             sharedCandidates?: number | undefined;
             maxPages?: number | undefined;
-            linkedPages?: number | undefined;
             pageChars?: number | undefined;
+            linkedPages?: number | undefined;
+            linkedChars?: number | undefined;
             navigatorModel?: string | undefined;
             answerModel?: string | undefined;
             live?: {
@@ -9746,6 +9864,7 @@ declare const daemonConfigSchema: z.ZodObject<{
         required?: {
             enabled?: boolean | undefined;
             agents?: Record<string, boolean> | undefined;
+            retentionDays?: number | undefined;
             exemptQuestions?: boolean | undefined;
         } | undefined;
         followUp?: {
@@ -10536,6 +10655,7 @@ declare class AgentXDaemon {
     private httpServer?;
     private attachSweep?;
     private callSweep?;
+    private taskRunPrune?;
     private webhooks;
     private github?;
     private webrtc?;
@@ -13537,6 +13657,22 @@ declare const pausedAtSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     nudges?: number | undefined;
     maxNudges?: number | undefined;
     nextNudgeAt?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"agentStop">;
+    nodeId: z.ZodString;
+    agentId: z.ZodString;
+    /** The stopped turn's running-task id: the stopped-task record. */
+    taskId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "agentStop";
+    agentId: string;
+    nodeId: string;
+    taskId?: string | undefined;
+}, {
+    kind: "agentStop";
+    agentId: string;
+    nodeId: string;
+    taskId?: string | undefined;
 }>]>;
 type PausedAt = z.infer<typeof pausedAtSchema>;
 /** What a follow-up run is about and who started it (#788). Runs that
@@ -13672,6 +13808,9 @@ declare const runMetaSchema: z.ZodObject<{
             dropped?: string[] | undefined;
         }[] | undefined;
     }>>;
+    /** The run this one continues (#870): a wrapped task that was stopped,
+     *  then resumed, gets a new run that names the one the stop closed. */
+    continues: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     followUp: boolean;
     tags: string[];
@@ -13701,6 +13840,7 @@ declare const runMetaSchema: z.ZodObject<{
     title?: string | undefined;
     approved?: Record<string, string> | undefined;
     requestId?: string | undefined;
+    continues?: string | undefined;
     startedBy?: string | undefined;
     endNotifiedAt?: string | undefined;
     wrap?: {
@@ -13737,6 +13877,7 @@ declare const runMetaSchema: z.ZodObject<{
     title?: string | undefined;
     approved?: Record<string, string> | undefined;
     requestId?: string | undefined;
+    continues?: string | undefined;
     startedBy?: string | undefined;
     approvedAtStart?: boolean | undefined;
     endNotifiedAt?: string | undefined;
@@ -13936,6 +14077,22 @@ declare const workflowRunSchema: z.ZodObject<{
         nudges?: number | undefined;
         maxNudges?: number | undefined;
         nextNudgeAt?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"agentStop">;
+        nodeId: z.ZodString;
+        agentId: z.ZodString;
+        /** The stopped turn's running-task id: the stopped-task record. */
+        taskId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "agentStop";
+        agentId: string;
+        nodeId: string;
+        taskId?: string | undefined;
+    }, {
+        kind: "agentStop";
+        agentId: string;
+        nodeId: string;
+        taskId?: string | undefined;
     }>]>>;
     /** Output bundles keyed by producing node id. Downstream nodes read via
      *  `{{<nodeId>.<path>}}` in templates. */
@@ -14147,6 +14304,9 @@ declare const workflowRunSchema: z.ZodObject<{
                 dropped?: string[] | undefined;
             }[] | undefined;
         }>>;
+        /** The run this one continues (#870): a wrapped task that was stopped,
+         *  then resumed, gets a new run that names the one the stop closed. */
+        continues: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         followUp: boolean;
         tags: string[];
@@ -14176,6 +14336,7 @@ declare const workflowRunSchema: z.ZodObject<{
         title?: string | undefined;
         approved?: Record<string, string> | undefined;
         requestId?: string | undefined;
+        continues?: string | undefined;
         startedBy?: string | undefined;
         endNotifiedAt?: string | undefined;
         wrap?: {
@@ -14212,6 +14373,7 @@ declare const workflowRunSchema: z.ZodObject<{
         title?: string | undefined;
         approved?: Record<string, string> | undefined;
         requestId?: string | undefined;
+        continues?: string | undefined;
         startedBy?: string | undefined;
         approvedAtStart?: boolean | undefined;
         endNotifiedAt?: string | undefined;
@@ -14225,7 +14387,7 @@ declare const workflowRunSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: "failed" | "completed" | "canceled" | "paused" | "running";
+    status: "failed" | "completed" | "running" | "canceled" | "paused";
     id: string;
     context: Record<string, Record<string, unknown>>;
     pending: string[];
@@ -14254,6 +14416,45 @@ declare const workflowRunSchema: z.ZodObject<{
     parentNodeId: string | null;
     rootRunId: string | null;
     depth: number;
+    meta?: {
+        followUp: boolean;
+        tags: string[];
+        approvedAtStart: boolean;
+        blocked?: {
+            at: string;
+            reason: string;
+            nodeId: string;
+        } | undefined;
+        plan?: {
+            steps: {
+                id: string;
+                title: string;
+            }[];
+            revisions: {
+                at: string;
+                steps: string[];
+                kind: "plan" | "revise";
+                dropped: string[];
+                reason?: string | undefined;
+            }[];
+            current?: {
+                id: string;
+                startedAt: string;
+            } | undefined;
+        } | undefined;
+        title?: string | undefined;
+        approved?: Record<string, string> | undefined;
+        requestId?: string | undefined;
+        continues?: string | undefined;
+        startedBy?: string | undefined;
+        endNotifiedAt?: string | undefined;
+        wrap?: {
+            channel: string;
+            mode: "plan" | "linear";
+            agentId: string;
+            taskId?: string | undefined;
+        } | undefined;
+    } | undefined;
     pausedAt?: {
         kind: "checkpoint";
         nodeId: string;
@@ -14308,12 +14509,41 @@ declare const workflowRunSchema: z.ZodObject<{
         stallMs: number;
         blocked?: string | undefined;
         nextNudgeAt?: string | undefined;
+    } | {
+        kind: "agentStop";
+        agentId: string;
+        nodeId: string;
+        taskId?: string | undefined;
     } | undefined;
     eventRootId?: string | undefined;
+}, {
+    status: "failed" | "completed" | "running" | "canceled" | "paused";
+    id: string;
+    updatedAt: string;
+    createdAt: string;
+    workflowVersion: 2;
+    workflowId: string;
+    homeNode: string;
+    entityRef: {
+        id: string;
+        backend: string;
+    };
+    context?: Record<string, Record<string, unknown>> | undefined;
+    pending?: string[] | undefined;
+    history?: {
+        at: string;
+        status: "timeout" | "ok" | "failed" | "skipped" | "resumed" | "paused";
+        idempotencyKey: string;
+        nodeId: string;
+        output?: Record<string, unknown> | undefined;
+        durationMs?: number | undefined;
+        note?: string | undefined;
+        startedAt?: string | undefined;
+        inputKeys?: string[] | undefined;
+    }[] | undefined;
     meta?: {
-        followUp: boolean;
-        tags: string[];
-        approvedAtStart: boolean;
+        followUp?: boolean | undefined;
+        tags?: string[] | undefined;
         blocked?: {
             at: string;
             reason: string;
@@ -14324,22 +14554,24 @@ declare const workflowRunSchema: z.ZodObject<{
                 id: string;
                 title: string;
             }[];
-            revisions: {
-                at: string;
-                steps: string[];
-                kind: "plan" | "revise";
-                dropped: string[];
-                reason?: string | undefined;
-            }[];
             current?: {
                 id: string;
                 startedAt: string;
             } | undefined;
+            revisions?: {
+                at: string;
+                steps: string[];
+                kind: "plan" | "revise";
+                reason?: string | undefined;
+                dropped?: string[] | undefined;
+            }[] | undefined;
         } | undefined;
         title?: string | undefined;
         approved?: Record<string, string> | undefined;
         requestId?: string | undefined;
+        continues?: string | undefined;
         startedBy?: string | undefined;
+        approvedAtStart?: boolean | undefined;
         endNotifiedAt?: string | undefined;
         wrap?: {
             channel: string;
@@ -14348,31 +14580,6 @@ declare const workflowRunSchema: z.ZodObject<{
             taskId?: string | undefined;
         } | undefined;
     } | undefined;
-}, {
-    status: "failed" | "completed" | "canceled" | "paused" | "running";
-    id: string;
-    updatedAt: string;
-    createdAt: string;
-    workflowVersion: 2;
-    workflowId: string;
-    homeNode: string;
-    entityRef: {
-        id: string;
-        backend: string;
-    };
-    context?: Record<string, Record<string, unknown>> | undefined;
-    pending?: string[] | undefined;
-    history?: {
-        at: string;
-        status: "timeout" | "ok" | "failed" | "skipped" | "resumed" | "paused";
-        idempotencyKey: string;
-        nodeId: string;
-        output?: Record<string, unknown> | undefined;
-        durationMs?: number | undefined;
-        note?: string | undefined;
-        startedAt?: string | undefined;
-        inputKeys?: string[] | undefined;
-    }[] | undefined;
     pausedAt?: {
         kind: "checkpoint";
         nodeId: string;
@@ -14427,6 +14634,11 @@ declare const workflowRunSchema: z.ZodObject<{
         nudges?: number | undefined;
         maxNudges?: number | undefined;
         nextNudgeAt?: string | undefined;
+    } | {
+        kind: "agentStop";
+        agentId: string;
+        nodeId: string;
+        taskId?: string | undefined;
     } | undefined;
     joinCounters?: Record<string, string[]> | undefined;
     parentRunId?: string | null | undefined;
@@ -14434,44 +14646,6 @@ declare const workflowRunSchema: z.ZodObject<{
     rootRunId?: string | null | undefined;
     depth?: number | undefined;
     eventRootId?: string | undefined;
-    meta?: {
-        followUp?: boolean | undefined;
-        tags?: string[] | undefined;
-        blocked?: {
-            at: string;
-            reason: string;
-            nodeId: string;
-        } | undefined;
-        plan?: {
-            steps: {
-                id: string;
-                title: string;
-            }[];
-            current?: {
-                id: string;
-                startedAt: string;
-            } | undefined;
-            revisions?: {
-                at: string;
-                steps: string[];
-                kind: "plan" | "revise";
-                reason?: string | undefined;
-                dropped?: string[] | undefined;
-            }[] | undefined;
-        } | undefined;
-        title?: string | undefined;
-        approved?: Record<string, string> | undefined;
-        requestId?: string | undefined;
-        startedBy?: string | undefined;
-        approvedAtStart?: boolean | undefined;
-        endNotifiedAt?: string | undefined;
-        wrap?: {
-            channel: string;
-            mode: "plan" | "linear";
-            agentId: string;
-            taskId?: string | undefined;
-        } | undefined;
-    } | undefined;
 }>;
 type WorkflowRun = z.infer<typeof workflowRunSchema>;
 
@@ -14485,8 +14659,12 @@ declare class RunStore {
     readonly baseDir: string;
     readonly runsDir: string;
     readonly indexDir: string;
+    /** Task runs (#883): kept out of runsDir. */
+    readonly tasksDir: string;
     readonly nodeId: string;
     constructor(opts: RunStoreOptions);
+    /** Where a run's file is: its folder by workflow id when known, else
+     *  whichever folder holds it. */
     private runPath;
     private indexPath;
     /** Create a new run. Seeds the initial pending queue (typically the
@@ -14512,6 +14690,7 @@ declare class RunStore {
     }): WorkflowRun;
     /** Read the latest snapshot of a run by replaying the jsonl log. */
     get(runId: string): WorkflowRun | null;
+    private readRun;
     /** Look up the active run id for an entity, if any. */
     getActiveByEntity(entity: EntityRef): string | null;
     /** Which node owns a given entity (null if unclaimed). Used by the
@@ -14548,11 +14727,27 @@ declare class RunStore {
     /** Remove a run and its entity index entry, as if it never ran (#858: a
      *  plain question exempted from workflows.required). */
     discard(runId: string): boolean;
-    /** List runs, newest first. */
+    /** List runs, newest first. Task runs (#883) are left out unless
+     *  `tasks` says otherwise; `workflowId: "task"` lists only them. A run
+     *  file last written before `since` (ms) is skipped unread: a run starts
+     *  before its file's last write. */
     list(opts?: {
         workflowId?: string;
         limit?: number;
+        tasks?: "exclude" | "include" | "only";
+        since?: number;
     }): WorkflowRun[];
+    /** Task runs still open (#883): their entity index entry is kept until
+     *  they end, so this reads the open ones only, however many have ended.
+     *  An entry whose run is gone is removed. */
+    openTaskRunIds(): string[];
+    /** Retention for task runs (#883): remove ended task runs last written
+     *  more than `maxDays` ago. Only old files are read; open runs stay.
+     *  Returns how many were removed. */
+    pruneTaskRuns(maxDays: number): number;
+    /** Move task runs written to _runs before they had a folder of their own
+     *  (0.133.0) into _tasks. Once: a marker file records it is done. */
+    moveTaskRuns(): number;
     /** Retention: keep at most `maxRuns` completed/failed/canceled runs
      *  younger than `maxDays`. Running/paused runs are never pruned. */
     prune(policy: {