Handle 402 status error as payment required

Author: jahooma

cli/src/utils/error-handling.ts

@@ -22,16 +22,21 @@ const extractErrorMessage = (error: unknown, fallback: string): string => {
   return fallback
 }
 
+/**
+ * Check if an error indicates the user is out of credits.
+ * Standardized on statusCode === 402 for payment required detection.
+ */
 export const isOutOfCreditsError = (error: unknown): boolean => {
   if (isPaymentRequiredError(error)) {
     return true
   }
 
+  // Check for error output with errorCode property (from agent run results)
   if (
     error &&
     typeof error === 'object' &&
     'errorCode' in error &&
-    (error as any).errorCode === ErrorCodes.PAYMENT_REQUIRED
+    (error as { errorCode: unknown }).errorCode === ErrorCodes.PAYMENT_REQUIRED
   ) {
     return true
   }

packages/agent-runtime/src/run-agent-step.ts

@@ -629,7 +629,7 @@ export async function loopAgentSteps(
   const system =
     agentTemplate.inheritParentSystemPrompt && parentSystemPrompt
       ? parentSystemPrompt
-      : (await getAgentPrompt({
+      : ((await getAgentPrompt({
           ...params,
           agentTemplate,
           promptType: { type: 'systemPrompt' },
@@ -645,7 +645,7 @@ export async function loopAgentSteps(
             }
             return cachedAdditionalToolDefinitions
           },
-        })) ?? ''
+        })) ?? '')
 
   // Build agent tools (agents as direct tool calls) for non-inherited tools
   const agentTools = useParentTools
@@ -674,8 +674,8 @@ export async function loopAgentSteps(
 
   const hasUserMessage = Boolean(
     prompt ||
-      (spawnParams && Object.keys(spawnParams).length > 0) ||
-      (content && content.length > 0),
+    (spawnParams && Object.keys(spawnParams).length > 0) ||
+    (content && content.length > 0),
   )
 
   const initialMessages = buildArray<Message>(
@@ -918,10 +918,14 @@ export async function loopAgentSteps(
     )
 
     // Re-throw NetworkError and PaymentRequiredError to allow SDK retry wrapper to handle it
-    if (
-      error instanceof Error &&
-      (error.name === 'NetworkError' || error.name === 'PaymentRequiredError')
-    ) {
+    if (error instanceof Error && error.name === 'NetworkError') {
+      throw error
+    }
+
+    const isPaymentRequired =
+      (error as { statusCode?: number }).statusCode === 402
+
+    if (isPaymentRequired) {
       throw error
     }
 

sdk/src/errors.ts

@@ -145,10 +145,26 @@ export function isAuthenticationError(error: unknown): error is AuthenticationEr
 }
 
 /**
- * Type guard to check if an error is a PaymentRequiredError
+ * Type guard to check if an error is a PaymentRequiredError or an AI SDK APICallError with 402 status
  */
 export function isPaymentRequiredError(error: unknown): error is PaymentRequiredError {
-  return error instanceof PaymentRequiredError
+  // Check for our custom PaymentRequiredError
+  if (error instanceof PaymentRequiredError) {
+    return true
+  }
+
+  // Check for AI SDK's APICallError with 402 status code
+  // Use duck typing since we can't import APICallError directly
+  if (
+    error &&
+    typeof error === 'object' &&
+    'statusCode' in error &&
+    (error as { statusCode: unknown }).statusCode === 402
+  ) {
+    return true
+  }
+
+  return false
 }
 
 /**