@zhin.js/core 1.0.33 → 1.0.34

package/lib/scheduler/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Scheduler types
+ *
+ * 支持三种调度：at（单次指定时间）、every（固定间隔）、cron（表达式）
+ * Payload 支持 agent_turn（到点执行 prompt）、heartbeat（读 HEARTBEAT.md）、system_event
+ */
+export interface Schedule {
+    kind: 'at' | 'every' | 'cron';
+    /** 单次执行时间戳（kind=at） */
+    atMs?: number;
+    /** 间隔毫秒（kind=every） */
+    everyMs?: number;
+    /** Cron 表达式（kind=cron） */
+    expr?: string;
+    /** 时区（kind=cron 可选） */
+    tz?: string;
+}
+export interface JobPayload {
+    kind: 'system_event' | 'agent_turn' | 'heartbeat';
+    /** 触发时发给 AI 的 prompt（agent_turn）或 heartbeat 说明 */
+    message: string;
+    /** 是否投递到指定 channel/user */
+    deliver: boolean;
+    channel?: string;
+    to?: string;
+}
+export interface JobState {
+    nextRunAtMs?: number;
+    lastRunAtMs?: number;
+    lastStatus?: 'ok' | 'error' | 'skipped';
+    lastError?: string;
+}
+export interface ScheduledJob {
+    id: string;
+    name: string;
+    enabled: boolean;
+    schedule: Schedule;
+    payload: JobPayload;
+    state: JobState;
+    createdAtMs: number;
+    updatedAtMs: number;
+    /** 单次任务执行后是否删除 */
+    deleteAfterRun: boolean;
+}
+export interface JobStore {
+    version: number;
+    jobs: ScheduledJob[];
+}
+export type JobCallback = (job: ScheduledJob) => Promise<void>;
+export interface AddJobOptions {
+    name: string;
+    schedule: Schedule;
+    payload: JobPayload;
+    enabled?: boolean;
+    deleteAfterRun?: boolean;
+}
+export interface IScheduler {
+    start(): Promise<void>;
+    stop(): void;
+    addJob(options: AddJobOptions): ScheduledJob;
+    removeJob(jobId: string): boolean;
+    enableJob(jobId: string, enabled: boolean): boolean;
+    runJob(jobId: string): Promise<void>;
+    listJobs(): ScheduledJob[];
+    status(): {
+        running: boolean;
+        jobCount: number;
+        nextWakeAt?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/scheduler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scheduler/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9B,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;IAClD,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC3B,MAAM,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE"}

package/lib/scheduler/types.js

@@ -0,0 +1,8 @@
+/**
+ * Scheduler types
+ *
+ * 支持三种调度：at（单次指定时间）、every（固定间隔）、cron（表达式）
+ * Payload 支持 agent_turn（到点执行 prompt）、heartbeat（读 HEARTBEAT.md）、system_event
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/scheduler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scheduler/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/tool-zod.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod 工具适配层（可选）
+ *
+ * 使用 Zod 定义工具参数时可获得类型推断与校验。需安装 zod：
+ *   pnpm add zod
+ *
+ * 用法：
+ *   import { createToolFromZod } from '@zhin.js/core/tool-zod';
+ *   import { z } from 'zod';
+ *   const tool = createToolFromZod('my_tool', '描述', z.object({ id: z.string() }), async (args) => { ... });
+ *   plugin.addTool(tool);
+ */
+import type { Tool, ToolContext } from './types.js';
+type MaybePromise<T> = T | Promise<T>;
+export interface CreateToolFromZodOptions {
+    tags?: string[];
+    keywords?: string[];
+    source?: string;
+    hidden?: boolean;
+    kind?: string;
+}
+/**
+ * 从 Zod 模式创建 Tool，便于类型安全与校验。
+ * 需要安装 zod：pnpm add zod。传入的 schema 应为 z.object({ ... })。
+ */
+export declare function createToolFromZod<T extends Record<string, any>>(name: string, description: string, schema: any, execute: (args: T, context?: ToolContext) => MaybePromise<any>, options?: CreateToolFromZodOptions): Tool;
+export {};
+//# sourceMappingURL=tool-zod.d.ts.map

package/lib/tool-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-zod.d.ts","sourceRoot":"","sources":["../src/tool-zod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAwB,MAAM,YAAY,CAAC;AAE1E,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAyDtC,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,YAAY,CAAC,GAAG,CAAC,EAC9D,OAAO,CAAC,EAAE,wBAAwB,GACjC,IAAI,CAuBN"}

package/lib/tool-zod.js

@@ -0,0 +1,98 @@
+/**
+ * Zod 工具适配层（可选）
+ *
+ * 使用 Zod 定义工具参数时可获得类型推断与校验。需安装 zod：
+ *   pnpm add zod
+ *
+ * 用法：
+ *   import { createToolFromZod } from '@zhin.js/core/tool-zod';
+ *   import { z } from 'zod';
+ *   const tool = createToolFromZod('my_tool', '描述', z.object({ id: z.string() }), async (args) => { ... });
+ *   plugin.addTool(tool);
+ */
+function zodFieldToJsonSchema(z) {
+    if (!z || !z._def)
+        return { type: 'string' };
+    const def = z._def;
+    const typeName = def.typeName;
+    if (typeName === 'ZodOptional' || typeName === 'ZodDefault') {
+        const inner = def.innerType ?? def.type;
+        return zodFieldToJsonSchema(inner);
+    }
+    if (typeName === 'ZodString') {
+        const out = { type: 'string' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodNumber') {
+        const out = { type: 'number' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodBoolean') {
+        const out = { type: 'boolean' };
+        if (def.description)
+            out.description = def.description;
+        return out;
+    }
+    if (typeName === 'ZodEnum') {
+        return { type: 'string', enum: def.values };
+    }
+    if (typeName === 'ZodArray') {
+        return { type: 'array', items: zodFieldToJsonSchema(def.type ?? def.element) };
+    }
+    return { type: 'string' };
+}
+function zodToJsonSchema(schema) {
+    const result = {
+        type: 'object',
+        properties: {},
+        required: [],
+    };
+    if (!schema || !schema.shape)
+        return result;
+    const shape = schema.shape;
+    const properties = result.properties;
+    const required = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const zodValue = value;
+        properties[key] = zodFieldToJsonSchema(zodValue);
+        const typeName = zodValue?._def?.typeName;
+        if (typeName !== 'ZodOptional' && typeName !== 'ZodDefault') {
+            required.push(key);
+        }
+    }
+    result.required = required.length > 0 ? required : undefined;
+    return result;
+}
+/**
+ * 从 Zod 模式创建 Tool，便于类型安全与校验。
+ * 需要安装 zod：pnpm add zod。传入的 schema 应为 z.object({ ... })。
+ */
+export function createToolFromZod(name, description, schema, execute, options) {
+    if (!schema?.safeParse) {
+        throw new Error('createToolFromZod: schema must be a Zod object schema (e.g. z.object({ ... })). Install zod: pnpm add zod');
+    }
+    const parameters = zodToJsonSchema(schema);
+    return {
+        name,
+        description,
+        parameters,
+        execute: async (args, context) => {
+            const parsed = schema.safeParse(args);
+            if (!parsed.success) {
+                const msg = parsed.error.errors?.map((e) => `${e.path?.join('.') ?? 'root'}: ${e.message}`).join('; ') ?? 'Invalid arguments';
+                return `Error: ${msg}`;
+            }
+            return execute(parsed.data, context);
+        },
+        tags: options?.tags,
+        keywords: options?.keywords,
+        source: options?.source,
+        hidden: options?.hidden,
+        kind: options?.kind,
+    };
+}
+//# sourceMappingURL=tool-zod.js.map

package/lib/tool-zod.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.0.33",
+  "version": "1.0.34",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",
@@ -11,6 +11,11 @@
       "development": "./src/index.ts",
       "import": "./lib/index.js"
     },
+    "./tool-zod": {
+      "types": "./lib/tool-zod.d.ts",
+      "development": "./src/tool-zod.ts",
+      "import": "./lib/tool-zod.js"
+    },
     "./jsx": {
       "types": "./lib/jsx.d.ts",
       "development": "./src/jsx.ts",
@@ -32,9 +37,9 @@
     "segment-matcher": "latest",
     "smol-toml": "^1.6.0",
     "yaml": "^2.3.4",
-    "@zhin.js/database": "1.0.20",
-    "@zhin.js/logger": "0.1.17",
-    "@zhin.js/schema": "1.0.17"
+    "@zhin.js/database": "1.0.21",
+    "@zhin.js/logger": "0.1.18",
+    "@zhin.js/schema": "1.0.18"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/ai/agent.ts

@@ -32,6 +32,7 @@ export function formatToolTitle(name: string, args?: Record<string, any>): strin
     case 'read_file': return a.file_path != null ? `read_file: ${a.file_path}` : name;
     case 'write_file': return a.file_path != null ? `write_file: ${a.file_path}` : name;
     case 'edit_file': return a.file_path != null ? `edit_file: ${a.file_path}` : name;
+    case 'list_dir': return a.path != null ? `list_dir: ${a.path}` : name;
     case 'web_search': return a.query != null ? `web_search: ${String(a.query).slice(0, 40)}` : name;
     case 'web_fetch': return a.url != null ? `web_fetch: ${String(a.url).slice(0, 50)}` : name;
     default: {
@@ -286,10 +287,21 @@ export class Agent {
       });
     }
 
+    let args: Record<string, unknown>;
     try {
-      const args = JSON.parse(toolCall.function.arguments);
-      this.emit('tool_call', tool.name, args);
+      args = JSON.parse(toolCall.function.arguments);
+    } catch {
+      return JSON.stringify({
+        error: 'Invalid tool arguments JSON',
+        tool: toolCall.function.name,
+        hint: '请检查工具参数格式后重试。',
+      });
+    }
+
+    logger.debug({ tool: toolCall.function.name, params: args }, 'Executing tool');
+    this.emit('tool_call', tool.name, args);
 
+    try {
       // 带超时的工具执行
       const result = await Promise.race([
         tool.execute(args),
@@ -303,6 +315,7 @@ export class Agent {
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
       logger.warn(`工具 ${toolCall.function.name} 执行失败: ${errorMsg}`);
+      logger.error({ tool: toolCall.function.name, params: args, err: error }, 'Tool execution failed');
       // 向 AI 提供结构化的错误信息和恢复提示
       return JSON.stringify({
         error: errorMsg,

package/src/ai/bootstrap.ts

@@ -24,10 +24,10 @@ const logger = new Logger(null, 'Bootstrap');
 // 常量
 // ============================================================================
 
-/** 支持的引导文件名 */
+/** 支持的引导文件名（顺序：SOUL → AGENTS → TOOLS） */
 export const BOOTSTRAP_FILENAMES = [
-  'AGENTS.md',
   'SOUL.md',
+  'AGENTS.md',
   'TOOLS.md',
 ] as const;
 
@@ -104,6 +104,52 @@ function getDataDir(workspaceDir?: string): string {
   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') : '';
+}
+
 /**
  * 加载工作区引导文件
  *