@roll-agent/runtime 0.22.0 → 0.23.0

package/dist/scheduler/trigger.d.ts

@@ -1,29 +1,187 @@
 import { z } from "zod";
 export declare const TRIGGER_KINDS: {
     readonly interval: "interval";
+    readonly calendar: "calendar";
 };
 export type TriggerKind = (typeof TRIGGER_KINDS)[keyof typeof TRIGGER_KINDS];
 export declare const intervalTriggerSchema: z.ZodObject<{
     kind: z.ZodLiteral<"interval">;
     everyMs: z.ZodNumber;
+    startAtMs: z.ZodOptional<z.ZodNumber>;
+    timeZone: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
 }, "strict", z.ZodTypeAny, {
     kind: "interval";
     everyMs: number;
+    timeZone?: string | undefined;
+    startAtMs?: number | undefined;
 }, {
     kind: "interval";
     everyMs: number;
+    timeZone?: string | undefined;
+    startAtMs?: number | undefined;
 }>;
 export declare const triggerSpecSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"interval">;
     everyMs: z.ZodNumber;
+    startAtMs: z.ZodOptional<z.ZodNumber>;
+    timeZone: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
 }, "strict", z.ZodTypeAny, {
     kind: "interval";
     everyMs: number;
+    timeZone?: string | undefined;
+    startAtMs?: number | undefined;
 }, {
     kind: "interval";
     everyMs: number;
+    timeZone?: string | undefined;
+    startAtMs?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"calendar">;
+    calendar: z.ZodDiscriminatedUnion<"frequency", [z.ZodObject<{
+        time: z.ZodString;
+        timeZone: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        frequency: z.ZodLiteral<"daily">;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        frequency: "daily";
+        timeZone: string;
+    }, {
+        time: string;
+        frequency: "daily";
+        timeZone: string;
+    }>, z.ZodObject<{
+        weekdays: z.ZodEffects<z.ZodArray<z.ZodNumber, "many">, number[], number[]>;
+        time: z.ZodString;
+        timeZone: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        frequency: z.ZodLiteral<"weekly">;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        frequency: "weekly";
+        timeZone: string;
+        weekdays: number[];
+    }, {
+        time: string;
+        frequency: "weekly";
+        timeZone: string;
+        weekdays: number[];
+    }>]>;
+    startAtMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    kind: "calendar";
+    calendar: {
+        time: string;
+        frequency: "daily";
+        timeZone: string;
+    } | {
+        time: string;
+        frequency: "weekly";
+        timeZone: string;
+        weekdays: number[];
+    };
+    startAtMs?: number | undefined;
+}, {
+    kind: "calendar";
+    calendar: {
+        time: string;
+        frequency: "daily";
+        timeZone: string;
+    } | {
+        time: string;
+        frequency: "weekly";
+        timeZone: string;
+        weekdays: number[];
+    };
+    startAtMs?: number | undefined;
 }>]>;
 export type TriggerSpec = z.infer<typeof triggerSpecSchema>;
