convex-durable-agents 0.2.3 → 0.2.4

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,qBAAa,MAAM;aACW,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAExC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG7C"}

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B,MAAM,OAAO,MAAM;IACW;IAA5B,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE5C,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,69 @@
+import type { ActionCtx, RetryBackoffConfig } from "../client/types.js";
+export type RetryErrorKind = "network" | "rate_limited" | "provider_5xx" | "context_window_exceeded" | "insufficient_credits" | "invalid_request" | "auth" | "unknown";
+export type RetryErrorSignal = {
+    name?: string;
+    code?: string;
+    status?: number;
+    statusCode?: number;
+    isRetryable?: boolean;
+    retryErrorReason?: "maxRetriesExceeded" | "errorNotRetryable" | "abort";
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    providerCode?: string;
+    providerType?: string;
+};
+export type RetryErrorClassification = {
+    kind: RetryErrorKind;
+    retryable: boolean;
+    requiresExplicitHandling: boolean;
+    signal: RetryErrorSignal;
+};
+export type RetryDecision = {
+    action: "retry";
+    delayMs?: number;
+    reason?: string;
+} | {
+    action: "fail";
+    kind?: RetryErrorKind;
+    reason?: string;
+    requiresExplicitHandling?: boolean;
+};
+export type RetryContext = {
+    threadId: string;
+    streamId: string;
+    attempt: number;
+    maxAttempts: number;
+    toolCallsScheduled: number;
+    streamPartCount: number;
+    error: unknown;
+    normalizedError: string;
+    defaultClassification: RetryErrorClassification;
+    defaultDecision: RetryDecision;
+};
+export type RetryOptions = {
+    enabled?: boolean;
+    maxAttempts?: number;
+    backoff?: RetryBackoffConfig;
+    retryAfterToolCalls?: boolean;
+    classify?: (ctx: ActionCtx, input: RetryContext) => RetryDecision | Promise<RetryDecision>;
+};
+export type ToolErrorInfo = {
+    message: string;
+    name?: string;
+    code?: string;
+    status?: number;
+    statusCode?: number;
+    causeMessage?: string;
+};
+export declare const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export declare const DEFAULT_RETRY_BACKOFF: RetryBackoffConfig;
+export declare function clampDelayMs(delayMs: number): number;
+export declare function computeBackoffDelayMs(attempt: number, backoff: RetryBackoffConfig | undefined): number;
+export declare function normalizeErrorMessage(error: unknown): string;
+export declare function extractRetryErrorSignal(error: unknown): RetryErrorSignal;
+export declare function extractRetryAfterDelayMs(signal: RetryErrorSignal): number | undefined;
+export declare function classifyRetryErrorDefault(error: unknown): RetryErrorClassification;
+export declare function extractToolErrorInfo(error: unknown): ToolErrorInfo;
+export declare function isRetryableToolErrorDefault(error: ToolErrorInfo | string): boolean;
+export declare function isRetryableDecision(value: unknown): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

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

package/dist/utils/retry.js

