@rk0429/agentic-relay 1.4.1 → 1.5.0

package/dist/relay.mjs

@@ -160,6 +160,47 @@ var init_metadata_validation = __esm({
   }
 });
 
+// src/infrastructure/version-check.ts
+async function getLatestNpmVersion(packageName) {
+  try {
+    const response = await fetch(
+      `https://registry.npmjs.org/${packageName}/latest`,
+      {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(5e3)
+      }
+    );
+    if (!response.ok) {
+      logger.debug(
+        `npm registry returned ${response.status} for ${packageName}`
+      );
+      return null;
+    }
+    const data = await response.json();
+    return data.version ?? null;
+  } catch (error) {
+    logger.debug(
+      `Failed to check npm registry: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return null;
+  }
+}
+function compareSemver(a, b) {
+  const partsA = a.replace(/^v/, "").split(".").map(Number);
+  const partsB = b.replace(/^v/, "").split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+var init_version_check = __esm({
+  "src/infrastructure/version-check.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/mcp-server/deferred-cleanup-task-store.ts
 import { isTerminal } from "@modelcontextprotocol/sdk/experimental/tasks/interfaces.js";
 import { randomBytes } from "crypto";
@@ -1035,7 +1076,6 @@ async function executeSpawnAgent(input, registry2, sessionManager2, guard, hooks
     const availableBackends = registry2.listIds();
     const selectionContext = {
       availableBackends,
-      preferredBackend: input.preferredBackend,
       agentType: input.agent,
       taskType: input.taskType
     };
@@ -1354,7 +1394,6 @@ ${input.prompt}`;
     const metadata = {
       durationMs: new Date(completedAt).getTime() - new Date(spawnStartedAt).getTime(),
       selectedBackend: effectiveBackend,
-      ...input.preferredBackend ? { requestedBackend: input.preferredBackend } : {},
       selectionReason,
       startedAt: spawnStartedAt,
       completedAt,
@@ -1594,12 +1633,12 @@ var init_spawn_agent = __esm({
     init_metadata_validation();
     spawnAgentInputSchema = z2.object({
       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)."
+        "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: 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."
       ),
-      agent: z2.string().optional().describe(
+      agent: z2.string().describe(
         "Agent type identifier (e.g., 'coder', 'researcher', 'documenter', 'software-engineer'). Affects backend auto-selection: coder/researcher/software-engineer/devops-engineer\u2192codex, documenter\u2192claude. Also used to resolve agentDefinition files from .agents/agents/<agent>.md."
       ),
       systemPrompt: z2.string().optional().describe(
@@ -1618,11 +1657,8 @@ var init_spawn_agent = __esm({
       agentDefinition: z2.object({
         definitionPath: z2.string().describe("Path to the agent definition .md file (e.g., '.agents/agents/coder.md')")
       }).optional().describe("Agent definition file to inject into the sub-agent's system prompt as <agent-definition> context."),
-      preferredBackend: z2.enum(["claude", "codex", "gemini"]).optional().describe(
-        "Preferred backend override. Takes highest priority in backend selection. Use when the automatic agentType/taskType mapping does not match your needs."
-      ),
       taskType: z2.enum(["code-writing", "code-review", "document-writing", "document-review", "research", "mixed"]).optional().describe(
-        "Task type hint for automatic backend selection (priority 3, after preferredBackend and agentType). Mapping: code-writing\u2192codex, code-review\u2192claude, document-writing\u2192claude, document-review\u2192codex, research\u2192codex, mixed\u2192claude."
+        "Task type hint for automatic backend selection (priority 2, after agentType). Mapping: code-writing\u2192codex, code-review\u2192claude, document-writing\u2192claude, document-review\u2192codex, research\u2192codex, mixed\u2192claude."
       ),
       taskInstructionPath: z2.string().optional().describe(
         "Path to a file containing task instructions. Content is prepended to the prompt. Path is resolved relative to the project root and validated against path traversal."
@@ -2088,13 +2124,10 @@ var init_backend_selector = __esm({
         return this.selectBackendWithReason(context).backend;
       }
       selectBackendWithReason(context) {
-        const { availableBackends, preferredBackend, agentType, taskType } = context;
+        const { availableBackends, agentType, taskType } = context;
         if (availableBackends.length === 0) {
           throw new Error("No backends available");
         }
-        if (preferredBackend && availableBackends.includes(preferredBackend)) {
-          return { backend: preferredBackend, reason: "preferredBackend" };
-        }
         if (agentType) {
           const mapped = this.agentToBackendMap[agentType];
           if (mapped && availableBackends.includes(mapped)) {
@@ -2330,6 +2363,7 @@ var init_server = __esm({
     init_backend_selector();
     init_metadata_validation();
     init_logger();
+    init_version_check();
     init_types();
     init_response_formatter();
     spawnAgentsParallelInputShape = {
@@ -2378,7 +2412,7 @@ var init_server = __esm({
           this.agentEventStore
         );
         this.server = new McpServer(
-          { name: "agentic-relay", version: "1.4.1" },
+          { name: "agentic-relay", version: "1.5.0" },
           createMcpServerOptions()
         );
         this.registerTools(this.server);
@@ -2516,7 +2550,7 @@ var init_server = __esm({
         server.experimental.tasks.registerToolTask(
           "spawn_agent",
           {
-            description: "Spawn a sub-agent on a backend CLI (Claude Code, Codex CLI, or Gemini CLI). The agent executes the given prompt in non-interactive mode and returns the result. Backend is auto-selected by priority: preferredBackend > agentType mapping (coder/researcher\u2192codex, documenter\u2192claude) > taskType mapping > default (claude). Use 'agentDefinition' to inject an agent .md file, 'skillContext' for a SKILL.md, or 'systemPrompt' for custom instructions.",
+            description: "Spawn a sub-agent on a backend CLI (Claude Code, Codex CLI, or Gemini CLI). The agent executes the given prompt in non-interactive mode and returns the result. Backend is auto-selected by priority: agentType mapping (coder/researcher\u2192codex, documenter\u2192claude) > taskType mapping > default (claude). Use 'agentDefinition' to inject an agent .md file, 'skillContext' for a SKILL.md, or 'systemPrompt' for custom instructions.",
             inputSchema: spawnAgentInputSchema.shape,
             execution: { taskSupport: "optional" }
           },
@@ -2572,20 +2606,11 @@ var init_server = __esm({
             failedResults: z7.array(z7.object({
               index: z7.number(),
               originalInput: spawnAgentInputSchema
-            })).min(1).describe("Array of failed results with their original input configurations"),
-            overrides: z7.object({
-              preferredBackend: z7.enum(["claude", "codex", "gemini"]).optional()
-            }).optional().describe("Parameter overrides applied to all retried agents")
+            })).min(1).describe("Array of failed results with their original input configurations")
           },
           async (params) => {
             try {
-              const agents = params.failedResults.map((r) => {
-                const input = { ...r.originalInput };
-                if (params.overrides) {
-                  if (params.overrides.preferredBackend !== void 0) input.preferredBackend = params.overrides.preferredBackend;
-                }
-                return input;
-              });
+              const agents = params.failedResults.map((r) => ({ ...r.originalInput }));
               const result = await executeSpawnAgentsParallel(
                 agents,
                 this.registry,
@@ -2782,8 +2807,25 @@ var init_server = __esm({
           }
         );
       }
+      async checkForUpdates(currentVersion) {
+        try {
+          const latest = await getLatestNpmVersion("@rk0429/agentic-relay");
+          if (latest && compareSemver(latest, currentVersion) > 0) {
+            logger.warn(
+              `A newer version of @rk0429/agentic-relay is available: ${latest} (current: ${currentVersion})`
+            );
+            logger.warn(
+              "  Run: npm install -g @rk0429/agentic-relay@latest"
+            );
+          }
+        } catch {
+        }
+      }
       async start(options) {
         const transportType = options?.transport ?? "stdio";
+        if (options?.currentVersion) {
+          void this.checkForUpdates(options.currentVersion);
+        }
         if (transportType === "stdio") {
           redirectToStderr();
           logger.info("Starting agentic-relay MCP server (stdio transport)...");
@@ -2849,7 +2891,7 @@ var init_server = __esm({
             sessionIdGenerator: () => randomUUID()
           });
           const server = new McpServer(
-            { name: "agentic-relay", version: "1.4.1" },
+            { name: "agentic-relay", version: "1.5.0" },
             createMcpServerOptions()
           );
           this.registerTools(server);
@@ -6982,45 +7024,8 @@ function createBackendCommand(backendId, registry2, sessionManager2, hooksEngine
 
 // src/commands/update.ts
 init_logger();
+init_version_check();
 import { defineCommand as defineCommand2 } from "citty";
-
-// src/infrastructure/version-check.ts
-init_logger();
-async function getLatestNpmVersion(packageName) {
-  try {
-    const response = await fetch(
-      `https://registry.npmjs.org/${packageName}/latest`,
-      {
-        headers: { Accept: "application/json" },
-        signal: AbortSignal.timeout(5e3)
-      }
-    );
-    if (!response.ok) {
-      logger.debug(
-        `npm registry returned ${response.status} for ${packageName}`
-      );
-      return null;
-    }
-    const data = await response.json();
-    return data.version ?? null;
-  } catch (error) {
-    logger.debug(
-      `Failed to check npm registry: ${error instanceof Error ? error.message : String(error)}`
-    );
-    return null;
-  }
-}
-function compareSemver(a, b) {
-  const partsA = a.replace(/^v/, "").split(".").map(Number);
-  const partsB = b.replace(/^v/, "").split(".").map(Number);
-  for (let i = 0; i < 3; i++) {
-    const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);
-    if (diff !== 0) return diff;
-  }
-  return 0;
-}
-
-// src/commands/update.ts
 var PACKAGE_NAME = "@rk0429/agentic-relay";
 var CURRENT_VERSION = "0.4.0";
 function createUpdateCommand(registry2) {
@@ -7325,7 +7330,7 @@ function createMCPCommand(configManager2, registry2, sessionManager2, hooksEngin
             responseOutputDir,
             relayConfig
           );
-          await server.start({ transport, port });
+          await server.start({ transport, port, currentVersion: "1.5.0" });
         }
       })
     },
@@ -7485,7 +7490,7 @@ function createVersionCommand(registry2) {
       description: "Show relay and backend versions"
     },
     async run() {
-      const relayVersion = "1.4.1";
+      const relayVersion = "1.5.0";
       console.log(`agentic-relay v${relayVersion}`);
       console.log("");
       console.log("Backends:");
@@ -7882,7 +7887,7 @@ var subCommandNames = /* @__PURE__ */ new Set(["claude", "codex", "gemini", "upd
 var main = defineCommand11({
   meta: {
     name: "relay",
-    version: "1.4.1",
+    version: "1.5.0",
     description: "Unified CLI proxy for Claude Code, Codex CLI, and Gemini CLI"
   },
   args: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rk0429/agentic-relay",
-  "version": "1.4.1",
+  "version": "1.5.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",