@zhin.js/core 1.0.30 → 1.0.32

package/src/ai/builtin-tools.ts

@@ -15,6 +15,7 @@
  */
 
 import * as fs from 'fs';
+import * as os from 'os';
 import * as path from 'path';
 import { exec } from 'child_process';
 import { promisify } from 'util';
@@ -54,6 +55,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('读取文件内容（带行号，支持 offset/limit 分页）')
       .keyword('读文件', '查看', '打开', 'cat', 'read')
       .tag('file', 'read')
+      .kind('file')
       .param('file_path', { type: 'string', description: '文件路径（绝对或相对）' }, true)
       .param('offset', { type: 'number', description: '起始行号（0-based，默认 0）' })
       .param('limit', { type: 'number', description: '最大读取行数（默认全部）' })
@@ -78,6 +80,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('创建或覆盖文件（自动创建目录）')
       .keyword('写文件', '创建文件', '保存', 'write')
       .tag('file', 'write')
+      .kind('file')
       .param('file_path', { type: 'string', description: '文件路径' }, true)
       .param('content', { type: 'string', description: '写入内容' }, true)
       .execute(async (args) => {
@@ -97,6 +100,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('查找并替换文件内容（old_string 必须唯一匹配）。注意：old_string 应包含完整的行内容（含前后文），不要只匹配单个数字或单词')
       .keyword('编辑', '修改', '替换', 'edit')
       .tag('file', 'edit')
+      .kind('file')
       .param('file_path', { type: 'string', description: '文件路径' }, true)
       .param('old_string', { type: 'string', description: '要替换的原文（必须在文件中唯一出现，建议包含完整行）' }, true)
       .param('new_string', { type: 'string', description: '替换后的文本（必须是替换 old_string 后的完整内容）' }, true)
@@ -125,6 +129,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('按 glob 模式查找文件（如 **/*.ts）')
       .keyword('查找文件', '搜索文件', '文件列表', 'ls', 'find')
       .tag('file', 'search')
+      .kind('file')
       .param('pattern', { type: 'string', description: 'Glob 模式（如 **/*.ts）' }, true)
       .param('cwd', { type: 'string', description: '工作目录（默认项目根目录）' })
       .execute(async (args) => {
@@ -150,6 +155,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('按正则搜索文件内容，返回匹配行和行号')
       .keyword('搜索', '查找内容', 'grep', '正则')
       .tag('search', 'regex')
+      .kind('file')
       .param('pattern', { type: 'string', description: '正则表达式' }, true)
       .param('path', { type: 'string', description: '搜索路径（默认 .）' })
       .param('include', { type: 'string', description: '文件类型过滤（如 *.ts）' })
@@ -175,6 +181,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('执行 Shell 命令（带超时保护）')
       .keyword('执行', '运行', '命令', '终端', 'shell', 'bash')
       .tag('shell', 'exec')
+      .kind('shell')
       .param('command', { type: 'string', description: 'Shell 命令' }, true)
       .param('cwd', { type: 'string', description: '工作目录' })
       .param('timeout', { type: 'number', description: '超时毫秒数（默认 30000）' })
@@ -264,6 +271,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('抓取网页内容（去除 HTML 标签，最大 20KB）')
       .keyword('抓取', '网页', 'fetch', 'url', '链接')
       .tag('web', 'fetch')
+      .kind('web')
       .param('url', { type: 'string', description: 'URL 地址' }, true)
       .execute(async (args) => {
         try {
@@ -293,6 +301,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('读取当前任务计划列表，用于查看进度和待办事项')
       .keyword('任务', '计划', '进度', 'todo', '待办')
       .tag('plan', 'todo')
+      .kind('plan')
       .param('chat_id', { type: 'string', description: '聊天范围（传 "global" 表示全局，或传具体聊天 ID）' }, true)
       .execute(async (args) => {
         try {
@@ -318,6 +327,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('创建或更新任务计划，用于分解复杂任务并跟踪进度')
       .keyword('创建计划', '更新任务', '标记完成', 'todo')
       .tag('plan', 'todo')
+      .kind('plan')
       .param('items', { type: 'array', description: '任务列表 [{title, detail?, status: pending|in-progress|done}]' } as any, true)
       .param('chat_id', { type: 'string', description: '聊天范围（可选）' })
       .execute(async (args) => {
@@ -341,6 +351,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('读取持久化记忆（AGENTS.md）。记忆跨会话保持。scope: global（共享）或 chat（按聊天隔离）')
       .keyword('记忆', '记住', '回忆', '之前', '上次', 'memory')
       .tag('memory', 'agents')
+      .kind('memory')
       .param('scope', { type: 'string', description: "'global' 或 'chat'（默认 chat）", enum: ['global', 'chat'] }, true)
       .param('chat_id', { type: 'string', description: '聊天 ID（chat scope 时使用）' })
       .execute(async (args) => {
@@ -362,6 +373,7 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('写入持久化记忆。当用户说"记住…"、"记录…"时使用此工具')
       .keyword('记住', '保存', 'remember', '记录')
       .tag('memory', 'agents')
+      .kind('memory')
       .param('content', { type: 'string', description: '要保存的记忆内容（Markdown）' }, true)
       .param('scope', { type: 'string', description: "'global' 或 'chat'（默认 chat）", enum: ['global', 'chat'] })
       .param('chat_id', { type: 'string', description: '聊天 ID' })
@@ -385,19 +397,24 @@ export function createBuiltinTools(): ZhinTool[] {
       .desc('按名称激活技能，加载其完整指令。当判断某个技能与用户请求相关时使用')
       .keyword('技能', '激活', '启用', '使用', 'skill', 'activate', 'use')
       .tag('skill', 'activate')
+      .kind('skill')
       .param('name', { type: 'string', description: '技能名称' }, true)
       .execute(async (args) => {
         try {
+          // 与 discoverWorkspaceSkills 顺序一致：Workspace > Local > Bundled
           const dirs = [
             path.join(process.cwd(), 'skills'),
+            path.join(os.homedir(), '.zhin', 'skills'),
             path.join(DATA_DIR, 'skills'),
           ];
           for (const dir of dirs) {
             const skillPath = path.join(dir, args.name, 'SKILL.md');
             if (fs.existsSync(skillPath)) {
               const fullContent = await fs.promises.readFile(skillPath, 'utf-8');
-              // 提取精简的执行指令，避免全文输出占用太多 token
-              return extractSkillInstructions(args.name, fullContent);
+              // 5.3 可执行环境检查：若 SKILL 声明了 deps，再次检查；缺失则在返回内容中提示
+              const depWarning = await checkSkillDeps(fullContent);
+              const instructions = extractSkillInstructions(args.name, fullContent);
+              return depWarning ? `${depWarning}\n\n${instructions}` : instructions;
             }
           }
           return `Skill '${args.name}' not found. Check skills/ directory.`;
@@ -411,6 +428,36 @@ export function createBuiltinTools(): ZhinTool[] {
   return tools;
 }
 
+/**
+ * 检查技能声明的依赖是否在环境中可用；若有缺失返回提示文案，否则返回空字符串
+ */
+async function checkSkillDeps(content: string): Promise<string> {
+  const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!fmMatch) return '';
+  let yaml: any;
+  try {
+    yaml = await import('yaml');
+    if (yaml.default) yaml = yaml.default;
+  } catch {
+    return '';
+  }
+  const metadata = yaml.parse(fmMatch[1]);
+  if (!metadata) return '';
+  const compat = metadata.compatibility || {};
+  const deps = compat.deps || metadata.deps;
+  if (!deps || !Array.isArray(deps)) return '';
+  const missing: string[] = [];
+  for (const dep of deps) {
+    try {
+      await execAsync(`which ${dep} 2>/dev/null`);
+    } catch {
+      missing.push(dep);
+    }
+  }
+  if (missing.length === 0) return '';
+  return `⚠️ 当前环境缺少以下依赖，请先安装后再使用本技能：${missing.join(', ')}`;
+}
+
 /**
  * 从 SKILL.md 全文中提取精简的执行指令
  * 只保留 frontmatter（工具列表）和执行规则，去掉示例、测试场景等冗余内容
@@ -433,11 +480,27 @@ function extractSkillInstructions(name: string, content: string): string {
     }
   }
 
-  // 2. 提取"执行规则"或"规则"部分（关键的行动指导）
-  const rulesMatch = content.match(/## 执行规则[\s\S]*?(?=\n## [^执]|$)/);
+  // 2. 提取执行指导：优先 "## 执行规则"，否则尝试 "## Workflow" / "## Instructions" / "## 使用说明"，再否则用正文（去掉 frontmatter）
+  const rulesMatch = content.match(/## 执行规则[\s\S]*?(?=\n## [^\s]|$)/);
+  const workflowMatch = content.match(/## (?:Workflow|Instructions|使用说明)[\s\S]*?(?=\n## [^\s]|$)/);
+  const bodyAfterFm = fmMatch && fmMatch.index !== undefined
+    ? content.slice(fmMatch.index + fmMatch[0].length).replace(/^\s+/, '')
+    : content;
   if (rulesMatch) {
     lines.push(rulesMatch[0].trim());
     lines.push('');
+  } else if (workflowMatch) {
+    lines.push(workflowMatch[0].trim());
+    lines.push('');
+  } else if (bodyAfterFm.trim()) {
+    // 无上述标题时使用正文（去除 frontmatter 后）作为指导
+    const firstH2 = bodyAfterFm.match(/\n## [^\s]/);
+    const main = firstH2 ? bodyAfterFm.slice(0, firstH2.index).trim() : bodyAfterFm.trim();
+    if (main) {
+      lines.push('## 指导');
+      lines.push(main);
+      lines.push('');
+    }
   }
 
   // 3. 添加强制执行提醒
@@ -462,15 +525,18 @@ interface SkillMeta {
 }
 
 /**
- * 扫描工作区 skills/ 目录，发现 SKILL.md 技能文件
+ * 扫描技能目录，发现 SKILL.md 技能文件
+ * 加载顺序：Workspace（cwd/skills）> Local（~/.zhin/skills）> Bundled（data/skills），同名技能先发现者优先
  * 支持平台/依赖兼容性过滤
  */
 export async function discoverWorkspaceSkills(): Promise<SkillMeta[]> {
   const skills: SkillMeta[] = [];
+  const seenNames = new Set<string>();
   const dataDir = getDataDir();
   const skillDirs = [
-    path.join(process.cwd(), 'skills'),
-    path.join(dataDir, 'skills'),
+    path.join(process.cwd(), 'skills'),           // Workspace
+    path.join(os.homedir(), '.zhin', 'skills'),  // Local
+    path.join(dataDir, 'skills'),                 // Bundled / 默认 data
   ];
 
   // 确保 data/skills 目录存在
@@ -546,6 +612,12 @@ export async function discoverWorkspaceSkills(): Promise<SkillMeta[]> {
           if (missing) continue;
         }
 
+        if (seenNames.has(metadata.name)) {
+          logger.debug(`Skill '${metadata.name}' 已由先序目录加载，跳过: ${skillMdPath}`);
+          continue;
+        }
+        seenNames.add(metadata.name);
+
         skills.push({
           name: metadata.name,
           description: metadata.description,

package/src/ai/cron-engine.ts

@@ -0,0 +1,337 @@
+/**
+ * 持久化定时任务
+ *
+ * 将定时任务持久化到 data/cron-jobs.json，进程重启后自动加载；
+ * 触发时以 prompt 调用 ZhinAgent，实现「到点执行 AI 任务」。
+ *
+ * - 存储：id, cronExpression, prompt, label?, enabled, createdAt
+ * - 启动时：读取文件 → 为每条启用的任务创建 Cron → 注册到 CronFeature
+ * - CLI / AI 工具：可对持久化任务做 list / add / remove / pause / resume（AI 侧立即生效）
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { Cron } from '../cron.js';
+import { Logger } from '@zhin.js/logger';
+import { ZhinTool } from '../built/tool.js';
+
+const logger = new Logger(null, 'cron-engine');
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 类型与存储路径
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const CRON_JOBS_FILENAME = 'cron-jobs.json';
+
+export interface CronJobRecord {
+  id: string;
+  /** Cron 表达式，5 字段：分 时 日 月 周 */
+  cronExpression: string;
+  /** 触发时发给 AI 的 prompt */
+  prompt: string;
+  /** 可选标签，便于识别 */
+  label?: string;
+  /** 是否启用（暂停的任务不加载） */
+  enabled: boolean;
+  createdAt: number;
+}
+
+export function getCronJobsFilePath(dataDir: string): string {
+  return path.join(dataDir, CRON_JOBS_FILENAME);
+}
+
+export async function readCronJobsFile(dataDir: string): Promise<CronJobRecord[]> {
+  const filePath = getCronJobsFilePath(dataDir);
+  try {
+    const raw = await fs.promises.readFile(filePath, 'utf-8');
+    const data = JSON.parse(raw);
+    if (!Array.isArray(data)) return [];
+    return data;
+  } catch (e: any) {
+    if (e?.code === 'ENOENT') return [];
+    logger.warn('读取定时任务文件失败: ' + (e?.message || String(e)));
+    return [];
+  }
+}
+
+export async function writeCronJobsFile(dataDir: string, jobs: CronJobRecord[]): Promise<void> {
+  const filePath = getCronJobsFilePath(dataDir);
+  await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.promises.writeFile(filePath, JSON.stringify(jobs, null, 2), 'utf-8');
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 持久化引擎：加载文件并注册到 CronFeature
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type CronRunner = (prompt: string, jobId: string) => void | Promise<void>;
+
+export type AddCronFn = (cron: Cron) => () => void;
+
+export interface PersistentCronEngineOptions {
+  dataDir: string;
+  addCron: AddCronFn;
+  runner: CronRunner;
+}
+
+export class PersistentCronEngine {
+  private options: PersistentCronEngineOptions;
+  /** jobId -> dispose */
+  private disposes = new Map<string, () => void>();
+
+  constructor(options: PersistentCronEngineOptions) {
+    this.options = options;
+  }
+
+  getDataDir(): string {
+    return this.options.dataDir;
+  }
+
+  /**
+   * 从文件加载任务并注册到 CronFeature；仅加载 enabled 的任务。
+   */
+  load(): void {
+    const { dataDir, addCron, runner } = this.options;
+    readCronJobsFile(dataDir).then((jobs) => {
+      for (const job of jobs) {
+        if (!job.enabled) continue;
+        this.registerOne(job, addCron, runner);
+      }
+      if (jobs.filter((j) => j.enabled).length > 0) {
+        logger.info(`已加载 ${this.disposes.size} 个持久化定时任务`);
+      }
+    }).catch((e) => {
+      logger.warn('加载持久化定时任务失败: ' + (e?.message || String(e)));
+    });
+  }
+
+  private registerOne(
+    job: CronJobRecord,
+    addCron: AddCronFn,
+    runner: CronRunner,
+  ): void {
+    const { prompt, id: jobId, cronExpression } = job;
+    try {
+      const cron = new Cron(cronExpression, async () => {
+        await runner(prompt, jobId);
+      });
+      cron.id = jobId;
+      const dispose = addCron(cron);
+      this.disposes.set(jobId, dispose);
+    } catch (e: any) {
+      logger.warn(`定时任务加载失败 [${jobId}]: ${e?.message || String(e)}`);
+    }
+  }
+
+  /**
+   * 列出所有持久化任务（从文件读取）
+   */
+  async listJobs(): Promise<CronJobRecord[]> {
+    return readCronJobsFile(this.options.dataDir);
+  }
+
+  /**
+   * 添加持久化任务并立即生效
+   */
+  async addJob(record: Omit<CronJobRecord, 'createdAt'> & { createdAt?: number }): Promise<CronJobRecord> {
+    const jobs = await readCronJobsFile(this.options.dataDir);
+    const full: CronJobRecord = {
+      ...record,
+      createdAt: record.createdAt ?? Date.now(),
+      enabled: record.enabled ?? true,
+    };
+    jobs.push(full);
+    await writeCronJobsFile(this.options.dataDir, jobs);
+    if (full.enabled) {
+      this.registerOne(full, this.options.addCron, this.options.runner);
+    }
+    return full;
+  }
+
+  /**
+   * 删除持久化任务并立即生效
+   */
+  async removeJob(id: string): Promise<boolean> {
+    const jobs = await readCronJobsFile(this.options.dataDir);
+    const next = jobs.filter((j) => j.id !== id);
+    if (next.length === jobs.length) return false;
+    await writeCronJobsFile(this.options.dataDir, next);
+    const dispose = this.disposes.get(id);
+    if (dispose) {
+      dispose();
+      this.disposes.delete(id);
+    }
+    return true;
+  }
+
+  /**
+   * 暂停任务（不删除，停止调度）
+   */
+  async pauseJob(id: string): Promise<boolean> {
+    const jobs = await readCronJobsFile(this.options.dataDir);
+    const j = jobs.find((x) => x.id === id);
+    if (!j) return false;
+    j.enabled = false;
+    await writeCronJobsFile(this.options.dataDir, jobs);
+    const dispose = this.disposes.get(id);
+    if (dispose) {
+      dispose();
+      this.disposes.delete(id);
+    }
+    return true;
+  }
+
+  /**
+   * 恢复已暂停的任务
+   */
+  async resumeJob(id: string): Promise<boolean> {
+    const jobs = await readCronJobsFile(this.options.dataDir);
+    const j = jobs.find((x) => x.id === id);
+    if (!j) return false;
+    j.enabled = true;
+    await writeCronJobsFile(this.options.dataDir, jobs);
+    this.registerOne(j, this.options.addCron, this.options.runner);
+    return true;
+  }
+
+  /**
+   * 卸载所有由本引擎注册的定时任务（用于 dispose）
+   */
+  unload(): void {
+    for (const dispose of this.disposes.values()) {
+      try {
+        dispose();
+      } catch (_) {}
+    }
+    this.disposes.clear();
+  }
+}
+
+/**
+ * 生成唯一 ID（用于 CLI / AI 添加时）
+ */
+export function generateCronJobId(): string {
+  return `cron_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 供 AI 工具使用的 Cron 管理器引用（init 中设置）
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface CronManager {
+  cronFeature: { getStatus(): Array<{ expression: string; running: boolean; nextExecution: Date | null; plugin: string }> };
+  engine: PersistentCronEngine | null;
+}
+
+let cronManager: CronManager | null = null;
+
+export function setCronManager(m: CronManager | null): void {
+  cronManager = m;
+}
+
+export function getCronManager(): CronManager | null {
+  return cronManager;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// AI 可调用的定时任务管理工具
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function createCronTools(): ZhinTool[] {
+  const listTool = new ZhinTool('cron_list')
+    .desc('列出所有定时任务：包括插件注册的内存任务与持久化任务（持久化任务有 id，可用于 cron_remove/cron_pause/cron_resume）')
+    .keyword('定时任务', 'cron', '计划任务', '任务列表')
+    .tag('cron', 'schedule')
+    .execute(async () => {
+      const m = getCronManager();
+      if (!m) {
+        return { error: '定时任务服务不可用' };
+      }
+      const memory = m.cronFeature.getStatus().map((s) => ({
+        type: 'memory' as const,
+        expression: s.expression,
+        running: s.running,
+        nextExecution: s.nextExecution?.toISOString() ?? null,
+        plugin: s.plugin,
+      }));
+      const persistent = m.engine
+        ? (await m.engine.listJobs()).map((j) => ({
+            type: 'persistent' as const,
+            id: j.id,
+            cronExpression: j.cronExpression,
+            prompt: j.prompt,
+            label: j.label,
+            enabled: j.enabled,
+            createdAt: j.createdAt,
+          }))
+        : [];
+      return { memory, persistent };
+    });
+
+  const addTool = new ZhinTool('cron_add')
+    .desc('添加一条持久化定时任务：到点由 AI 执行指定 prompt，重启后仍保留')
+    .keyword('添加定时', '新建定时任务', 'cron add')
+    .tag('cron', 'schedule')
+    .param('cron_expression', { type: 'string', description: 'Cron 表达式，如 "0 9 * * *" 表示每天 9:00' }, true)
+    .param('prompt', { type: 'string', description: '到点触发时发给 AI 的提示词' }, true)
+    .param('label', { type: 'string', description: '可选标签，便于识别' })
+    .execute(async (args) => {
+      const m = getCronManager();
+      if (!m?.engine) {
+        return { error: '持久化定时任务引擎不可用' };
+      }
+      const id = generateCronJobId();
+      const job = await m.engine.addJob({
+        id,
+        cronExpression: args.cron_expression as string,
+        prompt: args.prompt as string,
+        label: args.label as string | undefined,
+        enabled: true,
+      });
+      return { success: true, id: job.id, message: '已添加并立即生效' };
+    });
+
+  const removeTool = new ZhinTool('cron_remove')
+    .desc('按 id 删除一条持久化定时任务')
+    .keyword('删除定时', '取消定时', 'cron remove')
+    .tag('cron', 'schedule')
+    .param('id', { type: 'string', description: '任务 ID（cron_list 中 persistent 的 id）' }, true)
+    .execute(async (args) => {
+      const m = getCronManager();
+      if (!m?.engine) {
+        return { error: '持久化定时任务引擎不可用' };
+      }
+      const ok = await m.engine.removeJob(args.id as string);
+      return ok ? { success: true, message: '已删除' } : { error: '未找到该任务' };
+    });
+
+  const pauseTool = new ZhinTool('cron_pause')
+    .desc('暂停一条持久化定时任务（不删除，可 cron_resume 恢复）')
+    .keyword('暂停定时', 'cron pause')
+    .tag('cron', 'schedule')
+    .param('id', { type: 'string', description: '任务 ID' }, true)
+    .execute(async (args) => {
+      const m = getCronManager();
+      if (!m?.engine) {
+        return { error: '持久化定时任务引擎不可用' };
+      }
+      const ok = await m.engine.pauseJob(args.id as string);
+      return ok ? { success: true, message: '已暂停' } : { error: '未找到该任务' };
+    });
+
+  const resumeTool = new ZhinTool('cron_resume')
+    .desc('恢复已暂停的持久化定时任务')
+    .keyword('恢复定时', 'cron resume')
+    .tag('cron', 'schedule')
+    .param('id', { type: 'string', description: '任务 ID' }, true)
+    .execute(async (args) => {
+      const m = getCronManager();
+      if (!m?.engine) {
+        return { error: '持久化定时任务引擎不可用' };
+      }
+      const ok = await m.engine.resumeJob(args.id as string);
+      return ok ? { success: true, message: '已恢复' } : { error: '未找到该任务' };
+    });
+
+  return [listTool, addTool, removeTool, pauseTool, resumeTool];
+}

package/src/ai/index.ts

@@ -26,7 +26,7 @@ export type {
 export { AIService } from './service.js';
 
 // ── Agent ──
-export { Agent, createAgent } from './agent.js';
+export { Agent, createAgent, formatToolTitle } from './agent.js';
 
 // ── Session ──
 export {
@@ -74,6 +74,26 @@ export type { RateLimitConfig, RateLimitResult } from './rate-limiter.js';
 export { FollowUpManager, AI_FOLLOWUP_MODEL } from './follow-up.js';
 export type { FollowUpRecord, FollowUpSender } from './follow-up.js';
 
+// ── 持久化定时任务引擎 ──
+export {
+  PersistentCronEngine,
+  readCronJobsFile,
+  writeCronJobsFile,
+  getCronJobsFilePath,
+  generateCronJobId,
+  createCronTools,
+  setCronManager,
+  getCronManager,
+  CRON_JOBS_FILENAME,
+} from './cron-engine.js';
+export type {
+  CronJobRecord,
+  CronRunner,
+  AddCronFn,
+  PersistentCronEngineOptions,
+  CronManager,
+} from './cron-engine.js';
+
 // ── Tone Detector ──
 export { detectTone } from './tone-detector.js';
 export type { Tone } from './tone-detector.js';