toolroll 0.9.93 → 0.9.95

package/dist/contracts/flow-send.d.ts

@@ -60,6 +60,69 @@ export declare const flowSendPayloadSchema: z.ZodObject<{
         plug: z.ZodString;
         shot: z.ZodNullable<z.ZodInt>;
     }, z.core.$strict>>>;
+    card: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        title: z.ZodString;
+        asOf: z.ZodString;
+        repos: z.ZodArray<z.ZodString>;
+        blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"divider">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"facts">;
+            heading: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"table">;
+            heading: z.ZodString;
+            origin: z.ZodEnum<{
+                records: "records";
+                report: "report";
+            }>;
+            columns: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                numeric: z.ZodBoolean;
+            }, z.core.$strict>>;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            more: z.ZodInt;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"notes">;
+            heading: z.ZodString;
+            origin: z.ZodEnum<{
+                records: "records";
+                report: "report";
+            }>;
+            items: z.ZodArray<z.ZodString>;
+            more: z.ZodInt;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"chart">;
+            heading: z.ZodString;
+            chart: z.ZodEnum<{
+                area: "area";
+                bar: "bar";
+                line: "line";
+                pie: "pie";
+            }>;
+            points: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodNumber;
+                shown: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">>;
+        buttons: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strict>>;
+        actions: z.ZodArray<z.ZodObject<{
+            proposal: z.ZodInt;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const flowChoosePayloadSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -85,6 +148,69 @@ export declare const flowChoosePayloadSchema: z.ZodObject<{
         plug: z.ZodString;
         shot: z.ZodNullable<z.ZodInt>;
     }, z.core.$strict>>>;
+    card: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        title: z.ZodString;
+        asOf: z.ZodString;
+        repos: z.ZodArray<z.ZodString>;
+        blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"divider">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"facts">;
+            heading: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"table">;
+            heading: z.ZodString;
+            origin: z.ZodEnum<{
+                records: "records";
+                report: "report";
+            }>;
+            columns: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                numeric: z.ZodBoolean;
+            }, z.core.$strict>>;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            more: z.ZodInt;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"notes">;
+            heading: z.ZodString;
+            origin: z.ZodEnum<{
+                records: "records";
+                report: "report";
+            }>;
+            items: z.ZodArray<z.ZodString>;
+            more: z.ZodInt;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"chart">;
+            heading: z.ZodString;
+            chart: z.ZodEnum<{
+                area: "area";
+                bar: "bar";
+                line: "line";
+                pie: "pie";
+            }>;
+            points: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodNumber;
+                shown: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">>;
+        buttons: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strict>>;
+        actions: z.ZodArray<z.ZodObject<{
+            proposal: z.ZodInt;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
     options: z.ZodArray<z.ZodObject<{
         choice: z.ZodInt;
         label: z.ZodString;

package/dist/contracts/flow-send.js

@@ -12,6 +12,7 @@
  */
 import { z } from "zod";
 import { parseContract, readVersioned, versioned } from "./contract.js";
+import { chatCardSchema } from "./chat-card.js";
 import { isRecord } from "../is-record.js";
 /** A link the message carries: a page of Toolroll's (a button) or the one outside page, a pull request. */
 export const flowSendLinkSchema = z.union([
@@ -42,6 +43,8 @@ const sendShape = {
     shots: z.strictObject({ taskId: z.string(), run: z.int() }).nullable(),
     /** After research: the report's items, numbered in this order in every message and screenshot caption. */
     items: z.array(flowSendItemSchema).min(1).optional(),
+    /** A "Send to me" visit's result as a card (flow-result-card.ts), from what the flow recorded. */
+    card: chatCardSchema.optional(),
 };
 export const flowChoiceOptionSchema = z.strictObject({ choice: z.int().min(0), label: z.string() });
 export const flowSendPayloadSchema = versioned(FLOW_SEND_VERSION, sendShape);

package/dist/contracts/gateway-tools.d.ts

@@ -49,6 +49,19 @@ export declare const GATEWAY_TOOL_INPUTS: {
             search: "search";
         }>>;
     }, z.core.$strict>;
+    readonly get_code_map: z.ZodObject<{
+        repo: z.ZodString;
+        version: z.ZodOptional<z.ZodInt>;
+        view: z.ZodEnum<{
+            area: "area";
+            file: "file";
+            overview: "overview";
+            search: "search";
+        }>;
+        id: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly get_assignment: z.ZodObject<{
         ref: z.ZodString;
     }, z.core.$strict>;
@@ -157,6 +170,10 @@ export declare const GATEWAY_TOOL_OUTPUTS: {
         asOf: z.ZodString;
         excerpts: z.ZodArray<z.ZodUnknown>;
     }, z.core.$loose>;
+    readonly get_code_map: z.ZodObject<{
+        v: z.ZodLiteral<1>;
+        ok: z.ZodBoolean;
+    }, z.core.$loose>;
     readonly get_assignment: z.ZodObject<{
         version: z.ZodLiteral<1>;
         rootId: z.ZodString;

package/dist/contracts/gateway-tools.js

@@ -11,7 +11,7 @@
 import { z } from "zod";
 import { TEXT_LIMITS } from "../text-limits.js";
 import { envelopeSchema } from "./cli.js";
-import { catchUpOutput, decisionOutput, decisionsOutput, LISTED_TASK_STATES, queueColumnsOutput, recapOutput, repositoryContextOutput, scopeText, touches } from "./lead-tools.js";
+import { catchUpOutput, CODE_MAP_VIEWS, codeMapOutput, decisionOutput, decisionsOutput, LISTED_TASK_STATES, queueColumnsOutput, recapOutput, repositoryContextOutput, scopeText, touches } from "./lead-tools.js";
 const text = (key) => z.string().max(TEXT_LIMITS[key]);
 const ref = z.string().min(1).max(TEXT_LIMITS.taskRef);
 const projectPath = text("projectPath").min(1);
@@ -30,6 +30,7 @@ export const ASSIGNMENT_INPUTS = {
 };
 export const GATEWAY_TOOL_INPUTS = {
     get_project_context: z.strictObject({ repo: projectPath, query: text("contextQuery").min(1), mode: z.enum(["search", "impact"]).optional() }),
+    get_code_map: z.strictObject({ repo: projectPath, version: z.int().min(1).optional(), view: z.enum(CODE_MAP_VIEWS), id: text("projectPath").optional(), query: text("contextQuery").optional(), cursor: z.string().max(40).optional() }),
     get_assignment: ASSIGNMENT_INPUTS.show,
     list_assignment_updates: ASSIGNMENT_INPUTS.updates,
     claim_assignment: ASSIGNMENT_INPUTS.claim,
@@ -68,6 +69,7 @@ const proposed = z.looseObject({ proposal: int, kind: z.enum(["next", "reserve",
 const assignmentOutput = z.looseObject({ version: z.literal(1), rootId: str, activeTaskId: str, title: str, state: str, detail: str, attention: z.array(str) });
 export const GATEWAY_TOOL_OUTPUTS = {
     get_project_context: repositoryContextOutput,
+    get_code_map: codeMapOutput,
     get_assignment: assignmentOutput,
     list_assignment_updates: z.looseObject({ events: list, nextCursor: int, hasMore: z.boolean() }),
     claim_assignment: assignmentOutput,

package/dist/contracts/lead-tools.d.ts

@@ -30,6 +30,7 @@ export declare const acceptance: z.ZodArray<z.ZodObject<{
         screenshot: "screenshot";
     }>>;
 }, z.core.$strict>>;
+export declare const CODE_MAP_VIEWS: readonly ["overview", "area", "file", "search"];
 /** Task states a list filters by. */
 export declare const LISTED_TASK_STATES: readonly ["queued", "running", "done", "failed", "cancelled"];
 export declare const LEAD_TOOL_INPUTS: {
@@ -48,6 +49,22 @@ export declare const LEAD_TOOL_INPUTS: {
             search: "search";
         }>>;
     }, z.core.$strict>;
+    readonly get_code_map: z.ZodObject<{
+        repo: z.ZodString;
+        version: z.ZodOptional<z.ZodInt>;
+        view: z.ZodEnum<{
+            area: "area";
+            file: "file";
+            overview: "overview";
+            search: "search";
+        }>;
+        id: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly refresh_code_map: z.ZodObject<{
+        repo: z.ZodString;
+    }, z.core.$strict>;
     readonly get_action_status: z.ZodObject<{
         proposal: z.ZodInt;
     }, z.core.$strict>;
@@ -74,6 +91,23 @@ export declare const LEAD_TOOL_INPUTS: {
         url: z.ZodOptional<z.ZodString>;
         secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         about: z.ZodOptional<z.ZodString>;
+        on: z.ZodOptional<z.ZodBoolean>;
+        finding: z.ZodOptional<z.ZodInt>;
+        summary: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodInt>;
+        pointer: z.ZodOptional<z.ZodString>;
+        revision: z.ZodOptional<z.ZodInt>;
+        incident: z.ZodOptional<z.ZodInt>;
+        provider: z.ZodOptional<z.ZodString>;
+        runner: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        proposal: z.ZodOptional<z.ZodInt>;
+        decision: z.ZodOptional<z.ZodEnum<{
+            accept: "accept";
+            reject: "reject";
+        }>>;
+        reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     readonly propose_task_action: z.ZodObject<{
         task: z.ZodString;
@@ -92,6 +126,63 @@ export declare const LEAD_TOOL_INPUTS: {
         repo: z.ZodOptional<z.ZodString>;
         run: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
+    readonly show_card: z.ZodObject<{
+        spec: z.ZodObject<{
+            root: z.ZodString;
+            elements: z.ZodObject<{}, z.core.$catchall<z.ZodObject<{
+                type: z.ZodEnum<{
+                    [x: string]: string;
+                }>;
+                props: z.ZodObject<{
+                    source: z.ZodOptional<z.ZodEnum<{
+                        builders: "builders";
+                        findings: "findings";
+                        flow_zones: "flow_zones";
+                        flows: "flows";
+                        handover: "handover";
+                        integrations: "integrations";
+                        mode: "mode";
+                        projects: "projects";
+                        providers: "providers";
+                        results: "results";
+                        spend: "spend";
+                        tasks: "tasks";
+                    }>>;
+                    chart: z.ZodOptional<z.ZodEnum<{
+                        area: "area";
+                        bar: "bar";
+                        line: "line";
+                        pie: "pie";
+                    }>>;
+                    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    facts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    repo: z.ZodOptional<z.ZodString>;
+                    state: z.ZodOptional<z.ZodEnum<{
+                        cancelled: "cancelled";
+                        done: "done";
+                        failed: "failed";
+                        queued: "queued";
+                        running: "running";
+                    }>>;
+                    limit: z.ZodOptional<z.ZodInt>;
+                    flow: z.ZodOptional<z.ZodInt>;
+                    days: z.ZodOptional<z.ZodInt>;
+                    text: z.ZodOptional<z.ZodString>;
+                    control: z.ZodOptional<z.ZodEnum<{
+                        [x: string]: string;
+                    }>>;
+                    task: z.ZodOptional<z.ZodString>;
+                    run: z.ZodOptional<z.ZodInt>;
+                    proposal: z.ZodOptional<z.ZodInt>;
+                }, z.core.$strict>;
+                children: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    readonly get_findings: z.ZodObject<{
+        task: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly offer_approval: z.ZodObject<{
         task: z.ZodOptional<z.ZodString>;
         card: z.ZodOptional<z.ZodInt>;
@@ -156,7 +247,9 @@ export declare const LEAD_TOOL_INPUTS: {
             add_card: "add_card";
             add_trigger: "add_trigger";
             allow_browser: "allow_browser";
+            allow_unattended: "allow_unattended";
             approve: "approve";
+            archive: "archive";
             assign: "assign";
             cancel_card: "cancel_card";
             choose: "choose";
@@ -173,11 +266,16 @@ export declare const LEAD_TOOL_INPUTS: {
             send_back: "send_back";
             starter: "starter";
             turn_off_browser: "turn_off_browser";
+            turn_off_unattended: "turn_off_unattended";
             unfollow: "unfollow";
         }>;
         repo: z.ZodOptional<z.ZodString>;
         flow: z.ZodOptional<z.ZodInt>;
         card: z.ZodOptional<z.ZodInt>;
+        days: z.ZodOptional<z.ZodInt>;
+        budget: z.ZodOptional<z.ZodString>;
+        runs: z.ZodOptional<z.ZodString>;
+        include: z.ZodOptional<z.ZodArray<z.ZodInt>>;
         kit: z.ZodOptional<z.ZodEnum<{
             [x: string]: string;
         }>>;
@@ -537,6 +635,10 @@ export declare const LEAD_TOOL_INPUTS: {
         reference: z.ZodOptional<z.ZodString>;
         decision: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
+    readonly get_flaky_tests: z.ZodObject<{
+        repo: z.ZodString;
+        row: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly get_task_conversation: z.ZodObject<{
         task: z.ZodString;
         limit: z.ZodOptional<z.ZodInt>;
@@ -785,6 +887,22 @@ export declare const LEAD_TOOL_READ_INPUTS: {
             search: "search";
         }>>;
     }, z.core.$strict>;
+    readonly get_code_map: z.ZodObject<{
+        repo: z.ZodString;
+        version: z.ZodOptional<z.ZodInt>;
+        view: z.ZodEnum<{
+            area: "area";
+            file: "file";
+            overview: "overview";
+            search: "search";
+        }>;
+        id: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly refresh_code_map: z.ZodObject<{
+        repo: z.ZodString;
+    }, z.core.$strict>;
     readonly get_action_status: z.ZodObject<{
         proposal: z.ZodInt;
     }, z.core.$strict>;
@@ -811,6 +929,23 @@ export declare const LEAD_TOOL_READ_INPUTS: {
         url: z.ZodOptional<z.ZodString>;
         secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
         about: z.ZodOptional<z.ZodString>;
+        on: z.ZodOptional<z.ZodBoolean>;
+        finding: z.ZodOptional<z.ZodInt>;
+        summary: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodInt>;
+        pointer: z.ZodOptional<z.ZodString>;
+        revision: z.ZodOptional<z.ZodInt>;
+        incident: z.ZodOptional<z.ZodInt>;
+        provider: z.ZodOptional<z.ZodString>;
+        runner: z.ZodOptional<z.ZodString>;
+        persona: z.ZodOptional<z.ZodString>;
+        proposal: z.ZodOptional<z.ZodInt>;
+        decision: z.ZodOptional<z.ZodEnum<{
+            accept: "accept";
+            reject: "reject";
+        }>>;
+        reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     readonly propose_task_action: z.ZodObject<{
         task: z.ZodString;
@@ -829,6 +964,63 @@ export declare const LEAD_TOOL_READ_INPUTS: {
         repo: z.ZodOptional<z.ZodString>;
         run: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
+    readonly show_card: z.ZodObject<{
+        spec: z.ZodObject<{
+            root: z.ZodString;
+            elements: z.ZodObject<{}, z.core.$catchall<z.ZodObject<{
+                type: z.ZodEnum<{
+                    [x: string]: string;
+                }>;
+                props: z.ZodObject<{
+                    source: z.ZodOptional<z.ZodEnum<{
+                        builders: "builders";
+                        findings: "findings";
+                        flow_zones: "flow_zones";
+                        flows: "flows";
+                        handover: "handover";
+                        integrations: "integrations";
+                        mode: "mode";
+                        projects: "projects";
+                        providers: "providers";
+                        results: "results";
+                        spend: "spend";
+                        tasks: "tasks";
+                    }>>;
+                    chart: z.ZodOptional<z.ZodEnum<{
+                        area: "area";
+                        bar: "bar";
+                        line: "line";
+                        pie: "pie";
+                    }>>;
+                    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    facts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    repo: z.ZodOptional<z.ZodString>;
+                    state: z.ZodOptional<z.ZodEnum<{
+                        cancelled: "cancelled";
+                        done: "done";
+                        failed: "failed";
+                        queued: "queued";
+                        running: "running";
+                    }>>;
+                    limit: z.ZodOptional<z.ZodInt>;
+                    flow: z.ZodOptional<z.ZodInt>;
+                    days: z.ZodOptional<z.ZodInt>;
+                    text: z.ZodOptional<z.ZodString>;
+                    control: z.ZodOptional<z.ZodEnum<{
+                        [x: string]: string;
+                    }>>;
+                    task: z.ZodOptional<z.ZodString>;
+                    run: z.ZodOptional<z.ZodInt>;
+                    proposal: z.ZodOptional<z.ZodInt>;
+                }, z.core.$strict>;
+                children: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    readonly get_findings: z.ZodObject<{
+        task: z.ZodOptional<z.ZodString>;
+        repo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly offer_approval: z.ZodObject<{
         task: z.ZodOptional<z.ZodString>;
         card: z.ZodOptional<z.ZodInt>;
@@ -893,7 +1085,9 @@ export declare const LEAD_TOOL_READ_INPUTS: {
             add_card: "add_card";
             add_trigger: "add_trigger";
             allow_browser: "allow_browser";
+            allow_unattended: "allow_unattended";
             approve: "approve";
+            archive: "archive";
             assign: "assign";
             cancel_card: "cancel_card";
             choose: "choose";
@@ -910,11 +1104,16 @@ export declare const LEAD_TOOL_READ_INPUTS: {
             send_back: "send_back";
             starter: "starter";
             turn_off_browser: "turn_off_browser";
+            turn_off_unattended: "turn_off_unattended";
             unfollow: "unfollow";
         }>;
         repo: z.ZodOptional<z.ZodString>;
         flow: z.ZodOptional<z.ZodInt>;
         card: z.ZodOptional<z.ZodInt>;
+        days: z.ZodOptional<z.ZodInt>;
+        budget: z.ZodOptional<z.ZodString>;
+        runs: z.ZodOptional<z.ZodString>;
+        include: z.ZodOptional<z.ZodArray<z.ZodInt>>;
         kit: z.ZodOptional<z.ZodEnum<{
             [x: string]: string;
         }>>;
@@ -1267,6 +1466,10 @@ export declare const LEAD_TOOL_READ_INPUTS: {
         reference: z.ZodOptional<z.ZodString>;
         decision: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
+    readonly get_flaky_tests: z.ZodObject<{
+        repo: z.ZodString;
+        row: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly commit_to: z.ZodObject<{
         what: z.ZodString;
         when: z.ZodEnum<{
@@ -1503,6 +1706,11 @@ export declare const LEAD_TOOL_READ_INPUTS: {
 export type LeadToolInput<N extends LeadToolName> = z.infer<(typeof LEAD_TOOL_READ_INPUTS)[N]>;
 /** How a tool's call names a key it doesn't know: propose_flow suggests the flow vocabulary's own words. */
 export declare const LEAD_TOOL_OPTIONS: Partial<Record<LeadToolName, ContractOptions>>;
+/** One bounded answer from the shared code map reader (code-map-read.ts `MapAnswer`). */
+export declare const codeMapOutput: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    ok: z.ZodBoolean;
+}, z.core.$loose>;
 /** A repository-context read (repository-context.ts `RepositoryContext`). */
 export declare const repositoryContextOutput: z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -1609,6 +1817,16 @@ export declare const LEAD_TOOL_OUTPUTS: {
         asOf: z.ZodString;
         excerpts: z.ZodArray<z.ZodUnknown>;
     }, z.core.$loose>;
+    readonly get_code_map: z.ZodObject<{
+        v: z.ZodLiteral<1>;
+        ok: z.ZodBoolean;
+    }, z.core.$loose>;
+    readonly refresh_code_map: z.ZodObject<{
+        request: z.ZodEnum<{
+            "already-queued": "already-queued";
+            queued: "queued";
+        }>;
+    }, z.core.$loose>;
     readonly get_action_status: z.ZodObject<{
         proposal: z.ZodNumber;
         operation: z.ZodString;
@@ -1651,6 +1869,19 @@ export declare const LEAD_TOOL_OUTPUTS: {
         label: z.ZodString;
         action: z.ZodString;
     }, z.core.$loose>;
+    readonly show_card: z.ZodObject<{
+        card: z.ZodNumber;
+        title: z.ZodString;
+        shows: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>;
+    readonly get_findings: z.ZodObject<{
+        findings: z.ZodArray<z.ZodObject<{
+            finding: z.ZodNumber;
+            task: z.ZodString;
+            state: z.ZodString;
+        }, z.core.$loose>>;
+        rule: z.ZodString;
+    }, z.core.$loose>;
     readonly offer_approval: z.ZodObject<{
         offered: z.ZodBoolean;
     }, z.core.$loose>;
@@ -1824,6 +2055,9 @@ export declare const LEAD_TOOL_OUTPUTS: {
     readonly get_project_knowledge: z.ZodObject<{
         revision: z.ZodNumber;
     }, z.core.$loose>;
+    readonly get_flaky_tests: z.ZodObject<{
+        notice: z.ZodString;
+    }, z.core.$loose>;
     readonly get_task_conversation: z.ZodObject<{
         task: z.ZodString;
         messages: z.ZodArray<z.ZodObject<{

package/dist/contracts/lead-tools.js

@@ -11,7 +11,9 @@
 import { z } from "zod";
 import { CHAT_ACTIONS } from "../chat-actions.js";
 import { RESULT_IMAGES_PER_TURN_CAP } from "../chat-evidence.js";
+import { CARD_CATALOG, CARD_SOURCES, CARD_TASK_STATES } from "../card-catalog.js";
 import { CHAT_CONTROLS } from "../chat-controls.js";
+import { CARD_CHART_TYPES, CARD_LIMITS } from "./chat-card.js";
 import { CHAT_TASK_ACTIONS } from "../chat-task-actions.js";
 import { LIMITS } from "../decision.js";
 import { CHECK_RESULTS, RUN_OUTCOMES, TASK_STATES } from "../lead-commitments.js";
@@ -46,14 +48,24 @@ export const touches = z.array(text("taskTouch")).max(50);
 export const acceptance = z.array(acceptanceCriterionSchema).min(1).max(ACCEPTANCE_LIMITS.criteria);
 /** A note the operator's own words fill (revise feedback, steering, a flow card's note). */
 const note = z.string().max(LIMITS.note, { error: issue => overBy(LIMITS.note, issue.input) }).describe(`At most ${LIMITS.note} characters; longer is refused with its length, not cut.`);
+export const CODE_MAP_VIEWS = ["overview", "area", "file", "search"];
 /** Task states a list filters by. */
 export const LISTED_TASK_STATES = ["queued", "running", "done", "failed", "cancelled"];
 /** The shared actions the lead proposes with propose_action; flows and subagents have their own tools. */
 const ACTION_OPERATIONS = Object.keys(CHAT_ACTIONS).filter(one => !one.startsWith("flow_") && !one.startsWith("subagent_"));
+/** A card's spec as the lead sees it: one flat props object. Each element's own props are read strictly by card-catalog.ts. */
+const cardProps = z.strictObject({
+    source: z.enum(CARD_SOURCES).optional(), chart: z.enum(CARD_CHART_TYPES).optional(), columns: z.array(z.string().max(40)).max(CARD_LIMITS.columns).optional(), facts: z.array(z.string().max(40)).max(CARD_LIMITS.facts).optional(),
+    repo: repoId.optional(), state: z.enum(CARD_TASK_STATES).optional(), limit: z.int().min(1).max(CARD_LIMITS.rows).optional(), flow: id.optional(), days: z.int().min(1).max(90).optional(),
+    text: z.string().max(CARD_LIMITS.text).optional(), control: enumOf(Object.keys(CHAT_CONTROLS)).optional(), task: taskRef.optional(), run: id.optional(), proposal: id.optional(),
+});
+const cardSpec = z.strictObject({ root: z.string().max(40), elements: z.object({}).catchall(z.strictObject({ type: enumOf(Object.keys(CARD_CATALOG.data.components)), props: cardProps, children: z.array(z.string().max(40)).max(16) })) });
 export const LEAD_TOOL_INPUTS = {
     get_brief: z.strictObject({ repo: repoId.optional() }),
     get_project_activity: z.strictObject({ repo: repoId, offset: offset.optional() }),
     get_project_context: z.strictObject({ repo: repoId, query: text("contextQuery").min(1), mode: z.enum(["search", "impact"]).optional() }),
+    get_code_map: z.strictObject({ repo: repoId, version: id.optional(), view: z.enum(CODE_MAP_VIEWS), id: text("projectPath").optional(), query: text("contextQuery").optional(), cursor: z.string().max(40).optional() }),
+    refresh_code_map: z.strictObject({ repo: repoId }),
     get_action_status: z.strictObject({ proposal: id }),
     get_actions: z.strictObject({}),
     propose_action: z.strictObject({
@@ -61,11 +73,15 @@ export const LEAD_TOOL_INPUTS = {
         sample: text("actionSample").optional(), content: text("actionContent").optional(), instructions: text("flowInstructions").optional(),
         title: text("actionTitle").optional(), id: z.string().optional(), run: id.optional(), note: note.optional(), catalog: text("actionName").optional(),
         name: text("actionName").optional(), command: text("actionCommand").optional(), args: z.array(text("actionCommand")).max(40).optional(),
-        url: text("actionUrl").optional(), secrets: z.array(text("actionSecret")).max(12).optional(), about: text("actionAbout").optional(),
+        url: text("actionUrl").optional(), secrets: z.array(text("actionSecret")).max(12).optional(), about: text("actionAbout").optional(), on: z.boolean().optional(),
+        finding: id.optional(), summary: text("actionAbout").optional(), file: text("actionName").optional(), line: id.optional(), pointer: z.string().max(40).optional(),
+        revision: id.optional(), incident: id.optional(), provider: z.string().max(40).optional(), runner: text("actionName").optional(), persona: note.optional(), proposal: id.optional(), decision: z.enum(["accept", "reject"]).optional(), reason: text("actionAbout").optional(),
     }),
     propose_task_action: z.strictObject({ task: taskRef, operation: enumOf(Object.keys(CHAT_TASK_ACTIONS)), dependency: taskRef.optional(), run: id.optional() }),
     get_controls: z.strictObject({}),
     show_control: z.strictObject({ control: enumOf(Object.keys(CHAT_CONTROLS)), task: taskRef.optional(), repo: repoId.optional(), run: id.optional() }),
+    show_card: z.strictObject({ spec: cardSpec }),
+    get_findings: z.strictObject({ task: taskRef.optional(), repo: repoId.optional() }),
     offer_approval: z.strictObject({ task: taskRef.optional(), card: id.optional() }),
     get_result: z.strictObject({ task: taskRef, run: id.optional(), feedback_offset: offset.optional() }),
     get_diff: z.strictObject({ task: taskRef, run: id.optional(), file: text("diffPath").min(1).optional(), offset: offset.optional() }),
@@ -100,6 +116,7 @@ export const LEAD_TOOL_INPUTS = {
     get_flow_insights: z.strictObject({ repo: repoId.optional(), flow: id.optional(), days: z.int().min(1).max(90).optional(), card: id.optional(), entry: id.optional() }),
     get_skills: z.strictObject({ repo: repoId, version: z.string().regex(/^[a-f0-9]{20}$/).optional(), offset: offset.optional() }),
     get_project_knowledge: z.strictObject({ repo: repoId, reference: text("knowledgeReference").optional(), decision: id.optional() }),
+    get_flaky_tests: z.strictObject({ repo: repoId, row: text("knowledgeReference").optional() }),
     get_task_conversation: z.strictObject({ task: taskRef, limit: z.int().min(1).max(30).optional() }),
     commit_to: z.strictObject({
         what: text("promise").min(3), when: z.enum(["task", "run", "check", "time"]), task: taskRef.optional(), run: id.optional(),
@@ -185,6 +202,8 @@ const rows = (shape) => z.array(z.looseObject(shape));
 const cardDrafted = z.looseObject({ proposal: int, label: str, awaiting: str, executed: z.literal(false) });
 /** A proposal row drafted by one of the queue, hold, scope and answer tools. */
 const proposed = (kind, shape = {}) => z.looseObject({ proposal: int, kind: z.literal(kind), awaiting: str, ...shape });
+/** One bounded answer from the shared code map reader (code-map-read.ts `MapAnswer`). */
+export const codeMapOutput = z.looseObject({ v: z.literal(1), ok: z.boolean() });
 /** A repository-context read (repository-context.ts `RepositoryContext`). */
 export const repositoryContextOutput = z.looseObject({ version: z.literal(1), readOnly: z.boolean(), query: str, mode: z.enum(["search", "impact"]), asOf: str, excerpts: list });
 /** The local catch-up (assignment-brief.ts `AssignmentCatchUp`). */
@@ -201,12 +220,16 @@ export const LEAD_TOOL_OUTPUTS = {
     get_brief: catchUpOutput,
     get_project_activity: z.looseObject({ asOf: str, since: str, days: int, limit: int, truncated: z.boolean(), ready: z.object({ count: int, oldestFinishedAgeMs: nullable(int), dated: int }), completed: z.looseObject({ count: int }), families: list, familiesTotal: int, familiesOffset: int, nextOffset: nullable(int), incompleteHistory: int }),
     get_project_context: repositoryContextOutput,
+    get_code_map: codeMapOutput,
+    refresh_code_map: z.looseObject({ request: z.enum(["queued", "already-queued"]) }),
     get_action_status: z.looseObject({ proposal: int, operation: str, state: str, outcome: z.unknown(), finishedAt: nullable(str) }),
     get_actions: z.looseObject({ actions: rows({ operation: str, label: str, secureReview: z.boolean(), inputs: z.array(str) }), notice: str }),
     propose_action: cardDrafted,
     propose_task_action: z.looseObject({ proposal: int, action: str, awaiting: str }),
     get_controls: z.looseObject({ confirmedInChat: z.array(str), existingControls: rows({ id: str, label: str, needsTask: z.boolean(), needsProject: z.boolean() }), rule: str }),
     show_control: z.looseObject({ card: int, label: str, action: str }),
+    show_card: z.looseObject({ card: int, title: str, shows: z.array(str) }),
+    get_findings: z.looseObject({ findings: z.array(z.looseObject({ finding: int, task: str, state: str })), rule: str }),
     offer_approval: z.looseObject({ offered: z.boolean() }),
     get_result: z.looseObject({
         task: str, root: str, currentExecution: str, run: int, title: str, feedback: list, feedbackTotal: int, nextFeedbackOffset: nullable(int),
@@ -241,6 +264,7 @@ export const LEAD_TOOL_OUTPUTS = {
         z.looseObject({ skills: list, nextOffset: nullable(int) }),
     ]),
     get_project_knowledge: z.looseObject({ revision: int }),
+    get_flaky_tests: z.looseObject({ notice: z.string() }),
     get_task_conversation: z.looseObject({ task: str, messages: rows({ from: z.enum(["operator", "lead"]), text: str, at: str }), notice: nullable(str) }),
     commit_to: z.looseObject({ commitment: int, condition: str, expires: str, report: str }),
     release_commitment: z.looseObject({ commitment: int, state: z.literal("cancelled") }),