+export declare const scheduleTimingInputSchema: z.ZodEffects<z.ZodObject<{
+    every: z.ZodOptional<z.ZodString>;
+    calendar: z.ZodOptional<z.ZodDiscriminatedUnion<"frequency", [z.ZodObject<{
+        time: z.ZodString;
+        frequency: z.ZodLiteral<"daily">;
+    } & {
+        timeZone: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    }, {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    }>, z.ZodObject<{
+        weekdays: z.ZodEffects<z.ZodArray<z.ZodNumber, "many">, number[], number[]>;
+        time: z.ZodString;
+        frequency: z.ZodLiteral<"weekly">;
+    } & {
+        timeZone: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    }, {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    }>]>>;
+    startAt: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    every?: string | undefined;
+    calendar?: {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    } | {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    } | undefined;
+    startAt?: string | undefined;
+}, {
+    every?: string | undefined;
+    calendar?: {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    } | {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    } | undefined;
+    startAt?: string | undefined;
+}>, {
+    every?: string | undefined;
+    calendar?: {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    } | {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    } | undefined;
+    startAt?: string | undefined;
+}, {
+    every?: string | undefined;
+    calendar?: {
+        time: string;
+        frequency: "daily";
+        timeZone?: string | undefined;
+    } | {
+        time: string;
+        frequency: "weekly";
+        weekdays: number[];
+        timeZone?: string | undefined;
+    } | undefined;
+    startAt?: string | undefined;
+}>;
+export type ScheduleTimingInput = z.input<typeof scheduleTimingInputSchema>;
+export declare function createScheduleTrigger(input: ScheduleTimingInput, nowMs?: number): TriggerSpec;
 export declare class ScheduleTriggerError extends Error {
     readonly code: "schedule_trigger_invalid";
     constructor(message: string);
@@ -32,7 +190,8 @@ export declare function formatDuration(ms: number): string;
 export declare function formatInterval(ms: number): string;
 export declare function parseIntervalText(text: string): number;
 export declare function parseMaxRunText(text: string): number;
-export declare function createIntervalTrigger(text: string): TriggerSpec;
+export declare function createIntervalTrigger(text: string): z.infer<typeof intervalTriggerSchema>;
 export declare function describeTrigger(trigger: TriggerSpec): string;
 export declare function computeNextRunAtMs(trigger: TriggerSpec, nowMs: number): number;
+export declare function computeFirstRunAtMs(trigger: TriggerSpec, nowMs: number): number;
 export declare function parseTriggerJson(json: string): TriggerSpec;

package/dist/scheduler/trigger.js

@@ -1 +1 @@
-import{z as r}from"zod";import{SCHEDULER_LIMITS as e}from"./limits.js";export const TRIGGER_KINDS={interval:"interval"};export const intervalTriggerSchema=r.object({kind:r.literal(TRIGGER_KINDS.interval),everyMs:r.number().int().min(e.minIntervalMs).max(e.maxIntervalMs)}).strict();export const triggerSpecSchema=r.discriminatedUnion("kind",[intervalTriggerSchema]);export class ScheduleTriggerError extends Error{code="schedule_trigger_invalid";constructor(r){super(r),this.name="ScheduleTriggerError"}}const t={s:1e3,m:6e4,h:36e5,d:864e5},n=/^(\d{1,9})([smhd])$/u;function i(r){return Object.hasOwn(t,r)}export function formatDuration(r){return r%t.d===0?`${String(r/t.d)} 天`:r%t.h===0?`${String(r/t.h)} 小时`:r%t.m===0?`${String(r/t.m)} 分钟`:`${String(Math.round(r/t.s))} 秒`}export function formatInterval(r){return`每 ${formatDuration(r)}`}function o(r,e){const o=r.trim(),a=n.exec(o),s=a?.[1],c=a?.[2];if(void 0===s||void 0===c||!i(c))throw new ScheduleTriggerError(`无法识别的${e.label} "${o}"：格式为 <数字><s|m|h|d>，例如 30m、2h、1d`);const u=Number.parseInt(s,10);if(u<=0)throw new ScheduleTriggerError(`${e.label}必须大于 0`);const g=u*t[c];if(g<e.minMs)throw new ScheduleTriggerError(`${e.label}不能小于 ${String(e.minMs/t.s)} 秒（收到 ${o}）`);if(g>e.maxMs)throw new ScheduleTriggerError(`${e.label}不能大于 ${formatDuration(e.maxMs)}（收到 ${o}）`);return g}export function parseIntervalText(r){return o(r,{label:"间隔",minMs:e.minIntervalMs,maxMs:e.maxIntervalMs})}export function parseMaxRunText(r){return o(r,{label:"单次运行上限",minMs:e.minMaxRunMs,maxMs:e.maxRunCeilingMs})}export function createIntervalTrigger(r){return{kind:TRIGGER_KINDS.interval,everyMs:parseIntervalText(r)}}export function describeTrigger(r){return formatInterval(r.everyMs)}export function computeNextRunAtMs(r,e){return e+r.everyMs}export function parseTriggerJson(r){let e;try{e=JSON.parse(r)}catch{throw new ScheduleTriggerError("trigger 不是合法 JSON")}const t=triggerSpecSchema.safeParse(e);if(!t.success)throw new ScheduleTriggerError(`trigger 不合法：${t.error.issues[0]?.message??"unknown"}`);return t.data}
+import{z as r}from"zod";import{SCHEDULER_LIMITS as e}from"./limits.js";import{calendarScheduleSchema as t,calendarScheduleInputSchema as n,describeCalendar as a,nextCalendarRunAtMs as i,parseLocalStartAt as s,systemTimeZone as o,timeZoneSchema as c}from"./calendar.js";export const TRIGGER_KINDS={interval:"interval",calendar:"calendar"};export const intervalTriggerSchema=r.object({kind:r.literal(TRIGGER_KINDS.interval),everyMs:r.number().int().min(e.minIntervalMs).max(e.maxIntervalMs),startAtMs:r.number().int().min(0).max(2534022144e5).optional(),timeZone:c.optional()}).strict();const l=r.object({kind:r.literal(TRIGGER_KINDS.calendar),calendar:t,startAtMs:r.number().int().min(0).max(2534022144e5).optional()}).strict();export const triggerSpecSchema=r.discriminatedUnion("kind",[intervalTriggerSchema,l]);export const scheduleTimingInputSchema=r.object({every:r.string().trim().min(1).optional(),calendar:n.optional(),startAt:r.string().trim().min(1).optional()}).strict().refine(r=>void 0===r.every!=(void 0===r.calendar),{message:"every 与 calendar 必须且只能提供一个"});export function createScheduleTrigger(e,t=Date.now()){const n=scheduleTimingInputSchema.safeParse(e);if(!n.success)throw new ScheduleTriggerError(n.error.issues[0]?.message??"定时参数无效");const a=n.data,i=a.calendar?.timeZone??o();let c;if(void 0!==a.startAt){try{c=/(?:Z|[+-]\d{2}:\d{2})$/u.test(a.startAt)?Date.parse(r.string().datetime({offset:!0}).parse(a.startAt)):s(a.startAt,i)}catch(r){throw new ScheduleTriggerError(`startAt 无效：${r instanceof Error?r.message:String(r)}`)}if(!Number.isFinite(c)||c<=t)throw new ScheduleTriggerError("startAt 必须是未来时间")}const l=void 0===c?{}:{startAtMs:c},m=void 0!==a.calendar?{kind:TRIGGER_KINDS.calendar,calendar:{...a.calendar,timeZone:i},...l}:{...createIntervalTrigger(a.every??""),...l,...void 0===c?{}:{timeZone:i}},d=triggerSpecSchema.safeParse(m);if(!d.success)throw new ScheduleTriggerError(d.error.issues[0]?.message??"定时参数无效");return d.data}export class ScheduleTriggerError extends Error{code="schedule_trigger_invalid";constructor(r){super(r),this.name="ScheduleTriggerError"}}const m={s:1e3,m:6e4,h:36e5,d:864e5},d=/^(\d{1,9})([smhd])$/u;function u(r){return Object.hasOwn(m,r)}export function formatDuration(r){return r%m.d===0?`${String(r/m.d)} 天`:r%m.h===0?`${String(r/m.h)} 小时`:r%m.m===0?`${String(r/m.m)} 分钟`:`${String(Math.round(r/m.s))} 秒`}export function formatInterval(r){return`每 ${formatDuration(r)}`}function g(r,e){const t=r.trim(),n=d.exec(t),a=n?.[1],i=n?.[2];if(void 0===a||void 0===i||!u(i))throw new ScheduleTriggerError(`无法识别的${e.label} "${t}"：格式为 <数字><s|m|h|d>，例如 30m、2h、1d`);const s=Number.parseInt(a,10);if(s<=0)throw new ScheduleTriggerError(`${e.label}必须大于 0`);const o=s*m[i];if(o<e.minMs)throw new ScheduleTriggerError(`${e.label}不能小于 ${String(e.minMs/m.s)} 秒（收到 ${t}）`);if(o>e.maxMs)throw new ScheduleTriggerError(`${e.label}不能大于 ${formatDuration(e.maxMs)}（收到 ${t}）`);return o}export function parseIntervalText(r){return g(r,{label:"间隔",minMs:e.minIntervalMs,maxMs:e.maxIntervalMs})}export function parseMaxRunText(r){return g(r,{label:"单次运行上限",minMs:e.minMaxRunMs,maxMs:e.maxRunCeilingMs})}export function createIntervalTrigger(r){return{kind:TRIGGER_KINDS.interval,everyMs:parseIntervalText(r)}}export function describeTrigger(r){const e=r.kind===TRIGGER_KINDS.interval?formatInterval(r.everyMs):a(r.calendar);if(void 0===r.startAtMs)return e;const t=r.kind===TRIGGER_KINDS.calendar?r.calendar.timeZone:r.timeZone??"UTC";return`${e}，从 ${new Date(r.startAtMs).toLocaleString("zh-CN",{timeZone:t,hour12:!1})}（${t}）开始`}export function computeNextRunAtMs(r,e){return r.kind===TRIGGER_KINDS.interval?Math.max(e+r.everyMs,r.startAtMs??-1/0):i(r.calendar,Math.max(e,(r.startAtMs??0)-1))}export function computeFirstRunAtMs(r,e){if(void 0!==r.startAtMs&&r.startAtMs<=e)throw new ScheduleTriggerError("startAt 必须是未来时间；开始时间已过，请重新创建");return r.kind===TRIGGER_KINDS.interval&&void 0!==r.startAtMs?r.startAtMs:computeNextRunAtMs(r,e)}export function parseTriggerJson(r){let e;try{e=JSON.parse(r)}catch{throw new ScheduleTriggerError("trigger 不是合法 JSON")}const t=triggerSpecSchema.safeParse(e);if(!t.success)throw new ScheduleTriggerError(`trigger 不合法（${t.error.issues[0]?.path.join(".")??""}）：${t.error.issues[0]?.message??"unknown"}`);return t.data}

package/dist/scheduler/types.d.ts

@@ -193,6 +193,8 @@ export interface CreateScheduleInput {
     readonly cwd: string;
     readonly trigger: TriggerSpec;
     readonly fireImmediately?: boolean;
+    /** Approval snapshot, checked atomically when inserting a new schedule. */
+    readonly expectedFirstRunAtMs?: number;
     readonly authorityDigest?: string;
     readonly maxRunMs?: number;
     readonly maxRounds?: number;

package/dist/tool-bridge/invalid-schedule-retry.d.ts

@@ -0,0 +1,6 @@
+import type { StopCondition, ToolSet } from "ai";
+/** Local to one inference sequence; never blocks repaired inputs or future user turns. */
+export declare function createInvalidScheduleRetryGuard(): {
+    stop: StopCondition<ToolSet>;
+    readonly message: string | undefined;
+};

package/dist/tool-bridge/invalid-schedule-retry.js

@@ -0,0 +1 @@
+import{isDeepStrictEqual as o}from"node:util";import{readToolOutcome as t,TOOL_OUTCOME_KINDS as e}from"./normalize-result.js";import{SCHEDULE_CREATE_TOOL_ID as r}from"./schedule-tool.js";export function createInvalidScheduleRetryGuard(){let n;return{stop:({steps:l})=>{const i=[];for(const u of l)for(const l of u.toolCalls){if(l.toolName!==r)continue;const s=u.toolResults.find(o=>o.toolCallId===l.toolCallId);if(!0===l.invalid||void 0!==s&&t(s.output).kind===e.invalidInput){if(i.some(t=>o(t,l.input)))return n="定时任务参数连续重复出错，已停止本轮自动重试。请按错误提示修正 recurrence；若只指定了开始时间和总轮数，请补充两轮间隔。此前已成功执行的其他操作不会回滚。",!0;i.push(l.input)}}return!1},get message(){return n}}}

package/dist/tool-bridge/schedule-create-input.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import type { ScheduleToolCreateRequest } from "@roll-agent/core/scheduler-host/schedule-tool-binding";
+/** Provider strict mode requires every property; null represents only declared defaults. */
+export declare const scheduleCreateInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodString;
+    recurrence: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"interval">;
+        every: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        every: string;
+        kind: "interval";
+    }, {
+        every: string;
+        kind: "interval";
+    }>, z.ZodObject<{
+        time: z.ZodString;
+    } & {
+        kind: z.ZodLiteral<"daily">;
+        timeZone: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        kind: "daily";
+        timeZone: string | null;
+    }, {
+        time: string;
+        kind: "daily";
+        timeZone: string | null;
+    }>, z.ZodObject<{
+        time: z.ZodString;
+        weekdays: z.ZodEffects<z.ZodArray<z.ZodNumber, "many">, number[], number[]>;
+    } & {
+        kind: z.ZodLiteral<"weekly">;
+        timeZone: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        time: string;
+        kind: "weekly";
+        timeZone: string | null;
+        weekdays: number[];
+    }, {
+        time: string;
+        kind: "weekly";
+        timeZone: string | null;
+        weekdays: number[];
+    }>]>;
+    startAt: z.ZodNullable<z.ZodString>;
+    cwd: z.ZodNullable<z.ZodString>;
+    rounds: z.ZodNullable<z.ZodNumber>;
+    maxRun: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    prompt: string;
+    cwd: string | null;
+    startAt: string | null;
+    maxRun: string | null;
+    rounds: number | null;
+    recurrence: {
+        every: string;
+        kind: "interval";
+    } | {
+        time: string;
+        kind: "daily";
+        timeZone: string | null;
+    } | {
+        time: string;
+        kind: "weekly";
+        timeZone: string | null;
+        weekdays: number[];
+    };
+}, {
+    name: string;
+    prompt: string;
+    cwd: string | null;
+    startAt: string | null;
+    maxRun: string | null;
+    rounds: number | null;
+    recurrence: {
+        every: string;
+        kind: "interval";
+    } | {
+        time: string;
+        kind: "daily";
+        timeZone: string | null;
+    } | {
+        time: string;
+        kind: "weekly";
+        timeZone: string | null;
+        weekdays: number[];
+    };
+}>;
+export declare function toScheduleCreateRequest(input: z.output<typeof scheduleCreateInputSchema>): ScheduleToolCreateRequest;

