@cursor/bdk 0.2.11 → 0.2.13

package/dist/internal/storage-coordinator.js

@@ -74,8 +74,8 @@ function resumeProjectionJson(record) {
 /** Session records out of raw sink entries; rows without a usable id are dropped. */
 function sessionRecordsOf(entries) {
     return entries
-        .map(entry => entry.value)
-        .filter(record => record != null && typeof record.sessionId === "string" && record.sessionId !== "");
+        .map((entry) => entry.value)
+        .filter((record) => record != null && typeof record.sessionId === "string" && record.sessionId !== "");
 }
 export class StorageCoordinator {
     constructor(options) {
@@ -186,7 +186,7 @@ export class StorageCoordinator {
         // A terminal event can arrive through a debounce-policy timer flush,
         // where eventDispatched never ran: detect it from the buffered events
         // so a finished session's record is exact under either policy.
-        const exact = exactRecord || events.some(event => TERMINAL_SESSION_EVENTS.has(event.type));
+        const exact = exactRecord || events.some((event) => TERMINAL_SESSION_EVENTS.has(event.type));
         // Exact flushes repair earlier volatile-only skips: when the buffer no
         // longer holds a record, the newest skipped one still gets written.
         const record = buffer?.record ??
@@ -272,7 +272,7 @@ export class StorageCoordinator {
         const putMany = this.definition.putMany?.bind(this.definition);
         if (putMany !== undefined) {
             return {
-                label: `putMany(${puts.map(entry => entry.key).join(", ")})`,
+                label: `putMany(${puts.map((entry) => entry.key).join(", ")})`,
                 run: async (ctx) => {
                     const results = await putMany(puts, ctx);
                     let recordFailed = false;
@@ -290,7 +290,7 @@ export class StorageCoordinator {
             };
         }
         return {
-            label: `put(${puts.map(entry => entry.key).join(", ")})`,
+            label: `put(${puts.map((entry) => entry.key).join(", ")})`,
             run: async (ctx) => {
                 let recordFailed = false;
                 for (const entry of puts) {
@@ -334,14 +334,14 @@ export class StorageCoordinator {
     putOp(key, value) {
         return {
             label: `put(${key})`,
-            run: ctx => this.definition.put(key, value, ctx),
+            run: (ctx) => this.definition.put(key, value, ctx),
         };
     }
     /** KV delete op on the sink's `delete` (skipped when the hook is absent). */
     deleteOp(key) {
         return {
             label: `delete(${key})`,
-            run: ctx => this.definition.delete?.(key, ctx),
+            run: (ctx) => this.definition.delete?.(key, ctx),
         };
     }
     // ==========================================================================
@@ -366,8 +366,8 @@ export class StorageCoordinator {
     async listSessions() {
         const entries = await this.tryList(this.keys.sessionPrefix(this.agentName));
         return entries
-            .map(entry => entry.value)
-            .filter(record => record != null);
+            .map((entry) => entry.value)
+            .filter((record) => record != null);
     }
     /**
      * Session records from the sink for the sessions API. Unlike
@@ -537,7 +537,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.put(${run.runId})`,
-                        run: ctx => table.put(snapshot, ctx),
+                        run: (ctx) => table.put(snapshot, ctx),
                     },
                 ], "policy");
             },
@@ -545,7 +545,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.delete(${runId})`,
-                        run: ctx => table.delete(runId, ctx),
+                        run: (ctx) => table.delete(runId, ctx),
                     },
                 ], "policy");
             },
@@ -586,7 +586,7 @@ export class StorageCoordinator {
         let timer;
         const drained = await Promise.race([
             this.queue.then(() => true),
-            new Promise(resolve => {
+            new Promise((resolve) => {
                 timer = setTimeout(() => resolve(false), CLOSE_DRAIN_TIMEOUT_MS);
                 timer.unref?.();
             }),

package/dist/internal/store-api-protocol.d.ts

@@ -110,4 +110,55 @@ export type MemoryReadResponse = {
  * (`{ code, error }`) with a matching HTTP status.
  */
 export declare const memoryReadResponseSchema: z.ZodType<MemoryReadResponse>;
+/**
+ * Live session relay: the engine posts batches of session events, and the
+ * service keeps them only while a viewer is watching that session. The
+ * stored transcript stays the durable copy.
+ */
+export declare const STORE_API_SESSION_LIVE_CALL = "session.live";
+/**
+ * Cap on one serialized live event. A larger event crosses as a stub with
+ * `liveTruncated: true`; viewers reread the stored transcript after the turn.
+ */
+export declare const SESSION_LIVE_MAX_EVENT_BYTES: number;
+/** Cap on one batch's serialized `events`, enforced on both sides. */
+export declare const SESSION_LIVE_MAX_BATCH_BYTES: number;
+export declare const SESSION_LIVE_MAX_BATCH_EVENTS = 500;
+/**
+ * One session event as it crosses the live wire. `index` orders and
+ * deduplicates events; everything else passes through.
+ */
+export type SessionLiveEventWire = {
+    index: number;
+    type: string;
+} & Record<string, unknown>;
+export declare const sessionLiveEventWireSchema: z.ZodType<SessionLiveEventWire>;
+/** `session.live` validated payload. An empty batch is a subscription probe. */
+export type SessionLiveWirePayload = {
+    sessionId: string;
+    events: SessionLiveEventWire[];
+};
+export declare const sessionLivePayloadSchema: z.ZodType<SessionLiveWirePayload>;
+/** The versioned request body for the `session.live` call. */
+export type SessionLiveEnvelope = {
+    v: typeof STORE_API_PROTOCOL_VERSION;
+    call: typeof STORE_API_SESSION_LIVE_CALL;
+    payload: SessionLiveWirePayload;
+};
+/** The whole request body. Unknown envelope fields are stripped (= ignored). */
+export declare const sessionLiveEnvelopeSchema: z.ZodType<SessionLiveEnvelope>;
+/**
+ * `session.live` success body. `subscribed` says whether a viewer is
+ * watching (the service kept nothing when false), `recheckAfterMs` is the
+ * earliest next probe while unsubscribed, and `replayFromIndex` asks the
+ * engine to resend its local log from that index.
+ */
+export type SessionLiveResponse = {
+    v: typeof STORE_API_PROTOCOL_VERSION;
+    ok: true;
+    subscribed: boolean;
+    recheckAfterMs: number;
+    replayFromIndex: number | null;
+};
+export declare const sessionLiveResponseSchema: z.ZodType<SessionLiveResponse>;
 //# sourceMappingURL=store-api-protocol.d.ts.map

package/dist/internal/store-api-protocol.d.ts.map

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

package/dist/internal/store-api-protocol.js

@@ -53,7 +53,7 @@ export const memoryAppendPayloadSchema = z.object({
         .string()
         .min(1)
         .max(256)
-        .refine(name => !name.includes("/") && !name.includes("\\") && name !== "." && name !== "..", {
+        .refine((name) => !name.includes("/") && !name.includes("\\") && name !== "." && name !== "..", {
         message: "agent must be a single store key segment",
     }),
     record: turnMemoryRecordWireSchema,
@@ -82,7 +82,7 @@ export const memoryReadPayloadSchema = z.object({
         .string()
         .min(1)
         .max(256)
-        .refine(name => !name.includes("/") && !name.includes("\\") && name !== "." && name !== "..", {
+        .refine((name) => !name.includes("/") && !name.includes("\\") && name !== "." && name !== "..", {
         message: "agent must be a single store key segment",
     }),
 });
@@ -106,3 +106,40 @@ export const memoryReadResponseSchema = z.object({
     })
         .nullable(),
 });
+/**
+ * Live session relay: the engine posts batches of session events, and the
+ * service keeps them only while a viewer is watching that session. The
+ * stored transcript stays the durable copy.
+ */
+export const STORE_API_SESSION_LIVE_CALL = "session.live";
+/**
+ * Cap on one serialized live event. A larger event crosses as a stub with
+ * `liveTruncated: true`; viewers reread the stored transcript after the turn.
+ */
+export const SESSION_LIVE_MAX_EVENT_BYTES = 16 * 1024;
+/** Cap on one batch's serialized `events`, enforced on both sides. */
+export const SESSION_LIVE_MAX_BATCH_BYTES = 256 * 1024;
+export const SESSION_LIVE_MAX_BATCH_EVENTS = 500;
+export const sessionLiveEventWireSchema = z
+    .object({
+    index: z.number().int().min(0),
+    type: z.string().min(1),
+})
+    .passthrough();
+export const sessionLivePayloadSchema = z.object({
+    sessionId: z.string().regex(/^[A-Za-z0-9_-]{1,128}$/),
+    events: z.array(sessionLiveEventWireSchema).max(SESSION_LIVE_MAX_BATCH_EVENTS),
+});
+/** The whole request body. Unknown envelope fields are stripped (= ignored). */
+export const sessionLiveEnvelopeSchema = z.object({
+    v: z.literal(STORE_API_PROTOCOL_VERSION),
+    call: z.literal(STORE_API_SESSION_LIVE_CALL),
+    payload: sessionLivePayloadSchema,
+});
+export const sessionLiveResponseSchema = z.object({
+    v: z.literal(STORE_API_PROTOCOL_VERSION),
+    ok: z.literal(true),
+    subscribed: z.boolean(),
+    recheckAfterMs: z.number().int().min(0),
+    replayFromIndex: z.number().int().min(0).nullable(),
+});

package/dist/internal/store-mirror.js

@@ -13,11 +13,11 @@ import { FileConflictError } from "../files.js";
  */
 export async function mirrorToStore(args) {
     await Promise.all([...args.desired].map(([key, body]) => putLastWriterWins(args.sink, key, body)));
-    const listed = await Promise.all([args.prefix, ...(args.legacyPrefixes ?? [])].map(prefix => args.sink.list(prefix)));
+    const listed = await Promise.all([args.prefix, ...(args.legacyPrefixes ?? [])].map((prefix) => args.sink.list(prefix)));
     await Promise.all(listed
         .flat()
-        .filter(entry => !args.desired.has(entry.key))
-        .map(entry => args.sink.delete(entry.key)));
+        .filter((entry) => !args.desired.has(entry.key))
+        .map((entry) => args.sink.delete(entry.key)));
 }
 /**
  * Same refusals as local materialization's `resolveInside`: a rel that
@@ -31,7 +31,7 @@ export function storeRelPath(relPath, what) {
         relPath.includes("\\") ||
         posix.isAbsolute(relPath) ||
         relPath.endsWith("/") ||
-        relPath.split("/").some(seg => seg === ".." || seg === ".") ||
+        relPath.split("/").some((seg) => seg === ".." || seg === ".") ||
         posix.normalize(relPath) !== relPath) {
         throw new Error(`Refusing ${what} path "${relPath}" (must be a normalized relative path)`);
     }

package/dist/internal/stream-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-progress.d.ts","sourceRoot":"","sources":["../../src/internal/stream-progress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,cAAc,CA2NjB"}
+{"version":3,"file":"stream-progress.d.ts","sourceRoot":"","sources":["../../src/internal/stream-progress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,cAAc,CAmOjB"}

package/dist/internal/stream-progress.js

@@ -124,6 +124,10 @@ export function createStreamProgress(options) {
                     write(`    ${mark} ${c.bold(event.data.connection)} ${c.dim(event.data.decision === "approve" ? "connected" : "denied")}\n`);
                     break;
                 }
+                case "action.tool_retry": {
+                    write(`    ${c.yellow("↻")} ${c.bold(event.data.toolName)} ${c.dim(`again as try ${event.data.attempt} (${event.data.reason})`)}\n`);
+                    break;
+                }
                 case "action.result": {
                     if (event.data.toolName === "task" && event.data.parentCallId === undefined) {
                         break;

package/dist/internal/terminal-style.js

@@ -69,7 +69,7 @@ export function terminalHyperlink(url, label, enabled = colorEnabledFor()) {
 export function formatTerminalBox(lines, options) {
     const color = options?.color ?? IDENTITY;
     const padding = options?.padding ?? 1;
-    const contentWidth = Math.max(options?.minWidth ?? 0, ...lines.map(line => visibleWidth(line)), 1);
+    const contentWidth = Math.max(options?.minWidth ?? 0, ...lines.map((line) => visibleWidth(line)), 1);
     const inner = contentWidth + padding * 2;
     const padLine = (line) => {
         const extra = contentWidth - visibleWidth(line);
@@ -78,7 +78,7 @@ export function formatTerminalBox(lines, options) {
     const paint = (line) => color(line);
     const box = [
         paint(`╭${"─".repeat(inner)}╮`),
-        ...lines.map(line => paint(padLine(line))),
+        ...lines.map((line) => paint(padLine(line))),
         paint(`╰${"─".repeat(inner)}╯`),
     ].join("\n");
     return box;

package/dist/internal/testing/conversation-identity-vectors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logical resources shared by the July and control-plane conversation
+ * identity suites. Each vector exercises both claim minting and mailbox
+ * extraction for one typed conversation.
+ *
+ * Pure data: server-shared loads this module without importing July runtime
+ * code into the control plane.
+ */
+type RepoNumberClaim = {
+    type: "pr" | "issue" | "origin-pr" | "gitlab-mr" | "bitbucket-pr";
+    resource: {
+        fullName: string;
+        number: number;
+    };
+};
+type ConversationIdentityClaim = RepoNumberClaim | {
+    type: "thread";
+    resource: {
+        channelId: string;
+        threadTs: string;
+    };
+} | {
+    type: "deployment";
+    resource: {
+        deploymentId: string;
+    };
+} | {
+    type: "change-monitor-checkpoint";
+    resource: {
+        checkpointName: string;
+    };
+} | {
+    type: "factory-issue";
+    resource: {
+        issueName: string;
+    };
+};
+export type ConversationIdentityVector = {
+    name: string;
+    kind: "github" | "slack" | "origin" | "gitlab" | "bitbucket" | "deployments" | "change_monitors" | "issues";
+    claim: ConversationIdentityClaim;
+    eventName: string;
+    payload: Record<string, unknown>;
+    expectedKey: string;
+};
+export declare const CONVERSATION_IDENTITY_VECTORS: readonly ConversationIdentityVector[];
+export {};
+//# sourceMappingURL=conversation-identity-vectors.d.ts.map

package/dist/internal/testing/conversation-identity-vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-identity-vectors.d.ts","sourceRoot":"","sources":["../../../src/internal/testing/conversation-identity-vectors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAClE,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,KAAK,yBAAyB,GAC1B,eAAe,GACf;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAAC;AAEN,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,QAAQ,CAAC;IACb,KAAK,EAAE,yBAAyB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,SAAS,0BAA0B,EA+H9E,CAAC"}

package/dist/internal/testing/conversation-identity-vectors.js

@@ -0,0 +1,136 @@
+/**
+ * Logical resources shared by the July and control-plane conversation
+ * identity suites. Each vector exercises both claim minting and mailbox
+ * extraction for one typed conversation.
+ *
+ * Pure data: server-shared loads this module without importing July runtime
+ * code into the control plane.
+ */
+export const CONVERSATION_IDENTITY_VECTORS = [
+    {
+        name: "GitHub pull request",
+        kind: "github",
+        claim: {
+            type: "pr",
+            resource: { fullName: "Acme/Widgets", number: 12 },
+        },
+        eventName: "pull_request",
+        payload: {
+            repository: { full_name: "Acme/Widgets" },
+            pull_request: { number: 12 },
+        },
+        expectedKey: "cont:github-pr:Acme/Widgets#12",
+    },
+    {
+        name: "GitHub issue",
+        kind: "github",
+        claim: {
+            type: "issue",
+            resource: { fullName: "Acme/Widgets", number: 34 },
+        },
+        eventName: "issues",
+        payload: {
+            repository: { full_name: "Acme/Widgets" },
+            issue: { number: 34 },
+        },
+        expectedKey: "cont:github-issue:Acme/Widgets#34",
+    },
+    {
+        name: "Slack thread",
+        kind: "slack",
+        claim: {
+            type: "thread",
+            resource: { channelId: "C123", threadTs: "1719.000" },
+        },
+        eventName: "message",
+        payload: {
+            type: "event_callback",
+            event: {
+                type: "message",
+                channel: "C123",
+                ts: "1720.000",
+                thread_ts: "1719.000",
+            },
+        },
+        expectedKey: "cont:C123:1719.000",
+    },
+    {
+        name: "Origin pull request",
+        kind: "origin",
+        claim: {
+            type: "origin-pr",
+            resource: { fullName: "Acme/Widgets", number: 42 },
+        },
+        eventName: "pull_request.created",
+        payload: {
+            pullRequest: { number: 42 },
+            repository: { name: "Widgets", owner: { slug: "Acme" } },
+        },
+        expectedKey: "cont:origin-pr:Acme/Widgets#42",
+    },
+    {
+        name: "GitLab merge request",
+        kind: "gitlab",
+        claim: {
+            type: "gitlab-mr",
+            resource: { fullName: "Acme/Platform/API", number: 56 },
+        },
+        eventName: "merge_request",
+        payload: {
+            project: { path_with_namespace: "Acme/Platform/API" },
+            object_attributes: { iid: 56 },
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!56",
+    },
+    {
+        name: "Bitbucket pull request",
+        kind: "bitbucket",
+        claim: {
+            type: "bitbucket-pr",
+            resource: { fullName: "ACME/Widgets", number: 78 },
+        },
+        eventName: "pullrequest:created",
+        payload: {
+            repository: { full_name: "ACME/Widgets" },
+            pullrequest: { id: 78 },
+        },
+        expectedKey: "cont:bitbucket-pr:acme/widgets#78",
+    },
+    {
+        name: "deployment",
+        kind: "deployments",
+        claim: {
+            type: "deployment",
+            resource: { deploymentId: "dep-90" },
+        },
+        eventName: "deployment.created",
+        payload: { deploymentId: "dep-90" },
+        expectedKey: "cont:deployments:dep-90",
+    },
+    {
+        name: "change monitor checkpoint",
+        kind: "change_monitors",
+        claim: {
+            type: "change-monitor-checkpoint",
+            resource: {
+                checkpointName: "changeMonitors/cm-1/checkpoints/cp-2",
+            },
+        },
+        eventName: "checkpoint.created",
+        payload: {
+            checkpoint: { name: "changeMonitors/cm-1/checkpoints/cp-2" },
+        },
+        expectedKey: "cont:change_monitors:changeMonitors/cm-1/checkpoints/cp-2",
+    },
+    {
+        name: "factory issue",
+        kind: "issues",
+        claim: {
+            type: "factory-issue",
+            resource: { issueName: "issues/iss-3" },
+        },
+        eventName: "issue.created",
+        payload: { issue: { name: "issues/iss-3" } },
+        expectedKey: "cont:issues:issues/iss-3",
+    },
+];

package/dist/internal/tool-call-retry.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Transient retry for a read-effect tool call that already executed.
+ *
+ * Writes, unclassified tools, dry-run stubs, approval denials, and
+ * validation failures never reach this helper. Auth, elicitation, and a
+ * timeout that already ran long enough to repeat are not transient.
+ *
+ * Backoff is full jitter (base 500ms, cap 4s) and at most 10s asleep per
+ * call. An attempt that already ran longer than 15s is not retried, so
+ * one slow call plus the backoff budget stays under 30s. Sleep yields the
+ * event loop, so a timer can still fire during the wait.
+ */
+import { type Meter } from "@opentelemetry/api";
+import type { ToolEffect } from "../types.js";
+/** Total tries, including the first, for a read-effect call. */
+export declare const TOOL_RETRY_DEFAULT_MAX_ATTEMPTS = 3;
+export declare const TOOL_RETRY_BACKOFF_BASE_MS = 500;
+export declare const TOOL_RETRY_BACKOFF_CAP_MS = 4000;
+/** Cumulative sleep per call. */
+export declare const TOOL_RETRY_BACKOFF_BUDGET_MS = 10000;
+/**
+ * An attempt slower than this is not retried. Paired with the backoff
+ * budget, the extra wait stays under 30s.
+ */
+export declare const TOOL_RETRY_MAX_ATTEMPT_MS = 15000;
+/** Quiet-stream limit the extra wait must stay under. */
+export declare const TOOL_RETRY_STALL_FAIL_MS = 30000;
+export type ToolRetryReason = "transport" | "http_429" | "http_502" | "http_503" | "http_504" | "mcp_transient";
+export type ToolRetryOutcome = "recovered" | "exhausted" | "not_eligible";
+export interface ToolRetryNotice {
+    /** The try that is about to run (2 = first retry). */
+    readonly attempt: number;
+    readonly reason: ToolRetryReason;
+    readonly backoffMs: number;
+    readonly connection?: string;
+}
+/**
+ * Vendor-reported MCP `isError` result. Distinct from a thrown transport
+ * failure so the classifier can require an explicit transient phrase.
+ */
+export declare class McpToolError extends Error {
+    readonly connection: string;
+    readonly toolName: string;
+    readonly vendorMessage: string;
+    constructor(args: {
+        connection: string;
+        toolName: string;
+        vendorMessage: string;
+    });
+}
+export type ToolFailureVerdict = {
+    readonly transient: false;
+} | {
+    readonly transient: true;
+    readonly reason: ToolRetryReason;
+    readonly retryAfterMs?: number;
+};
+type SleepFn = (ms: number, signal: AbortSignal | undefined) => Promise<void>;
+/** @internal Test seam. `undefined` restores the real timer. */
+export declare function setToolRetrySleepForTests(sleep: SleepFn | undefined): void;
+/** @internal Test seam. `undefined` restores `Math.random`. */
+export declare function setToolRetryRandomForTests(random: (() => number) | undefined): void;
+/** @internal Test seam. `undefined` restores the global meter. */
+export declare function setToolRetryMeterForTests(meter: Meter | undefined): void;
+export declare function classifyToolFailure(error: unknown): ToolFailureVerdict;
+/**
+ * Full-jitter delay for the backoff after `failedAttempt` (1 = first try
+ * failed). `Retry-After` replaces the jittered delay and is still capped.
+ * Returns `undefined` when the cumulative budget is already spent.
+ */
+export declare function toolRetryBackoffMs(args: {
+    failedAttempt: number;
+    random: number;
+    retryAfterMs?: number;
+    spentMs: number;
+}): number | undefined;
+export declare function retryReadOnlyToolCall<T>(args: {
+    toolName: string;
+    connection?: string;
+    effect: ToolEffect | undefined;
+    signal?: AbortSignal;
+    now?: () => number;
+    onRetry?: (notice: ToolRetryNotice) => void;
+    execute: () => T | Promise<T>;
+}): Promise<T>;
+export {};
+//# sourceMappingURL=tool-call-retry.d.ts.map

package/dist/internal/tool-call-retry.d.ts.map

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