@dexto/server 1.6.26 → 1.7.0

package/dist/approval/approval-coordinator.cjs

@@ -23,14 +23,17 @@ __export(approval_coordinator_exports, {
 module.exports = __toCommonJS(approval_coordinator_exports);
 var import_node_events = require("node:events");
 class ApprovalCoordinator extends import_node_events.EventEmitter {
-  // Track approvalId -> sessionId mapping for multi-client SSE routing
-  approvalSessions = /* @__PURE__ */ new Map();
+  // Track approvalId -> request context mapping for multi-client routing and correlation.
+  approvalContexts = /* @__PURE__ */ new Map();
   /**
    * Emit an approval request.
    * Called by ManualApprovalHandler when tool/command needs approval.
    */
   emitRequest(request) {
-    this.approvalSessions.set(request.approvalId, request.sessionId);
+    this.approvalContexts.set(request.approvalId, {
+      sessionId: request.sessionId,
+      hostRuntime: request.hostRuntime
+    });
     this.emit("approval:request", request);
   }
   /**
@@ -39,14 +42,17 @@ class ApprovalCoordinator extends import_node_events.EventEmitter {
    */
   emitResponse(response) {
     this.emit("approval:response", response);
-    this.approvalSessions.delete(response.approvalId);
+    this.approvalContexts.delete(response.approvalId);
   }
   /**
    * Get the sessionId associated with an approval request.
    * Used by API routes to attach sessionId to responses for SSE routing.
    */
   getSessionId(approvalId) {
-    return this.approvalSessions.get(approvalId);
+    return this.approvalContexts.get(approvalId)?.sessionId;
+  }
+  getHostRuntime(approvalId) {
+    return this.approvalContexts.get(approvalId)?.hostRuntime;
   }
   /**
    * Subscribe to approval requests.

package/dist/approval/approval-coordinator.d.ts

@@ -12,7 +12,7 @@ import type { ApprovalRequest, ApprovalResponse } from '@dexto/core';
  * - Approval routes: Emits responses from client submissions
  */
 export declare class ApprovalCoordinator extends EventEmitter {
-    private approvalSessions;
+    private approvalContexts;
     /**
      * Emit an approval request.
      * Called by ManualApprovalHandler when tool/command needs approval.
@@ -28,6 +28,7 @@ export declare class ApprovalCoordinator extends EventEmitter {
      * Used by API routes to attach sessionId to responses for SSE routing.
      */
     getSessionId(approvalId: string): string | undefined;
+    getHostRuntime(approvalId: string): ApprovalRequest['hostRuntime'] | undefined;
     /**
      * Subscribe to approval requests.
      * Used by streaming endpoints to forward requests to SSE clients.

package/dist/approval/approval-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-coordinator.d.ts","sourceRoot":"","sources":["../../src/approval/approval-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,OAAO,CAAC,gBAAgB,CAAyC;IAEjE;;;OAGG;IACI,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAMlD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAMrD;;;OAGG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D;;;;;;OAMG;IACI,SAAS,CACZ,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;IAYP;;;;;;OAMG;IACI,UAAU,CACb,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;CAWV"}
+{"version":3,"file":"approval-coordinator.d.ts","sourceRoot":"","sources":["../../src/approval/approval-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,OAAO,CAAC,gBAAgB,CAGpB;IAEJ;;;OAGG;IACI,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IASlD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAMrD;;;OAGG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,GAAG,SAAS;IAIrF;;;;;;OAMG;IACI,SAAS,CACZ,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;IAYP;;;;;;OAMG;IACI,UAAU,CACb,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;CAWV"}

package/dist/approval/approval-coordinator.js

@@ -1,13 +1,16 @@
 import { EventEmitter } from "node:events";
 class ApprovalCoordinator extends EventEmitter {
-  // Track approvalId -> sessionId mapping for multi-client SSE routing
-  approvalSessions = /* @__PURE__ */ new Map();
+  // Track approvalId -> request context mapping for multi-client routing and correlation.
+  approvalContexts = /* @__PURE__ */ new Map();
   /**
    * Emit an approval request.
    * Called by ManualApprovalHandler when tool/command needs approval.
    */
   emitRequest(request) {
-    this.approvalSessions.set(request.approvalId, request.sessionId);
+    this.approvalContexts.set(request.approvalId, {
+      sessionId: request.sessionId,
+      hostRuntime: request.hostRuntime
+    });
     this.emit("approval:request", request);
   }
   /**
@@ -16,14 +19,17 @@ class ApprovalCoordinator extends EventEmitter {
    */
   emitResponse(response) {
     this.emit("approval:response", response);
-    this.approvalSessions.delete(response.approvalId);
+    this.approvalContexts.delete(response.approvalId);
   }
   /**
    * Get the sessionId associated with an approval request.
    * Used by API routes to attach sessionId to responses for SSE routing.
    */
   getSessionId(approvalId) {
-    return this.approvalSessions.get(approvalId);
+    return this.approvalContexts.get(approvalId)?.sessionId;
+  }
+  getHostRuntime(approvalId) {
+    return this.approvalContexts.get(approvalId)?.hostRuntime;
   }
   /**
    * Subscribe to approval requests.

package/dist/approval/manual-approval-handler.cjs

@@ -36,6 +36,7 @@ function createManualApprovalHandler(coordinator) {
             approvalId: request.approvalId,
             status: import_core.ApprovalStatus.CANCELLED,
             sessionId: request.sessionId,
+            hostRuntime: request.hostRuntime,
             reason: import_core.DenialReason.TIMEOUT,
             message: `Approval request timed out after ${effectiveTimeout}ms`,
             timeoutMs: effectiveTimeout
@@ -81,6 +82,7 @@ function createManualApprovalHandler(coordinator) {
           approvalId,
           status: import_core.ApprovalStatus.CANCELLED,
           sessionId: pending.request.sessionId,
+          hostRuntime: pending.request.hostRuntime,
           reason: import_core.DenialReason.SYSTEM_CANCELLED,
           message: "Approval request was cancelled"
         };
@@ -114,6 +116,7 @@ function createManualApprovalHandler(coordinator) {
             approvalId,
             status: import_core.ApprovalStatus.APPROVED,
             sessionId: pending.request.sessionId,
+            hostRuntime: pending.request.hostRuntime,
             message: "Auto-approved due to matching remembered pattern",
             data: responseData
           };

package/dist/approval/manual-approval-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manual-approval-handler.d.ts","sourceRoot":"","sources":["../../src/approval/manual-approval-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAqC,MAAM,aAAa,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,mBAAmB,GAAG,eAAe,CAkK7F"}
+{"version":3,"file":"manual-approval-handler.d.ts","sourceRoot":"","sources":["../../src/approval/manual-approval-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAqC,MAAM,aAAa,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,mBAAmB,GAAG,eAAe,CAqK7F"}

package/dist/approval/manual-approval-handler.js

@@ -13,6 +13,7 @@ function createManualApprovalHandler(coordinator) {
             approvalId: request.approvalId,
             status: ApprovalStatus.CANCELLED,
             sessionId: request.sessionId,
+            hostRuntime: request.hostRuntime,
             reason: DenialReason.TIMEOUT,
             message: `Approval request timed out after ${effectiveTimeout}ms`,
             timeoutMs: effectiveTimeout
@@ -58,6 +59,7 @@ function createManualApprovalHandler(coordinator) {
           approvalId,
           status: ApprovalStatus.CANCELLED,
           sessionId: pending.request.sessionId,
+          hostRuntime: pending.request.hostRuntime,
           reason: DenialReason.SYSTEM_CANCELLED,
           message: "Approval request was cancelled"
         };
@@ -91,6 +93,7 @@ function createManualApprovalHandler(coordinator) {
             approvalId,
             status: ApprovalStatus.APPROVED,
             sessionId: pending.request.sessionId,
+            hostRuntime: pending.request.hostRuntime,
             message: "Auto-approved due to matching remembered pattern",
             data: responseData
           };

package/dist/events/session-sse-subscriber.cjs

@@ -25,19 +25,39 @@ var import_events = require("events");
 var import_node_util = require("node:util");
 var import_web = require("node:stream/web");
 var import_core = require("@dexto/core");
+const SESSION_EVENT_NAMES = [
+  "llm:thinking",
+  "llm:chunk",
+  "llm:response",
+  "llm:tool-call",
+  "llm:tool-call-partial",
+  "llm:tool-result",
+  "llm:error",
+  "llm:unsupported-input",
+  "tool:running",
+  "context:compacting",
+  "context:compacted",
+  "context:pruned",
+  "message:queued",
+  "message:dequeued",
+  "session:title-updated",
+  "approval:request",
+  "approval:response",
+  "service:event",
+  "run:complete"
+];
 function serializeEventPayload(eventName, payload) {
-  if (eventName === "llm:error") {
-    const errorPayload = payload;
+  if (eventName === "llm:error" && "error" in payload) {
     return {
-      ...errorPayload,
-      error: errorPayload.error instanceof Error ? {
-        message: errorPayload.error.message,
-        name: errorPayload.error.name,
-        stack: errorPayload.error.stack
-      } : errorPayload.error
+      ...payload,
+      error: payload.error instanceof Error ? {
+        message: payload.error.message,
+        name: payload.error.name,
+        stack: payload.error.stack
+      } : payload.error
     };
   }
-  return payload;
+  return { ...payload };
 }
 class SessionSseEventSubscriber {
   connections = /* @__PURE__ */ new Map();
@@ -48,40 +68,22 @@ class SessionSseEventSubscriber {
     const { signal } = this.globalAbortController;
     (0, import_events.setMaxListeners)(32, signal);
     const subscribeSessionEvent = (eventName) => {
-      eventBus.on(
-        eventName,
-        ((payload) => {
-          if (!payload || typeof payload !== "object" || !("sessionId" in payload) || typeof payload.sessionId !== "string") {
-            return;
-          }
-          this.broadcastToSession(
-            payload.sessionId,
-            String(eventName),
-            serializeEventPayload(eventName, payload)
-          );
-        }),
-        { signal }
-      );
+      const listener = (...args) => {
+        const [payload] = args;
+        if (!payload || typeof payload !== "object" || !("sessionId" in payload) || typeof payload.sessionId !== "string") {
+          return;
+        }
+        this.broadcastToSession(
+          payload.sessionId,
+          String(eventName),
+          serializeEventPayload(eventName, payload)
+        );
+      };
+      eventBus.on(eventName, listener, { signal });
     };
-    subscribeSessionEvent("llm:thinking");
-    subscribeSessionEvent("llm:chunk");
-    subscribeSessionEvent("llm:response");
-    subscribeSessionEvent("llm:tool-call");
-    subscribeSessionEvent("llm:tool-call-partial");
-    subscribeSessionEvent("llm:tool-result");
-    subscribeSessionEvent("llm:error");
-    subscribeSessionEvent("llm:unsupported-input");
-    subscribeSessionEvent("tool:running");
-    subscribeSessionEvent("context:compacting");
-    subscribeSessionEvent("context:compacted");
-    subscribeSessionEvent("context:pruned");
-    subscribeSessionEvent("message:queued");
-    subscribeSessionEvent("message:dequeued");
-    subscribeSessionEvent("session:title-updated");
-    subscribeSessionEvent("approval:request");
-    subscribeSessionEvent("approval:response");
-    subscribeSessionEvent("service:event");
-    subscribeSessionEvent("run:complete");
+    for (const eventName of SESSION_EVENT_NAMES) {
+      subscribeSessionEvent(eventName);
+    }
     import_core.logger.debug("SessionSseEventSubscriber subscribed to agent events");
   }
   createStream(sessionId) {

package/dist/events/session-sse-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-sse-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/session-sse-subscriber.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwC,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAgChE,qBAAa,yBAAyB;IAClC,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAuDxC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAsC3D,OAAO,CAAC,kBAAkB;IAgC1B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IAKtB,OAAO,IAAI,IAAI;CASlB"}
+{"version":3,"file":"session-sse-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/session-sse-subscriber.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwC,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAA2C,MAAM,aAAa,CAAC;AAwD1F,qBAAa,yBAAyB;IAClC,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAsCxC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAsC3D,OAAO,CAAC,kBAAkB;IAgC1B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IAKtB,OAAO,IAAI,IAAI;CASlB"}

package/dist/events/session-sse-subscriber.js

@@ -2,19 +2,39 @@ import { setMaxListeners } from "events";
 import { TextEncoder } from "node:util";
 import { ReadableStream } from "node:stream/web";
 import { logger } from "@dexto/core";
+const SESSION_EVENT_NAMES = [
+  "llm:thinking",
+  "llm:chunk",
+  "llm:response",
+  "llm:tool-call",
+  "llm:tool-call-partial",
+  "llm:tool-result",
+  "llm:error",
+  "llm:unsupported-input",
+  "tool:running",
+  "context:compacting",
+  "context:compacted",
+  "context:pruned",
+  "message:queued",
+  "message:dequeued",
+  "session:title-updated",
+  "approval:request",
+  "approval:response",
+  "service:event",
+  "run:complete"
+];
 function serializeEventPayload(eventName, payload) {
-  if (eventName === "llm:error") {
-    const errorPayload = payload;
+  if (eventName === "llm:error" && "error" in payload) {
     return {
-      ...errorPayload,
-      error: errorPayload.error instanceof Error ? {
-        message: errorPayload.error.message,
-        name: errorPayload.error.name,
-        stack: errorPayload.error.stack
-      } : errorPayload.error
+      ...payload,
+      error: payload.error instanceof Error ? {
+        message: payload.error.message,
+        name: payload.error.name,
+        stack: payload.error.stack
+      } : payload.error
     };
   }
-  return payload;
+  return { ...payload };
 }
 class SessionSseEventSubscriber {
   connections = /* @__PURE__ */ new Map();
@@ -25,40 +45,22 @@ class SessionSseEventSubscriber {
     const { signal } = this.globalAbortController;
     setMaxListeners(32, signal);
     const subscribeSessionEvent = (eventName) => {
-      eventBus.on(
-        eventName,
-        ((payload) => {
-          if (!payload || typeof payload !== "object" || !("sessionId" in payload) || typeof payload.sessionId !== "string") {
-            return;
-          }
-          this.broadcastToSession(
-            payload.sessionId,
-            String(eventName),
-            serializeEventPayload(eventName, payload)
-          );
-        }),
-        { signal }
-      );
+      const listener = (...args) => {
+        const [payload] = args;
+        if (!payload || typeof payload !== "object" || !("sessionId" in payload) || typeof payload.sessionId !== "string") {
+          return;
+        }
+        this.broadcastToSession(
+          payload.sessionId,
+          String(eventName),
+          serializeEventPayload(eventName, payload)
+        );
+      };
+      eventBus.on(eventName, listener, { signal });
     };
-    subscribeSessionEvent("llm:thinking");
-    subscribeSessionEvent("llm:chunk");
-    subscribeSessionEvent("llm:response");
-    subscribeSessionEvent("llm:tool-call");
-    subscribeSessionEvent("llm:tool-call-partial");
-    subscribeSessionEvent("llm:tool-result");
-    subscribeSessionEvent("llm:error");
-    subscribeSessionEvent("llm:unsupported-input");
-    subscribeSessionEvent("tool:running");
-    subscribeSessionEvent("context:compacting");
-    subscribeSessionEvent("context:compacted");
-    subscribeSessionEvent("context:pruned");
-    subscribeSessionEvent("message:queued");
-    subscribeSessionEvent("message:dequeued");
-    subscribeSessionEvent("session:title-updated");
-    subscribeSessionEvent("approval:request");
-    subscribeSessionEvent("approval:response");
-    subscribeSessionEvent("service:event");
-    subscribeSessionEvent("run:complete");
+    for (const eventName of SESSION_EVENT_NAMES) {
+      subscribeSessionEvent(eventName);
+    }
     logger.debug("SessionSseEventSubscriber subscribed to agent events");
   }
   createStream(sessionId) {

package/dist/hono/routes/a2a-tasks.cjs

@@ -198,7 +198,7 @@ const MessageSendRequestSchema = import_zod_openapi.z.object({
     historyLength: import_zod_openapi.z.number().optional().describe("Limit conversation history length"),
     pushNotificationConfig: import_zod_openapi.z.object({
       url: import_zod_openapi.z.string().describe("Push notification webhook URL"),
-      headers: import_zod_openapi.z.record(import_zod_openapi.z.string()).optional().describe("HTTP headers for webhook")
+      headers: import_zod_openapi.z.record(import_zod_openapi.z.string(), import_zod_openapi.z.string()).optional().describe("HTTP headers for webhook")
     }).optional().describe("Push notification configuration"),
     blocking: import_zod_openapi.z.boolean().optional().describe("Wait for task completion")
   }).optional().describe("Optional configuration"),

package/dist/hono/routes/a2a-tasks.js

@@ -179,7 +179,7 @@ const MessageSendRequestSchema = z.object({
     historyLength: z.number().optional().describe("Limit conversation history length"),
     pushNotificationConfig: z.object({
       url: z.string().describe("Push notification webhook URL"),
-      headers: z.record(z.string()).optional().describe("HTTP headers for webhook")
+      headers: z.record(z.string(), z.string()).optional().describe("HTTP headers for webhook")
     }).optional().describe("Push notification configuration"),
     blocking: z.boolean().optional().describe("Wait for task completion")
   }).optional().describe("Optional configuration"),

package/dist/hono/routes/agents.cjs

@@ -734,9 +734,9 @@ function createAgentsRouter(getAgent, context, getAgentConfigPath) {
     const validationResult = import_agent_config.AgentConfigSchema.safeParse(enriched);
     if (!validationResult.success) {
       throw new import_core2.DextoValidationError(
-        validationResult.error.errors.map((err) => ({
+        (0, import_core.zodToIssues)(validationResult.error).map((err) => ({
           code: import_core2.AgentErrorCode.INVALID_CONFIG,
-          message: `${err.path.join(".")}: ${err.message}`,
+          message: `${err.path?.join(".") || "root"}: ${err.message}`,
           scope: import_core2.ErrorScope.AGENT,
           type: import_core2.ErrorType.USER,
           severity: "error"