@rk0429/agentic-relay 1.4.2 → 1.6.0

package/dist/relay.mjs

@@ -104,7 +104,7 @@ function validateMetadataValue(value, path2, depth) {
 }
 function validateMetadata(raw) {
   if (raw === void 0 || raw === null) {
-    return {};
+    return { taskId: "TASK-000" };
   }
   if (!isPlainObject(raw)) {
     throw new Error("metadata must be a plain object");
@@ -127,10 +127,13 @@ function validateMetadata(raw) {
     validateMetadataValue(value, key, 1);
   }
   const typed = raw;
-  if (typed.taskId !== void 0 && typeof typed.taskId !== "string") {
+  if (typed.taskId === void 0) {
+    typed.taskId = "TASK-000";
+  }
+  if (typeof typed.taskId !== "string") {
     throw new Error("metadata.taskId must be a string");
   }
-  if (typed.taskId !== void 0 && typeof typed.taskId === "string" && !TASK_ID_PATTERN.test(typed.taskId)) {
+  if (!TASK_ID_PATTERN.test(typed.taskId)) {
     throw new Error("metadata.taskId must match ^(TASK|GOAL)-\\d{3,}$");
   }
   if (typed.agentType !== void 0 && typeof typed.agentType !== "string") {
@@ -1012,6 +1015,13 @@ function buildChildMcpServers(parentMcpServers, childHttpUrl) {
   return result;
 }
 function resolveValidatedSessionMetadata(input) {
+  if (input.metadata === void 0 || input.metadata === null) {
+    throw new Error("metadata is required");
+  }
+  const rawTaskId = input.metadata.taskId;
+  if (typeof rawTaskId !== "string" || rawTaskId.trim().length === 0) {
+    throw new Error("metadata.taskId is required");
+  }
   const validated = validateMetadata(input.metadata);
   const mergedMetadata = { ...validated };
   if (mergedMetadata.agentType === void 0 && input.agent !== void 0) {
@@ -1076,16 +1086,12 @@ async function executeSpawnAgent(input, registry2, sessionManager2, guard, hooks
     const availableBackends = registry2.listIds();
     const selectionContext = {
       availableBackends,
-      preferredBackend: input.preferredBackend,
       agentType: input.agent,
       taskType: input.taskType
     };
     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)";
@@ -1227,6 +1233,24 @@ ${skillText}
 
 ${wrapped}` : wrapped;
     }
+  } else {
+    const autoSkillPaths = [
+      `.agents/skills/${input.agent}`,
+      `.claude/skills/${input.agent}`
+    ];
+    for (const skillPath of autoSkillPaths) {
+      const skillText = readSkillContext({ skillPath });
+      if (!skillText) {
+        continue;
+      }
+      const wrapped = `<skill-context path="${skillPath}">
+${skillText}
+</skill-context>`;
+      enhancedSystemPrompt = enhancedSystemPrompt ? `${enhancedSystemPrompt}
+
+${wrapped}` : wrapped;
+      break;
+    }
   }
   if (input.agentDefinition) {
     const defText = readAgentDefinition(input.agentDefinition.definitionPath);
@@ -1236,6 +1260,17 @@ ${defText}
 </agent-definition>`;
       enhancedSystemPrompt = enhancedSystemPrompt ? `${enhancedSystemPrompt}
 
+${wrapped}` : wrapped;
+    }
+  } else {
+    const autoDefinitionPath = `.agents/agents/${input.agent}.md`;
+    const defText = readAgentDefinition(autoDefinitionPath);
+    if (defText) {
+      const wrapped = `<agent-definition source="${autoDefinitionPath}">
+${defText}
+</agent-definition>`;
+      enhancedSystemPrompt = enhancedSystemPrompt ? `${enhancedSystemPrompt}
+
 ${wrapped}` : wrapped;
     }
   }
@@ -1395,7 +1430,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,
@@ -1634,13 +1668,10 @@ var init_spawn_agent = __esm({
     init_logger();
     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)."
-      ),
       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(
@@ -1659,23 +1690,20 @@ 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."
       ),
       label: z2.string().optional().describe("Human-readable label for identifying this agent in parallel results and logs."),
       metadata: z2.object({
-        taskId: z2.string().regex(TASK_ID_PATTERN).optional(),
+        taskId: z2.string().regex(TASK_ID_PATTERN),
         agentType: z2.string().optional(),
         label: z2.string().optional(),
         parentTaskId: z2.string().optional(),
         tags: z2.array(z2.string()).optional()
-      }).catchall(z2.unknown()).optional().describe("Session metadata for task linkage and orchestration context.")
+      }).catchall(z2.unknown()).describe("Session metadata for task linkage and orchestration context.")
     });
   }
 });