package/dist/tool-bridge/schedule-create-input.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{calendarScheduleSchema as n,timeZoneSchema as t}from"../scheduler/calendar.js";const r=e.object({kind:e.literal("interval"),every:e.string().trim().min(1).describe("两轮间隔，如 1m、30m（60s..365d）；用户未指定时先询问，不能猜测")}).strict(),i=n.options[0].omit({frequency:!0}).extend({kind:e.literal("daily"),timeZone:t.nullable().describe("IANA 时区；null 使用并保存运行 Roll 的机器时区")}),l=n.options[1].omit({frequency:!0}).extend({kind:e.literal("weekly"),timeZone:i.shape.timeZone});export const scheduleCreateInputSchema=e.object({name:e.string().trim().min(1).max(120).describe("任务名称"),prompt:e.string().trim().min(1).max(4e3).describe("每轮执行的工作；不要把触发时间或停止条件只写在 prompt 中"),recurrence:e.discriminatedUnion("kind",[r,i,l]).describe("重复规则：interval=固定间隔，daily=每天，weekly=每周。今天/明天某时只指定 startAt，不代表 daily。缺少两轮间隔时先询问用户"),startAt:e.string().trim().min(1).nullable().describe("未来开始时间 YYYY-MM-DDTHH:mm 或带偏移 ISO；null 不指定。interval 首轮在此时执行，daily/weekly 在此时起找匹配日期；不是重复规则"),cwd:e.string().nullable().describe("执行工作目录；null 使用当前会话目录"),rounds:e.number().int().positive().max(Number.MAX_SAFE_INTEGER).nullable().describe("总自动轮数；null 不限。失败、取消、空结果占轮数；同轮重试和手动运行不额外计数"),maxRun:e.string().nullable().describe("单轮时长上限，如 1h（60s..24h）；null 使用默认 1 小时")}).strict();export function toScheduleCreateRequest(e){const{recurrence:n,startAt:t,cwd:r,rounds:i,maxRun:l,name:m,prompt:a}=e,s={name:m,prompt:a,...null===t?{}:{startAt:t},...null===r?{}:{cwd:r},...null===i?{}:{rounds:i},...null===l?{}:{maxRun:l}};if("interval"===n.kind)return{...s,every:n.every};const d={time:n.time,...null===n.timeZone?{}:{timeZone:n.timeZone}};return{...s,calendar:"daily"===n.kind?{frequency:"daily",...d}:{frequency:"weekly",...d,weekdays:n.weekdays}}}

