@dexto/core 1.2.4 → 1.2.5

package/dist/telemetry/utils.cjs

@@ -25,43 +25,47 @@ __export(utils_exports, {
 module.exports = __toCommonJS(utils_exports);
 var import_api = require("@opentelemetry/api");
 var import_telemetry = require("./telemetry.js");
-var import_logger = require("../logger/index.js");
-function hasActiveTelemetry() {
-  import_logger.logger.silly("hasActiveTelemetry called.");
+function hasActiveTelemetry(logger) {
+  logger?.silly("hasActiveTelemetry called.");
   try {
     const telemetryInstance = import_telemetry.Telemetry.get();
     const isActive = telemetryInstance.isInitialized();
-    import_logger.logger.silly(`hasActiveTelemetry: Telemetry is initialized: ${isActive}`);
+    logger?.silly(`hasActiveTelemetry: Telemetry is initialized: ${isActive}`);
     return isActive;
   } catch (error) {
-    import_logger.logger.silly(
+    logger?.silly(
       `hasActiveTelemetry: Telemetry not active or initialized. Error: ${error instanceof Error ? error.message : String(error)}`
     );
     return false;
   }
 }
-function getBaggageValues(ctx) {
-  import_logger.logger.silly("getBaggageValues called.");
+function getBaggageValues(ctx, logger) {
+  logger?.silly("getBaggageValues called.");
   const currentBaggage = import_api.propagation.getBaggage(ctx);
   const requestId = currentBaggage?.getEntry("http.request_id")?.value;
   const componentName = currentBaggage?.getEntry("componentName")?.value;
   const runId = currentBaggage?.getEntry("runId")?.value;
   const threadId = currentBaggage?.getEntry("threadId")?.value;
   const resourceId = currentBaggage?.getEntry("resourceId")?.value;
-  import_logger.logger.silly(
-    `getBaggageValues: Extracted - requestId: ${requestId}, componentName: ${componentName}, runId: ${runId}, threadId: ${threadId}, resourceId: ${resourceId}`
+  const sessionId = currentBaggage?.getEntry("sessionId")?.value;
+  logger?.silly(
+    `getBaggageValues: Extracted - requestId: ${requestId}, componentName: ${componentName}, runId: ${runId}, threadId: ${threadId}, resourceId: ${resourceId}, sessionId: ${sessionId}`
   );
   return {
     requestId,
     componentName,
     runId,
     threadId,
-    resourceId
+    resourceId,
+    sessionId
   };
 }
-function addBaggageAttributesToSpan(span, ctx) {
-  import_logger.logger.debug("addBaggageAttributesToSpan called.");
-  const { requestId, componentName, runId, threadId, resourceId } = getBaggageValues(ctx);
+function addBaggageAttributesToSpan(span, ctx, logger) {
+  logger?.debug("addBaggageAttributesToSpan called.");
+  const { requestId, componentName, runId, threadId, resourceId, sessionId } = getBaggageValues(
+    ctx,
+    logger
+  );
   if (componentName) {
     span.setAttribute("componentName", componentName);
   }
@@ -77,7 +81,10 @@ function addBaggageAttributesToSpan(span, ctx) {
   if (resourceId) {
     span.setAttribute("resourceId", resourceId);
   }
-  import_logger.logger.debug("addBaggageAttributesToSpan: Baggage attributes added to span.");
+  if (sessionId) {
+    span.setAttribute("sessionId", sessionId);
+  }
+  logger?.debug("addBaggageAttributesToSpan: Baggage attributes added to span.");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/telemetry/utils.d.ts

@@ -1,21 +1,25 @@
 import type { Context, Span } from '@opentelemetry/api';
-export declare function hasActiveTelemetry(): boolean;
+import type { IDextoLogger } from '../logger/v2/types.js';
+export declare function hasActiveTelemetry(logger?: IDextoLogger): boolean;
 /**
  * Get baggage values from context
  * @param ctx The context to get baggage values from
+ * @param logger Optional logger instance
  * @returns
  */
-export declare function getBaggageValues(ctx: Context): {
+export declare function getBaggageValues(ctx: Context, logger?: IDextoLogger): {
     requestId: string | undefined;
     componentName: string | undefined;
     runId: string | undefined;
     threadId: string | undefined;
     resourceId: string | undefined;
+    sessionId: string | undefined;
 };
 /**
  * Attaches baggage values from the given context to the provided span as attributes.
  * @param span The OpenTelemetry Span to add attributes to.
  * @param ctx The OpenTelemetry Context from which to extract baggage values.
+ * @param logger Optional logger instance
  */
-export declare function addBaggageAttributesToSpan(span: Span, ctx: Context): void;
+export declare function addBaggageAttributesToSpan(span: Span, ctx: Context, logger?: IDextoLogger): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/telemetry/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/telemetry/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAKxD,wBAAgB,kBAAkB,IAAI,OAAO,CAa5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO;;;;;;EAkB5C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAoBzE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/telemetry/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAajE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY;;;;;;;EAoBnE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CA0BhG"}

package/dist/telemetry/utils.js

@@ -1,43 +1,47 @@
 import "../chunk-C6A6W6XS.js";
 import { propagation } from "@opentelemetry/api";
 import { Telemetry } from "./telemetry.js";
-import { logger } from "../logger/index.js";
-function hasActiveTelemetry() {
-  logger.silly("hasActiveTelemetry called.");
+function hasActiveTelemetry(logger) {
+  logger?.silly("hasActiveTelemetry called.");
   try {
     const telemetryInstance = Telemetry.get();
     const isActive = telemetryInstance.isInitialized();
-    logger.silly(`hasActiveTelemetry: Telemetry is initialized: ${isActive}`);
+    logger?.silly(`hasActiveTelemetry: Telemetry is initialized: ${isActive}`);
     return isActive;
   } catch (error) {
-    logger.silly(
+    logger?.silly(
       `hasActiveTelemetry: Telemetry not active or initialized. Error: ${error instanceof Error ? error.message : String(error)}`
     );
     return false;
   }
 }
-function getBaggageValues(ctx) {
-  logger.silly("getBaggageValues called.");
+function getBaggageValues(ctx, logger) {
+  logger?.silly("getBaggageValues called.");
   const currentBaggage = propagation.getBaggage(ctx);
   const requestId = currentBaggage?.getEntry("http.request_id")?.value;
   const componentName = currentBaggage?.getEntry("componentName")?.value;
   const runId = currentBaggage?.getEntry("runId")?.value;
   const threadId = currentBaggage?.getEntry("threadId")?.value;
   const resourceId = currentBaggage?.getEntry("resourceId")?.value;
-  logger.silly(
-    `getBaggageValues: Extracted - requestId: ${requestId}, componentName: ${componentName}, runId: ${runId}, threadId: ${threadId}, resourceId: ${resourceId}`
+  const sessionId = currentBaggage?.getEntry("sessionId")?.value;
+  logger?.silly(
+    `getBaggageValues: Extracted - requestId: ${requestId}, componentName: ${componentName}, runId: ${runId}, threadId: ${threadId}, resourceId: ${resourceId}, sessionId: ${sessionId}`
   );
   return {
     requestId,
     componentName,
     runId,
     threadId,
-    resourceId
+    resourceId,
+    sessionId
   };
 }
-function addBaggageAttributesToSpan(span, ctx) {
-  logger.debug("addBaggageAttributesToSpan called.");
-  const { requestId, componentName, runId, threadId, resourceId } = getBaggageValues(ctx);
+function addBaggageAttributesToSpan(span, ctx, logger) {
+  logger?.debug("addBaggageAttributesToSpan called.");
+  const { requestId, componentName, runId, threadId, resourceId, sessionId } = getBaggageValues(
+    ctx,
+    logger
+  );
   if (componentName) {
     span.setAttribute("componentName", componentName);
   }
@@ -53,7 +57,10 @@ function addBaggageAttributesToSpan(span, ctx) {
   if (resourceId) {
     span.setAttribute("resourceId", resourceId);
   }
-  logger.debug("addBaggageAttributesToSpan: Baggage attributes added to span.");
+  if (sessionId) {
+    span.setAttribute("sessionId", sessionId);
+  }
+  logger?.debug("addBaggageAttributesToSpan: Baggage attributes added to span.");
 }
 export {
   addBaggageAttributesToSpan,

package/dist/tools/confirmation/allowed-tools-provider/factory.cjs

@@ -24,12 +24,12 @@ module.exports = __toCommonJS(factory_exports);
 var import_in_memory = require("./in-memory.js");
 var import_storage = require("./storage.js");
 var import_errors = require("../../errors.js");
-function createAllowedToolsProvider(config) {
+function createAllowedToolsProvider(config, logger) {
   switch (config.type) {
     case "memory":
       return new import_in_memory.InMemoryAllowedToolsProvider();
     case "storage":
-      return new import_storage.StorageAllowedToolsProvider(config.storageManager);
+      return new import_storage.StorageAllowedToolsProvider(config.storageManager, logger);
     default: {
       const _exhaustive = config;
       throw import_errors.ToolError.configInvalid(

package/dist/tools/confirmation/allowed-tools-provider/factory.d.ts

@@ -1,5 +1,6 @@
 import type { IAllowedToolsProvider } from './types.js';
 import type { StorageManager } from '../../../storage/index.js';
+import type { IDextoLogger } from '../../../logger/v2/types.js';
 export type AllowedToolsConfig = {
     type: 'memory';
 } | {
@@ -9,5 +10,5 @@ export type AllowedToolsConfig = {
 /**
  * Create an AllowedToolsProvider based on configuration.
  */
-export declare function createAllowedToolsProvider(config: AllowedToolsConfig): IAllowedToolsProvider;
+export declare function createAllowedToolsProvider(config: AllowedToolsConfig, logger: IDextoLogger): IAllowedToolsProvider;
 //# sourceMappingURL=factory.d.ts.map

package/dist/tools/confirmation/allowed-tools-provider/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/tools/confirmation/allowed-tools-provider/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAW7D,MAAM,MAAM,kBAAkB,GACxB;IACI,IAAI,EAAE,QAAQ,CAAC;CAClB,GACD;IACI,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;CAClC,CAAC;AAER;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAc5F"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/tools/confirmation/allowed-tools-provider/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAU7D,MAAM,MAAM,kBAAkB,GACxB;IACI,IAAI,EAAE,QAAQ,CAAC;CAClB,GACD;IACI,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;CAClC,CAAC;AAER;;GAEG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,YAAY,GACrB,qBAAqB,CAcvB"}

package/dist/tools/confirmation/allowed-tools-provider/factory.js

@@ -2,12 +2,12 @@ import "../../../chunk-C6A6W6XS.js";
 import { InMemoryAllowedToolsProvider } from "./in-memory.js";
 import { StorageAllowedToolsProvider } from "./storage.js";
 import { ToolError } from "../../errors.js";
-function createAllowedToolsProvider(config) {
+function createAllowedToolsProvider(config, logger) {
   switch (config.type) {
     case "memory":
       return new InMemoryAllowedToolsProvider();
     case "storage":
-      return new StorageAllowedToolsProvider(config.storageManager);
+      return new StorageAllowedToolsProvider(config.storageManager, logger);
     default: {
       const _exhaustive = config;
       throw ToolError.configInvalid(

package/dist/tools/confirmation/allowed-tools-provider/storage.cjs

@@ -21,26 +21,27 @@ __export(storage_exports, {
   StorageAllowedToolsProvider: () => StorageAllowedToolsProvider
 });
 module.exports = __toCommonJS(storage_exports);
-var import_logger = require("../../../logger/index.cjs");
 class StorageAllowedToolsProvider {
-  constructor(storageManager) {
+  constructor(storageManager, logger) {
     this.storageManager = storageManager;
+    this.logger = logger;
   }
+  logger;
   buildKey(sessionId) {
     return sessionId ? `allowedTools:${sessionId}` : "allowedTools:global";
   }
   async allowTool(toolName, sessionId) {
     const key = this.buildKey(sessionId);
-    import_logger.logger.debug(`Adding allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Adding allowed tool '${toolName}' for key '${key}'`);
     const existingRaw = await this.storageManager.getDatabase().get(key);
     const newSet = new Set(Array.isArray(existingRaw) ? existingRaw : []);
     newSet.add(toolName);
     await this.storageManager.getDatabase().set(key, Array.from(newSet));
-    import_logger.logger.debug(`Added allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Added allowed tool '${toolName}' for key '${key}'`);
   }
   async disallowTool(toolName, sessionId) {
     const key = this.buildKey(sessionId);
-    import_logger.logger.debug(`Removing allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Removing allowed tool '${toolName}' for key '${key}'`);
     const existingRaw = await this.storageManager.getDatabase().get(key);
     if (!Array.isArray(existingRaw)) return;
     const newSet = new Set(existingRaw);
@@ -52,7 +53,7 @@ class StorageAllowedToolsProvider {
     if (Array.isArray(sessionArr) && sessionArr.includes(toolName)) return true;
     const globalArr = await this.storageManager.getDatabase().get(this.buildKey(void 0));
     const allowed = Array.isArray(globalArr) ? globalArr.includes(toolName) : false;
-    import_logger.logger.debug(
+    this.logger.debug(
       `Checked allowed tool '${toolName}' in session '${sessionId ?? "global"}' \u2013 allowed=${allowed}`
     );
     return allowed;

package/dist/tools/confirmation/allowed-tools-provider/storage.d.ts

@@ -1,5 +1,6 @@
 import type { StorageManager } from '../../../storage/index.js';
 import type { IAllowedToolsProvider } from './types.js';
+import type { IDextoLogger } from '../../../logger/v2/types.js';
 /**
  * Storage-backed implementation that persists allowed tools in the Dexto
  * storage manager. The key scheme is:
@@ -10,7 +11,8 @@ import type { IAllowedToolsProvider } from './types.js';
  */
 export declare class StorageAllowedToolsProvider implements IAllowedToolsProvider {
     private storageManager;
-    constructor(storageManager: StorageManager);
+    private logger;
+    constructor(storageManager: StorageManager, logger: IDextoLogger);
     private buildKey;
     allowTool(toolName: string, sessionId?: string): Promise<void>;
     disallowTool(toolName: string, sessionId?: string): Promise<void>;

package/dist/tools/confirmation/allowed-tools-provider/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/tools/confirmation/allowed-tools-provider/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;GAOG;AACH,qBAAa,2BAA4B,YAAW,qBAAqB;IACzD,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAElD,OAAO,CAAC,QAAQ;IAIV,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;CAIlE"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/tools/confirmation/allowed-tools-provider/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;GAOG;AACH,qBAAa,2BAA4B,YAAW,qBAAqB;IAIjE,OAAO,CAAC,cAAc;IAH1B,OAAO,CAAC,MAAM,CAAe;gBAGjB,cAAc,EAAE,cAAc,EACtC,MAAM,EAAE,YAAY;IAKxB,OAAO,CAAC,QAAQ;IAIV,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;CAIlE"}

package/dist/tools/confirmation/allowed-tools-provider/storage.js

@@ -1,24 +1,25 @@
 import "../../../chunk-C6A6W6XS.js";
-import { logger } from "../../../logger/index.js";
 class StorageAllowedToolsProvider {
-  constructor(storageManager) {
+  constructor(storageManager, logger) {
     this.storageManager = storageManager;
+    this.logger = logger;
   }
+  logger;
   buildKey(sessionId) {
     return sessionId ? `allowedTools:${sessionId}` : "allowedTools:global";
   }
   async allowTool(toolName, sessionId) {
     const key = this.buildKey(sessionId);
-    logger.debug(`Adding allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Adding allowed tool '${toolName}' for key '${key}'`);
     const existingRaw = await this.storageManager.getDatabase().get(key);
     const newSet = new Set(Array.isArray(existingRaw) ? existingRaw : []);
     newSet.add(toolName);
     await this.storageManager.getDatabase().set(key, Array.from(newSet));
-    logger.debug(`Added allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Added allowed tool '${toolName}' for key '${key}'`);
   }
   async disallowTool(toolName, sessionId) {
     const key = this.buildKey(sessionId);
-    logger.debug(`Removing allowed tool '${toolName}' for key '${key}'`);
+    this.logger.debug(`Removing allowed tool '${toolName}' for key '${key}'`);
     const existingRaw = await this.storageManager.getDatabase().get(key);
     if (!Array.isArray(existingRaw)) return;
     const newSet = new Set(existingRaw);
@@ -30,7 +31,7 @@ class StorageAllowedToolsProvider {
     if (Array.isArray(sessionArr) && sessionArr.includes(toolName)) return true;
     const globalArr = await this.storageManager.getDatabase().get(this.buildKey(void 0));
     const allowed = Array.isArray(globalArr) ? globalArr.includes(toolName) : false;
-    logger.debug(
+    this.logger.debug(
       `Checked allowed tool '${toolName}' in session '${sessionId ?? "global"}' \u2013 allowed=${allowed}`
     );
     return allowed;

package/dist/tools/errors.cjs

@@ -65,11 +65,12 @@ class ToolError {
    * Tool execution timeout
    */
   static executionTimeout(toolName, timeoutMs, sessionId) {
+    const message = timeoutMs > 0 ? `Tool '${toolName}' execution timed out after ${timeoutMs}ms` : `Tool '${toolName}' execution timed out`;
     return new import_DextoRuntimeError.DextoRuntimeError(
       import_error_codes.ToolErrorCode.EXECUTION_TIMEOUT,
       import_types.ErrorScope.TOOLS,
       import_types.ErrorType.TIMEOUT,
-      `Tool '${toolName}' execution timed out after ${timeoutMs}ms`,
+      message,
       { toolName, timeoutMs, sessionId }
     );
   }

package/dist/tools/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;GAGG;AACH,qBAAa,SAAS;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;;;IAUhC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAU3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAU3D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAU/E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAUxD;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM;;;IAUlD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAUlF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAUnD;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM;;;IAUnD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;IAUpC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;CAShE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;GAGG;AACH,qBAAa,SAAS;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;;;IAUhC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAU3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAU3D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAc/E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;IAUxD;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM;;;IAUlD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAUlF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAUnD;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM;;;IAUnD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;IAUpC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;CAShE"}

package/dist/tools/errors.js

@@ -43,11 +43,12 @@ class ToolError {
    * Tool execution timeout
    */
   static executionTimeout(toolName, timeoutMs, sessionId) {
+    const message = timeoutMs > 0 ? `Tool '${toolName}' execution timed out after ${timeoutMs}ms` : `Tool '${toolName}' execution timed out`;
     return new DextoRuntimeError(
       ToolErrorCode.EXECUTION_TIMEOUT,
       ErrorScope.TOOLS,
       ErrorType.TIMEOUT,
-      `Tool '${toolName}' execution timed out after ${timeoutMs}ms`,
+      message,
       { toolName, timeoutMs, sessionId }
     );
   }

package/dist/tools/internal-tools/constants.cjs

@@ -31,7 +31,8 @@ const INTERNAL_TOOL_NAMES = [
   "edit_file",
   "bash_exec",
   "bash_output",
-  "kill_process"
+  "kill_process",
+  "delegate_to_url"
 ];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/tools/internal-tools/constants.d.ts

@@ -7,6 +7,6 @@
  * Available internal tool names
  * Must be kept in sync with INTERNAL_TOOL_REGISTRY in registry.ts
  */
-export declare const INTERNAL_TOOL_NAMES: readonly ["search_history", "ask_user", "read_file", "glob_files", "grep_content", "write_file", "edit_file", "bash_exec", "bash_output", "kill_process"];
+export declare const INTERNAL_TOOL_NAMES: readonly ["search_history", "ask_user", "read_file", "glob_files", "grep_content", "write_file", "edit_file", "bash_exec", "bash_output", "kill_process", "delegate_to_url"];
 export type KnownInternalTool = (typeof INTERNAL_TOOL_NAMES)[number];
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/internal-tools/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2JAWtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/internal-tools/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8KAYtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools/internal-tools/constants.js

@@ -9,7 +9,8 @@ const INTERNAL_TOOL_NAMES = [
   "edit_file",
   "bash_exec",
   "bash_output",
-  "kill_process"
+  "kill_process",
+  "delegate_to_url"
 ];
 export {
   INTERNAL_TOOL_NAMES

package/dist/tools/internal-tools/implementations/bash-exec-tool.cjs

@@ -47,7 +47,7 @@ const BashExecInputSchema = import_zod.z.object({
 function createBashExecTool(processService, approvalManager) {
   return {
     id: "bash_exec",
-    description: "Execute a shell command. Returns stdout, stderr, exit code, and duration. Use run_in_background=true for long-running commands (use bash_output to retrieve results later). Requires approval for all commands. Dangerous commands (rm, git push, etc.) require additional per-command approval. Always quote file paths with spaces. Set timeout to prevent hanging commands. Security: dangerous commands are blocked, injection attempts are detected.",
+    description: "Execute a shell command with 2-minute default timeout. Returns stdout, stderr, exit code, and duration. For long-running commands (servers, watchers, npm run dev), MUST use run_in_background=true (use bash_output to retrieve results later). Commands ending with & are blocked - use run_in_background instead. Requires approval for all commands. Dangerous commands (rm, git push, etc.) require additional per-command approval. Always quote file paths with spaces. Security: dangerous commands are blocked, injection attempts are detected.",
     inputSchema: BashExecInputSchema,
     execute: async (input, context) => {
       const { command, description, timeout, run_in_background, cwd } = input;

package/dist/tools/internal-tools/implementations/bash-exec-tool.js

@@ -15,7 +15,7 @@ const BashExecInputSchema = z.object({
 function createBashExecTool(processService, approvalManager) {
   return {
     id: "bash_exec",
-    description: "Execute a shell command. Returns stdout, stderr, exit code, and duration. Use run_in_background=true for long-running commands (use bash_output to retrieve results later). Requires approval for all commands. Dangerous commands (rm, git push, etc.) require additional per-command approval. Always quote file paths with spaces. Set timeout to prevent hanging commands. Security: dangerous commands are blocked, injection attempts are detected.",
+    description: "Execute a shell command with 2-minute default timeout. Returns stdout, stderr, exit code, and duration. For long-running commands (servers, watchers, npm run dev), MUST use run_in_background=true (use bash_output to retrieve results later). Commands ending with & are blocked - use run_in_background instead. Requires approval for all commands. Dangerous commands (rm, git push, etc.) require additional per-command approval. Always quote file paths with spaces. Security: dangerous commands are blocked, injection attempts are detected.",
     inputSchema: BashExecInputSchema,
     execute: async (input, context) => {
       const { command, description, timeout, run_in_background, cwd } = input;

package/dist/tools/internal-tools/implementations/delegate-to-url-tool.cjs

@@ -0,0 +1,192 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var delegate_to_url_tool_exports = {};
+__export(delegate_to_url_tool_exports, {
+  createDelegateToUrlTool: () => createDelegateToUrlTool
+});
+module.exports = __toCommonJS(delegate_to_url_tool_exports);
+var import_zod = require("zod");
+var import_errors = require("../../../errors/index.js");
+const DelegateToUrlInputSchema = import_zod.z.object({
+  url: import_zod.z.string().url().describe(
+    'The A2A-compliant agent URL (e.g., "http://localhost:3001" or "https://agent.example.com"). The tool will automatically append the correct JSON-RPC endpoint.'
+  ),
+  message: import_zod.z.string().min(1).describe(
+    "The message or task to delegate to the agent. This will be sent as natural language input."
+  ),
+  sessionId: import_zod.z.string().optional().describe(
+    "Optional session ID for maintaining conversation state across multiple delegations to the same agent"
+  ),
+  timeout: import_zod.z.number().optional().default(3e4).describe("Request timeout in milliseconds (default: 30000)")
+}).strict();
+class SimpleA2AClient {
+  url;
+  timeout;
+  constructor(url, timeout = 3e4) {
+    this.url = url.replace(/\/$/, "");
+    this.timeout = timeout;
+  }
+  /**
+   * Send a message to the A2A agent using JSON-RPC 2.0
+   */
+  async sendMessage(message, sessionId) {
+    const messageId = this.generateId();
+    const taskId = sessionId || this.generateId();
+    const a2aMessage = {
+      role: "user",
+      parts: [
+        {
+          kind: "text",
+          text: message
+        }
+      ],
+      messageId,
+      taskId,
+      contextId: taskId,
+      kind: "message"
+    };
+    const rpcRequest = {
+      jsonrpc: "2.0",
+      id: this.generateId(),
+      method: "message/send",
+      params: {
+        message: a2aMessage,
+        configuration: {
+          blocking: true
+          // Wait for completion
+        }
+      }
+    };
+    const endpoints = [
+      `${this.url}/v1/jsonrpc`,
+      // A2A v0.3.0 JSON-RPC endpoint
+      `${this.url}/jsonrpc`
+      // Alternative path
+    ];
+    let lastError = null;
+    for (const endpoint of endpoints) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "User-Agent": "@dexto/core"
+          },
+          body: JSON.stringify(rpcRequest),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          lastError = new Error(
+            `HTTP ${response.status}: ${response.statusText} (tried ${endpoint})`
+          );
+          continue;
+        }
+        const data = await response.json();
+        if ("error" in data && data.error) {
+          throw new Error(
+            `Agent returned error: ${data.error.message || "Unknown error"}`
+          );
+        }
+        if ("result" in data) {
+          return this.extractTaskResponse(data.result);
+        }
+        return data;
+      } catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+          throw new import_errors.DextoRuntimeError(
+            `Delegation timeout after ${this.timeout}ms`,
+            import_errors.ErrorScope.TOOLS,
+            import_errors.ErrorType.TIMEOUT,
+            "DELEGATION_TIMEOUT"
+          );
+        }
+        lastError = error instanceof Error ? error : new Error(String(error));
+      }
+    }
+    throw new import_errors.DextoRuntimeError(
+      `Failed to connect to agent at ${this.url}. Tried endpoints: ${endpoints.join(", ")}. Last error: ${lastError?.message || "Unknown error"}`,
+      import_errors.ErrorScope.TOOLS,
+      import_errors.ErrorType.THIRD_PARTY,
+      "DELEGATION_FAILED"
+    );
+  }
+  /**
+   * Extract response text from A2A Task structure
+   */
+  extractTaskResponse(task) {
+    if (task.history && Array.isArray(task.history)) {
+      const agentMessages = task.history.filter((m) => m.role === "agent");
+      if (agentMessages.length > 0) {
+        const lastMessage = agentMessages[agentMessages.length - 1];
+        if (lastMessage.parts && Array.isArray(lastMessage.parts)) {
+          const textParts = lastMessage.parts.filter((p) => p.kind === "text").map((p) => p.text);
+          if (textParts.length > 0) {
+            return textParts.join("\n");
+          }
+        }
+      }
+    }
+    return JSON.stringify(task, null, 2);
+  }
+  /**
+   * Generate unique ID
+   */
+  generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+  }
+}
+function createDelegateToUrlTool() {
+  return {
+    id: "delegate_to_url",
+    description: 'Delegate a task to another A2A-compliant agent at a specific URL. Supports STATEFUL multi-turn conversations via sessionId parameter. USAGE: (1) First delegation: provide url + message. Tool returns a response AND a sessionId. (2) Follow-up: use the SAME sessionId to continue the conversation with that agent. The agent remembers previous context. EXAMPLE: First call {url: "http://agent:3001", message: "Analyze data X"} returns {sessionId: "xyz", response: "..."}. Second call {url: "http://agent:3001", message: "What was the top insight?", sessionId: "xyz"}. The agent will remember the first analysis and can answer specifically.',
+    inputSchema: DelegateToUrlInputSchema,
+    execute: async (input, _context) => {
+      const { url, message, sessionId, timeout } = input;
+      try {
+        const client = new SimpleA2AClient(url, timeout);
+        const effectiveSessionId = sessionId || `delegation-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const response = await client.sendMessage(message, effectiveSessionId);
+        return {
+          success: true,
+          agentUrl: url,
+          sessionId: effectiveSessionId,
+          response,
+          _hint: sessionId ? "Continued existing conversation" : "Started new conversation - use this sessionId for follow-ups"
+        };
+      } catch (error) {
+        if (error instanceof import_errors.DextoRuntimeError) {
+          throw error;
+        }
+        throw new import_errors.DextoRuntimeError(
+          `Delegation failed: ${error instanceof Error ? error.message : String(error)}`,
+          import_errors.ErrorScope.TOOLS,
+          import_errors.ErrorType.SYSTEM,
+          "DELEGATION_ERROR"
+        );
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDelegateToUrlTool
+});