@zhin.js/agent 0.1.0 → 0.1.3

package/lib/follow-up.js

@@ -1,265 +0,0 @@
-/**
- * FollowUpStore — 定时跟进任务的持久化存储
- *
- * 解决纯 setTimeout 重启即丢失的问题：
- *   1. 创建任务时同步写入数据库
- *   2. 执行完成 / 过期后从数据库中删除
- *   3. 机器人启动时从数据库加载所有未完成任务，重新挂定时器
- *   4. 同一会话创建新任务时，自动取消旧的 pending 任务（防止重复提醒）
- *
- *   ai_followups 表：
- *   ┌──────────────────────────────────────────────────────────────────┐
- *   │ id (PK)  | session_id | platform | sender_id | scene_id        │
- *   │          | message    | fire_at  | created_at | status          │
- *   └──────────────────────────────────────────────────────────────────┘
- */
-import { Logger } from '@zhin.js/core';
-const logger = new Logger(null, 'FollowUp');
-// ============================================================================
-// 数据库模型
-// ============================================================================
-export const AI_FOLLOWUP_MODEL = {
-    session_id: { type: 'text', nullable: false },
-    platform: { type: 'text', nullable: false },
-    bot_id: { type: 'text', nullable: false },
-    sender_id: { type: 'text', nullable: false },
-    scene_id: { type: 'text', nullable: false },
-    scene_type: { type: 'text', nullable: false },
-    message: { type: 'text', nullable: false },
-    /** 触发时间戳 (ms) */
-    fire_at: { type: 'integer', nullable: false },
-    created_at: { type: 'integer', default: 0 },
-    /** pending | fired | cancelled */
-    status: { type: 'text', default: 'pending' },
-};
-// ============================================================================
-// 内存实现
-// ============================================================================
-class MemoryFollowUpStore {
-    records = [];
-    nextId = 1;
-    async create(record) {
-        const full = { ...record, id: this.nextId++ };
-        this.records.push(full);
-        return full;
-    }
-    async markFired(id) {
-        const r = this.records.find(r => r.id === id);
-        if (r)
-            r.status = 'fired';
-    }
-    async cancel(id) {
-        const r = this.records.find(r => r.id === id);
-        if (r)
-            r.status = 'cancelled';
-    }
-    async getPending() {
-        return this.records.filter(r => r.status === 'pending');
-    }
-    async getPendingBySession(sessionId) {
-        return this.records.filter(r => r.status === 'pending' && r.session_id === sessionId);
-    }
-    dispose() {
-        this.records = [];
-    }
-}
-// ============================================================================
-// 数据库实现
-// ============================================================================
-class DatabaseFollowUpStore {
-    model;
-    constructor(model) {
-        this.model = model;
-    }
-    async create(record) {
-        const created = await this.model.create(record);
-        return { ...record, id: created.id ?? created };
-    }
-    async markFired(id) {
-        await this.model.update({ status: 'fired' }).where({ id });
-    }
-    async cancel(id) {
-        await this.model.update({ status: 'cancelled' }).where({ id });
-    }
-    async getPending() {
-        return this.model.select().where({ status: 'pending' });
-    }
-    async getPendingBySession(sessionId) {
-        return this.model.select().where({ status: 'pending', session_id: sessionId });
-    }
-    dispose() { }
-}
-// ============================================================================
-// FollowUpManager
-// ============================================================================
-export class FollowUpManager {
-    store;
-    /** 内存中活跃的定时器: recordId → timer */
-    timers = new Map();
-    sender = null;
-    constructor() {
-        this.store = new MemoryFollowUpStore();
-    }
-    /** 注入消息发送回调 */
-    setSender(sender) {
-        this.sender = sender;
-    }
-    /** 升级到数据库存储 */
-    upgradeToDatabase(model) {
-        const old = this.store;
-        this.store = new DatabaseFollowUpStore(model);
-        old.dispose();
-        logger.debug('FollowUpManager: 已升级到数据库存储');
-    }
-    /**
-     * 创建一个跟进任务
-     *
-     * 重要：同一会话的旧 pending 任务会被自动取消，防止重复提醒。
-     *
-     * @returns 人类可读的确认文本
-     */
-    async schedule(params) {
-        const { sessionId, platform, botId, senderId, sceneId, sceneType, message, delayMinutes } = params;
-        // ── 详细参数日志（方便排查问题） ──
-        logger.debug(`[跟进] 收到请求: delay_minutes=${delayMinutes}, message="${message}", session=${sessionId}`);
-        // 限制最大延迟 7 天
-        const maxDelay = 7 * 24 * 60;
-        const actualDelay = Math.min(Math.max(delayMinutes, 1), maxDelay);
-        const delayMs = actualDelay * 60 * 1000;
-        const fireAt = Date.now() + delayMs;
-        // ── 自动取消同一会话的旧 pending 任务 ──
-        const existingPending = await this.store.getPendingBySession(sessionId);
-        if (existingPending.length > 0) {
-            for (const old of existingPending) {
-                if (old.id != null) {
-                    // 取消数据库记录
-                    await this.store.cancel(old.id);
-                    // 清除内存中的定时器
-                    const timer = this.timers.get(old.id);
-                    if (timer) {
-                        clearTimeout(timer);
-                        this.timers.delete(old.id);
-                    }
-                    logger.debug(`[跟进] 自动取消旧任务: id=${old.id}, "${old.message}"`);
-                }
-            }
-        }
-        const record = await this.store.create({
-            session_id: sessionId,
-            platform,
-            bot_id: botId,
-            sender_id: senderId,
-            scene_id: sceneId,
-            scene_type: sceneType,
-            message,
-            fire_at: fireAt,
-            created_at: Date.now(),
-            status: 'pending',
-        });
-        // 挂定时器
-        this.scheduleTimer(record);
-        const readableTime = actualDelay >= 1440
-            ? `${(actualDelay / 1440).toFixed(1)} 天后`
-            : actualDelay >= 60
-                ? `${(actualDelay / 60).toFixed(1)} 小时后`
-                : `${actualDelay} 分钟后`;
-        // 精确触发时间（方便日志对照）
-        const fireDate = new Date(fireAt);
-        const fireTimeStr = fireDate.toLocaleString('zh-CN', { hour12: false });
-        logger.debug(`[跟进] 已创建: id=${record.id}, delay=${actualDelay}分钟(${delayMs}ms), 触发时间=${fireTimeStr}, "${message}"`);
-        return `✅ 已安排提醒，将在 ${readableTime}（${fireTimeStr}）提醒你：${message}`;
-    }
-    /**
-     * 取消指定会话的所有 pending 任务
-     */
-    async cancelBySession(sessionId) {
-        const pending = await this.store.getPendingBySession(sessionId);
-        let count = 0;
-        for (const record of pending) {
-            if (record.id != null) {
-                await this.store.cancel(record.id);
-                const timer = this.timers.get(record.id);
-                if (timer) {
-                    clearTimeout(timer);
-                    this.timers.delete(record.id);
-                }
-                count++;
-            }
-        }
-        if (count > 0) {
-            logger.debug(`[跟进] 已取消 ${count} 个待执行任务 (session=${sessionId})`);
-        }
-        return count;
-    }
-    /**
-     * 启动时从数据库恢复所有未完成的跟进任务
-     */
-    async restore() {
-        const pending = await this.store.getPending();
-        const now = Date.now();
-        let restored = 0;
-        for (const record of pending) {
-            if (record.fire_at <= now) {
-                // 已过期但未执行 → 立即触发（延迟 2 秒，等系统完全就绪）
-                const overdueSec = Math.round((now - record.fire_at) / 1000);
-                logger.debug(`[跟进恢复] id=${record.id} 已过期 ${overdueSec}s，立即触发`);
-                this.scheduleTimerWithDelay(record, 2000);
-                restored++;
-            }
-            else {
-                // 还没到时间 → 重新挂定时器
-                this.scheduleTimer(record);
-                const remainMs = record.fire_at - now;
-                const remainMin = (remainMs / 60_000).toFixed(1);
-                logger.debug(`[跟进恢复] id=${record.id} 剩余 ${remainMin} 分钟, "${record.message}"`);
-                restored++;
-            }
-        }
-        if (restored > 0) {
-            logger.info(`[跟进恢复] 共恢复 ${restored} 个待执行任务`);
-        }
-        return restored;
-    }
-    /**
-     * 为一条记录挂定时器
-     */
-    scheduleTimer(record) {
-        const delay = Math.max(record.fire_at - Date.now(), 0);
-        this.scheduleTimerWithDelay(record, delay);
-    }
-    scheduleTimerWithDelay(record, delayMs) {
-        if (!record.id)
-            return;
-        // 清除旧定时器（如果有）
-        const existing = this.timers.get(record.id);
-        if (existing)
-            clearTimeout(existing);
-        const timer = setTimeout(async () => {
-            try {
-                this.timers.delete(record.id);
-                // 发送提醒
-                if (this.sender) {
-                    await this.sender(record);
-                    logger.info(`[跟进提醒] 已发送: id=${record.id}, "${record.message}"`);
-                }
-                else {
-                    logger.warn(`[跟进提醒] 无法发送 (sender 未注入): id=${record.id}`);
-                }
-                // 标记完成
-                await this.store.markFired(record.id);
-            }
-            catch (e) {
-                logger.warn(`[跟进提醒] 发送失败: id=${record.id}`, e);
-            }
-        }, delayMs);
-        this.timers.set(record.id, timer);
-    }
-    dispose() {
-        for (const timer of this.timers.values()) {
-            clearTimeout(timer);
-        }
-        this.timers.clear();
-        this.store.dispose();
-    }
-}
-//# sourceMappingURL=follow-up.js.map

