@rk0429/agentic-relay 1.5.0 → 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) {
@@ -1082,9 +1092,6 @@ 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)";
@@ -1226,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);
@@ -1235,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;
     }
   }
@@ -1632,9 +1668,6 @@ 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: 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."
       ),
@@ -1665,12 +1698,12 @@ var init_spawn_agent = __esm({
       ),
       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.")
     });
   }
 });
@@ -2412,7 +2445,7 @@ var init_server = __esm({
           this.agentEventStore
         );
         this.server = new McpServer(
-          { name: "agentic-relay", version: "1.5.0" },
+          { name: "agentic-relay", version: "1.6.0" },
           createMcpServerOptions()
         );
         this.registerTools(this.server);
@@ -2550,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: 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" }
           },
@@ -2891,7 +2924,7 @@ var init_server = __esm({
             sessionIdGenerator: () => randomUUID()
           });
           const server = new McpServer(
-            { name: "agentic-relay", version: "1.5.0" },
+            { name: "agentic-relay", version: "1.6.0" },
             createMcpServerOptions()
           );
           this.registerTools(server);
@@ -5574,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 {
@@ -6643,7 +6676,7 @@ var ContextMonitor = class {
       sessionId,
       backendId,
       parentSessionId: void 0,
-      metadata: sessionMetadata ?? {},
+      metadata: sessionMetadata ?? { taskId: "TASK-000" },
       data: {
         usagePercent,
         currentTokens,
@@ -7330,7 +7363,7 @@ function createMCPCommand(configManager2, registry2, sessionManager2, hooksEngin
             responseOutputDir,
             relayConfig
           );
-          await server.start({ transport, port, currentVersion: "1.5.0" });
+          await server.start({ transport, port, currentVersion: "1.6.0" });
         }
       })
     },
@@ -7490,7 +7523,7 @@ function createVersionCommand(registry2) {
       description: "Show relay and backend versions"
     },
     async run() {
-      const relayVersion = "1.5.0";
+      const relayVersion = "1.6.0";
       console.log(`agentic-relay v${relayVersion}`);
       console.log("");
       console.log("Backends:");
@@ -7887,7 +7920,7 @@ var subCommandNames = /* @__PURE__ */ new Set(["claude", "codex", "gemini", "upd
 var main = defineCommand11({
   meta: {
     name: "relay",
-    version: "1.5.0",
+    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.5.0",
+  "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",