package/dist/tool-bridge/schedule-tool.js

@@ -1 +1 @@
-import{tool as e}from"ai";import{z as t}from"zod";import{buildScheduleExtendTools as r}from"./schedule-extend-tool.js";import{SCHEDULE_STATUSES as n}from"../scheduler/types.js";import{gateToolCall as o}from"./build-tools.js";import{TOOL_OUTCOME_KINDS as s,failedToolResult as i,successfulToolResult as a,toolResultToModelOutput as u}from"./normalize-result.js";import{TOOL_RESOURCE_ACCESS_MODES as l,executeCoordinatedTool as d}from"./tool-execution-coordinator.js";export const SCHEDULE_TOOL_AGENT_NAME="roll";export const SCHEDULE_CREATE_TOOL_NAME="schedule_create";export const SCHEDULE_LIST_TOOL_NAME="schedule_list";export const SCHEDULE_CREATE_TOOL_ID="roll__schedule_create";export const SCHEDULE_LIST_TOOL_ID="roll__schedule_list";const c=t.object({name:t.string().trim().min(1).max(120).describe("任务名称（确认界面与任务列表中展示）"),prompt:t.string().trim().min(1).max(4e3).describe("每次触发时交给新一轮 chat 的任务描述，写清要做什么"),every:t.string().trim().min(1).describe("触发间隔，格式 <数字><s|m|h|d>，如 30m、2h、1d（最短 60s，最长 365d）"),cwd:t.string().optional().describe("任务运行的工作目录；省略时使用当前会话工作目录，相对路径相对会话目录解析"),rounds:t.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional().describe("最多自动执行轮数；省略不限轮数。重试和手动运行不额外计数"),maxRun:t.string().optional().describe("单次运行时长上限，格式同 every（60s..24h；省略时默认 1 小时）")}),m=t.object({status:t.enum(["all",...Object.values(n)]).optional().describe("按状态过滤，省略时返回全部"),offset:t.number().int().min(0).optional().describe("分页偏移，默认 0"),limit:t.number().int().min(1).max(100).optional().describe("最多返回条数，默认 50")}),p=Symbol("schedule-invalid-input");function g(e){return"object"==typeof e&&null!==e&&e.kind===p}function $(e){return"object"==typeof e&&null!==e&&!1===e.ok}function f(e){const t="invalid_input"===e.code||"schedule_invalid"===e.code||"schedule_trigger_invalid"===e.code?s.invalidInput:s.toolFailed;return i(t,e.message,{raw:e})}function _(e){return 0===e.warnings.length?"":`\n${e.warnings.map(e=>`注意：${e.message}。`).join("\n")}`}function h(e){return{name:e.name,prompt:e.prompt,every:e.everyDisplay,cwd:e.cwd,maxRun:e.maxRunDisplay,firstRunAt:x(e.firstRunAt),rounds:void 0===e.maxRounds?"不限轮数":`最多自动执行 ${String(e.maxRounds)} 轮`,lifecycle:void 0===e.maxRounds?"会持续运行，直到暂停或删除；创建时记录当前权限边界":"达到轮数上限后，最后一轮执行、重试及清场结算完毕自动结束；创建时记录当前权限边界",...e.readiness.warnings.length>0?{serviceStatus:e.readiness.warnings.map(e=>e.message).join("；")}:{}}}function x(e){const t=new Date(e);return Number.isNaN(t.getTime())?e:t.toLocaleString()}export function buildScheduleToolset(t,n,y){const v=t.includeCreate??!0,E=v?n.register("roll","schedule_create"):void 0,b=n.register("roll","schedule_list"),S={captureExecutionState:e=>{const r=c.safeParse(e);return r.success?t.port.captureCreate(r.data,t.sessionCwd):{kind:p,message:`参数校验失败: ${r.error.issues.map(e=>e.message).join("; ")}`}},prepare:async(e,t)=>{if(g(t))return i(s.invalidInput,t.message);if($(t))return f(t);const r=t;return o(y,"roll","schedule_create",h(r),void 0,{explanation:`将登记定时任务「${r.name}」（${r.everyDisplay}）`})},resources:()=>[{key:"schedule-ledger",mode:l.write}]};void 0!==E&&y.coordinator?.register(E,S);const R={prepare:async e=>o(y,"roll","schedule_list",e??{},{readOnlyHint:!0}),resources:()=>[{key:"schedule-ledger",mode:l.read}]};y.coordinator?.register(b,R);const w=void 0===E?{}:{[E]:e({description:"登记一个按固定间隔重复运行的定时任务：到点后由 roll 调度器发起新一轮无人值守 chat 执行 prompt。创建前会向用户展示完整参数并请求确认，不要在调用前重复询问。可用 rounds 限制自动执行轮数，省略不限轮数。仅支持固定间隔（every），不支持一次性时间点、cron 表达式或时区。",inputSchema:c,toModelOutput:({output:e})=>u(e),execute:async(e,r)=>d(y.coordinator,S,E,r.toolCallId,e,r.abortSignal,async e=>{if(g(e))return i(s.invalidInput,e.message);if($(e))return f(e);const r=e,n=await t.port.create(r);if($(n))return f(n);const o=n.schedule,u=n.created?`已登记定时任务 "${o.name}"（${o.trigger.display}，单次上限 ${o.maxRun.display}）。`:n.reauthorized?`已存在相同定义的任务 "${o.name}"（id ${o.id}），未重复创建；已按当前权限边界重新授权。`:`已存在相同定义的任务 "${o.name}"（id ${o.id}），未重复创建。`,l=void 0===o.nextRunAt?"":`下次运行约 ${x(o.nextRunAt)}。`,d=_(n.readiness)||(n.readiness.automaticRunsReady?"":"\n注意：调度服务未就绪，任务不会自动执行。");return a(`${u}${null===o.rounds.max?"":`最多自动执行 ${String(o.rounds.max)} 轮。`}${o.roundsDisplay}。${l}${d}`,{raw:n})})})},T={[b]:e({description:"列出当前配置下已登记的定时任务（含状态、频率、下次运行时间与最近错误摘要）。创建前可用它确认是否已有同类任务。",inputSchema:m,toModelOutput:({output:e})=>u(e),execute:async(e,r)=>d(y.coordinator,R,b,r.toolCallId,e,r.abortSignal,async()=>{const r=m.safeParse(e??{});if(!r.success)return i(s.invalidInput,`参数校验失败: ${r.error.issues.map(e=>e.message).join("; ")}`);const n=await t.port.list(r.data,t.sessionCwd);if($(n))return f(n);if(0===n.total)return a(`暂无定时任务。${_(n.readiness)}`.trim(),{raw:n});const o=n.schedules.map(e=>{const t="active"===e.status&&void 0!==e.nextRunAt?`，下次 ${x(e.nextRunAt)}`:"",r=void 0===e.lastError?"":`，最近错误：${e.lastError}`;return`- ${e.name}（${e.status}，${e.trigger}，${e.roundsDisplay}${t}）id=${e.id}\n  内容：${e.promptExcerpt}${r}`}),u=n.hasMore?`\n共 ${String(n.total)} 个，仅显示 ${String(n.schedules.length)} 个；用 offset/limit 翻页。`:"";return a(`${o.join("\n")}${u}${_(n.readiness)}`,{raw:n})})})};return{createTools:w,extendTools:v?r(t,n,y):{},listTools:T}}
+import{tool as e}from"ai";import{z as t}from"zod";import{buildScheduleExtendTools as r}from"./schedule-extend-tool.js";import{SCHEDULE_STATUSES as n}from"../scheduler/types.js";import{systemTimeZone as i}from"../scheduler/calendar.js";import{computeNextRunAtMs as o}from"../scheduler/trigger.js";import{scheduleCreateInputSchema as s,toScheduleCreateRequest as a}from"./schedule-create-input.js";import{gateToolCall as u}from"./build-tools.js";import{TOOL_OUTCOME_KINDS as c,failedToolResult as l,successfulToolResult as d,toolResultToModelOutput as m}from"./normalize-result.js";import{TOOL_RESOURCE_ACCESS_MODES as p,executeCoordinatedTool as g}from"./tool-execution-coordinator.js";export const SCHEDULE_TOOL_AGENT_NAME="roll";export const SCHEDULE_CREATE_TOOL_NAME="schedule_create";export const SCHEDULE_LIST_TOOL_NAME="schedule_list";export const SCHEDULE_CREATE_TOOL_ID="roll__schedule_create";export const SCHEDULE_LIST_TOOL_ID="roll__schedule_list";const $=t.object({status:t.enum(["all",...Object.values(n)]).optional().describe("按状态过滤，省略时返回全部"),offset:t.number().int().min(0).optional().describe("分页偏移，默认 0"),limit:t.number().int().min(1).max(100).optional().describe("最多返回条数，默认 50")}),f=Symbol("schedule-invalid-input");function h(e){return"object"==typeof e&&null!==e&&e.kind===f}function _(e){return"object"==typeof e&&null!==e&&!1===e.ok}function x(e){const t="invalid_input"===e.code||"schedule_invalid"===e.code||"schedule_trigger_invalid"===e.code?c.invalidInput:c.toolFailed;return l(t,e.message,{raw:e})}function y(e){return 0===e.warnings.length?"":`\n${e.warnings.map(e=>`注意：${e.message}。`).join("\n")}`}function v(e){const t="calendar"===e.trigger.kind?e.trigger.calendar.timeZone:e.trigger.timeZone??i();return{name:e.name,prompt:e.prompt,every:e.everyDisplay,recurrence:e.everyDisplay,cwd:e.cwd,maxRun:e.maxRunDisplay,firstRunAt:E(e.firstRunAt,t),firstRunAtIso:e.firstRunAt,timeZone:t,...1===e.maxRounds?{}:{nextRunAtEstimate:E(new Date(o(e.trigger,Date.parse(e.firstRunAt))).toISOString(),t)},timingSemantics:"interval"===e.trigger.kind?"第二轮时间仅为预计；按每轮实际领取时间加间隔计算，延迟领取时顺延，不固定每天执行":"按保存的时区和日历规则匹配；跳时日期跳过，重复钟点仅执行较早一次",rounds:void 0===e.maxRounds?"不限轮数":`最多自动执行 ${String(e.maxRounds)} 轮`,lifecycle:void 0===e.maxRounds?"会持续运行，直到暂停或删除；创建时记录当前权限边界":"达到轮数上限后，最后一轮执行、重试及清场结算完毕自动结束；创建时记录当前权限边界",...e.readiness.warnings.length>0?{serviceStatus:e.readiness.warnings.map(e=>e.message).join("；")}:{}}}function E(e,t=i()){const r=new Date(e);return Number.isNaN(r.getTime())?e:r.toLocaleString("zh-CN",{timeZone:t,hour12:!1})}export function buildScheduleToolset(t,n,o){const S=t.includeCreate??!0,R=S?n.register("roll","schedule_create"):void 0,j=n.register("roll","schedule_list"),A={captureExecutionState:e=>{const r=s.safeParse(e);return r.success?t.port.captureCreate(a(r.data),t.sessionCwd):{kind:f,message:`参数校验失败: ${r.error.issues.map(e=>`${e.path.join(".")||"input"}: ${e.message}`).join("; ")}。使用唯一 recurrence 分支；今天/明天某时填写 startAt，缺少两轮间隔先询问用户。缺省字段填写 null。不要原样重试相同参数。`}},prepare:async(e,t)=>{if(h(t))return l(c.invalidInput,t.message);if(_(t))return x(t);const r=t;return u(o,"roll","schedule_create",v(r),void 0,{explanation:`将登记定时任务「${r.name}」（${r.everyDisplay}）`})},resources:()=>[{key:"schedule-ledger",mode:p.write}]};void 0!==R&&o.coordinator?.register(R,A);const w={prepare:async e=>u(o,"roll","schedule_list",e??{},{readOnlyHint:!0}),resources:()=>[{key:"schedule-ledger",mode:p.read}]};o.coordinator?.register(j,w);const D=void 0===R?{}:{[R]:e({description:"登记定时任务，每轮无人值守 chat 执行 prompt。startAt=开始时间，recurrence=重复规则，rounds=总轮数，三个维度独立。今天/明天某时不是 daily；缺少两轮间隔先澄清，不能猜成每天一次。信息齐全后只做工具自带的完整参数确认，不重复口头确认。可选值用 null 表示缺省。不支持 cron 或每天开启一组多轮循环。",inputSchema:s,strict:!0,toModelOutput:({output:e})=>m(e),execute:async(e,r)=>g(o.coordinator,A,R,r.toolCallId,e,r.abortSignal,async e=>{if(h(e))return l(c.invalidInput,e.message);if(_(e))return x(e);const r=e,n=await t.port.create(r);if(_(n))return x(n);const o=n.schedule,s="calendar"===o.trigger.spec?.kind?o.trigger.spec.calendar.timeZone:o.trigger.spec?.timeZone??i(),a=n.created?`已登记定时任务 "${o.name}"（${o.trigger.display}，单次上限 ${o.maxRun.display}）。`:n.reauthorized?`已存在相同定义的任务 "${o.name}"（id ${o.id}），未重复创建；已按当前权限边界重新授权。`:`已存在相同定义的任务 "${o.name}"（id ${o.id}），未重复创建。`,u=void 0===o.nextRunAt?"":`下次运行约 ${E(o.nextRunAt,s)}（${s}）。`,m=y(n.readiness)||(n.readiness.automaticRunsReady?"":"\n注意：调度服务未就绪，任务不会自动执行。");return d(`${a}${null===o.rounds.max?"":`最多自动执行 ${String(o.rounds.max)} 轮。`}${o.roundsDisplay}。${u}${m}`,{raw:n})})})},b={[j]:e({description:"列出当前配置下已登记的定时任务（含状态、频率、下次运行时间与最近错误摘要）。创建前可用它确认是否已有同类任务。",inputSchema:$,toModelOutput:({output:e})=>m(e),execute:async(e,r)=>g(o.coordinator,w,j,r.toolCallId,e,r.abortSignal,async()=>{const r=$.safeParse(e??{});if(!r.success)return l(c.invalidInput,`参数校验失败: ${r.error.issues.map(e=>e.message).join("; ")}`);const n=await t.port.list(r.data,t.sessionCwd);if(_(n))return x(n);if(0===n.total)return d(`暂无定时任务。${y(n.readiness)}`.trim(),{raw:n});const o=n.schedules.map(e=>{const t="active"===e.status&&void 0!==e.nextRunAt?`，下次 ${E(e.nextRunAt,e.timeZone)}（${e.timeZone??i()}）`:"",r=void 0===e.lastError?"":`，最近错误：${e.lastError}`;return`- ${e.name}（${e.status}，${e.trigger}，${e.roundsDisplay}${t}）id=${e.id}\n  内容：${e.promptExcerpt}${r}`}),s=n.hasMore?`\n共 ${String(n.total)} 个，仅显示 ${String(n.schedules.length)} 个；用 offset/limit 翻页。`:"";return d(`${o.join("\n")}${s}${y(n.readiness)}`,{raw:n})})})};return{createTools:D,extendTools:S?r(t,n,o):{},listTools:b}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/runtime",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@roll-agent/core": "0.39.0",
+    "@roll-agent/core": "0.40.0",
     "@types/node": "^22.0.0"
   },
   "scripts": {