@dexto/tools-scheduler 1.6.0 → 1.6.2

package/dist/service.cjs

@@ -0,0 +1,51 @@
+"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 service_exports = {};
+__export(service_exports, {
+  createSchedulerService: () => createSchedulerService
+});
+module.exports = __toCommonJS(service_exports);
+var import_schemas = require("./schemas.js");
+var import_manager = require("./manager.js");
+async function createSchedulerService(options) {
+  const resolvedConfig = options.config ?? import_schemas.SchedulerToolsConfigSchema.parse({ type: "scheduler-tools" });
+  const manager = new import_manager.SchedulerManager(
+    options.storageManager,
+    resolvedConfig,
+    options.logger,
+    options.storageNamespace ? { storageNamespace: options.storageNamespace } : void 0
+  );
+  if (options.executor) {
+    manager.setExecutor(options.executor);
+  }
+  await manager.init();
+  if (options.autoStart !== false) {
+    try {
+      await manager.start();
+    } catch (error) {
+      await manager.stop().catch(() => void 0);
+      throw error;
+    }
+  }
+  return manager;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSchedulerService
+});

package/dist/service.d.cts

@@ -0,0 +1,37 @@
+import { StorageManager, Logger } from '@dexto/core';
+import { SchedulerToolsConfig } from './schemas.cjs';
+import { ScheduleExecutorFn } from './types.cjs';
+import { SchedulerManager } from './manager.cjs';
+import 'zod';
+
+/**
+ * Options for constructing a scheduler service.
+ *
+ * @property storageManager Storage manager used for persistence.
+ * @property logger Logger used by the scheduler manager.
+ * @property config Optional scheduler config. Defaults to `SchedulerToolsConfigSchema` when omitted.
+ * @property storageNamespace Optional namespace for scheduler storage.
+ * @property executor Optional executor override for schedule runs.
+ * @property autoStart When false, initializes without starting the scheduler.
+ */
+type SchedulerServiceOptions = {
+    storageManager: StorageManager;
+    logger: Logger;
+    config?: SchedulerToolsConfig;
+    storageNamespace?: string;
+    executor?: ScheduleExecutorFn;
+    autoStart?: boolean;
+};
+/**
+ * Create and initialize a SchedulerManager with optional overrides.
+ *
+ * If `config` is omitted, this uses `SchedulerToolsConfigSchema` to provide defaults.
+ * Use `executor` to override how scheduled tasks are executed without changing storage or config.
+ *
+ * @param options Service construction options.
+ *
+ * @returns A ready-to-use SchedulerManager instance.
+ */
+declare function createSchedulerService(options: SchedulerServiceOptions): Promise<SchedulerManager>;
+
+export { type SchedulerServiceOptions, createSchedulerService };

package/dist/service.d.ts

@@ -0,0 +1,34 @@
+import type { Logger, StorageManager } from '@dexto/core';
+import { type SchedulerToolsConfig } from './schemas.js';
+import type { ScheduleExecutorFn } from './types.js';
+import { SchedulerManager } from './manager.js';
+/**
+ * Options for constructing a scheduler service.
+ *
+ * @property storageManager Storage manager used for persistence.
+ * @property logger Logger used by the scheduler manager.
+ * @property config Optional scheduler config. Defaults to `SchedulerToolsConfigSchema` when omitted.
+ * @property storageNamespace Optional namespace for scheduler storage.
+ * @property executor Optional executor override for schedule runs.
+ * @property autoStart When false, initializes without starting the scheduler.
+ */
+export type SchedulerServiceOptions = {
+    storageManager: StorageManager;
+    logger: Logger;
+    config?: SchedulerToolsConfig;
+    storageNamespace?: string;
+    executor?: ScheduleExecutorFn;
+    autoStart?: boolean;
+};
+/**
+ * Create and initialize a SchedulerManager with optional overrides.
+ *
+ * If `config` is omitted, this uses `SchedulerToolsConfigSchema` to provide defaults.
+ * Use `executor` to override how scheduled tasks are executed without changing storage or config.
+ *
+ * @param options Service construction options.
+ *
+ * @returns A ready-to-use SchedulerManager instance.
+ */
+export declare function createSchedulerService(options: SchedulerServiceOptions): Promise<SchedulerManager>;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAyB3B"}