package/lib/follow-up.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"follow-up.js","sourceRoot":"","sources":["../src/follow-up.ts"],"names":[],"mappings":"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"}

package/src/agent.ts

@@ -1,6 +0,0 @@
-/**
- * Re-export from @zhin.js/ai for backward compatibility.
- * The Agent engine has been extracted to the framework-agnostic @zhin.js/ai package.
- */
-export { Agent, createAgent, formatToolTitle } from '@zhin.js/ai';
-export type { AgentState, AgentEvents } from '@zhin.js/ai';

package/src/bootstrap.ts

@@ -1,309 +0,0 @@
-/**
- * Workspace Bootstrap Files
- *
- * Injectable prompt files inspired by OpenClaw's workspace bootstrap design:
- *
- *   AGENTS.md  — persistent memory / instructions (AI read-write)
- *   SOUL.md    — persona definition (read-only)
- *   TOOLS.md   — tool usage guidelines (read-only)
- *
- * Key design:
- *   1. mtime-based file cache to avoid redundant disk reads
- *   2. Missing files are silently skipped
- *   3. Per-file and total size limits to prevent prompt injection
- *   4. Unified ContextFile format for system prompt injection
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { Logger } from '@zhin.js/core';
-
-const logger = new Logger(null, 'Bootstrap');
-
-// ============================================================================
-// 常量
-// ============================================================================
-
-/** 支持的引导文件名（顺序：SOUL → AGENTS → TOOLS） */
-export const BOOTSTRAP_FILENAMES = [
-  'SOUL.md',
-  'AGENTS.md',
-  'TOOLS.md',
-] as const;
-
-export type BootstrapFileName = typeof BOOTSTRAP_FILENAMES[number];
-
-/** 单文件最大字符数（默认 16KB） */
-const DEFAULT_MAX_CHARS = 16 * 1024;
-
-/** 所有引导文件总最大字符数（默认 48KB） */
-const DEFAULT_TOTAL_MAX_CHARS = 48 * 1024;
-
-// ============================================================================
-// 类型
-// ============================================================================
-
-/** 引导文件信息 */
-export interface BootstrapFile {
-  name: BootstrapFileName;
-  path: string;
-  content?: string;
-  missing: boolean;
-}
-
-/** 上下文文件（用于注入到 system prompt） */
-export interface ContextFile {
-  path: string;
-  content: string;
-}
-
-// ============================================================================
-// 文件缓存（基于 mtime）
-// ============================================================================
-
-const fileCache = new Map<string, { content: string; mtimeMs: number }>();
-
-/**
- * 读文件，带 mtime 缓存
- */
-async function readFileWithCache(filePath: string): Promise<string> {
-  try {
-    const stats = await fs.promises.stat(filePath);
-    const mtimeMs = stats.mtimeMs;
-    const cached = fileCache.get(filePath);
-
-    if (cached && cached.mtimeMs === mtimeMs) {
-      return cached.content;
-    }
-
-    const content = await fs.promises.readFile(filePath, 'utf-8');
-    fileCache.set(filePath, { content, mtimeMs });
-    return content;
-  } catch {
-    fileCache.delete(filePath);
-    throw new Error(`Failed to read file: ${filePath}`);
-  }
-}
-
-/**
- * 清除文件缓存（热重载时调用）
- */
-export function clearBootstrapCache(): void {
-  fileCache.clear();
-}
-
-// ============================================================================
-// 文件加载
-// ============================================================================
-
-/**
- * 获取数据目录
- */
-function getDataDir(workspaceDir?: string): string {
-  const cwd = workspaceDir || process.cwd();
-  return path.join(cwd, 'data');
-}
-
-/**
- * 获取文件制长期记忆目录（data/memory），不存在则创建
- */
-export function getMemoryDir(workspaceDir?: string): string {
-  const dir = path.join(getDataDir(workspaceDir), 'memory');
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  return dir;
-}
-
-function todayDate(): string {
-  return new Date().toISOString().split('T')[0];
-}
-
-/**
- * 读取文件制长期记忆 + 当日笔记，拼成注入 system prompt 的字符串（与 miniclawd 一致）
- * 同步读取，供 buildRichSystemPrompt 等同步调用
- */
-export function getFileMemoryContext(workspaceDir?: string): string {
-  const memoryDir = getMemoryDir(workspaceDir);
-  const parts: string[] = [];
-
-  const memoryFile = path.join(memoryDir, 'MEMORY.md');
-  if (fs.existsSync(memoryFile)) {
-    try {
-      const longTerm = fs.readFileSync(memoryFile, 'utf-8').trim();
-      if (longTerm) parts.push('## Long-term Memory\n' + longTerm);
-    } catch {
-      // ignore read errors
-    }
-  }
-
-  const todayFile = path.join(memoryDir, `${todayDate()}.md`);
-  if (fs.existsSync(todayFile)) {
-    try {
-      const today = fs.readFileSync(todayFile, 'utf-8').trim();
-      if (today) parts.push("## Today's Notes\n" + today);
-    } catch {
-      // ignore read errors
-    }
-  }
-
-  return parts.length > 0 ? parts.join('\n\n') : '';
-}
-
-/**
- * 加载工作区引导文件
- *
- * 搜索顺序：项目根目录 → data/ 目录
- */
-export async function loadBootstrapFiles(
-  workspaceDir?: string,
-): Promise<BootstrapFile[]> {
-  const cwd = workspaceDir || process.cwd();
-  const dataDir = getDataDir(cwd);
-
-  const result: BootstrapFile[] = [];
-
-  for (const name of BOOTSTRAP_FILENAMES) {
-    // 优先项目根目录
-    const rootPath = path.join(cwd, name);
-    const dataPath = path.join(dataDir, name);
-
-    let found = false;
-    for (const filePath of [rootPath, dataPath]) {
-      try {
-        const content = await readFileWithCache(filePath);
-        result.push({ name, path: filePath, content, missing: false });
-        found = true;
-        break; // 找到就不再搜索
-      } catch {
-        // 继续尝试下一个路径
-      }
-    }
-
-    if (!found) {
-      result.push({ name, path: rootPath, missing: true });
-    }
-  }
-
-  return result;
-}
-
-/**
- * 将引导文件转为上下文文件列表（用于注入到 system prompt）
- *
- * 自动裁剪超长内容，跳过缺失文件
- */
-export function buildContextFiles(
-  bootstrapFiles: BootstrapFile[],
-  options?: {
-    maxChars?: number;
-    totalMaxChars?: number;
-  },
-): ContextFile[] {
-  const maxChars = options?.maxChars ?? DEFAULT_MAX_CHARS;
-  const totalMaxChars = options?.totalMaxChars ?? DEFAULT_TOTAL_MAX_CHARS;
-
-  const contextFiles: ContextFile[] = [];
-  let totalChars = 0;
-
-  for (const file of bootstrapFiles) {
-    if (file.missing || !file.content) continue;
-
-    let content = file.content.trim();
-    if (!content) continue;
-
-    // 单文件裁剪
-    if (content.length > maxChars) {
-      content = content.slice(0, maxChars) + '\n...(truncated)';
-      logger.warn(`Bootstrap file ${file.name} exceeds ${maxChars} chars, truncated`);
-    }
-
-    // 总量限制
-    if (totalChars + content.length > totalMaxChars) {
-      logger.warn(`Bootstrap total exceeds ${totalMaxChars} chars, skipping ${file.name}`);
-      break;
-    }
-
-    contextFiles.push({ path: file.name, content });
-    totalChars += content.length;
-  }
-
-  return contextFiles;
-}
-
-/**
- * 加载 SOUL.md 人格定义
- */
-export async function loadSoulPersona(workspaceDir?: string): Promise<string | null> {
-  const files = await loadBootstrapFiles(workspaceDir);
-  const soulFile = files.find(f => f.name === 'SOUL.md' && !f.missing);
-  return soulFile?.content?.trim() || null;
-}
-
-/**
- * 加载 TOOLS.md 工具使用指引
- */
-export async function loadToolsGuide(workspaceDir?: string): Promise<string | null> {
-  const files = await loadBootstrapFiles(workspaceDir);
-  const toolsFile = files.find(f => f.name === 'TOOLS.md' && !f.missing);
-  return toolsFile?.content?.trim() || null;
-}
-
-/**
- * 加载 AGENTS.md 持久化记忆
- */
-export async function loadAgentsMemory(workspaceDir?: string): Promise<string | null> {
-  const files = await loadBootstrapFiles(workspaceDir);
-  const agentsFile = files.find(f => f.name === 'AGENTS.md' && !f.missing);
-  return agentsFile?.content?.trim() || null;
-}
-
-// ============================================================================
-// System Prompt 构建帮助函数
-// ============================================================================
-
-/**
- * 构建引导文件上下文段（注入到 system prompt 末尾）
- *
- * 格式与 OpenClaw 一致：
- * ```
- * # Project Context
- *
- * The following project context files have been loaded:
- * If SOUL.md is present, embody its persona and tone.
- *
- * ## SOUL.md
- *
- * <content>
- *
- * ## TOOLS.md
- *
- * <content>
- * ```
- */
-export function buildBootstrapContextSection(contextFiles: ContextFile[]): string {
-  if (contextFiles.length === 0) return '';
-
-  const hasSoul = contextFiles.some(f =>
-    f.path.toLowerCase().endsWith('soul.md'),
-  );
-
-  const lines: string[] = [
-    '# Project Context',
-    '',
-    'The following project context files have been loaded:',
-  ];
-
-  if (hasSoul) {
-    lines.push(
-      'If SOUL.md is present, embody its persona and tone. Avoid generic responses.',
-    );
-  }
-  lines.push('');
-
-  for (const file of contextFiles) {
-    lines.push(`## ${file.path}`, '', file.content, '');
-  }
-
-  return lines.join('\n');
-}