@llm4ts/shell 2.45.0 → 2.47.0

package/dist/OperatorTools.d.ts

@@ -0,0 +1,558 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Tool from "effect/ai/Tool";
+import * as Toolkit from "effect/ai/Toolkit";
+import { type FlowError } from "@llm4ts/flow/FlowError";
+import { TraceLine } from "@llm4ts/flow/FlowRecorder";
+import { CostsOut, Diagnosis, OperatorRun, PreflightResult, ReadFailed, RunStatus, StoryDetail, UnknownEpic, UnknownRepo, UnknownRun, UnknownStory } from "@llm4ts/flow/OperatorSchemas";
+import { CostsResult } from "@llm4ts/runner/Costs";
+import type { DoctorReport } from "@llm4ts/runner/Doctor";
+import type { RosterReport } from "@llm4ts/runner/ExecutorRoster";
+import { TraceUnreadable } from "@llm4ts/runner/RunReaders";
+import { type TranscriptFiles } from "@llm4ts/runner/Transcripts";
+import type { DiscoveredFlow } from "./FlowCatalog.ts";
+import type { OperatorConfig } from "./OperatorConfig.ts";
+import { type RunLookupDeps } from "./OperatorRuns.ts";
+/**
+ * The operator's read-only MCP tools (`llm4ts mcp`, ADR 0041): answers about
+ * repositories, epics and runs from the files they write, over an
+ * `OperatorDeps` record so tests call the handlers directly on memory stores
+ * and fakes. A client never names a path: repositories, epics and runs are
+ * ids resolved against the configuration and the files found on disk
+ * (`OperatorRuns.ts`).
+ */
+export interface OperatorDeps extends RunLookupDeps {
+    readonly config: OperatorConfig;
+    /** Relative paths of every regular file under a directory, recursively; none when absent. */
+    readonly listFiles: (directory: string) => ReadonlyArray<string>;
+    readonly transcripts: TranscriptFiles;
+    readonly doctor: Effect.Effect<DoctorReport>;
+    readonly roster: (repoPath: string) => Effect.Effect<RosterReport, FlowError>;
+    readonly probe: (url: string) => Effect.Effect<boolean>;
+    readonly flows: (repoPath: string) => Effect.Effect<ReadonlyArray<DiscoveredFlow>, unknown>;
+    readonly now: Effect.Effect<number>;
+    readonly environment: Readonly<Record<string, string | undefined>>;
+}
+/** The repository a tool call means; the id may be left out when the server serves one. */
+export declare const resolveRepo: (config: OperatorConfig, id: string | undefined) => Effect.Effect<{
+    id: string;
+    path: string;
+}, UnknownRepo>;
+export declare const preflight: Tool.Tool<"preflight", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+    }>;
+    readonly success: typeof PreflightResult;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const FlowOut: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly tier: Schema.String;
+    readonly description: Schema.optionalKey<Schema.String>;
+    readonly kit: Schema.optionalKey<Schema.String>;
+}>;
+export declare const list_flows: Tool.Tool<"list_flows", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly tier: Schema.String;
+        readonly description: Schema.optionalKey<Schema.String>;
+        readonly kit: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const EpicOut: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly title: Schema.String;
+    readonly stories: Schema.Int;
+    readonly board: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly status: Schema.Literals<readonly ["planned", "active", "waiting", "done", "failed", "skipped"]>;
+    }>>;
+    readonly lastRun: Schema.optionalKey<Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly startedAt: Schema.Number;
+        readonly action: Schema.String;
+    }>>;
+}>;
+export declare const list_epics: Tool.Tool<"list_epics", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly stories: Schema.Int;
+        readonly board: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly status: Schema.Literals<readonly ["planned", "active", "waiting", "done", "failed", "skipped"]>;
+        }>>;
+        readonly lastRun: Schema.optionalKey<Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly startedAt: Schema.Number;
+            readonly action: Schema.String;
+        }>>;
+    }>>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const list_runs: Tool.Tool<"list_runs", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly epic: Schema.optional<Schema.String>;
+        readonly limit: Schema.optional<Schema.Int>;
+    }>;
+    readonly success: Schema.$Array<typeof OperatorRun>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const run_status: Tool.Tool<"run_status", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+    }>;
+    readonly success: typeof RunStatus;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const run_events: Tool.Tool<"run_events", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly sinceSeq: Schema.optional<Schema.Int>;
+        readonly kinds: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly limit: Schema.optional<Schema.Int>;
+    }>;
+    readonly success: Schema.$Array<typeof TraceLine>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const RunLogOut: Schema.Struct<{
+    readonly stdout: Schema.$Array<Schema.String>;
+    readonly stderr: Schema.$Array<Schema.String>;
+}>;
+export declare const run_log: Tool.Tool<"run_log", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly lines: Schema.optional<Schema.Int>;
+    }>;
+    readonly success: Schema.Struct<{
+        readonly stdout: Schema.$Array<Schema.String>;
+        readonly stderr: Schema.$Array<Schema.String>;
+    }>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const story_detail: Tool.Tool<"story_detail", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly epic: Schema.String;
+        readonly story: Schema.String;
+    }>;
+    readonly success: typeof StoryDetail;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic, typeof UnknownStory, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const diagnose: Tool.Tool<"diagnose", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly story: Schema.optional<Schema.String>;
+        readonly chars: Schema.optional<Schema.Int>;
+    }>;
+    readonly success: typeof Diagnosis;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof UnknownStory, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const transcript_tail: Tool.Tool<"transcript_tail", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly lane: Schema.String;
+        readonly entries: Schema.optional<Schema.Int>;
+        readonly role: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.$Array<Schema.String>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const costs: Tool.Tool<"costs", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly runId: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.Union<readonly [typeof CostsOut, typeof CostsResult]>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const profile: Tool.Tool<"profile", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+    }>;
+    readonly success: Schema.Struct<{
+        readonly estimated: Schema.Boolean;
+        readonly wallMs: Schema.Number;
+        readonly stories: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly executor: Schema.optionalKey<Schema.String>;
+            readonly status: Schema.Literals<readonly ["done", "failed", "running"]>;
+            readonly wallMs: Schema.Number;
+            readonly queuedMs: Schema.optionalKey<Schema.Number>;
+            readonly time: Schema.Struct<{
+                readonly model: Schema.Number;
+                readonly tools: Schema.Number;
+                readonly gates: Schema.Number;
+                readonly merge: Schema.Number;
+                readonly waiting: Schema.Number;
+                readonly unaccounted: Schema.Number;
+            }>;
+            readonly turns: Schema.Struct<{
+                readonly count: Schema.Int;
+                readonly avgMs: Schema.Number;
+                readonly maxMs: Schema.Number;
+                readonly firstPrompt: Schema.optionalKey<Schema.Int>;
+                readonly lastPrompt: Schema.optionalKey<Schema.Int>;
+                readonly maxPrompt: Schema.optionalKey<Schema.Int>;
+                readonly promptGrowth: Schema.Boolean;
+                readonly avgSteps: Schema.Number;
+                readonly avgStepMs: Schema.Number;
+            }>;
+            readonly gaps: Schema.$Array<Schema.Struct<{
+                readonly ms: Schema.Number;
+                readonly after: Schema.String;
+                readonly before: Schema.String;
+            }>>;
+            readonly openTurnMs: Schema.Number;
+            readonly openTurnTools: Schema.Int;
+            readonly toolCalls: Schema.Struct<{
+                readonly explore: Schema.Int;
+                readonly edit: Schema.Int;
+                readonly test: Schema.Int;
+                readonly other: Schema.Int;
+            }>;
+            readonly tasks: Schema.Int;
+            readonly firstEditMs: Schema.optionalKey<Schema.Number>;
+            readonly exploreBeforeEdit: Schema.Int;
+            readonly unverifiedClaims: Schema.Int;
+            readonly lowConfidenceTasks: Schema.Int;
+        }>>;
+        readonly skipped: Schema.$Array<Schema.String>;
+        readonly totals: Schema.Struct<{
+            readonly model: Schema.Number;
+            readonly tools: Schema.Number;
+            readonly gates: Schema.Number;
+            readonly merge: Schema.Number;
+            readonly waiting: Schema.Number;
+            readonly unaccounted: Schema.Number;
+        }>;
+        readonly models: Schema.$Array<Schema.Struct<{
+            readonly role: Schema.String;
+            readonly executor: Schema.optionalKey<Schema.String>;
+            readonly calls: Schema.Int;
+            readonly ms: Schema.Number;
+            readonly avgMs: Schema.Number;
+            readonly avgFirstMs: Schema.optionalKey<Schema.Number>;
+            readonly apiMs: Schema.optionalKey<Schema.Number>;
+            readonly toolMs: Schema.optionalKey<Schema.Number>;
+        }>>;
+        readonly gates: Schema.$Array<Schema.Struct<{
+            readonly command: Schema.String;
+            readonly runs: Schema.Int;
+            readonly ms: Schema.Number;
+            readonly avgMs: Schema.Number;
+            readonly failed: Schema.Int;
+        }>>;
+        readonly tools: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.String;
+            readonly count: Schema.Int;
+            readonly ms: Schema.Number;
+        }>>;
+        readonly toolCategories: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.String;
+            readonly count: Schema.Int;
+            readonly ms: Schema.Number;
+        }>>;
+        readonly waits: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.String;
+            readonly count: Schema.Int;
+            readonly ms: Schema.Number;
+        }>>;
+        readonly outside: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.String;
+            readonly count: Schema.Int;
+            readonly ms: Schema.Number;
+        }>>;
+        readonly findings: Schema.$Array<Schema.Struct<{
+            readonly text: Schema.String;
+            readonly ms: Schema.optionalKey<Schema.Number>;
+        }>>;
+    }>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const RetroOut: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly at: Schema.Number;
+    readonly approved: Schema.Boolean;
+    readonly applied: Schema.Boolean;
+}>;
+export declare const retro_list: Tool.Tool<"retro_list", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly epic: Schema.String;
+    }>;
+    readonly success: Schema.$Array<Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly at: Schema.Number;
+        readonly approved: Schema.Boolean;
+        readonly applied: Schema.Boolean;
+    }>>;
+    readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const readToolkit: Toolkit.Toolkit<{
+    readonly preflight: Tool.Tool<"preflight", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+        }>;
+        readonly success: typeof PreflightResult;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly list_flows: Tool.Tool<"list_flows", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly tier: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly kit: Schema.optionalKey<Schema.String>;
+        }>>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly list_epics: Tool.Tool<"list_epics", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly stories: Schema.Int;
+            readonly board: Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly status: Schema.Literals<readonly ["planned", "active", "waiting", "done", "failed", "skipped"]>;
+            }>>;
+            readonly lastRun: Schema.optionalKey<Schema.Struct<{
+                readonly runId: Schema.String;
+                readonly startedAt: Schema.Number;
+                readonly action: Schema.String;
+            }>>;
+        }>>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly list_runs: Tool.Tool<"list_runs", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly epic: Schema.optional<Schema.String>;
+            readonly limit: Schema.optional<Schema.Int>;
+        }>;
+        readonly success: Schema.$Array<typeof OperatorRun>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly run_status: Tool.Tool<"run_status", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+        }>;
+        readonly success: typeof RunStatus;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly run_events: Tool.Tool<"run_events", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly sinceSeq: Schema.optional<Schema.Int>;
+            readonly kinds: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly limit: Schema.optional<Schema.Int>;
+        }>;
+        readonly success: Schema.$Array<typeof TraceLine>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly run_log: Tool.Tool<"run_log", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly lines: Schema.optional<Schema.Int>;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly stdout: Schema.$Array<Schema.String>;
+            readonly stderr: Schema.$Array<Schema.String>;
+        }>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly story_detail: Tool.Tool<"story_detail", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly epic: Schema.String;
+            readonly story: Schema.String;
+        }>;
+        readonly success: typeof StoryDetail;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic, typeof UnknownStory, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly diagnose: Tool.Tool<"diagnose", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly story: Schema.optional<Schema.String>;
+            readonly chars: Schema.optional<Schema.Int>;
+        }>;
+        readonly success: typeof Diagnosis;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof UnknownStory, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly transcript_tail: Tool.Tool<"transcript_tail", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly lane: Schema.String;
+            readonly entries: Schema.optional<Schema.Int>;
+            readonly role: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.$Array<Schema.String>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly costs: Tool.Tool<"costs", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly runId: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.Union<readonly [typeof CostsOut, typeof CostsResult]>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly profile: Tool.Tool<"profile", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly estimated: Schema.Boolean;
+            readonly wallMs: Schema.Number;
+            readonly stories: Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly executor: Schema.optionalKey<Schema.String>;
+                readonly status: Schema.Literals<readonly ["done", "failed", "running"]>;
+                readonly wallMs: Schema.Number;
+                readonly queuedMs: Schema.optionalKey<Schema.Number>;
+                readonly time: Schema.Struct<{
+                    readonly model: Schema.Number;
+                    readonly tools: Schema.Number;
+                    readonly gates: Schema.Number;
+                    readonly merge: Schema.Number;
+                    readonly waiting: Schema.Number;
+                    readonly unaccounted: Schema.Number;
+                }>;
+                readonly turns: Schema.Struct<{
+                    readonly count: Schema.Int;
+                    readonly avgMs: Schema.Number;
+                    readonly maxMs: Schema.Number;
+                    readonly firstPrompt: Schema.optionalKey<Schema.Int>;
+                    readonly lastPrompt: Schema.optionalKey<Schema.Int>;
+                    readonly maxPrompt: Schema.optionalKey<Schema.Int>;
+                    readonly promptGrowth: Schema.Boolean;
+                    readonly avgSteps: Schema.Number;
+                    readonly avgStepMs: Schema.Number;
+                }>;
+                readonly gaps: Schema.$Array<Schema.Struct<{
+                    readonly ms: Schema.Number;
+                    readonly after: Schema.String;
+                    readonly before: Schema.String;
+                }>>;
+                readonly openTurnMs: Schema.Number;
+                readonly openTurnTools: Schema.Int;
+                readonly toolCalls: Schema.Struct<{
+                    readonly explore: Schema.Int;
+                    readonly edit: Schema.Int;
+                    readonly test: Schema.Int;
+                    readonly other: Schema.Int;
+                }>;
+                readonly tasks: Schema.Int;
+                readonly firstEditMs: Schema.optionalKey<Schema.Number>;
+                readonly exploreBeforeEdit: Schema.Int;
+                readonly unverifiedClaims: Schema.Int;
+                readonly lowConfidenceTasks: Schema.Int;
+            }>>;
+            readonly skipped: Schema.$Array<Schema.String>;
+            readonly totals: Schema.Struct<{
+                readonly model: Schema.Number;
+                readonly tools: Schema.Number;
+                readonly gates: Schema.Number;
+                readonly merge: Schema.Number;
+                readonly waiting: Schema.Number;
+                readonly unaccounted: Schema.Number;
+            }>;
+            readonly models: Schema.$Array<Schema.Struct<{
+                readonly role: Schema.String;
+                readonly executor: Schema.optionalKey<Schema.String>;
+                readonly calls: Schema.Int;
+                readonly ms: Schema.Number;
+                readonly avgMs: Schema.Number;
+                readonly avgFirstMs: Schema.optionalKey<Schema.Number>;
+                readonly apiMs: Schema.optionalKey<Schema.Number>;
+                readonly toolMs: Schema.optionalKey<Schema.Number>;
+            }>>;
+            readonly gates: Schema.$Array<Schema.Struct<{
+                readonly command: Schema.String;
+                readonly runs: Schema.Int;
+                readonly ms: Schema.Number;
+                readonly avgMs: Schema.Number;
+                readonly failed: Schema.Int;
+            }>>;
+            readonly tools: Schema.$Array<Schema.Struct<{
+                readonly label: Schema.String;
+                readonly count: Schema.Int;
+                readonly ms: Schema.Number;
+            }>>;
+            readonly toolCategories: Schema.$Array<Schema.Struct<{
+                readonly label: Schema.String;
+                readonly count: Schema.Int;
+                readonly ms: Schema.Number;
+            }>>;
+            readonly waits: Schema.$Array<Schema.Struct<{
+                readonly label: Schema.String;
+                readonly count: Schema.Int;
+                readonly ms: Schema.Number;
+            }>>;
+            readonly outside: Schema.$Array<Schema.Struct<{
+                readonly label: Schema.String;
+                readonly count: Schema.Int;
+                readonly ms: Schema.Number;
+            }>>;
+            readonly findings: Schema.$Array<Schema.Struct<{
+                readonly text: Schema.String;
+                readonly ms: Schema.optionalKey<Schema.Number>;
+            }>>;
+        }>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly retro_list: Tool.Tool<"retro_list", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly epic: Schema.String;
+        }>;
+        readonly success: Schema.$Array<Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly at: Schema.Number;
+            readonly approved: Schema.Boolean;
+            readonly applied: Schema.Boolean;
+        }>>;
+        readonly failure: Schema.Union<readonly [typeof UnknownRepo, typeof UnknownEpic]>;
+        readonly failureMode: "error";
+    }, never>;
+}>;
+export declare const readHandlers: (deps: OperatorDeps) => Toolkit.HandlersFrom<Toolkit.Tools<typeof readToolkit>>;
+//# sourceMappingURL=OperatorTools.d.ts.map

package/dist/OperatorTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperatorTools.d.ts","sourceRoot":"","sources":["../src/OperatorTools.ts"],"names":[],"mappings":"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"}