@zhin.js/core 1.0.32 → 1.0.34

package/lib/scheduler/scheduler.js

@@ -0,0 +1,352 @@
+/**
+ * Unified scheduler — at / every / cron + heartbeat
+ *
+ * 持久化到 data/scheduler-jobs.json，支持单次 at、间隔 every、cron 表达式，
+ * 以及可选的 HEARTBEAT.md 周期检查。
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+import { Cron as Croner } from 'croner';
+import { Logger } from '@zhin.js/logger';
+const logger = new Logger(null, 'scheduler');
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 30 * 60 * 1000;
+const HEARTBEAT_PROMPT = `Read HEARTBEAT.md in your workspace (if it exists).
+Follow any instructions or tasks listed there.
+If nothing needs attention, reply with just: HEARTBEAT_OK`;
+function nowMs() {
+    return Date.now();
+}
+function computeNextRun(schedule, currentMs) {
+    if (schedule.kind === 'at') {
+        return schedule.atMs != null && schedule.atMs > currentMs ? schedule.atMs : undefined;
+    }
+    if (schedule.kind === 'every') {
+        if (schedule.everyMs == null || schedule.everyMs <= 0)
+            return undefined;
+        return currentMs + schedule.everyMs;
+    }
+    if (schedule.kind === 'cron' && schedule.expr) {
+        try {
+            const job = new Croner(schedule.expr, { paused: true, timezone: schedule.tz });
+            const next = job.nextRun();
+            job.stop();
+            return next ? next.getTime() : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function createStore() {
+    return { version: 1, jobs: [] };
+}
+function isHeartbeatEmpty(content) {
+    if (!content)
+        return true;
+    const skipPatterns = new Set(['- [ ]', '* [ ]', '- [x]', '* [x]']);
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('<!--') || skipPatterns.has(trimmed))
+            continue;
+        return false;
+    }
+    return true;
+}
+export class Scheduler {
+    storePath;
+    workspace;
+    onJob = null;
+    store = null;
+    timerTimeout = null;
+    _running = false;
+    heartbeatEnabled;
+    heartbeatIntervalMs;
+    heartbeatJobId = null;
+    constructor(options) {
+        this.storePath = options.storePath;
+        this.workspace = options.workspace;
+        this.onJob = options.onJob ?? null;
+        this.heartbeatEnabled = options.heartbeatEnabled ?? true;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+    }
+    loadStore() {
+        if (this.store)
+            return this.store;
+        if (fs.existsSync(this.storePath)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(this.storePath, 'utf-8'));
+                const jobs = (data.jobs || []).map((j) => ({
+                    id: j.id,
+                    name: j.name,
+                    enabled: j.enabled ?? true,
+                    schedule: {
+                        kind: j.schedule?.kind ?? 'cron',
+                        atMs: j.schedule?.atMs,
+                        everyMs: j.schedule?.everyMs,
+                        expr: j.schedule?.expr,
+                        tz: j.schedule?.tz,
+                    },
+                    payload: {
+                        kind: j.payload?.kind ?? 'agent_turn',
+                        message: j.payload?.message ?? '',
+                        deliver: j.payload?.deliver ?? false,
+                        channel: j.payload?.channel,
+                        to: j.payload?.to,
+                    },
+                    state: {
+                        nextRunAtMs: j.state?.nextRunAtMs,
+                        lastRunAtMs: j.state?.lastRunAtMs,
+                        lastStatus: j.state?.lastStatus,
+                        lastError: j.state?.lastError,
+                    },
+                    createdAtMs: j.createdAtMs ?? 0,
+                    updatedAtMs: j.updatedAtMs ?? 0,
+                    deleteAfterRun: j.deleteAfterRun ?? false,
+                }));
+                this.store = { version: data.version ?? 1, jobs };
+            }
+            catch (e) {
+                logger.warn('Failed to load scheduler store', e);
+                this.store = createStore();
+            }
+        }
+        else {
+            this.store = createStore();
+        }
+        return this.store;
+    }
+    saveStore() {
+        if (!this.store)
+            return;
+        const dir = path.dirname(this.storePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        const persistJobs = this.store.jobs.filter(j => j.id !== this.heartbeatJobId);
+        const data = {
+            version: this.store.version,
+            jobs: persistJobs.map(j => ({
+                id: j.id,
+                name: j.name,
+                enabled: j.enabled,
+                schedule: j.schedule,
+                payload: j.payload,
+                state: j.state,
+                createdAtMs: j.createdAtMs,
+                updatedAtMs: j.updatedAtMs,
+                deleteAfterRun: j.deleteAfterRun,
+            })),
+        };
+        fs.writeFileSync(this.storePath, JSON.stringify(data, null, 2));
+    }
+    async start() {
+        this._running = true;
+        this.loadStore();
+        if (this.heartbeatEnabled)
+            this.addHeartbeatJob();
+        this.recomputeNextRuns();
+        this.saveStore();
+        this.armTimer();
+        logger.info({ jobs: this.store?.jobs.length ?? 0 }, 'Scheduler started');
+    }
+    stop() {
+        this._running = false;
+        if (this.timerTimeout) {
+            clearTimeout(this.timerTimeout);
+            this.timerTimeout = null;
+        }
+    }
+    addHeartbeatJob() {
+        if (!this.store)
+            return;
+        const existing = this.store.jobs.find(j => j.payload.kind === 'heartbeat');
+        if (existing) {
+            this.heartbeatJobId = existing.id;
+            return;
+        }
+        const now = nowMs();
+        const job = {
+            id: `heartbeat-${randomUUID().slice(0, 8)}`,
+            name: 'Heartbeat',
+            enabled: true,
+            schedule: { kind: 'every', everyMs: this.heartbeatIntervalMs },
+            payload: { kind: 'heartbeat', message: HEARTBEAT_PROMPT, deliver: false },
+            state: { nextRunAtMs: now + this.heartbeatIntervalMs },
+            createdAtMs: now,
+            updatedAtMs: now,
+            deleteAfterRun: false,
+        };
+        this.heartbeatJobId = job.id;
+        this.store.jobs.push(job);
+        logger.info({ intervalMs: this.heartbeatIntervalMs }, 'Heartbeat job added');
+    }
+    recomputeNextRuns() {
+        if (!this.store)
+            return;
+        const now = nowMs();
+        for (const job of this.store.jobs) {
+            if (job.enabled)
+                job.state.nextRunAtMs = computeNextRun(job.schedule, now);
+        }
+    }
+    getNextWakeMs() {
+        if (!this.store)
+            return undefined;
+        const times = this.store.jobs
+            .filter(j => j.enabled && j.state.nextRunAtMs != null)
+            .map(j => j.state.nextRunAtMs);
+        return times.length > 0 ? Math.min(...times) : undefined;
+    }
+    armTimer() {
+        if (this.timerTimeout) {
+            clearTimeout(this.timerTimeout);
+            this.timerTimeout = null;
+        }
+        const nextWake = this.getNextWakeMs();
+        if (nextWake == null || !this._running)
+            return;
+        const delayMs = Math.max(0, nextWake - nowMs());
+        this.timerTimeout = setTimeout(async () => {
+            if (this._running)
+                await this.onTimer();
+        }, delayMs);
+    }
+    async onTimer() {
+        if (!this.store)
+            return;
+        const now = nowMs();
+        const dueJobs = this.store.jobs.filter(j => j.enabled && j.state.nextRunAtMs != null && now >= j.state.nextRunAtMs);
+        for (const job of dueJobs)
+            await this.executeJob(job);
+        this.saveStore();
+        this.armTimer();
+    }
+    async executeJob(job) {
+        const startMs = nowMs();
+        if (job.payload.kind === 'heartbeat') {
+            const shouldRun = this.checkHeartbeatFile();
+            if (!shouldRun) {
+                job.state.lastStatus = 'skipped';
+                job.state.lastRunAtMs = startMs;
+                job.updatedAtMs = nowMs();
+                job.state.nextRunAtMs = computeNextRun(job.schedule, nowMs());
+                return;
+            }
+        }
+        logger.info({ jobId: job.id, name: job.name }, 'Scheduler: executing job');
+        try {
+            if (this.onJob)
+                await this.onJob(job);
+            job.state.lastStatus = 'ok';
+            job.state.lastError = undefined;
+            logger.info({ jobId: job.id, name: job.name }, 'Scheduler: job completed');
+        }
+        catch (error) {
+            job.state.lastStatus = 'error';
+            job.state.lastError = String(error);
+            logger.error({ jobId: job.id, name: job.name, lastError: String(error) }, 'Scheduler: job failed');
+        }
+        job.state.lastRunAtMs = startMs;
+        job.updatedAtMs = nowMs();
+        if (job.schedule.kind === 'at') {
+            if (job.deleteAfterRun && this.store) {
+                this.store.jobs = this.store.jobs.filter(j => j.id !== job.id);
+            }
+            else {
+                job.enabled = false;
+                job.state.nextRunAtMs = undefined;
+            }
+        }
+        else {
+            job.state.nextRunAtMs = computeNextRun(job.schedule, nowMs());
+        }
+    }
+    checkHeartbeatFile() {
+        const heartbeatPath = path.join(this.workspace, 'HEARTBEAT.md');
+        if (!fs.existsSync(heartbeatPath))
+            return false;
+        try {
+            const content = fs.readFileSync(heartbeatPath, 'utf-8');
+            return !isHeartbeatEmpty(content);
+        }
+        catch {
+            return false;
+        }
+    }
+    listJobs() {
+        const store = this.loadStore();
+        return store.jobs
+            .filter(j => j.id !== this.heartbeatJobId)
+            .sort((a, b) => (a.state.nextRunAtMs ?? Infinity) - (b.state.nextRunAtMs ?? Infinity));
+    }
+    addJob(options) {
+        const store = this.loadStore();
+        const now = nowMs();
+        const job = {
+            id: randomUUID().slice(0, 8),
+            name: options.name,
+            enabled: options.enabled ?? true,
+            schedule: options.schedule,
+            payload: options.payload,
+            state: { nextRunAtMs: computeNextRun(options.schedule, now) },
+            createdAtMs: now,
+            updatedAtMs: now,
+            deleteAfterRun: options.deleteAfterRun ?? false,
+        };
+        store.jobs.push(job);
+        this.saveStore();
+        this.armTimer();
+        logger.info({ jobId: job.id, name: job.name }, 'Scheduler: added job');
+        return job;
+    }
+    removeJob(jobId) {
+        const store = this.loadStore();
+        const before = store.jobs.length;
+        store.jobs = store.jobs.filter(j => j.id !== jobId);
+        const removed = store.jobs.length < before;
+        if (removed) {
+            this.saveStore();
+            this.armTimer();
+            logger.info({ jobId }, 'Scheduler: removed job');
+        }
+        return removed;
+    }
+    enableJob(jobId, enabled = true) {
+        const store = this.loadStore();
+        const job = store.jobs.find(j => j.id === jobId);
+        if (!job)
+            return false;
+        job.enabled = enabled;
+        job.updatedAtMs = nowMs();
+        job.state.nextRunAtMs = enabled ? computeNextRun(job.schedule, nowMs()) : undefined;
+        this.saveStore();
+        this.armTimer();
+        return true;
+    }
+    async runJob(jobId) {
+        const store = this.loadStore();
+        const job = store.jobs.find(j => j.id === jobId);
+        if (job) {
+            await this.executeJob(job);
+            this.saveStore();
+            this.armTimer();
+        }
+    }
+    status() {
+        const store = this.loadStore();
+        return {
+            running: this._running,
+            jobCount: store.jobs.filter(j => j.id !== this.heartbeatJobId).length,
+            nextWakeAt: this.getNextWakeMs(),
+        };
+    }
+    async triggerHeartbeat() {
+        if (this.heartbeatJobId && this.store) {
+            const job = this.store.jobs.find(j => j.id === this.heartbeatJobId);
+            if (job && this.onJob)
+                await this.onJob(job);
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/lib/scheduler/scheduler.js.map

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

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.32",
+  "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.19",
-    "@zhin.js/logger": "0.1.16",
-    "@zhin.js/schema": "1.0.16"
+    "@zhin.js/database": "1.0.21",
+    "@zhin.js/logger": "0.1.18",
+    "@zhin.js/schema": "1.0.18"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",