@corvio/cli 0.1.0-beta.10 → 0.1.0-beta.11

package/dist/cli.js

@@ -39,7 +39,7 @@ import {
   agentCredentialPath,
 } from "./core.js";
 
-const VERSION = "0.1.0-beta.10";
+const VERSION = "0.1.0-beta.11";
 const DEFAULT_API_BASE = "https://api.corvio.ai/v1";
 const DEFAULT_APP_BASE = "https://corvio.ai";
 const USER_AGENT = `corvio-cli/${VERSION}`;
@@ -1628,6 +1628,43 @@ async function startAgentLeaseHeartbeat(api, event, leaseToken, leaseSeconds) {
   };
 }
 
+const FATAL_AGENT_LISTENER_ERROR_CODES = new Set([
+  "agent_auth_required",
+  "invalid_agent_key",
+  "agent_credential_store_invalid",
+  "agent_routing_ambiguous",
+  "agent_runtime_device_invalid",
+  "agent_runtime_provider_mismatch",
+  "agent_project_binding_required",
+  "agent_provider_unavailable",
+  "agent_provider_not_ready",
+  "agent_handler_required",
+  "agent_handler_failed",
+  "agent_handler_result_invalid",
+]);
+
+function classifyAgentListenerFailure(error) {
+  const code = String(error?.code || "agent_event_processing_failed").trim();
+  const status = Number(error?.status || 0);
+  const fatalListener = error?.exitCode === EXIT.AUTH
+    || status === 401
+    || status === 403
+    || FATAL_AGENT_LISTENER_ERROR_CODES.has(code);
+  const retryable = !fatalListener
+    && (!(status >= 400 && status < 500) || [408, 429].includes(status));
+  return { code, status: status || null, fatalListener, retryable };
+}
+
+function attachAgentEventFailure(error, failure) {
+  if (error && typeof error === "object") {
+    error.agentEventFailure = failure;
+    return error;
+  }
+  const wrapped = new CliError(String(error), { code: "agent_event_processing_failed" });
+  wrapped.agentEventFailure = failure;
+  return wrapped;
+}
+
 async function processClaimedAgentEvent(api, event, options) {
   const leaseToken = String(event?.delivery?.lease_token || "");
   if (!event?.id || !leaseToken) throw new CliError("Claimed event is missing its lease receipt.", { code: "agent_event_invalid" });
@@ -1751,15 +1788,37 @@ async function processClaimedAgentEvent(api, event, options) {
         // The original execution error remains the failure authority.
       }
     }
+    const disposition = classifyAgentListenerFailure(error);
+    let failedEvent = null;
+    let failError = null;
     try {
-      await api.request(`/agent-events/${resourcePath(event.id)}:fail`, {
+      failedEvent = await api.request(`/agent-events/${resourcePath(event.id)}:fail`, {
         method: "POST",
-        body: { lease_token: leaseToken, error: error instanceof Error ? error.message : String(error), retryable: true },
+        body: {
+          lease_token: leaseToken,
+          error: error instanceof Error ? error.message : String(error),
+          retryable: disposition.retryable,
+        },
       });
-    } catch {
+    } catch (failure) {
+      failError = failure;
       // Preserve the original execution failure; the expired lease remains reclaimable.
     }
-    throw error;
+    const finalError = failError && classifyAgentListenerFailure(failError).fatalListener
+      ? failError
+      : error;
+    throw attachAgentEventFailure(finalError, {
+      event_id: String(event.id),
+      event: failedEvent,
+      retryable: disposition.retryable,
+      fatal_listener: disposition.fatalListener
+        || Boolean(failError && classifyAgentListenerFailure(failError).fatalListener),
+      error: {
+        code: disposition.code,
+        message: error instanceof Error ? error.message : String(error),
+        ...(disposition.status ? { status: disposition.status } : {}),
+      },
+    });
   }
 }
 
@@ -1773,9 +1832,21 @@ async function runAgent(options) {
     const claimed = await claimAgentEvent(api, options, options.once ? 0 : 30);
     if (!claimed.event) {
       if (options.once) return writeResult({ processed: false, reason: "no_event", retry_after_seconds: claimed.retry_after_seconds }, { json: options.json });
+      const retryAfterSeconds = Number(claimed.retry_after_seconds || 0);
+      if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) {
+        await sleep(Math.min(30_000, Math.max(50, retryAfterSeconds * 1_000)));
+      }
+      continue;
+    }
+    let receipt;
+    try {
+      receipt = await processClaimedAgentEvent(api, claimed.event, options);
+    } catch (error) {
+      const failure = error?.agentEventFailure;
+      if (options.once || !failure || failure.fatal_listener) throw error;
+      process.stdout.write(`${JSON.stringify({ processed: false, ...failure })}\n`);
       continue;
     }
-    const receipt = await processClaimedAgentEvent(api, claimed.event, options);
     if (options.once) return writeResult({ processed: true, ...receipt }, { json: options.json });
     process.stdout.write(`${JSON.stringify({ processed: true, ...receipt })}\n`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corvio/cli",
-  "version": "0.1.0-beta.10",
+  "version": "0.1.0-beta.11",
   "description": "Official Corvio Workspace CLI for questions, knowledge search, documents, and Agent workflows.",
   "type": "module",
   "bin": {