@zhin.js/agent 0.0.20 → 0.1.2

package/src/compaction.ts

@@ -1,28 +0,0 @@
-/**
- * Re-export from @zhin.js/ai for backward compatibility.
- */
-export {
-  DEFAULT_CONTEXT_TOKENS,
-  CONTEXT_WINDOW_HARD_MIN_TOKENS,
-  CONTEXT_WINDOW_WARN_BELOW_TOKENS,
-  BASE_CHUNK_RATIO,
-  MIN_CHUNK_RATIO,
-  SAFETY_MARGIN,
-  estimateTokens,
-  estimateMessagesTokens,
-  splitMessagesByTokenShare,
-  chunkMessagesByMaxTokens,
-  computeAdaptiveChunkRatio,
-  resolveContextWindowTokens,
-  evaluateContextWindowGuard,
-  summarizeWithFallback,
-  summarizeInStages,
-  pruneHistoryForContext,
-  compactSession,
-} from '@zhin.js/ai';
-export type {
-  ContextWindowSource,
-  ContextWindowInfo,
-  ContextWindowGuardResult,
-  PruneResult,
-} from '@zhin.js/ai';

package/src/context-manager.ts

@@ -1,15 +0,0 @@
-/**
- * Re-export from @zhin.js/ai for backward compatibility.
- */
-export {
-  ContextManager,
-  createContextManager,
-  CHAT_MESSAGE_MODEL,
-  CONTEXT_SUMMARY_MODEL,
-} from '@zhin.js/ai';
-export type {
-  MessageRecord,
-  SummaryRecord,
-  ContextConfig,
-  SceneContext,
-} from '@zhin.js/ai';

package/src/conversation-memory.ts

@@ -1,5 +0,0 @@
-/**
- * Re-export from @zhin.js/ai for backward compatibility.
- */
-export { ConversationMemory, AI_MESSAGE_MODEL, AI_SUMMARY_MODEL } from '@zhin.js/ai';
-export type { ConversationMemoryConfig } from '@zhin.js/ai';

package/src/cron-engine.ts

@@ -1,338 +0,0 @@
-/**
- * 持久化定时任务
- *
- * 将定时任务持久化到 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, ZhinTool } from '@zhin.js/core';
-import { Logger } from '@zhin.js/core';
-
-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 [id, dispose] of this.disposes) {
-      try {
-        dispose();
-      } catch (e) {
-        logger.warn(`Cron dispose failed for ${id}:`, e);
-      }
-    }
-    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/discover-agents.ts

@@ -1,138 +0,0 @@
-/**
- * Agent 预设发现（*.agent.md 文件扫描）
- *
- * 加载顺序与 skills 一致：Workspace > ~/.zhin > data > 插件包
- * 同名先发现者优先
- */
-
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-import { Logger, type Plugin } from '@zhin.js/core';
-import { getDataDir } from './discovery-utils.js';
-
-const logger = new Logger(null, 'builtin-tools');
-
-// ============================================================================
-// 类型
-// ============================================================================
-
-export interface AgentMeta {
-  name: string;
-  description: string;
-  keywords?: string[];
-  tags?: string[];
-  /** frontmatter 中声明的工具名列表 */
-  toolNames?: string[];
-  /** *.agent.md 文件的绝对路径 */
-  filePath: string;
-  /** 首选模型名 */
-  model?: string;
-  /** 首选 Provider 名 */
-  provider?: string;
-  /** 最大工具调用迭代次数 */
-  maxIterations?: number;
-}
-
-// ============================================================================
-// 发现
-// ============================================================================
-
-/**
- * 扫描 agents/ 目录，发现 *.agent.md 文件
- */
-export async function discoverWorkspaceAgents(root?: Plugin | null): Promise<AgentMeta[]> {
-  const agents: AgentMeta[] = [];
-  const seenNames = new Set<string>();
-
-  const agentDirs: string[] = [
-    path.join(process.cwd(), 'agents'),
-    path.join(os.homedir(), '.zhin', 'agents'),
-    path.join(getDataDir(), 'agents'),
-  ];
-  if (root) {
-    const addPluginDir = (p: Plugin) => {
-      if (!p?.filePath) return;
-      const dir = path.dirname(p.filePath);
-      const d = path.join(dir, 'agents');
-      if (!agentDirs.includes(d)) agentDirs.push(d);
-      const dirName = path.basename(dir);
-      if (dirName === 'src' || dirName === 'lib') {
-        const d2 = path.join(path.dirname(dir), 'agents');
-        if (!agentDirs.includes(d2)) agentDirs.push(d2);
-      }
-    };
-    addPluginDir(root);
-    for (const child of root.children || []) {
-      addPluginDir(child);
-    }
-  }
-
-  for (const agentsDir of agentDirs) {
-    if (!fs.existsSync(agentsDir)) continue;
-
-    let entries: fs.Dirent[];
-    try {
-      entries = await fs.promises.readdir(agentsDir, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-
-    for (const entry of entries) {
-      let agentMdPath: string | undefined;
-      if (entry.isFile() && entry.name.endsWith('.agent.md')) {
-        agentMdPath = path.join(agentsDir, entry.name);
-      } else if (entry.isDirectory()) {
-        const nested = path.join(agentsDir, entry.name, `${entry.name}.agent.md`);
-        if (fs.existsSync(nested)) agentMdPath = nested;
-      }
-      if (!agentMdPath) continue;
-
-      try {
-        const content = await fs.promises.readFile(agentMdPath, 'utf-8');
-        const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
-        if (!match) {
-          logger.debug(`Agent文件 ${agentMdPath} 没有有效的frontmatter格式`);
-          continue;
-        }
-
-        let jsYaml: any;
-        try {
-          jsYaml = await import('js-yaml');
-          if (jsYaml.default) jsYaml = jsYaml.default;
-        } catch (e) {
-          logger.warn(`Unable to import js-yaml module: ${e}`);
-          continue;
-        }
-
-        const metadata = jsYaml.load(match[1]);
-        if (!metadata || !metadata.name || !metadata.description) {
-          logger.debug(`Agent文件 ${agentMdPath} 缺少必需的 name/description 字段`);
-          continue;
-        }
-
-        if (seenNames.has(metadata.name)) {
-          logger.debug(`Agent '${metadata.name}' 已由先序目录加载，跳过: ${agentMdPath}`);
-          continue;
-        }
-        seenNames.add(metadata.name);
-
-        agents.push({
-          name: metadata.name,
-          description: metadata.description,
-          keywords: metadata.keywords || [],
-          tags: metadata.tags || [],
-          toolNames: Array.isArray(metadata.tools) ? metadata.tools : [],
-          filePath: agentMdPath,
-          model: metadata.model,
-          provider: metadata.provider,
-          maxIterations: typeof metadata.maxIterations === 'number' ? metadata.maxIterations : undefined,
-        });
-        logger.debug(`Agent发现成功: ${metadata.name}`);
-      } catch (e) {
-        logger.warn(`Failed to parse agent.md in ${agentMdPath}:`, e);
-      }
-    }
-  }
-  return agents;
-}