@zhin.js/agent 0.3.1 → 1.0.2

package/lib/assistant/schedule-execution.js

@@ -0,0 +1,99 @@
+/** commMessage.extra / AI hookContext 键名（legacy；新路径用 TurnContext ALS） */
+export const SCHEDULE_MESSAGE_EXTRA = {
+    createdBy: 'scheduleCreatedBy',
+    activityFeedback: 'scheduleActivityFeedback',
+    preview: 'schedulePreview',
+    executionPlan: 'scheduleExecutionPlan',
+    jobId: 'scheduleJobId',
+};
+export function buildScheduleTurnPrompt(input) {
+    const base = input.basePrompt.trim();
+    if (input.mode === 'preview') {
+        return [
+            '[系统] 这是调度任务预演（dry-run），不会向群聊投递最终结果。',
+            '请按真实到点执行的预期完成一次完整输出；系统将记录所用工具/技能并展示给创建者确认。',
+            '不要输出「收到」「正在安排」等元评论，直接给出预演结果正文。',
+            '',
+            `任务: ${base}`,
+        ].join('\n');
+    }
+    const now = new Date();
+    const timeStr = now.toLocaleString('zh-CN', { hour12: false });
+    const weekdays = ['日', '一', '二', '三', '四', '五', '六'];
+    const weekday = weekdays[now.getDay()];
+    return [
+        `[系统] 这是定时任务自动触发，当前时间: ${timeStr} 星期${weekday}`,
+        '你的输出将被直接发送到目标聊天中，请注意：',
+        '- 直接输出最终内容，不要包含任何确认、进度报告或元评论（如"收到""正在执行""已完成"等）',
+        '- 不要使用"为您""帮你"等对话式措辞，你不是在回复某个人的请求',
+        '- 像一个真实的群成员一样自然发言',
+        '',
+        `任务: ${base}`,
+    ].join('\n');
+}
+/** @deprecated use buildScheduleTurnPrompt */
+export function buildScheduleTimeContextPrompt(prompt) {
+    return buildScheduleTurnPrompt({ basePrompt: prompt, mode: 'scheduled' });
+}
+/** @deprecated use buildScheduleTurnPrompt */
+export function buildSchedulePreviewPrompt(prompt) {
+    return buildScheduleTurnPrompt({ basePrompt: prompt, mode: 'preview' });
+}
+export function parseStringArrayArg(value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => String(v).trim()).filter(Boolean);
+    }
+    if (typeof value === 'string') {
+        return value.split(/[,，\s]+/).map((s) => s.trim()).filter(Boolean);
+    }
+    return [];
+}
+export function parseExecutionPlanFromArgs(args, fallbackPrompt) {
+    const raw = args.execution_plan ?? args.executionPlan;
+    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+        const record = raw;
+        const prompt = String(record.prompt ?? fallbackPrompt).trim();
+        const tools = parseStringArrayArg(record.tools);
+        const skills = parseStringArrayArg(record.skills);
+        const previewSample = record.previewSample != null ? String(record.previewSample) : undefined;
+        if (!prompt && !tools.length && !skills.length && !previewSample)
+            return undefined;
+        return {
+            prompt: prompt || fallbackPrompt,
+            tools: tools.length ? tools : undefined,
+            skills: skills.length ? skills : undefined,
+            previewSample,
+            previewedAt: typeof record.previewedAt === 'number' ? record.previewedAt : undefined,
+            confirmed: record.confirmed === true,
+        };
+    }
+    const refined = args.refined_prompt != null ? String(args.refined_prompt).trim() : '';
+    const tools = parseStringArrayArg(args.tools);
+    const skills = parseStringArrayArg(args.skills);
+    if (!refined && !tools.length && !skills.length)
+        return undefined;
+    return {
+        prompt: refined || fallbackPrompt,
+        tools: tools.length ? tools : undefined,
+        skills: skills.length ? skills : undefined,
+    };
+}
+export function parseScheduleJobExecutionPlan(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const prompt = record.prompt != null ? String(record.prompt).trim() : '';
+    if (!prompt)
+        return undefined;
+    const tools = parseStringArrayArg(record.tools);
+    const skills = parseStringArrayArg(record.skills);
+    return {
+        prompt,
+        tools: tools.length ? tools : undefined,
+        skills: skills.length ? skills : undefined,
+        previewSample: record.previewSample != null ? String(record.previewSample) : undefined,
+        previewedAt: typeof record.previewedAt === 'number' ? record.previewedAt : undefined,
+        confirmed: record.confirmed === true,
+    };
+}
+//# sourceMappingURL=schedule-execution.js.map