@@ -0,0 +1,404 @@
+export const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export const DEFAULT_RETRY_BACKOFF = {
+    strategy: "exponential",
+    initialDelayMs: 250,
+    multiplier: 2,
+    maxDelayMs: 4000,
+    jitter: true,
+};
+const CONTEXT_OVERFLOW_PATTERNS = [
+    /prompt is too long/i,
+    /input is too long for requested model/i,
+    /exceeds the context window/i,
+    /input token count.*exceeds the maximum/i,
+    /maximum prompt length is \d+/i,
+    /reduce the length of the messages/i,
+    /maximum context length is \d+ tokens/i,
+    /exceeds the limit of \d+/i,
+    /exceeds the available context size/i,
+    /greater than the context length/i,
+    /context window exceeds limit/i,
+    /exceeded model token limit/i,
+    /context[_ ]length[_ ]exceeded/i,
+    /^4(00|13)\s*(status code)?\s*\(no body\)/i,
+];
+const INSUFFICIENT_CREDITS_PATTERNS = [
+    /insufficient[_ ]quota/i,
+    /out of credits/i,
+    /quota exceeded/i,
+    /credit balance/i,
+    /freeusagelimiterror/i,
+    /usage limit reached/i,
+];
+const AUTH_PATTERNS = [/unauthorized/i, /forbidden/i, /invalid api key/i, /authentication/i];
+const RATE_LIMIT_PATTERNS = [/too many requests/i, /rate.?limit/i, /resource.?exhausted/i];
+const INVALID_REQUEST_PATTERNS = [/invalid request/i, /invalid argument/i, /validation error/i, /invalid prompt/i];
+const NETWORK_PATTERNS = [
+    /network/i,
+    /econnreset/i,
+    /econnrefused/i,
+    /etimedout/i,
+    /ehostunreach/i,
+    /connection reset/i,
+    /connection refused/i,
+    /fetch failed/i,
+    /socket hang up/i,
+    /upstream.?connect/i,
+    /other.?side.?closed/i,
+    /cannot connect to api/i,
+    /(?:connection|stream|socket)\s+terminated/i,
+];
+const NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "EHOSTUNREACH",
+    "EPIPE",
+    "ENOTFOUND",
+    "CONNECTIONREFUSED",
+    "CONNECTIONCLOSED",
+    "FAILEDTOOPENSOCKET",
+]);
+const CONTEXT_OVERFLOW_CODES = new Set([
+    "context_length_exceeded",
+    "context_window_exceeded",
+    "prompt_too_long",
+    "token_limit_exceeded",
+]);
+const INSUFFICIENT_CREDITS_CODES = new Set([
+    "insufficient_quota",
+    "usage_limit_reached",
+    "usage_not_included",
+    "credit_balance_too_low",
+    "quota_exceeded",
+]);
+const RATE_LIMIT_CODES = new Set(["rate_limit_exceeded", "too_many_requests", "resource_exhausted"]);
+const AUTH_CODES = new Set(["invalid_api_key", "authentication_error", "unauthorized", "forbidden"]);
+const INVALID_REQUEST_CODES = new Set(["invalid_request_error", "invalid_prompt", "bad_request"]);
+function asRecord(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    return value;
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function asNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function parseStatusCodeFromMessage(message) {
+    const patterns = [/status(?: code)?[:=\s]+(\d{3})/i, /\b(\d{3})\s*(?:status code)/i, /^\s*(\d{3})\b/];
+    for (const pattern of patterns) {
+        const match = message.match(pattern);
+        if (!match?.[1])
+            continue;
+        const status = Number.parseInt(match[1], 10);
+        if (!Number.isNaN(status))
+            return status;
+    }
+    return undefined;
+}
+function parseJsonRecord(value) {
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            return asRecord(parsed);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return asRecord(value);
+}
+function normalizeHeaderRecord(value) {
+    const record = asRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [key, headerValue] of Object.entries(record)) {
+        if (typeof headerValue === "string") {
+            normalized[key.toLowerCase()] = headerValue;
+        }
+        else if (typeof headerValue === "number" || typeof headerValue === "boolean") {
+            normalized[key.toLowerCase()] = String(headerValue);
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function parseRetryErrorReason(value) {
+    if (value === "maxRetriesExceeded" || value === "errorNotRetryable" || value === "abort") {
+        return value;
+    }
+    return undefined;
+}
+function getNestedErrorFields(payload) {
+    const nestedError = asRecord(payload.error);
+    const code = asString(nestedError?.code) ?? asString(payload.code);
+    const type = asString(nestedError?.type) ?? asString(payload.type);
+    return { code, type };
+}
+function includesAnyPattern(message, patterns) {
+    return patterns.some((pattern) => pattern.test(message));
+}
+export function clampDelayMs(delayMs) {
+    if (!Number.isFinite(delayMs) || delayMs < 0) {
+        return 0;
+    }
+    return Math.floor(delayMs);
+}
+export function computeBackoffDelayMs(attempt, backoff) {
+    const policy = backoff ?? DEFAULT_RETRY_BACKOFF;
+    if ("delayMs" in policy) {
+        const delayMs = clampDelayMs(policy.delayMs);
+        if (!policy.jitter)
+            return delayMs;
+        return Math.floor(Math.random() * (delayMs + 1));
+    }
+    const initialDelayMs = clampDelayMs(policy.initialDelayMs);
+    const multiplier = Number.isFinite(policy.multiplier ?? 2) ? (policy.multiplier ?? 2) : 2;
+    const unbounded = initialDelayMs * multiplier ** Math.max(0, attempt - 1);
+    const maxDelayMs = policy.maxDelayMs == null ? unbounded : clampDelayMs(policy.maxDelayMs);
+    const delayMs = Math.min(unbounded, maxDelayMs);
+    if (!policy.jitter)
+        return delayMs;
+    return Math.floor(Math.random() * (delayMs + 1));
+}
+export function normalizeErrorMessage(error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return errorMessage || "Unknown error";
+}
+export function extractRetryErrorSignal(error) {
+    const signal = {};
+    const queue = [error];
+    const seen = new Set();
+    let inspected = 0;
+    while (queue.length > 0 && inspected < 16) {
+        const current = queue.shift();
+        inspected += 1;
+        if (!current)
+            continue;
+        if (typeof current === "object") {
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+        }
+        const record = asRecord(current);
+        if (!record)
+            continue;
+        signal.name ??= asString(record.name);
+        signal.code ??= asString(record.code);
+        signal.status ??= asNumber(record.status);
+        signal.statusCode ??= asNumber(record.statusCode);
+        signal.responseBody ??= asString(record.responseBody);
+        signal.responseHeaders ??= normalizeHeaderRecord(record.responseHeaders);
+        signal.retryErrorReason ??= parseRetryErrorReason(record.reason);
+        if (typeof record.isRetryable === "boolean" && signal.isRetryable == null) {
+            signal.isRetryable = record.isRetryable;
+        }
+        const dataPayload = parseJsonRecord(record.data);
+        if (dataPayload) {
+            const nested = getNestedErrorFields(dataPayload);
+            signal.providerCode ??= nested.code;
+            signal.providerType ??= nested.type;
+        }
+        const bodyPayload = parseJsonRecord(signal.responseBody);
+        if (bodyPayload) {
+            const nested = getNestedErrorFields(bodyPayload);
+            signal.providerCode ??= nested.code;
+            signal.providerType ??= nested.type;
+        }
+        if ("cause" in record)
+            queue.push(record.cause);
+        if ("lastError" in record)
+            queue.push(record.lastError);
+        if (Array.isArray(record.errors)) {
+            queue.push(...record.errors.slice(0, 4));
+        }
+    }
+    if (signal.providerCode)
+        signal.providerCode = signal.providerCode.toLowerCase();
+    if (signal.providerType)
+        signal.providerType = signal.providerType.toLowerCase();
+    if (signal.code)
+        signal.code = signal.code.toUpperCase();
+    if (signal.name)
+        signal.name = signal.name.toLowerCase();
+    return signal;
+}
+export function extractRetryAfterDelayMs(signal) {
+    const headers = signal.responseHeaders;
+    if (!headers)
+        return undefined;
+    const retryAfterMs = headers["retry-after-ms"];
+    if (retryAfterMs) {
+        const parsedMs = Number.parseFloat(retryAfterMs);
+        if (Number.isFinite(parsedMs) && parsedMs >= 0 && parsedMs <= 60_000) {
+            return Math.ceil(parsedMs);
+        }
+    }
+    const retryAfter = headers["retry-after"];
+    if (retryAfter) {
+        const parsedSeconds = Number.parseFloat(retryAfter);
+        if (Number.isFinite(parsedSeconds)) {
+            const delayMs = parsedSeconds * 1000;
+            if (delayMs >= 0 && delayMs <= 60_000) {
+                return Math.ceil(delayMs);
+            }
+        }
+        const retryAfterDate = Date.parse(retryAfter);
+        if (!Number.isNaN(retryAfterDate)) {
+            const delayMs = retryAfterDate - Date.now();
+            if (delayMs >= 0 && delayMs <= 60_000) {
+                return Math.ceil(delayMs);
+            }
+        }
+    }
+    return undefined;
+}
+export function classifyRetryErrorDefault(error) {
+    const signal = extractRetryErrorSignal(error);
+    const message = normalizeErrorMessage(error);
+    const msg = message.toLowerCase();
+    const status = signal.statusCode ?? signal.status ?? parseStatusCodeFromMessage(msg);
+    const providerCode = signal.providerCode;
+    const isAbortError = signal.retryErrorReason === "abort" ||
+        signal.name === "aborterror" ||
+        signal.name === "responseaborted" ||
+        signal.name === "timeouterror" ||
+        msg.includes("request was aborted");
+    if (isAbortError) {
+        return { kind: "unknown", retryable: false, requiresExplicitHandling: false, signal };
+    }
+    if (providerCode && CONTEXT_OVERFLOW_CODES.has(providerCode)) {
+        return { kind: "context_window_exceeded", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    if (includesAnyPattern(msg, CONTEXT_OVERFLOW_PATTERNS)) {
+        return { kind: "context_window_exceeded", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    if (providerCode && INSUFFICIENT_CREDITS_CODES.has(providerCode)) {
+        return { kind: "insufficient_credits", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    if (includesAnyPattern(msg, INSUFFICIENT_CREDITS_PATTERNS)) {
+        return { kind: "insufficient_credits", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    if (status === 401 ||
+        status === 403 ||
+        (providerCode && AUTH_CODES.has(providerCode)) ||
+        includesAnyPattern(msg, AUTH_PATTERNS)) {
+        return { kind: "auth", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    if (status === 429 ||
+        (providerCode && RATE_LIMIT_CODES.has(providerCode)) ||
+        includesAnyPattern(msg, RATE_LIMIT_PATTERNS)) {
+        return { kind: "rate_limited", retryable: true, requiresExplicitHandling: false, signal };
+    }
+    if (status != null && status >= 500 && status <= 599) {
+        return { kind: "provider_5xx", retryable: true, requiresExplicitHandling: false, signal };
+    }
+    if (status === 408 || status === 409) {
+        return { kind: "network", retryable: true, requiresExplicitHandling: false, signal };
+    }
+    if ((signal.code && NETWORK_CODES.has(signal.code)) ||
+        includesAnyPattern(msg, NETWORK_PATTERNS) ||
+        (signal.isRetryable === true && status == null)) {
+        return { kind: "network", retryable: true, requiresExplicitHandling: false, signal };
+    }
+    if (status === 400 ||
+        status === 422 ||
+        (providerCode && INVALID_REQUEST_CODES.has(providerCode)) ||
+        includesAnyPattern(msg, INVALID_REQUEST_PATTERNS)) {
+        return { kind: "invalid_request", retryable: false, requiresExplicitHandling: true, signal };
+    }
+    return { kind: "unknown", retryable: false, requiresExplicitHandling: false, signal };
+}
+export function extractToolErrorInfo(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const info = {
+        message: message || "Unknown error",
+    };
+    const root = asRecord(error);
+    if (root) {
+        info.name = asString(root.name);
+        info.code = asString(root.code) ?? asString(root.errno);
+        info.status = asNumber(root.status);
+        info.statusCode = asNumber(root.statusCode);
+        const cause = asRecord(root.cause);
+        if (cause) {
+            info.causeMessage = asString(cause.message);
+            if (!info.code)
+                info.code = asString(cause.code) ?? asString(cause.errno);
+            if (info.status == null)
+                info.status = asNumber(cause.status);
+            if (info.statusCode == null)
+                info.statusCode = asNumber(cause.statusCode);
+        }
+    }
+    if (info.status == null && info.statusCode == null) {
+        const parsedStatus = parseStatusCodeFromMessage(info.message);
+        if (parsedStatus != null) {
+            info.statusCode = parsedStatus;
+        }
+    }
+    if (info.code)
+        info.code = info.code.toUpperCase();
+    return info;
+}
+export function isRetryableToolErrorDefault(error) {
+    const info = typeof error === "string" ? { message: error } : error;
+    const msg = info.message.toLowerCase();
+    const status = info.statusCode ?? info.status ?? parseStatusCodeFromMessage(msg);
+    const code = info.code?.toUpperCase();
+    const hasExplicit5xxStatus = /\bstatus(?:\s+code)?\s*[:=]?\s*5\d{2}\b/.test(msg);
+    if (status === 429 || status === 408 || status === 409 || (status != null && status >= 500 && status <= 599)) {
+        return true;
+    }
+    if (status === 401 || status === 403 || (status != null && status >= 400 && status <= 499)) {
+        return false;
+    }
+    if (code === "ECONNRESET" ||
+        code === "ECONNREFUSED" ||
+        code === "ETIMEDOUT" ||
+        code === "EHOSTUNREACH" ||
+        code === "EPIPE" ||
+        code === "ENOTFOUND" ||
+        code === "CONNECTIONREFUSED" ||
+        code === "CONNECTIONCLOSED" ||
+        code === "FAILEDTOOPENSOCKET") {
+        return true;
+    }
+    if (msg.includes("rate limit") ||
+        msg.includes("too many requests") ||
+        msg.includes("status: 429") ||
+        hasExplicit5xxStatus ||
+        msg.includes("internal server error") ||
+        msg.includes("bad gateway")) {
+        return true;
+    }
+    if (msg.includes("network") ||
+        msg.includes("econnreset") ||
+        msg.includes("econnrefused") ||
+        msg.includes("etimedout") ||
+        msg.includes("ehostunreach") ||
+        msg.includes("connection reset") ||
+        msg.includes("connection refused") ||
+        msg.includes("fetch failed") ||
+        msg.includes("socket hang up") ||
+        msg.includes("upstream connect") ||
+        msg.includes("other side closed") ||
+        msg.includes("cannot connect to api")) {
+        return true;
+    }
+    return false;
+}
+export function isRetryableDecision(value) {
+    if (value === true)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("retryable" in value))
+        return false;
+    return value.retryable === true;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/streaming.d.ts

@@ -0,0 +1,4 @@
+export declare const STREAM_HEARTBEAT_INTERVAL_MS = 30000;
+export declare const STREAM_HEARTBEAT_JITTER_MS = 10000;
+export declare const STREAM_LIVENESS_THRESHOLD_MS: number;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/utils/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/utils/streaming.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,4BAA4B,QAA4D,CAAC"}

package/dist/utils/streaming.js

@@ -0,0 +1,4 @@
+export const STREAM_HEARTBEAT_INTERVAL_MS = 30_000;
+export const STREAM_HEARTBEAT_JITTER_MS = 10_000;
+export const STREAM_LIVENESS_THRESHOLD_MS = STREAM_HEARTBEAT_INTERVAL_MS + STREAM_HEARTBEAT_JITTER_MS;
+//# sourceMappingURL=streaming.js.map

package/dist/utils/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/utils/streaming.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,4BAA4B,GAAG,0BAA0B,CAAC"}

package/package.json

@@ -6,7 +6,7 @@
   "bugs": {
     "url": "https://github.com/ziegfried/convex-durable-agents/issues"
   },
-  "version": "0.2.3",
+  "version": "0.2.4",
   "license": "Apache-2.0",
   "keywords": [
     "convex",

package/src/client/api.ts

@@ -36,6 +36,9 @@ async function checkThreadIsIdle(component: ComponentApi, ctx: MutationCtx, thre
   if (!thread) {
     throw new Error(`Thread ${threadId} not found`);
   }
+  if (thread.retryState) {
+    throw new Error(`Thread ${threadId} has retry pending; stop the thread to interrupt the retry flow`);
+  }
   switch (thread.status) {
     case "awaiting_tool_results":
     case "streaming":
@@ -43,6 +46,16 @@ async function checkThreadIsIdle(component: ComponentApi, ctx: MutationCtx, thre
   }
 }
 
+async function assertNoRetryPending(component: ComponentApi, ctx: MutationCtx, threadId: Id<"threads">): Promise<void> {
+  const thread = await ctx.runQuery(component.threads.get, { threadId });
+  if (!thread) {
+    throw new Error(`Thread ${threadId} not found`);
+  }
+  if (thread.retryState) {
+    throw new Error(`Thread ${threadId} has retry pending; stop the thread to interrupt the retry flow`);
+  }
+}
+
 export type StreamArgs = { kind: "list" } | { kind: "deltas"; cursors: Array<{ streamId: string; cursor: number }> };
 
 export type StreamMessage = {
@@ -199,15 +212,17 @@ function createAgentApi(
       returns: v.null(),
       handler: async (ctx, args) => {
         if (authorize) await authorize(ctx, args.threadId);
+        const threadId = args.threadId as Id<"threads">;
+        await assertNoRetryPending(component, ctx, threadId);
         await ctx.runMutation(component.messages.add, {
-          threadId: args.threadId,
+          threadId,
           msg: { role: "user", parts: [{ type: "text", text: args.prompt }] },
         });
         await ctx.runMutation(component.threads.resume, {
-          threadId: args.threadId,
+          threadId,
         });
         await ctx.scheduler.runAfter(0, component.agent.continueStream, {
-          threadId: args.threadId,
+          threadId,
         });
         return null;
       },
@@ -237,6 +252,7 @@ function createAgentApi(
       handler: async (ctx, args) => {
         if (authorize) await authorize(ctx, args.threadId);
         const threadId = args.threadId as Id<"threads">;
+        await assertNoRetryPending(component, ctx, threadId);
         if (args.prompt) {
           await ctx.runMutation(component.messages.add, {
             threadId,
@@ -262,10 +278,14 @@ function createAgentApi(
       returns: v.null(),
       handler: async (ctx, args) => {
         if (authorize) await authorize(ctx, args.threadId);
+        const threadId = args.threadId as Id<"threads">;
         await ctx.runMutation(component.threads.setStopSignal, {
-          threadId: args.threadId as Id<"threads">,
+          threadId,
           stopSignal: true,
         });
+        await ctx.runMutation(component.threads.clearRetryState, {
+          threadId,
+        });
         return null;
       },
     }),