toolroll 0.9.55 → 0.9.56

package/dist/{mate-tools.d.ts → lead-tools.d.ts}

@@ -3,18 +3,18 @@ import { type Integration } from "./integrations.js";
 import type { AuthMode } from "./keys.js";
 import type { ProviderId } from "./provider.js";
 import { type ReviewSnapshot } from "./chat-review.js";
-import { type Store, type MateProposalKind, type MateTurnEvidence } from "./store.js";
+import { type Store, type LeadProposalKind, type LeadTurnEvidence } from "./store.js";
 import type { VerifiedApprover } from "./principal.js";
-import type { MateToolSchema } from "./converse.js";
+import type { LeadToolSchema } from "./converse.js";
 import { type AcceptanceCriterion } from "./scope.js";
 import { type ContractResult } from "./contracts/contract.js";
-export declare const MATE_MAX_PROPOSALS_PER_TURN = 5;
-export type MateToolContext = {
+export declare const LEAD_MAX_PROPOSALS_PER_TURN = 5;
+export type LeadToolContext = {
     store: Store;
     who: VerifiedApprover;
     now: Date;
     /** Records a proposal as `drafting` under the running turn; null when the turn may draft no more. */
-    draft: (kind: MateProposalKind, payload: Record<string, unknown>) => number | null;
+    draft: (kind: LeadProposalKind, payload: Record<string, unknown>) => number | null;
     /** The step this call runs in, and which decisions were read (by get_decision) at which step —
      * an answer may be proposed only for a decision read in an EARLIER step (v3 review, finding 6). */
     step: number;
@@ -27,7 +27,7 @@ export type MateToolContext = {
     evidenceRoot?: string;
     /** Records the screenshots this turn selected, under the turn, for a channel that delivers files; returns how many are recorded. Absent: nothing durable is kept. */
     /** Return the exact artifact ids reserved under this running turn, including earlier calls. */
-    selectEvidence?: (rows: readonly Omit<MateTurnEvidence, "turn" | "ordinal" | "createdAt">[]) => readonly number[];
+    selectEvidence?: (rows: readonly Omit<LeadTurnEvidence, "turn" | "ordinal" | "createdAt">[]) => readonly number[];
     /** How this surface delivers selected images: Telegram sends them as documents after the reply; every other surface shows identity only. */
     mediaDelivery?: "documents";
     /** The conversation and turn this call runs in: where a promise (commit_to) is reported. Absent: no promise can be kept. */
@@ -49,7 +49,7 @@ export type MateToolContext = {
     /** Records this turn's one question to its owner; false when it already asked one. Absent: this surface cannot ask. */
     ask?: (question: string, options: readonly string[]) => boolean;
 };
-export type MateToolResult = {
+export type LeadToolResult = {
     ok: true;
     body: unknown;
 } | {
@@ -57,18 +57,18 @@ export type MateToolResult = {
     message: string;
 };
 export { reportSummaryFor } from "./report-summary.js";
-export type MateViewContext = {
+export type LeadViewContext = {
     repos: readonly string[];
     names: readonly string[];
 };
 /** Scrub one string. Exact repo paths and their basenames go first (v13: no paths, no basenames), then shapes. */
-export declare function redactForMate(text: string, view: MateViewContext): string;
+export declare function redactForLead(text: string, view: LeadViewContext): string;
 /** The choke point: every string inside a tool result, recursively, scrubbed. */
-export declare function mateView<T>(value: T, view: MateViewContext): T;
-export declare function mateViewContextFor(store: Store, who: VerifiedApprover): MateViewContext;
+export declare function leadView<T>(value: T, view: LeadViewContext): T;
+export declare function leadViewContextFor(store: Store, who: VerifiedApprover): LeadViewContext;
 /** Project names are deliberate display metadata, not a general basename
  * exemption. Invalid, sensitive or account-identifying labels stay opaque. */
-export declare function projectLabelForMate(path: string, index: number, names: readonly string[]): string;
+export declare function projectLabelForLead(path: string, index: number, names: readonly string[]): string;
 /** The same text rule, for the gateway's proposals. */
 export declare function honestText(value: unknown, maxChars: number): value is string;
 export declare function readOptionalText(value: unknown, maxChars: number): string | null | undefined;
@@ -78,9 +78,9 @@ export declare function readTouches(value: unknown): string[] | null;
  * the argument did not even parse into a non-empty rubric. */
 export declare function readAcceptanceArg(value: unknown): AcceptanceCriterion[] | null;
 /** A lead tool as the model is shown it (its inputSchema derived from its contract) and as a call is read and run. */
-export type MateTool = MateToolSchema & {
-    read: (ctx: MateToolContext, raw: Record<string, unknown>) => ContractResult<Record<string, unknown>>;
-    handle: (ctx: MateToolContext, args: Record<string, unknown>) => MateToolResult;
+export type LeadTool = LeadToolSchema & {
+    read: (ctx: LeadToolContext, raw: Record<string, unknown>) => ContractResult<Record<string, unknown>>;
+    handle: (ctx: LeadToolContext, args: Record<string, unknown>) => LeadToolResult;
 };
 /** Replace every `repoIndex` with a `repo` label, recursively. */
 export declare function labelRepos<T>(value: T, label: (index: number) => string): T;
@@ -106,7 +106,7 @@ export declare const ISO_STAMP_RULE: RegExp;
  */
 export declare function agentsOver(store: Store, taskId: string, now: Date): Record<string, unknown> | null;
 /** The lead's tools, in the order the model is shown them: each one's inputSchema is its contract, derived. */
-export declare const MATE_TOOLS: MateTool[];
+export declare const LEAD_TOOLS: LeadTool[];
 /** A unified diff, file by file, with each file's added and removed lines. */
 export declare function patchFiles(patch: string): {
     path: string;
@@ -114,10 +114,10 @@ export declare function patchFiles(patch: string): {
     removed: number;
     text: string;
 }[];
-export declare const MATE_TOOL_SCHEMAS: MateToolSchema[];
-export declare function isMateTool(name: string): boolean;
+export declare const LEAD_TOOL_SCHEMAS: LeadToolSchema[];
+export declare function isLeadTool(name: string): boolean;
 /** Scrub every result. Only list_repos then adds validated display metadata
  * from the same admitted project list; no user-authored result gets an exemption. */
-export declare function executeMateTool(ctx: MateToolContext, name: string, args: Record<string, unknown>, view?: MateViewContext): MateToolResult;
+export declare function executeLeadTool(ctx: LeadToolContext, name: string, args: Record<string, unknown>, view?: LeadViewContext): LeadToolResult;
 /** Bytes of a serialized tool result as it will sit inside the request body. */
 export declare function toolResultBytes(text: string): number;