package/lib/assistant/schedule-execution.js.map

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

package/lib/assistant/schedule-job-service.d.ts

@@ -0,0 +1,25 @@
+import { type Message } from '@zhin.js/core';
+import type { ScheduleJobEngine } from './job-engine.js';
+import type { JobNotify, JobSchedule, ScheduleJob, ScheduleJobCreator, ScheduleJobExecutionPlan } from './types.js';
+export declare function generateScheduleJobId(): string;
+export interface ScheduleAddInput {
+    id?: string;
+    label?: string;
+    prompt: string;
+    schedule: JobSchedule;
+    notify: JobNotify;
+    source?: ScheduleJob['source'];
+    createdBy?: ScheduleJobCreator;
+    executionPlan?: ScheduleJobExecutionPlan;
+    activityFeedback?: boolean;
+    enabled?: boolean;
+}
+export declare function addScheduleJob(engine: ScheduleJobEngine, input: ScheduleAddInput): Promise<ScheduleJob>;
+export declare function parseScheduleNotifyFromRpc(message: Record<string, unknown>): JobNotify;
+export declare function parseScheduleAddFromToolArgs(args: Record<string, unknown>, commMessage?: Message): ScheduleAddInput | {
+    error: string;
+};
+export declare function parseScheduleAddFromRpcMessage(message: Record<string, unknown>): ScheduleAddInput | {
+    error: string;
+};
+//# sourceMappingURL=schedule-job-service.d.ts.map

package/lib/assistant/schedule-job-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-job-service.d.ts","sourceRoot":"","sources":["../../src/assistant/schedule-job-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,eAAe,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AACpB,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,CAAC,CActB;AAmDD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAWtF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,OAAO,GACpB,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAuBtC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BtC"}

package/lib/assistant/schedule-job-service.js