@@ -2129,13 +2157,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)) {
@@ -2420,7 +2445,7 @@ var init_server = __esm({
           this.agentEventStore
         );
         this.server = new McpServer(
-          { name: "agentic-relay", version: "1.4.2" },
+          { name: "agentic-relay", version: "1.6.0" },
           createMcpServerOptions()
         );
         this.registerTools(this.server);
@@ -2558,7 +2583,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). metadata with metadata.taskId is required for task-first delegation. Use 'agentDefinition' to inject an agent .md file, 'skillContext' for a SKILL.md, or 'systemPrompt' for custom instructions.",
             inputSchema: spawnAgentInputSchema.shape,
             execution: { taskSupport: "optional" }
           },
@@ -2614,20 +2639,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,
@@ -2908,7 +2924,7 @@ var init_server = __esm({
             sessionIdGenerator: () => randomUUID()
           });
           const server = new McpServer(
-            { name: "agentic-relay", version: "1.4.2" },
+            { name: "agentic-relay", version: "1.6.0" },
             createMcpServerOptions()
           );
           this.registerTools(server);
@@ -5591,7 +5607,7 @@ function fromSessionData(data) {
     updatedAt,
     lastHeartbeatAt: Number.isNaN(lastHeartbeatAt.getTime()) ? updatedAt : lastHeartbeatAt,
     staleNotifiedAt: staleNotifiedAt && !Number.isNaN(staleNotifiedAt.getTime()) ? staleNotifiedAt : null,
-    metadata: data.metadata && typeof data.metadata === "object" ? data.metadata : {}
+    metadata: data.metadata && typeof data.metadata === "object" ? data.metadata : { taskId: "TASK-000" }
   };
 }
 var SessionManager = class _SessionManager {
@@ -6660,7 +6676,7 @@ var ContextMonitor = class {
       sessionId,
       backendId,
       parentSessionId: void 0,
-      metadata: sessionMetadata ?? {},
+      metadata: sessionMetadata ?? { taskId: "TASK-000" },
       data: {
         usagePercent,
         currentTokens,
@@ -7347,7 +7363,7 @@ function createMCPCommand(configManager2, registry2, sessionManager2, hooksEngin
             responseOutputDir,
             relayConfig
           );
-          await server.start({ transport, port, currentVersion: "1.4.2" });
+          await server.start({ transport, port, currentVersion: "1.6.0" });
         }
       })
     },
@@ -7507,7 +7523,7 @@ function createVersionCommand(registry2) {
       description: "Show relay and backend versions"
     },
     async run() {
-      const relayVersion = "1.4.2";
+      const relayVersion = "1.6.0";
       console.log(`agentic-relay v${relayVersion}`);
       console.log("");
       console.log("Backends:");
@@ -7904,7 +7920,7 @@ var subCommandNames = /* @__PURE__ */ new Set(["claude", "codex", "gemini", "upd
 var main = defineCommand11({
   meta: {
     name: "relay",
-    version: "1.4.2",
+    version: "1.6.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.2",
+  "version": "1.6.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",