@rk0429/agentic-relay 0.13.0 → 0.14.0

package/dist/relay.mjs

@@ -438,7 +438,11 @@ function buildChildMcpServers(parentMcpServers, childHttpUrl) {
   }
   return result;
 }
-function inferFailureReason(stderr, stdout) {
+function inferFailureReason(stderr, stdout, sdkErrorMetadata) {
+  if (sdkErrorMetadata) {
+    if (sdkErrorMetadata.subtype === "error_max_turns") return "max_turns_exhausted";
+    return "adapter_error";
+  }
   const combined = `${stderr} ${stdout}`.toLowerCase();
   if (combined.includes("timed out") || combined.includes("timeout")) return "timeout";
   if (combined.includes("max turns") || combined.includes("max_turns") || combined.includes("turn limit")) return "max_turns_exhausted";
@@ -452,8 +456,8 @@ function buildContextFromEnv() {
 }
 async function executeSpawnAgent(input, registry2, sessionManager2, guard, hooksEngine2, contextMonitor2, backendSelector, childHttpUrl, onProgress) {
   onProgress?.({ stage: "initializing", percent: 0 });
-  let effectiveBackend = input.backend;
-  let selectionReason = "direct";
+  let effectiveBackend;
+  let selectionReason;
   if (backendSelector) {
     const availableBackends = registry2.listIds();
     const selectionContext = {
@@ -465,6 +469,12 @@ async function executeSpawnAgent(input, registry2, sessionManager2, guard, hooks
     const selectionResult = backendSelector.selectBackendWithReason(selectionContext);
     effectiveBackend = selectionResult.backend;
     selectionReason = selectionResult.reason;
+  } else if (input.fallbackBackend) {
+    effectiveBackend = input.fallbackBackend;
+    selectionReason = "fallbackBackend";
+  } else {
+    effectiveBackend = "claude";
+    selectionReason = "default(no-selector)";
   }
   const envContext = buildContextFromEnv();
   const promptHash = RecursionGuard.hashPrompt(input.prompt);
@@ -694,7 +704,7 @@ ${input.prompt}`;
     }
     guard.recordSpawn(context);
     const status = result.exitCode === 0 ? "completed" : "error";
-    const failureReason = result.exitCode !== 0 ? inferFailureReason(result.stderr, result.stdout) : void 0;
+    const failureReason = result.exitCode !== 0 ? inferFailureReason(result.stderr, result.stdout, result.sdkErrorMetadata) : void 0;
     await sessionManager2.update(session.relaySessionId, {
       status,
       ...result.nativeSessionId ? { nativeSessionId: result.nativeSessionId } : {}
@@ -770,8 +780,8 @@ var init_spawn_agent = __esm({
     init_recursion_guard();
     init_logger();
     spawnAgentInputSchema = z2.object({
-      backend: z2.enum(["claude", "codex", "gemini"]).describe(
-        "Required fallback backend. Overridden by automatic selection when BackendSelector is active (priority: preferredBackend > agentType mapping > taskType mapping > default)."
+      fallbackBackend: z2.enum(["claude", "codex", "gemini"]).optional().describe(
+        "Optional fallback backend. Used only when BackendSelector is not active or cannot determine a backend. When BackendSelector is active, backend is auto-selected by priority: preferredBackend > agentType mapping > taskType mapping > default (claude)."
       ),
       prompt: z2.string().describe(
         "The task instruction for the sub-agent. Be specific and include all necessary context for autonomous execution."
@@ -1312,7 +1322,7 @@ var init_server = __esm({
         this.guard = new RecursionGuard(guardConfig);
         this.backendSelector = new BackendSelector();
         this.server = new McpServer(
-          { name: "agentic-relay", version: "0.13.0" },
+          { name: "agentic-relay", version: "0.14.0" },
           createMcpServerOptions()
         );
         this.registerTools(this.server);
@@ -1674,7 +1684,7 @@ var init_server = __esm({
             sessionIdGenerator: () => randomUUID()
           });
           const server = new McpServer(
-            { name: "agentic-relay", version: "0.13.0" },
+            { name: "agentic-relay", version: "0.14.0" },
             createMcpServerOptions()
           );
           this.registerTools(server);
@@ -2115,6 +2125,7 @@ var ClaudeAdapter = class extends BaseAdapter {
       let errorMessages = [];
       let totalInputTokens = 0;
       let totalOutputTokens = 0;
+      let sdkError = null;
       for await (const message of q) {
         if (message.type === "assistant") {
           const betaMessage = message.message;
@@ -2129,18 +2140,32 @@ var ClaudeAdapter = class extends BaseAdapter {
             resultText = message.result;
           } else {
             isError = true;
-            errorMessages = message.errors;
+            sdkError = message;
+            errorMessages = sdkError.errors;
           }
         }
       }
       logger.debug(`Claude SDK session: ${sessionId}`);
+      if (sdkError) {
+        logger.warn(
+          `Claude SDK error: subtype=${sdkError.subtype} stop_reason=${sdkError.stop_reason} num_turns=${sdkError.num_turns} errors=[${sdkError.errors.join("; ")}]`
+        );
+      }
       const hasTokenUsage = totalInputTokens > 0 || totalOutputTokens > 0;
       return {
         exitCode: isError ? 1 : 0,
         stdout: resultText,
         stderr: errorMessages.join("\n"),
         ...sessionId ? { nativeSessionId: sessionId } : {},
-        ...hasTokenUsage ? { tokenUsage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens } } : {}
+        ...hasTokenUsage ? { tokenUsage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens } } : {},
+        ...sdkError ? {
+          sdkErrorMetadata: {
+            subtype: sdkError.subtype,
+            numTurns: sdkError.num_turns,
+            stopReason: sdkError.stop_reason,
+            totalCostUsd: sdkError.total_cost_usd
+          }
+        } : {}
       };
     } catch (error) {
       if (abortController.signal.aborted) {
@@ -2221,13 +2246,23 @@ var ClaudeAdapter = class extends BaseAdapter {
               nativeSessionId
             };
           } else {
-            const errors = message.errors;
+            const sdkError = message;
+            const errors = sdkError.errors;
+            logger.warn(
+              `Claude SDK error: subtype=${sdkError.subtype} stop_reason=${sdkError.stop_reason} num_turns=${sdkError.num_turns} errors=[${sdkError.errors.join("; ")}]`
+            );
             yield {
               type: "done",
               result: {
                 exitCode: 1,
                 stdout: "",
-                stderr: errors.join("\n")
+                stderr: errors.join("\n"),
+                sdkErrorMetadata: {
+                  subtype: sdkError.subtype,
+                  numTurns: sdkError.num_turns,
+                  stopReason: sdkError.stop_reason,
+                  totalCostUsd: sdkError.total_cost_usd
+                }
               },
               nativeSessionId
             };
@@ -4623,7 +4658,7 @@ function createVersionCommand(registry2) {
       description: "Show relay and backend versions"
     },
     async run() {
-      const relayVersion = "0.13.0";
+      const relayVersion = "0.14.0";
       console.log(`agentic-relay v${relayVersion}`);
       console.log("");
       console.log("Backends:");
@@ -4973,7 +5008,7 @@ void configManager.getConfig().then((config) => {
 var main = defineCommand10({
   meta: {
     name: "relay",
-    version: "0.13.0",
+    version: "0.14.0",
     description: "Unified CLI proxy for Claude Code, Codex CLI, and Gemini CLI"
   },
   subCommands: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rk0429/agentic-relay",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Unified CLI proxy for Claude Code, Codex CLI, and Gemini CLI with MCP-based multi-layer sub-agent orchestration",
   "type": "module",
   "license": "Apache-2.0",