@@ -0,0 +1,129 @@
+import { messageToIMDeliveryTarget } from '@zhin.js/core';
+import { captureScheduleJobCreator, parseScheduleJobCreator } from './job-creator.js';
+import { parseExecutionPlanFromArgs } from './schedule-execution.js';
+import { parseJobNotify } from './notification-router.js';
+import { buildJobScheduleFromCronInput } from '../schedule-cron.js';
+export function generateScheduleJobId() {
+    return `sched_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export async function addScheduleJob(engine, input) {
+    const actionPrompt = input.executionPlan?.prompt?.trim() || input.prompt;
+    return engine.addJob({
+        id: input.id ?? generateScheduleJobId(),
+        label: input.label,
+        enabled: input.enabled ?? true,
+        schedule: input.schedule,
+        action: { kind: 'agent', prompt: actionPrompt },
+        notify: input.notify,
+        source: input.source ?? 'manual',
+        createdBy: input.createdBy,
+        executionPlan: input.executionPlan,
+        activityFeedback: input.activityFeedback || undefined,
+    });
+}
+function buildScheduleFromRecord(record) {
+    const kind = record.schedule_kind ?? record.scheduleKind;
+    const cron = record.cron;
+    const delayMin = record.delay_minutes ?? record.delayMinutes;
+    const atMsRaw = record.at_ms ?? record.atMs;
+    if (String(kind || '').toLowerCase() === 'at' || (typeof delayMin === 'number' && delayMin > 0)) {
+        const atMs = typeof delayMin === 'number' && delayMin > 0
+            ? Date.now() + delayMin * 60 * 1000
+            : atMsRaw != null ? Number(atMsRaw) : undefined;
+        if (!atMs)
+            return { error: '请提供 delay_minutes 或 at_ms' };
+        return { kind: 'at', atMs, deleteAfterRun: true };
+    }
+    if (!cron) {
+        return { error: '请提供 6 段 cron 表达式（秒 分 时 日 月 周）' };
+    }
+    const built = buildJobScheduleFromCronInput(kind != null ? String(kind) : undefined, cron, record.tz != null ? String(record.tz) : undefined);
+    if ('error' in built)
+        return built;
+    if (built.kind === 'holiday') {
+        const festivals = record.festivals;
+        return {
+            ...built,
+            festivals: Array.isArray(festivals) ? festivals : undefined,
+            everyDayOfHoliday: record.every_day_of_holiday === true || record.everyDayOfHoliday === true,
+        };
+    }
+    return built;
+}
+function resolveNotifyFromToolArgs(args, commMessage) {
+    const notifyChannel = String(args.notify_channel || 'im').toLowerCase();
+    if (notifyChannel === 'silent')
+        return { channel: 'silent' };
+    if (notifyChannel === 'log')
+        return { channel: 'log' };
+    if (notifyChannel !== 'im')
+        return { error: `notify_channel 无效: ${notifyChannel}` };
+    const target = commMessage ? messageToIMDeliveryTarget(commMessage) : undefined;
+    return target ? { channel: 'im', target } : { channel: 'silent' };
+}
+export function parseScheduleNotifyFromRpc(message) {
+    const raw = message.notify;
+    if (raw && typeof raw === 'object' && raw !== null && 'channel' in raw) {
+        return parseJobNotify(raw);
+    }
+    const ch = String(message.notifyChannel ?? message.notify_channel ?? 'silent').toLowerCase();
+    if (ch === 'im') {
+        throw new Error('IM notify requires notify.target (IMDeliveryTarget)');
+    }
+    if (ch === 'log')
+        return { channel: 'log' };
+    return { channel: 'silent' };
+}
+export function parseScheduleAddFromToolArgs(args, commMessage) {
+    const built = buildScheduleFromRecord(args);
+    if ('error' in built)
+        return built;
+    const prompt = String(args.prompt ?? '');
+    if (!prompt.trim())
+        return { error: '请提供 prompt' };
+    const notify = resolveNotifyFromToolArgs(args, commMessage);
+    if ('error' in notify)
+        return notify;
+    const executionPlan = parseExecutionPlanFromArgs(args, prompt);
+    if (executionPlan)
+        executionPlan.confirmed = true;
+    return {
+        prompt,
+        schedule: built,
+        notify,
+        label: args.label != null ? String(args.label) : undefined,
+        source: 'schedule',
+        createdBy: captureScheduleJobCreator(commMessage),
+        executionPlan,
+        activityFeedback: args.activity_feedback === true ? true : undefined,
+    };
+}
+export function parseScheduleAddFromRpcMessage(message) {
+    const built = buildScheduleFromRecord(message);
+    if ('error' in built)
+        return built;
+    const prompt = String(message.prompt ?? '');
+    if (!prompt.trim())
+        return { error: '缺少 prompt' };
+    let notify;
+    try {
+        notify = parseScheduleNotifyFromRpc(message);
+    }
+    catch (e) {
+        return { error: e.message };
+    }
+    const executionPlan = parseExecutionPlanFromArgs(message, prompt);
+    if (executionPlan)
+        executionPlan.confirmed = true;
+    return {
+        prompt,
+        schedule: built,
+        notify,
+        label: message.label != null ? String(message.label) : undefined,
+        source: 'manual',
+        createdBy: parseScheduleJobCreator(message.createdBy),
+        executionPlan,
+        activityFeedback: message.activityFeedback === true ? true : undefined,
+    };
+}
+//# sourceMappingURL=schedule-job-service.js.map

package/lib/assistant/schedule-job-service.js.map

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

package/lib/assistant/schedule-message.d.ts

@@ -0,0 +1,9 @@
+import { type Message, type AgentTurnMessage } from '@zhin.js/core';
+export interface BuildScheduleTurnMessageInput {
+    sourceMessage: Message;
+    /** 仅用于 synthetic 载体，不写入 sourceMessage */
+    extra?: Record<string, unknown>;
+}
+/** 构建调度 turn 用 synthetic Message，不 mutate 入站 Message */
+export declare function buildScheduleTurnMessage(input: BuildScheduleTurnMessageInput): AgentTurnMessage;
+//# sourceMappingURL=schedule-message.d.ts.map

package/lib/assistant/schedule-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-message.d.ts","sourceRoot":"","sources":["../../src/assistant/schedule-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA4C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9G,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,gBAAgB,CAoB/F"}

package/lib/assistant/schedule-message.js

@@ -0,0 +1,23 @@
+import { createSyntheticMessage } from '@zhin.js/core';
+/** 构建调度 turn 用 synthetic Message，不 mutate 入站 Message */
+export function buildScheduleTurnMessage(input) {
+    const { sourceMessage, extra } = input;
+    const channel = sourceMessage.$channel ?? {
+        type: 'private',
+        id: sourceMessage.$sender.id,
+    };
+    const reply = typeof sourceMessage.$reply === 'function'
+        ? sourceMessage.$reply.bind(sourceMessage)
+        : undefined;
+    return createSyntheticMessage({
+        adapter: String(sourceMessage.$adapter),
+        endpoint: sourceMessage.$endpoint,
+        sender: { ...sourceMessage.$sender },
+        channel,
+        id: sourceMessage.$id,
+        quote_id: sourceMessage.$quote_id,
+        reply: reply,
+        extra: extra && Object.keys(extra).length > 0 ? extra : undefined,
+    });
+}
+//# sourceMappingURL=schedule-message.js.map

package/lib/assistant/schedule-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-message.js","sourceRoot":"","sources":["../../src/assistant/schedule-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,sBAAsB,EAAyB,MAAM,eAAe,CAAC;AAO9G,wDAAwD;AACxD,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,IAAI;QACxC,IAAI,EAAE,SAAkB;QACxB,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE;KAC7B,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,aAAa,CAAC,MAAM,KAAK,UAAU;QACtD,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,sBAAsB,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QACvC,QAAQ,EAAE,aAAa,CAAC,SAAS;QACjC,MAAM,EAAE,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE;QACpC,OAAO;QACP,EAAE,EAAE,aAAa,CAAC,GAAG;QACrB,QAAQ,EAAE,aAAa,CAAC,SAAS;QACjC,KAAK,EAAE,KAA0F;QACjG,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAClE,CAAC,CAAC;AACL,CAAC"}

package/lib/assistant/schedule-skills.d.ts

@@ -0,0 +1,3 @@
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+export declare function rehydrateTurnActiveSkills(host: ZhinAgentPrivate, sessionId: string, alwaysSkillsBaseline: string): Promise<void>;
+//# sourceMappingURL=schedule-skills.d.ts.map

package/lib/assistant/schedule-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-skills.d.ts","sourceRoot":"","sources":["../../src/assistant/schedule-skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/lib/assistant/schedule-skills.js

@@ -0,0 +1,24 @@
+import { readSkillInstructions } from '../builtin/load-skill-tool.js';
+import { buildSkillLoadOptsForAgent } from '../skill/skill-load-opts.js';
+import { setTurnActiveSkills } from '../internal/turn-context.js';
+export async function rehydrateTurnActiveSkills(host, sessionId, alwaysSkillsBaseline) {
+    const snapshot = await host.contextRepository.getDeferredToolSnapshot(sessionId);
+    const parts = [];
+    if (alwaysSkillsBaseline.trim()) {
+        parts.push(alwaysSkillsBaseline.trim());
+    }
+    if (snapshot.loadedSkills.length && host.skillRegistry) {
+        const skillLoadOpts = buildSkillLoadOptsForAgent(host);
+        for (const skillName of snapshot.loadedSkills) {
+            const skill = host.skillRegistry.getByName(skillName);
+            if (!skill)
+                continue;
+            const instructions = await readSkillInstructions(skill.name, skillLoadOpts);
+            if (instructions.startsWith(`Skill '${skill.name}' not found`))
+                continue;
+            parts.push(instructions);
+        }
+    }
+    setTurnActiveSkills(parts.join('\n\n'));
+}
+//# sourceMappingURL=schedule-skills.js.map

package/lib/assistant/schedule-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-skills.js","sourceRoot":"","sources":["../../src/assistant/schedule-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAsB,EACtB,SAAiB,EACjB,oBAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM,aAAa,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACvD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YAC5E,IAAI,YAAY,CAAC,UAAU,CAAC,UAAU,KAAK,CAAC,IAAI,aAAa,CAAC;gBAAE,SAAS;YACzE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/lib/assistant/schedule-tool-runtime.d.ts

@@ -0,0 +1,7 @@
+import { type DeferredToolSessionSnapshot } from '@zhin.js/ai';
+import type { ToolCatalogItem } from '../tool-catalog/types.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { ScheduleJobExecutionPlan } from './types.js';
+export declare function preloadScheduleTools(host: ZhinAgentPrivate, sessionId: string, executionPlan: ScheduleJobExecutionPlan, catalog: ToolCatalogItem[], sessionSnapshot: DeferredToolSessionSnapshot): Promise<DeferredToolSessionSnapshot>;
+export declare function preloadScheduleToolsFromContext(host: ZhinAgentPrivate, sessionId: string, catalog: ToolCatalogItem[], sessionSnapshot: DeferredToolSessionSnapshot): Promise<DeferredToolSessionSnapshot>;
+//# sourceMappingURL=schedule-tool-runtime.d.ts.map

package/lib/assistant/schedule-tool-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tool-runtime.d.ts","sourceRoot":"","sources":["../../src/assistant/schedule-tool-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI3D,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,wBAAwB,EACvC,OAAO,EAAE,eAAe,EAAE,EAC1B,eAAe,EAAE,2BAA2B,GAC3C,OAAO,CAAC,2BAA2B,CAAC,CA0CtC;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EAAE,EAC1B,eAAe,EAAE,2BAA2B,GAC3C,OAAO,CAAC,2BAA2B,CAAC,CAItC"}

package/lib/assistant/schedule-tool-runtime.js

@@ -0,0 +1,50 @@
+import { addSkillToSnapshot, touchToolsInSnapshot, } from '@zhin.js/ai';
+import { Logger } from '@zhin.js/logger';
+import { resolveDeferredToolsConfig } from '../tool-catalog/resolve-config.js';
+import { persistDeferredToolSnapshot } from '../tool/deferred-resolution.js';
+import { getScheduleTurnContext } from '../internal/turn-context.js';
+const logger = new Logger(null, 'schedule-tool-runtime');
+export async function preloadScheduleTools(host, sessionId, executionPlan, catalog, sessionSnapshot) {
+    const deferredCfg = resolveDeferredToolsConfig(host.config);
+    const catalogNames = new Set(catalog.map((c) => c.name));
+    let snapshot = sessionSnapshot;
+    let touched = false;
+    if (executionPlan.skills?.length && host.skillRegistry) {
+        for (const skillName of executionPlan.skills) {
+            const skill = host.skillRegistry.getByName(skillName);
+            if (!skill) {
+                logger.warn(`Schedule execution plan: skill "${skillName}" not found in registry`);
+                continue;
+            }
+            snapshot = addSkillToSnapshot(snapshot, skill.name);
+            snapshot = touchToolsInSnapshot(snapshot, skill.tools.map((t) => t.name), deferredCfg.maxLoadedPerSession);
+            touched = true;
+        }
+    }
+    if (executionPlan.tools?.length) {
+        const validTools = [];
+        for (const name of executionPlan.tools) {
+            if (catalogNames.has(name)) {
+                validTools.push(name);
+            }
+            else {
+                logger.warn(`Schedule execution plan: tool "${name}" not in catalog for this turn`);
+            }
+        }
+        if (validTools.length) {
+            snapshot = touchToolsInSnapshot(snapshot, validTools, deferredCfg.maxLoadedPerSession);
+            touched = true;
+        }
+    }
+    if (touched) {
+        await persistDeferredToolSnapshot(host, sessionId, snapshot);
+    }
+    return snapshot;
+}
+export async function preloadScheduleToolsFromContext(host, sessionId, catalog, sessionSnapshot) {
+    const plan = getScheduleTurnContext()?.executionPlan;
+    if (!plan)
+        return sessionSnapshot;
+    return preloadScheduleTools(host, sessionId, plan, catalog, sessionSnapshot);
+}
+//# sourceMappingURL=schedule-tool-runtime.js.map

package/lib/assistant/schedule-tool-runtime.js.map

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

package/lib/assistant/types.d.ts

@@ -1,11 +1,35 @@
 /**
- * Assistant Runtime — 统一 Job 模型（M1）
+ * Schedule Runtime — 统一 Job 模型
  */
-export declare const ASSISTANT_JOBS_VERSION = 1;
-export declare const ASSISTANT_JOBS_FILENAME = "assistant-jobs.json";
+import type { FestivalName, HolidayInput, ScatterInput } from '@zhin.js/kernel';
+import type { IMDeliveryTarget, SenderRole } from '@zhin.js/core';
+export declare const SCHEDULE_JOBS_VERSION = 1;
+export declare const SCHEDULE_JOBS_FILENAME = "schedule-jobs.json";
 export type JobSchedule = {
-    kind: 'cron';
-    expr: string;
+    kind: 'solar';
+    cron: string;
+    tz?: string;
+} | {
+    kind: 'lunar';
+    cron: string;
+    tz?: string;
+} | {
+    kind: 'workday';
+    cron: string;
+    tz?: string;
+} | {
+    kind: 'freeDay';
+    cron: string;
+    tz?: string;
+} | {
+    kind: 'holiday';
+    cron: string;
+    festivals?: FestivalName[] | 'all';
+    everyDayOfHoliday?: boolean;
+    tz?: string;
+} | {
+    kind: 'scatter';
+    input: ScatterInput;
     tz?: string;
 } | {
     kind: 'every';
@@ -30,11 +54,7 @@ export type JobAction = {
 };
 export type JobNotify = {
     channel: 'im';
-    platform?: string;
-    endpointId?: string;
-    senderId?: string;
-    sceneId?: string;
-    scope?: string;
+    target: IMDeliveryTarget;
 } | {
     channel: 'silent';
 } | {
@@ -45,31 +65,63 @@ export type JobNotify = {
     target?: string;
     data?: Record<string, unknown>;
 };
-export interface AssistantJobState {
+export interface ScheduleJobState {
     lastExecutedAt?: number;
     lastStatus?: 'ok' | 'error' | 'skipped';
     lastError?: string;
     nextRunAtMs?: number;
     retryCount?: number;
 }
-export interface AssistantJob {
+/** 调度任务创建者（对话内 schedule_add 等场景持久化，执行时还原 harness 角色） */
+export interface ScheduleJobCreator {
+    userId: string;
+    roles: readonly SenderRole[];
+    name?: string;
+}
+export interface ScheduleJob {
     id: string;
     label?: string;
     enabled: boolean;
     schedule: JobSchedule;
     action: JobAction;
     notify: JobNotify;
-    /** 失败时是否向 notify 通道发送错误摘要（默认跟随 assistant.defaults.notifyOnFailure） */
     notifyOnFailure?: boolean;
     createdAt: number;
     updatedAt: number;
-    state: AssistantJobState;
-    source?: 'cron' | 'scheduler' | 'manual' | 'event';
-    /** 事件载荷（M2 ingress 可选持久化） */
+    state: ScheduleJobState;
+    source?: 'schedule' | 'manual' | 'event' | 'profile';
+    /** 创建者身份（执行 agent / subagent 时用于 exec/file 策略） */
+    createdBy?: ScheduleJobCreator;
+    /** 预演确认后的执行计划（prompt / tools / skills） */
+    executionPlan?: ScheduleJobExecutionPlan;
+    /** 到点执行时是否向 IM 发送 activity feedback（reaction/typing），默认 false */
+    activityFeedback?: boolean;
     eventPayload?: unknown;
 }
-export interface AssistantJobFile {
+/** 预演后固化的调度路径 */
+export interface ScheduleJobExecutionPlan {
+    /** 到点实际使用的 prompt（可经预演 refine） */
+    prompt: string;
+    tools?: string[];
+    skills?: string[];
+    /** 预演样例输出（供创建者确认） */
+    previewSample?: string;
+    previewedAt?: number;
+    confirmed?: boolean;
+}
+/** @deprecated use ScheduleJob */
+export type AssistantJob = ScheduleJob;
+/** @deprecated */
+export type AssistantJobState = ScheduleJobState;
+/** @deprecated */
+export type AssistantJobFile = ScheduleJobFile;
+export interface ScheduleJobFile {
     version: number;
-    jobs: AssistantJob[];
+    jobs: ScheduleJob[];
 }
+/** @deprecated */
+export declare const ASSISTANT_JOBS_VERSION = 1;
+/** @deprecated */
+export declare const ASSISTANT_JOBS_FILENAME = "schedule-jobs.json";
+export type { HolidayInput, ScatterInput, FestivalName };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/assistant/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,SAAS,GACjB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9G;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,GACrB;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAExF,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnD,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/assistant/types.ts"],"names":[],"mappings":"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"}

package/lib/assistant/types.js

@@ -1,6 +1,7 @@
-/**
- * Assistant Runtime — 统一 Job 模型（M1）
- */
-export const ASSISTANT_JOBS_VERSION = 1;
-export const ASSISTANT_JOBS_FILENAME = 'assistant-jobs.json';
+export const SCHEDULE_JOBS_VERSION = 1;
+export const SCHEDULE_JOBS_FILENAME = 'schedule-jobs.json';
+/** @deprecated */
+export const ASSISTANT_JOBS_VERSION = SCHEDULE_JOBS_VERSION;
+/** @deprecated */
+export const ASSISTANT_JOBS_FILENAME = SCHEDULE_JOBS_FILENAME;
 //# sourceMappingURL=types.js.map

package/lib/assistant/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/assistant/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/assistant/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAoF3D,kBAAkB;AAClB,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC5D,kBAAkB;AAClB,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAC"}

package/lib/builtin/analyze-media-tool.d.ts

@@ -3,7 +3,7 @@ import { BuiltinBaseTool } from './builtin-base-tool.js';
 export declare const ANALYZE_MEDIA_PARAMETERS: ToolParametersSchema;
 export declare class AnalyzeMediaBuiltinTool extends BuiltinBaseTool {
     readonly name = "analyze_media";
-    readonly description = "\u5206\u6790\u672C\u5730\u56FE\u7247\u3001\u97F3\u9891\u6216\u89C6\u9891\u6587\u4EF6\uFF0C\u8FD4\u56DE\u53EF\u8BFB\u6458\u8981\uFF08\u8F6C\u5199/\u5C3A\u5BF8/\u683C\u5F0F\uFF09\uFF1B\u4E0D\u8981\u5BF9\u5A92\u4F53\u6587\u4EF6\u4F7F\u7528 read_file\u3002";
+    readonly description = "Analyze a local image, audio, or video file and return a readable summary (transcript/dimensions/format). Do not use read_file for media files.";
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     readonly kind = "file";
     constructor();

package/lib/builtin/analyze-media-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-media-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,kQACqC;IACzD,QAAQ,CAAC,UAAU,4CAA4B;IAC/C,QAAQ,CAAC,IAAI,UAAU;;IAQjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CA+DrF;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"analyze-media-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/analyze-media-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,qJACgI;IACpJ,QAAQ,CAAC,UAAU,4CAA4B;IAC/C,QAAQ,CAAC,IAAI,UAAU;;IAQjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CA+DrF;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/lib/builtin/analyze-media-tool.js

@@ -21,13 +21,13 @@ function isMediaPath(filePath) {
 export const ANALYZE_MEDIA_PARAMETERS = {
     type: 'object',
     properties: {
-        file_path: { type: 'string', description: '媒体文件路径（图片/音频/视频）' },
+        file_path: { type: 'string', description: 'Media file path (image/audio/video)' },
     },
     required: ['file_path'],
 };
 export class AnalyzeMediaBuiltinTool extends BuiltinBaseTool {
     name = 'analyze_media';
-    description = '分析本地图片、音频或视频文件，返回可读摘要（转写/尺寸/格式）；不要对媒体文件使用 read_file。';
+    description = 'Analyze a local image, audio, or video file and return a readable summary (transcript/dimensions/format). Do not use read_file for media files.';
     parameters = ANALYZE_MEDIA_PARAMETERS;
     kind = 'file';
     constructor() {