@dexto/agent-management 1.6.25 → 1.6.27

package/dist/AgentFactory.cjs

@@ -137,6 +137,7 @@ const AgentFactory = {
     return await (0, import_agent_creation.createDextoAgentFromConfig)({
       config: configToEnrich,
       enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false },
+      hostContext: options?.hostContext,
       runtimeOverrides: options?.runtimeOverrides
     });
   }

package/dist/AgentFactory.d.ts

@@ -23,7 +23,7 @@
  * @see AgentManager for registry-based agent management
  * @see https://docs.dexto.ai/api/sdk/agent-factory for full documentation
  */
-import type { AgentConfig } from '@dexto/agent-config';
+import type { AgentConfig, DextoHostContext } from '@dexto/agent-config';
 import type { DextoAgent, DextoAgentConfigInput } from '@dexto/core';
 import { type InstallOptions } from './installation.js';
 import type { AgentMetadata } from './AgentManager.js';
@@ -44,6 +44,8 @@ export interface CreateAgentOptions {
     agentId?: string;
     /** Whether this is interactive CLI mode (affects logger defaults) */
     isInteractiveCli?: boolean;
+    /** Optional host-owned resolution context for hosted runtimes */
+    hostContext?: DextoHostContext | undefined;
     /** Explicit runtime overrides applied outside the validated agent config */
     runtimeOverrides?: Pick<DextoAgentConfigInput, 'usageScopeId'> | undefined;
 }

package/dist/AgentFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB5F,CAAC"}
+{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC3C,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAqB5F,CAAC"}

package/dist/AgentFactory.js

@@ -114,6 +114,7 @@ const AgentFactory = {
     return await createDextoAgentFromConfig({
       config: configToEnrich,
       enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false },
+      hostContext: options?.hostContext,
       runtimeOverrides: options?.runtimeOverrides
     });
   }

package/dist/agent-creation.cjs