package/dist/service.js

@@ -0,0 +1,27 @@
+import { SchedulerToolsConfigSchema } from "./schemas.js";
+import { SchedulerManager } from "./manager.js";
+async function createSchedulerService(options) {
+  const resolvedConfig = options.config ?? SchedulerToolsConfigSchema.parse({ type: "scheduler-tools" });
+  const manager = new SchedulerManager(
+    options.storageManager,
+    resolvedConfig,
+    options.logger,
+    options.storageNamespace ? { storageNamespace: options.storageNamespace } : void 0
+  );
+  if (options.executor) {
+    manager.setExecutor(options.executor);
+  }
+  await manager.init();
+  if (options.autoStart !== false) {
+    try {
+      await manager.start();
+    } catch (error) {
+      await manager.stop().catch(() => void 0);
+      throw error;
+    }
+  }
+  return manager;
+}
+export {
+  createSchedulerService
+};

package/dist/storage.cjs

@@ -22,21 +22,26 @@ __export(storage_exports, {
 });
 module.exports = __toCommonJS(storage_exports);
 var import_errors = require("./errors.js");
-const SCHEDULE_PREFIX = "schedule:";
-const EXECUTION_LOG_PREFIX = "execution:";
-const SCHEDULE_LIST_KEY = "scheduler:schedules";
+const DEFAULT_SCHEDULER_NAMESPACE = "default";
 class ScheduleStorage {
-  constructor(storageManager, maxExecutionHistory, logger) {
+  constructor(storageManager, maxExecutionHistory, logger, namespace) {
     this.storageManager = storageManager;
     this.maxExecutionHistory = maxExecutionHistory;
     this.logger = logger;
+    const ns = namespace && namespace.trim().length > 0 ? namespace.trim() : DEFAULT_SCHEDULER_NAMESPACE;
+    this.schedulePrefix = `scheduler:${ns}:schedule:`;
+    this.executionLogPrefix = `scheduler:${ns}:execution:`;
+    this.scheduleListKey = `scheduler:${ns}:schedules`;
   }
   listLock = Promise.resolve();
+  schedulePrefix;
+  executionLogPrefix;
+  scheduleListKey;
   /**
    * Save a schedule to persistent storage
    */
   async saveSchedule(schedule) {
-    const key = `${SCHEDULE_PREFIX}${schedule.id}`;
+    const key = `${this.schedulePrefix}${schedule.id}`;
     let persisted = false;
     try {
       await this.storageManager.getDatabase().set(key, schedule);
@@ -64,7 +69,7 @@ class ScheduleStorage {
    */
   async loadSchedule(scheduleId) {
     try {
-      const key = `${SCHEDULE_PREFIX}${scheduleId}`;
+      const key = `${this.schedulePrefix}${scheduleId}`;
       const schedule = await this.storageManager.getDatabase().get(key);
       return schedule || null;
     } catch (error) {
@@ -79,7 +84,7 @@ class ScheduleStorage {
    */
   async listSchedules() {
     try {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       const schedules = [];
       for (const scheduleId of scheduleIds) {
         const schedule = await this.loadSchedule(scheduleId);
@@ -102,7 +107,7 @@ class ScheduleStorage {
     let removedFromList = false;
     let deletedSchedule = false;
     try {
-      const key = `${SCHEDULE_PREFIX}${scheduleId}`;
+      const key = `${this.schedulePrefix}${scheduleId}`;
       await this.removeScheduleFromList(scheduleId);
       removedFromList = true;
       await this.storageManager.getDatabase().delete(key);
@@ -130,7 +135,7 @@ class ScheduleStorage {
    */
   async saveExecutionLog(log) {
     try {
-      const key = `${EXECUTION_LOG_PREFIX}${log.scheduleId}:${log.id}`;
+      const key = `${this.executionLogPrefix}${log.scheduleId}:${log.id}`;
       await this.storageManager.getDatabase().set(key, log);
       await this.pruneExecutionHistory(log.scheduleId);
       this.logger.debug(`Execution log ${log.id} saved for schedule ${log.scheduleId}`, {
@@ -148,7 +153,7 @@ class ScheduleStorage {
    */
   async getExecutionLogs(scheduleId, limit) {
     try {
-      const prefix = `${EXECUTION_LOG_PREFIX}${scheduleId}:`;
+      const prefix = `${this.executionLogPrefix}${scheduleId}:`;
       const keys = await this.storageManager.getDatabase().list(prefix);
       const logs = [];
       for (const key of keys) {
@@ -171,7 +176,7 @@ class ScheduleStorage {
    */
   async deleteExecutionLogs(scheduleId) {
     try {
-      const prefix = `${EXECUTION_LOG_PREFIX}${scheduleId}:`;
+      const prefix = `${this.executionLogPrefix}${scheduleId}:`;
       const keys = await this.storageManager.getDatabase().list(prefix);
       for (const key of keys) {
         await this.storageManager.getDatabase().delete(key);
@@ -192,7 +197,7 @@ class ScheduleStorage {
       if (logs.length > this.maxExecutionHistory) {
         const logsToDelete = logs.slice(this.maxExecutionHistory);
         for (const log of logsToDelete) {
-          const key = `${EXECUTION_LOG_PREFIX}${scheduleId}:${log.id}`;
+          const key = `${this.executionLogPrefix}${scheduleId}:${log.id}`;
           await this.storageManager.getDatabase().delete(key);
         }
         this.logger.debug(
@@ -210,10 +215,10 @@ class ScheduleStorage {
    */
   async addScheduleToList(scheduleId) {
     await this.withListLock(async () => {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       if (!scheduleIds.includes(scheduleId)) {
         scheduleIds.push(scheduleId);
-        await this.storageManager.getDatabase().set(SCHEDULE_LIST_KEY, scheduleIds);
+        await this.storageManager.getDatabase().set(this.scheduleListKey, scheduleIds);
       }
     });
   }
@@ -222,9 +227,9 @@ class ScheduleStorage {
    */
   async removeScheduleFromList(scheduleId) {
     await this.withListLock(async () => {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       const filtered = scheduleIds.filter((id) => id !== scheduleId);
-      await this.storageManager.getDatabase().set(SCHEDULE_LIST_KEY, filtered);
+      await this.storageManager.getDatabase().set(this.scheduleListKey, filtered);
     });
   }
   async withListLock(handler) {

package/dist/storage.d.cts

@@ -15,7 +15,10 @@ declare class ScheduleStorage {
     private maxExecutionHistory;
     private logger;
     private listLock;
-    constructor(storageManager: StorageManager, maxExecutionHistory: number, logger: Logger);
+    private schedulePrefix;
+    private executionLogPrefix;
+    private scheduleListKey;
+    constructor(storageManager: StorageManager, maxExecutionHistory: number, logger: Logger, namespace?: string);
     /**
      * Save a schedule to persistent storage
      */

package/dist/storage.d.ts

@@ -1,21 +1,20 @@
-import { StorageManager, Logger } from '@dexto/core';
-import { Schedule, ExecutionLog } from './types.js';
-import './schemas.js';
-import 'zod';
-
 /**
  * Storage layer for schedules and execution logs
  */
-
+import type { StorageManager, Logger } from '@dexto/core';
+import type { Schedule, ExecutionLog } from './types.js';
 /**
  * Storage layer for scheduler persistence
  */
-declare class ScheduleStorage {
+export declare class ScheduleStorage {
     private storageManager;
     private maxExecutionHistory;
     private logger;
     private listLock;
-    constructor(storageManager: StorageManager, maxExecutionHistory: number, logger: Logger);
+    private schedulePrefix;
+    private executionLogPrefix;
+    private scheduleListKey;
+    constructor(storageManager: StorageManager, maxExecutionHistory: number, logger: Logger, namespace?: string);
     /**
      * Save a schedule to persistent storage
      */
@@ -58,5 +57,4 @@ declare class ScheduleStorage {
     private removeScheduleFromList;
     private withListLock;
 }
-
-export { ScheduleStorage };
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKzD;;GAEG;AACH,qBAAa,eAAe;IAOpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,MAAM;IARlB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAS;gBAGpB,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM;IAWtB;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAahE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwB1C;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCvD;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2BnF;;OAEG;YACW,mBAAmB;IAkBjC;;OAEG;YACW,qBAAqB;IAyBnC;;OAEG;YACW,iBAAiB;IAY/B;;OAEG;YACW,sBAAsB;YAWtB,YAAY;CAiB7B"}

package/dist/storage.js

@@ -1,19 +1,24 @@
 import { SchedulerError } from "./errors.js";
-const SCHEDULE_PREFIX = "schedule:";
-const EXECUTION_LOG_PREFIX = "execution:";
-const SCHEDULE_LIST_KEY = "scheduler:schedules";
+const DEFAULT_SCHEDULER_NAMESPACE = "default";
 class ScheduleStorage {
-  constructor(storageManager, maxExecutionHistory, logger) {
+  constructor(storageManager, maxExecutionHistory, logger, namespace) {
     this.storageManager = storageManager;
     this.maxExecutionHistory = maxExecutionHistory;
     this.logger = logger;
+    const ns = namespace && namespace.trim().length > 0 ? namespace.trim() : DEFAULT_SCHEDULER_NAMESPACE;
+    this.schedulePrefix = `scheduler:${ns}:schedule:`;
+    this.executionLogPrefix = `scheduler:${ns}:execution:`;
+    this.scheduleListKey = `scheduler:${ns}:schedules`;
   }
   listLock = Promise.resolve();
+  schedulePrefix;
+  executionLogPrefix;
+  scheduleListKey;
   /**
    * Save a schedule to persistent storage
    */
   async saveSchedule(schedule) {
-    const key = `${SCHEDULE_PREFIX}${schedule.id}`;
+    const key = `${this.schedulePrefix}${schedule.id}`;
     let persisted = false;
     try {
       await this.storageManager.getDatabase().set(key, schedule);
@@ -41,7 +46,7 @@ class ScheduleStorage {
    */
   async loadSchedule(scheduleId) {
     try {
-      const key = `${SCHEDULE_PREFIX}${scheduleId}`;
+      const key = `${this.schedulePrefix}${scheduleId}`;
       const schedule = await this.storageManager.getDatabase().get(key);
       return schedule || null;
     } catch (error) {
@@ -56,7 +61,7 @@ class ScheduleStorage {
    */
   async listSchedules() {
     try {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       const schedules = [];
       for (const scheduleId of scheduleIds) {
         const schedule = await this.loadSchedule(scheduleId);
@@ -79,7 +84,7 @@ class ScheduleStorage {
     let removedFromList = false;
     let deletedSchedule = false;
     try {
-      const key = `${SCHEDULE_PREFIX}${scheduleId}`;
+      const key = `${this.schedulePrefix}${scheduleId}`;
       await this.removeScheduleFromList(scheduleId);
       removedFromList = true;
       await this.storageManager.getDatabase().delete(key);
@@ -107,7 +112,7 @@ class ScheduleStorage {
    */
   async saveExecutionLog(log) {
     try {
-      const key = `${EXECUTION_LOG_PREFIX}${log.scheduleId}:${log.id}`;
+      const key = `${this.executionLogPrefix}${log.scheduleId}:${log.id}`;
       await this.storageManager.getDatabase().set(key, log);
       await this.pruneExecutionHistory(log.scheduleId);
       this.logger.debug(`Execution log ${log.id} saved for schedule ${log.scheduleId}`, {
@@ -125,7 +130,7 @@ class ScheduleStorage {
    */
   async getExecutionLogs(scheduleId, limit) {
     try {
-      const prefix = `${EXECUTION_LOG_PREFIX}${scheduleId}:`;
+      const prefix = `${this.executionLogPrefix}${scheduleId}:`;
       const keys = await this.storageManager.getDatabase().list(prefix);
       const logs = [];
       for (const key of keys) {
@@ -148,7 +153,7 @@ class ScheduleStorage {
    */
   async deleteExecutionLogs(scheduleId) {
     try {
-      const prefix = `${EXECUTION_LOG_PREFIX}${scheduleId}:`;
+      const prefix = `${this.executionLogPrefix}${scheduleId}:`;
       const keys = await this.storageManager.getDatabase().list(prefix);
       for (const key of keys) {
         await this.storageManager.getDatabase().delete(key);
@@ -169,7 +174,7 @@ class ScheduleStorage {
       if (logs.length > this.maxExecutionHistory) {
         const logsToDelete = logs.slice(this.maxExecutionHistory);
         for (const log of logsToDelete) {
-          const key = `${EXECUTION_LOG_PREFIX}${scheduleId}:${log.id}`;
+          const key = `${this.executionLogPrefix}${scheduleId}:${log.id}`;
           await this.storageManager.getDatabase().delete(key);
         }
         this.logger.debug(
@@ -187,10 +192,10 @@ class ScheduleStorage {
    */
   async addScheduleToList(scheduleId) {
     await this.withListLock(async () => {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       if (!scheduleIds.includes(scheduleId)) {
         scheduleIds.push(scheduleId);
-        await this.storageManager.getDatabase().set(SCHEDULE_LIST_KEY, scheduleIds);
+        await this.storageManager.getDatabase().set(this.scheduleListKey, scheduleIds);
       }
     });
   }
@@ -199,9 +204,9 @@ class ScheduleStorage {
    */
   async removeScheduleFromList(scheduleId) {
     await this.withListLock(async () => {
-      const scheduleIds = await this.storageManager.getDatabase().get(SCHEDULE_LIST_KEY) || [];
+      const scheduleIds = await this.storageManager.getDatabase().get(this.scheduleListKey) || [];
       const filtered = scheduleIds.filter((id) => id !== scheduleId);
-      await this.storageManager.getDatabase().set(SCHEDULE_LIST_KEY, filtered);
+      await this.storageManager.getDatabase().set(this.scheduleListKey, filtered);
     });
   }
   async withListLock(handler) {

package/dist/tool-provider.cjs

@@ -21,7 +21,9 @@ __export(tool_provider_exports, {
   createSchedulerTools: () => createSchedulerTools,
   ensureSchedulerManagerForAgent: () => ensureSchedulerManagerForAgent,
   getSchedulerManager: () => getSchedulerManager,
-  schedulerToolsFactory: () => schedulerToolsFactory
+  registerSchedulerManager: () => registerSchedulerManager,
+  schedulerToolsFactory: () => schedulerToolsFactory,
+  unregisterSchedulerManager: () => unregisterSchedulerManager
 });
 module.exports = __toCommonJS(tool_provider_exports);
 var import_core = require("@dexto/core");
@@ -39,6 +41,17 @@ const schedulerManagerRegistry = /* @__PURE__ */ new Map();
 const schedulerConfigRegistry = /* @__PURE__ */ new Map();
 const schedulerManagerInitPromises = /* @__PURE__ */ new Map();
 let defaultSchedulerConfig;
+function registerSchedulerManager(agentId, manager, config) {
+  schedulerManagerRegistry.set(agentId, manager);
+  if (config) {
+    schedulerConfigRegistry.set(agentId, config);
+  }
+}
+function unregisterSchedulerManager(agentId) {
+  schedulerManagerRegistry.delete(agentId);
+  schedulerConfigRegistry.delete(agentId);
+  schedulerManagerInitPromises.delete(agentId);
+}
 function getSchedulerManager(agentId) {
   return schedulerManagerRegistry.get(agentId);
 }
@@ -235,5 +248,7 @@ const schedulerToolsFactory = {
   createSchedulerTools,
   ensureSchedulerManagerForAgent,
   getSchedulerManager,
-  schedulerToolsFactory
+  registerSchedulerManager,
+  schedulerToolsFactory,
+  unregisterSchedulerManager
 });

package/dist/tool-provider.d.cts

@@ -12,6 +12,14 @@ import './types.cjs';
  * When a scheduled task triggers, it invokes the agent with the task instruction.
  */
 
+/**
+ * Register an externally managed scheduler manager (e.g., runtime-owned service).
+ */
+declare function registerSchedulerManager(agentId: string, manager: SchedulerManager, config?: SchedulerToolsConfig): void;
+/**
+ * Unregister a scheduler manager and associated config.
+ */
+declare function unregisterSchedulerManager(agentId: string): void;
 /**
  * Get a scheduler manager instance by agent ID.
  * Returns undefined if no scheduler is registered for the agent.
@@ -31,4 +39,4 @@ declare function createSchedulerTools(manager: SchedulerManager): Tool[];
  */
 declare const schedulerToolsFactory: ToolFactory<SchedulerToolsConfig>;
 
-export { createSchedulerTools, ensureSchedulerManagerForAgent, getSchedulerManager, schedulerToolsFactory };
+export { createSchedulerTools, ensureSchedulerManagerForAgent, getSchedulerManager, registerSchedulerManager, schedulerToolsFactory, unregisterSchedulerManager };

package/dist/tool-provider.d.ts

@@ -1,34 +1,37 @@
-import { ToolFactory } from '@dexto/agent-config';
-import { ToolExecutionContext, Logger, Tool } from '@dexto/core';
-import { SchedulerToolsConfig } from './schemas.js';
-import { SchedulerManager } from './manager.js';
-import 'zod';
-import './types.js';
-
 /**
  * Scheduler Tools Factory
  *
  * Provides cron-based scheduling capabilities for proactive agent behavior.
  * When a scheduled task triggers, it invokes the agent with the task instruction.
  */
-
+import type { ToolFactory } from '@dexto/agent-config';
+import type { Tool, ToolExecutionContext, Logger } from '@dexto/core';
+import { type SchedulerToolsConfig } from './schemas.js';
+import { SchedulerManager } from './manager.js';
+/**
+ * Register an externally managed scheduler manager (e.g., runtime-owned service).
+ */
+export declare function registerSchedulerManager(agentId: string, manager: SchedulerManager, config?: SchedulerToolsConfig): void;
+/**
+ * Unregister a scheduler manager and associated config.
+ */
+export declare function unregisterSchedulerManager(agentId: string): void;
 /**
  * Get a scheduler manager instance by agent ID.
  * Returns undefined if no scheduler is registered for the agent.
  */
-declare function getSchedulerManager(agentId: string): SchedulerManager | undefined;
+export declare function getSchedulerManager(agentId: string): SchedulerManager | undefined;
 /**
  * Ensure a scheduler manager is available for the given agent.
  * Returns null if scheduler tools are not enabled in this process.
  */
-declare function ensureSchedulerManagerForAgent(agent: ToolExecutionContext['agent'], config?: SchedulerToolsConfig, loggerOverride?: Logger): Promise<SchedulerManager | null>;
+export declare function ensureSchedulerManagerForAgent(agent: ToolExecutionContext['agent'], config?: SchedulerToolsConfig, loggerOverride?: Logger): Promise<SchedulerManager | null>;
 /**
  * Create scheduler tools from an existing manager instance.
  */
-declare function createSchedulerTools(manager: SchedulerManager): Tool[];
+export declare function createSchedulerTools(manager: SchedulerManager): Tool[];
 /**
  * Scheduler tools factory for Dexto agents.
  */
-declare const schedulerToolsFactory: ToolFactory<SchedulerToolsConfig>;
-
-export { createSchedulerTools, ensureSchedulerManagerForAgent, getSchedulerManager, schedulerToolsFactory };
+export declare const schedulerToolsFactory: ToolFactory<SchedulerToolsConfig>;
+//# sourceMappingURL=tool-provider.d.ts.map

package/dist/tool-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-provider.d.ts","sourceRoot":"","sources":["../src/tool-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAqBhD;;GAEG;AACH,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,oBAAoB,GAC9B,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEjF;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAChD,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACpC,MAAM,CAAC,EAAE,oBAAoB,EAC7B,cAAc,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwKlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAUtE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,oBAAoB,CAwCnE,CAAC"}

package/dist/tool-provider.js

@@ -13,6 +13,17 @@ const schedulerManagerRegistry = /* @__PURE__ */ new Map();
 const schedulerConfigRegistry = /* @__PURE__ */ new Map();
 const schedulerManagerInitPromises = /* @__PURE__ */ new Map();
 let defaultSchedulerConfig;
+function registerSchedulerManager(agentId, manager, config) {
+  schedulerManagerRegistry.set(agentId, manager);
+  if (config) {
+    schedulerConfigRegistry.set(agentId, config);
+  }
+}
+function unregisterSchedulerManager(agentId) {
+  schedulerManagerRegistry.delete(agentId);
+  schedulerConfigRegistry.delete(agentId);
+  schedulerManagerInitPromises.delete(agentId);
+}
 function getSchedulerManager(agentId) {
   return schedulerManagerRegistry.get(agentId);
 }
@@ -208,5 +219,7 @@ export {
   createSchedulerTools,
   ensureSchedulerManagerForAgent,
   getSchedulerManager,
-  schedulerToolsFactory
+  registerSchedulerManager,
+  schedulerToolsFactory,
+  unregisterSchedulerManager
 };

package/dist/tool-types.d.ts

@@ -1,9 +1,4 @@
-import { ToolExecutionContext } from '@dexto/core';
-import { SchedulerManager } from './manager.js';
-import './schemas.js';
-import 'zod';
-import './types.js';
-
-type SchedulerManagerGetter = (context: ToolExecutionContext) => Promise<SchedulerManager>;
-
-export type { SchedulerManagerGetter };
+import type { ToolExecutionContext } from '@dexto/core';
+import type { SchedulerManager } from './manager.js';
+export type SchedulerManagerGetter = (context: ToolExecutionContext) => Promise<SchedulerManager>;
+//# sourceMappingURL=tool-types.d.ts.map

package/dist/tool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../src/tool-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/tools/create-schedule.d.ts

@@ -1,14 +1,7 @@
-import { Tool } from '@dexto/core';
-import { SchedulerManagerGetter } from '../tool-types.js';
-import '../manager.js';
-import '../schemas.js';
-import 'zod';
-import '../types.js';
-
 /**
  * Tool for creating schedules
  */
-
-declare function createCreateScheduleTool(getManager: SchedulerManagerGetter): Tool;
-
-export { createCreateScheduleTool };
+import type { Tool } from '@dexto/core';
+import type { SchedulerManagerGetter } from '../tool-types.js';
+export declare function createCreateScheduleTool(getManager: SchedulerManagerGetter): Tool;
+//# sourceMappingURL=create-schedule.d.ts.map

package/dist/tools/create-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-schedule.d.ts","sourceRoot":"","sources":["../../src/tools/create-schedule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CA6DjF"}

package/dist/tools/delete-schedule.d.ts

@@ -1,14 +1,7 @@
-import { Tool } from '@dexto/core';
-import { SchedulerManagerGetter } from '../tool-types.js';
-import '../manager.js';
-import '../schemas.js';
-import 'zod';
-import '../types.js';
-
 /**
  * Tool for deleting schedules
  */
-
-declare function createDeleteScheduleTool(getManager: SchedulerManagerGetter): Tool;
-
-export { createDeleteScheduleTool };
+import type { Tool } from '@dexto/core';
+import type { SchedulerManagerGetter } from '../tool-types.js';
+export declare function createDeleteScheduleTool(getManager: SchedulerManagerGetter): Tool;
+//# sourceMappingURL=delete-schedule.d.ts.map

package/dist/tools/delete-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-schedule.d.ts","sourceRoot":"","sources":["../../src/tools/delete-schedule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAkBjF"}