@@ -61,7 +61,7 @@ function applySubAgentToolConstraints(config) {
   return { ...config, tools: constrainedTools };
 }
 async function createDextoAgentFromConfig(options) {
-  const { configPath, enrichOptions, agentIdOverride, overrides, runtimeOverrides } = options;
+  const { configPath, enrichOptions, agentIdOverride, hostContext, overrides, runtimeOverrides } = options;
   const cleanedConfig = (0, import_agent_config.cleanNullValues)(options.config);
   const { image } = await loadImageForConfig({
     config: cleanedConfig,
@@ -80,12 +80,14 @@ async function createDextoAgentFromConfig(options) {
     enrichedConfig.agentId = agentIdOverride;
   }
   const validatedConfig = import_agent_config.AgentConfigSchema.parse(enrichedConfig);
-  const services = await (0, import_agent_config.resolveServicesFromConfig)(validatedConfig, image);
+  const services = await (0, import_agent_config.resolveServicesFromConfig)(validatedConfig, image, hostContext);
   const mergedOverrides = overrides ? { ...overrides } : void 0;
   return new import_core.DextoAgent(
     (0, import_agent_config.toDextoAgentOptions)({
       config: validatedConfig,
       services,
+      image,
+      ...hostContext ? { hostContext } : {},
       ...runtimeOverrides ? { runtimeOverrides } : {},
       overrides: mergedOverrides
     })

package/dist/agent-creation.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig } from '@dexto/agent-config';
+import type { AgentConfig, DextoHostContext } from '@dexto/agent-config';
 import { DextoAgent, type DextoAgentConfigInput, type InitializeServicesOptions } from '@dexto/core';
 import { type EnrichAgentConfigOptions } from './config/index.js';
 type CreateDextoAgentFromConfigOptions = {
@@ -8,6 +8,7 @@ type CreateDextoAgentFromConfigOptions = {
     agentIdOverride?: string | undefined;
     imageNameOverride?: string | undefined;
     agentContext?: 'subagent' | undefined;
+    hostContext?: DextoHostContext | undefined;
     overrides?: InitializeServicesOptions | undefined;
     runtimeOverrides?: Pick<DextoAgentConfigInput, 'usageScopeId'> | undefined;
 };

package/dist/agent-creation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EACH,UAAU,EAEV,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClD,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAuCrB"}
+{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAc,MAAM,qBAAqB,CAAC;AASrF,OAAO,EACH,UAAU,EAEV,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClD,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CA0CrB"}

package/dist/agent-creation.js

@@ -48,7 +48,7 @@ function applySubAgentToolConstraints(config) {
   return { ...config, tools: constrainedTools };
 }
 async function createDextoAgentFromConfig(options) {
-  const { configPath, enrichOptions, agentIdOverride, overrides, runtimeOverrides } = options;
+  const { configPath, enrichOptions, agentIdOverride, hostContext, overrides, runtimeOverrides } = options;
   const cleanedConfig = cleanNullValues(options.config);
   const { image } = await loadImageForConfig({
     config: cleanedConfig,
@@ -67,12 +67,14 @@ async function createDextoAgentFromConfig(options) {
     enrichedConfig.agentId = agentIdOverride;
   }
   const validatedConfig = AgentConfigSchema.parse(enrichedConfig);
-  const services = await resolveServicesFromConfig(validatedConfig, image);
+  const services = await resolveServicesFromConfig(validatedConfig, image, hostContext);
   const mergedOverrides = overrides ? { ...overrides } : void 0;
   return new DextoAgent(
     toDextoAgentOptions({
       config: validatedConfig,
       services,
+      image,
+      ...hostContext ? { hostContext } : {},
       ...runtimeOverrides ? { runtimeOverrides } : {},
       overrides: mergedOverrides
     })

package/dist/tool-factories/agent-spawner/factory.cjs

@@ -78,6 +78,7 @@ const agentSpawnerToolsFactory = {
       updateWorkspaceRootHint(spawnerRuntime, context);
       attachTaskForker({ toolServices, taskForker: spawnerRuntime, logger });
       const taskSessions = /* @__PURE__ */ new Map();
+      const taskHostRuntimeContexts = /* @__PURE__ */ new Map();
       const emitTasksUpdate = (sessionId) => {
         const tasks = taskRegistry.list({
           status: ["running", "completed", "failed", "cancelled"]
@@ -100,13 +101,14 @@ const agentSpawnerToolsFactory = {
           }
         });
       };
-      const triggerBackgroundCompletion = (taskId, sessionId) => {
+      const triggerBackgroundCompletion = (taskId, sessionId, hostRuntime) => {
         if (!sessionId) {
           return;
         }
         agent.emit("tool:background-completed", {
           toolCallId: taskId,
-          sessionId
+          sessionId,
+          ...hostRuntime !== void 0 && { hostRuntime }
         });
         const taskInfo = taskRegistry.getInfo(taskId);
         const resultText = (() => {
@@ -154,9 +156,14 @@ const agentSpawnerToolsFactory = {
               sessionId,
               content,
               source: "external",
-              metadata: { taskId }
+              metadata: { taskId },
+              ...hostRuntime !== void 0 && { hostRuntime }
             });
-            agent.generate(content, sessionId).catch(() => void 0);
+            agent.generate(content, sessionId, {
+              ...hostRuntime !== void 0 && {
+                executionContext: hostRuntime
+              }
+            }).catch(() => void 0);
           }
         }).catch(() => {
         });
@@ -169,6 +176,9 @@ const agentSpawnerToolsFactory = {
         if (event.sessionId) {
           taskSessions.set(taskId, event.sessionId);
         }
+        if (event.hostRuntime !== void 0) {
+          taskHostRuntimeContexts.set(taskId, event.hostRuntime);
+        }
         try {
           taskRegistry.register(
             {
@@ -186,6 +196,7 @@ const agentSpawnerToolsFactory = {
           );
         } catch (error) {
           taskSessions.delete(taskId);
+          taskHostRuntimeContexts.delete(taskId);
           event.promise.catch(() => void 0);
           logger.warn(
             `Failed to register background task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
@@ -196,8 +207,10 @@ const agentSpawnerToolsFactory = {
         emitTasksUpdate(event.sessionId);
         event.promise.finally(() => {
           taskSessions.delete(taskId);
+          const hostRuntime = taskHostRuntimeContexts.get(taskId);
+          taskHostRuntimeContexts.delete(taskId);
           emitTasksUpdate(event.sessionId);
-          triggerBackgroundCompletion(taskId, event.sessionId);
+          triggerBackgroundCompletion(taskId, event.sessionId, hostRuntime);
         });
       };
       const abortController = new AbortController();

package/dist/tool-factories/agent-spawner/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiBvD,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAqCtB,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,kBAAkB,CA8WpE,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiBvD,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAqCtB,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,kBAAkB,CAiYpE,CAAC"}

package/dist/tool-factories/agent-spawner/factory.js

@@ -68,6 +68,7 @@ const agentSpawnerToolsFactory = {
       updateWorkspaceRootHint(spawnerRuntime, context);
       attachTaskForker({ toolServices, taskForker: spawnerRuntime, logger });
       const taskSessions = /* @__PURE__ */ new Map();
+      const taskHostRuntimeContexts = /* @__PURE__ */ new Map();
       const emitTasksUpdate = (sessionId) => {
         const tasks = taskRegistry.list({
           status: ["running", "completed", "failed", "cancelled"]
@@ -90,13 +91,14 @@ const agentSpawnerToolsFactory = {
           }
         });
       };
-      const triggerBackgroundCompletion = (taskId, sessionId) => {
+      const triggerBackgroundCompletion = (taskId, sessionId, hostRuntime) => {
         if (!sessionId) {
           return;
         }
         agent.emit("tool:background-completed", {
           toolCallId: taskId,
-          sessionId
+          sessionId,
+          ...hostRuntime !== void 0 && { hostRuntime }
         });
         const taskInfo = taskRegistry.getInfo(taskId);
         const resultText = (() => {
@@ -144,9 +146,14 @@ const agentSpawnerToolsFactory = {
               sessionId,
               content,
               source: "external",
-              metadata: { taskId }
+              metadata: { taskId },
+              ...hostRuntime !== void 0 && { hostRuntime }
             });
-            agent.generate(content, sessionId).catch(() => void 0);
+            agent.generate(content, sessionId, {
+              ...hostRuntime !== void 0 && {
+                executionContext: hostRuntime
+              }
+            }).catch(() => void 0);
           }
         }).catch(() => {
         });
@@ -159,6 +166,9 @@ const agentSpawnerToolsFactory = {
         if (event.sessionId) {
           taskSessions.set(taskId, event.sessionId);
         }
+        if (event.hostRuntime !== void 0) {
+          taskHostRuntimeContexts.set(taskId, event.hostRuntime);
+        }
         try {
           taskRegistry.register(
             {
@@ -176,6 +186,7 @@ const agentSpawnerToolsFactory = {
           );
         } catch (error) {
           taskSessions.delete(taskId);
+          taskHostRuntimeContexts.delete(taskId);
           event.promise.catch(() => void 0);
           logger.warn(
             `Failed to register background task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
@@ -186,8 +197,10 @@ const agentSpawnerToolsFactory = {
         emitTasksUpdate(event.sessionId);
         event.promise.finally(() => {
           taskSessions.delete(taskId);
+          const hostRuntime = taskHostRuntimeContexts.get(taskId);
+          taskHostRuntimeContexts.delete(taskId);
           emitTasksUpdate(event.sessionId);
-          triggerBackgroundCompletion(taskId, event.sessionId);
+          triggerBackgroundCompletion(taskId, event.sessionId, hostRuntime);
         });
       };
       const abortController = new AbortController();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.6.25",
+  "version": "1.6.27",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -17,10 +17,10 @@
   "dependencies": {
     "yaml": "^2.8.3",
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.25",
-    "@dexto/core": "1.6.25",
-    "@dexto/orchestration": "1.6.25",
-    "@dexto/tools-builtins": "1.6.25"
+    "@dexto/agent-config": "1.6.27",
+    "@dexto/core": "1.6.27",
+    "@dexto/orchestration": "1.6.27",
+    "@dexto/tools-builtins": "1.6.27"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"