@zhin.js/plugin-calendar 0.1.15 → 0.1.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-calendar",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "CalDAV / Google / Microsoft calendar tools for Zhin Agent",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,34 +40,29 @@
     "url": "https://github.com/lc-cn"
   },
   "dependencies": {
-    "@zhin.js/console-contract": "1.1.5",
-    "@zhin.js/host-http": "1.1.17",
-    "@zhin.js/im-contract": "1.1.13",
-    "@zhin.js/page": "1.1.17",
-    "@zhin.js/skill": "1.1.16",
-    "@zhin.js/tool": "1.1.18"
+    "zod": "^4.6.7",
+    "@zhin.js/console-contract": "1.1.6",
+    "@zhin.js/host-http": "1.2.0",
+    "@zhin.js/page": "1.1.18",
+    "@zhin.js/skill": "1.1.17",
+    "@zhin.js/tool": "1.1.19"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zod": "^4.4.3",
-    "@zhin.js/command": "1.1.17",
-    "zhin.js": "1.1.24"
+    "@zhin.js/command": "1.2.0",
+    "zhin.js": "1.1.26"
   },
   "peerDependencies": {
-    "zod": "^4.0.0",
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/page": "^1.1.17",
-    "@zhin.js/skill": "^1.1.16",
-    "@zhin.js/tool": "^1.1.18",
-    "zhin.js": "^1.1.24"
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/page": "^1.1.18",
+    "@zhin.js/skill": "^1.1.17",
+    "@zhin.js/tool": "^1.1.19",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
       "optional": true
-    },
-    "zod": {
-      "optional": true
     }
   },
   "repository": {
@@ -110,6 +105,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "clean": "rimraf lib",
     "check": "tsc -p tsconfig.check.json",
     "test": "vitest run --root ../../.. plugins/utils/calendar/tests",
     "auth": "tsx src/cli/auth.ts"

package/pages/index/index.js

@@ -1,5 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
+import { definePage, definePageBlueprint } from '@zhin.js/console-contract';
 export const meta = definePage({
     title: '日历日程',
     titleI18n: { en: 'Calendar' },
@@ -7,11 +7,11 @@ export const meta = definePage({
     order: 53,
     requiredPermissions: ['calendar:read'],
 });
-export default createDeclarativePage({
+export default definePageBlueprint({
     title: { zh: '日历日程', en: 'Calendar' },
     description: {
-        zh: '查看日历后端连接状态、时区与工作时间范围',
-        en: 'View calendar provider status, timezone, and working hours configuration',
+        zh: '查看日历后端连接状态、时区与工作时间范围，并在线新建或管理日程',
+        en: 'View calendar provider status, timezone, and working hours configuration, and create or manage events',
     },
     dictionary: {
         '已就绪': 'Ready',
@@ -59,7 +59,75 @@ export default createDeclarativePage({
             value: 'workingHours',
         },
     ],
+    actions: [
+        {
+            name: 'create',
+            label: { zh: '新建日程', en: 'Create Event' },
+            variant: 'primary',
+            fields: [
+                {
+                    key: 'title',
+                    label: { zh: '日程标题', en: 'Event Title' },
+                    type: 'text',
+                    required: true,
+                },
+                {
+                    key: 'date',
+                    label: { zh: '日期 YYYY-MM-DD', en: 'Date (YYYY-MM-DD)' },
+                    type: 'text',
+                    required: true,
+                    placeholder: '2026-11-08',
+                },
+                {
+                    key: 'time',
+                    label: { zh: '时间 HH:mm', en: 'Time (HH:mm)' },
+                    type: 'text',
+                    defaultValue: '09:00',
+                },
+                {
+                    key: 'repeat',
+                    label: { zh: '重复周期', en: 'Repeat' },
+                    type: 'select',
+                    defaultValue: 'none',
+                    options: [
+                        { value: 'none', label: { zh: '不重复 (none)', en: 'None' } },
+                        { value: 'daily', label: { zh: '每天 (daily)', en: 'Daily' } },
+                        { value: 'weekly', label: { zh: '每周 (weekly)', en: 'Weekly' } },
+                        { value: 'monthly', label: { zh: '每月 (monthly)', en: 'Monthly' } },
+                        { value: 'yearly', label: { zh: '每年 (yearly)', en: 'Yearly' } },
+                    ],
+                },
+            ],
+        },
+        {
+            name: 'delete',
+            label: { zh: '删除日程', en: 'Delete Event' },
+            variant: 'danger',
+            fields: [
+                {
+                    key: 'id',
+                    label: { zh: '日程 ID', en: 'Event ID' },
+                    type: 'text',
+                    required: true,
+                },
+            ],
+        },
+    ],
     sections: [
+        {
+            id: 'events',
+            layout: 'table',
+            title: { zh: '日程列表', en: 'Calendar Events' },
+            emptyText: { zh: '暂无日程记录', en: 'No calendar events yet' },
+            items: 'events',
+            columns: [
+                { key: 'id', label: { zh: 'ID', en: 'ID' } },
+                { key: 'title', label: { zh: '日程标题', en: 'Title' } },
+                { key: 'date', label: { zh: '日期', en: 'Date' } },
+                { key: 'time', label: { zh: '时间', en: 'Time' } },
+                { key: 'repeat', label: { zh: '重复', en: 'Repeat' } },
+            ],
+        },
         {
             id: 'overview',
             title: { zh: '配置概览', en: 'Configuration Overview' },

package/pages/index/index.ts

@@ -1,4 +1,5 @@
-import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
+import { definePage, definePageBlueprint } from '@zhin.js/console-contract';
+import type { CalendarConsoleEventItem } from '../../plugin.js';
 
 export interface CalendarConsoleStatus {
   readonly provider: 'none' | 'google' | 'microsoft' | 'caldav';
@@ -6,6 +7,8 @@ export interface CalendarConsoleStatus {
   readonly ready: boolean;
   readonly oauthCallbackPath: string;
   readonly workingHours: string;
+  readonly eventCount?: number;
+  readonly events?: readonly CalendarConsoleEventItem[];
 }
 
 export const meta = definePage({
@@ -16,11 +19,11 @@ export const meta = definePage({
   requiredPermissions: ['calendar:read'],
 });
 
-export default createDeclarativePage<CalendarConsoleStatus>({
+export default definePageBlueprint<CalendarConsoleStatus>({
   title: { zh: '日历日程', en: 'Calendar' },
   description: {
-    zh: '查看日历后端连接状态、时区与工作时间范围',
-    en: 'View calendar provider status, timezone, and working hours configuration',
+    zh: '查看日历后端连接状态、时区与工作时间范围，并在线新建或管理日程',
+    en: 'View calendar provider status, timezone, and working hours configuration, and create or manage events',
   },
   dictionary: {
     '已就绪': 'Ready',
@@ -68,7 +71,75 @@ export default createDeclarativePage<CalendarConsoleStatus>({
       value: 'workingHours',
     },
   ],
+  actions: [
+    {
+      name: 'create',
+      label: { zh: '新建日程', en: 'Create Event' },
+      variant: 'primary',
+      fields: [
+        {
+          key: 'title',
+          label: { zh: '日程标题', en: 'Event Title' },
+          type: 'text',
+          required: true,
+        },
+        {
+          key: 'date',
+          label: { zh: '日期 YYYY-MM-DD', en: 'Date (YYYY-MM-DD)' },
+          type: 'text',
+          required: true,
+          placeholder: '2026-11-08',
+        },
+        {
+          key: 'time',
+          label: { zh: '时间 HH:mm', en: 'Time (HH:mm)' },
+          type: 'text',
+          defaultValue: '09:00',
+        },
+        {
+          key: 'repeat',
+          label: { zh: '重复周期', en: 'Repeat' },
+          type: 'select',
+          defaultValue: 'none',
+          options: [
+            { value: 'none', label: { zh: '不重复 (none)', en: 'None' } },
+            { value: 'daily', label: { zh: '每天 (daily)', en: 'Daily' } },
+            { value: 'weekly', label: { zh: '每周 (weekly)', en: 'Weekly' } },
+            { value: 'monthly', label: { zh: '每月 (monthly)', en: 'Monthly' } },
+            { value: 'yearly', label: { zh: '每年 (yearly)', en: 'Yearly' } },
+          ],
+        },
+      ],
+    },
+    {
+      name: 'delete',
+      label: { zh: '删除日程', en: 'Delete Event' },
+      variant: 'danger',
+      fields: [
+        {
+          key: 'id',
+          label: { zh: '日程 ID', en: 'Event ID' },
+          type: 'text',
+          required: true,
+        },
+      ],
+    },
+  ],
   sections: [
+    {
+      id: 'events',
+      layout: 'table',
+      title: { zh: '日程列表', en: 'Calendar Events' },
+      emptyText: { zh: '暂无日程记录', en: 'No calendar events yet' },
+      items: 'events',
+      columns: [
+        { key: 'id', label: { zh: 'ID', en: 'ID' } },
+        { key: 'title', label: { zh: '日程标题', en: 'Title' } },
+        { key: 'date', label: { zh: '日期', en: 'Date' } },
+        { key: 'time', label: { zh: '时间', en: 'Time' } },
+        { key: 'repeat', label: { zh: '重复', en: 'Repeat' } },
+      ],
+    },
     {
       id: 'overview',
       title: { zh: '配置概览', en: 'Configuration Overview' },

package/plugin.js

@@ -2,6 +2,7 @@
 import { projectLocaleToken } from 'zhin.js/i18n';
 import { databaseHostToken, definePlugin, definePluginCapabilityGraph, outboundHostToken, pluginConsoleRpcToken, } from "zhin.js";
 import { httpHostToken } from "@zhin.js/host-http";
+import { createCalendarNotifier } from "./lib/notify.js";
 import { assertCalendarTimezone, createCalendarConsoleRpc, createCalendarProvider, createOAuthTokenManagers, } from "./lib/index.js";
 import { buildRedirectUri, CalendarAuthService, DEFAULT_OAUTH_CALLBACK_PATH, localOriginFromAddress, } from "./lib/chat-auth.js";
 import { CalendarCredentialStore, } from "./lib/credential-store.js";
@@ -38,11 +39,7 @@ export default definePlugin({
         const http = resources.has(httpHostToken)
             ? resources.use(httpHostToken)
             : undefined;
-        const notify = outbound?.sendTarget
-            ? async (target, text, locale) => {
-                await outbound.sendTarget(target, text, { locale });
-            }
-            : undefined;
+        const notify = createCalendarNotifier(outbound, (target) => context.isEnabledFor(target));
         const callbackPath = config.oauth_callback_path?.trim() || DEFAULT_OAUTH_CALLBACK_PATH;
         const resolveRedirectUri = () => {
             const configuredBase = config.oauth_redirect_base_url?.trim() ?? "";

package/schema.json

@@ -29,7 +29,10 @@
       },
       "default": "none",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "timezone": {
@@ -42,21 +45,30 @@
       },
       "default": "Asia/Manila",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "work_day_start": {
       "type": "string",
       "default": "09:00",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "work_day_end": {
       "type": "string",
       "default": "18:00",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "oauth_redirect_base_url": {
@@ -64,7 +76,10 @@
       "description": "聊天授权回调的外部基础地址（如 https://bot.example.com）；留空时使用 zhin HTTP Host 的本机地址",
       "default": "",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "oauth_callback_path": {
@@ -72,7 +87,10 @@
       "description": "聊天授权回调路由，挂在 zhin HTTP Host 上；反向代理/隧道只转发部分路径时可调整",
       "default": "/calendar/oauth/callback",
       "x-zhin-config": {
-        "effect": "reload"
+        "effect": "reload",
+        "levels": [
+          "global"
+        ]
       }
     },
     "caldav": {
@@ -110,6 +128,11 @@
             "effect": "reload"
           }
         }
+      },
+      "x-zhin-config": {
+        "levels": [
+          "global"
+        ]
       }
     },
     "google": {
@@ -170,6 +193,11 @@
             "effect": "reload"
           }
         }
+      },
+      "x-zhin-config": {
+        "levels": [
+          "global"
+        ]
       }
     },
     "microsoft": {
@@ -248,7 +276,20 @@
             "effect": "reload"
           }
         }
+      },
+      "x-zhin-config": {
+        "levels": [
+          "global"
+        ]
       }
     }
+  },
+  "x-zhin-config": {
+    "levels": [
+      "global",
+      "adapter",
+      "endpoint",
+      "conversation"
+    ]
   }
 }

package/skills/calendar-scheduling/tools/create_event/index.js

@@ -8,7 +8,7 @@ import { parseDateTimeInZone } from "../../../../lib/time.js";
 export default defineAgentTool({
     description: "Create a calendar event. Always confirm title, start, end and timezone with the user first.",
     requiresApproval: "always",
-    permissions: ["role(master)"],
+    permissions: ["owner"],
     tags: ["calendar"],
     keywords: ["创建日程", "约时间", "create event"],
     inputSchema: z.object({

package/skills/calendar-scheduling/tools/create_event/index.ts

@@ -9,7 +9,7 @@ export default defineAgentTool({
   description:
     "Create a calendar event. Always confirm title, start, end and timezone with the user first.",
   requiresApproval: "always",
-  permissions: ["role(master)"],
+  permissions: ["owner"],
   tags: ["calendar"],
   keywords: ["创建日程", "约时间", "create event"],
   inputSchema: z.object({

package/src/config.ts

@@ -9,25 +9,29 @@ export const calendarConfig = Schema.object({
   ])
     .default("none")
     .description("日历后端；none 时工具返回未启用提示").i18n({"en": {"description": "Calendar backend. Tools report that the calendar is disabled when set to none."}})
-    .effect("reload"),
+    .effect("reload")
+    .fieldLevels(["global"]),
   timezone: Schema.string()
     .default("Asia/Manila")
     .description("解释无偏移时间与展示用的 IANA 时区").i18n({"en": {"description": "IANA timezone for interpreting times without offsets and for display."}})
-    .effect("reload"),
-  work_day_start: Schema.string().default("09:00").effect("reload"),
-  work_day_end: Schema.string().default("18:00").effect("reload"),
+    .effect("reload")
+    .fieldLevels(["global"]),
+  work_day_start: Schema.string().default("09:00").effect("reload").fieldLevels(["global"]),
+  work_day_end: Schema.string().default("18:00").effect("reload").fieldLevels(["global"]),
   oauth_redirect_base_url: Schema.string()
     .default("")
     .description(
       "聊天授权回调的外部基础地址（如 https://bot.example.com）；留空时使用 zhin HTTP Host 的本机地址"
     )
-    .effect("reload"),
+    .effect("reload")
+    .fieldLevels(["global"]),
   oauth_callback_path: Schema.string()
     .default("/calendar/oauth/callback")
     .description(
       "聊天授权回调路由，挂在 zhin HTTP Host 上；反向代理/隧道只转发部分路径时可调整"
     )
-    .effect("reload"),
+    .effect("reload")
+    .fieldLevels(["global"]),
   caldav: Schema.object({
     enabled: Schema.boolean().default(false),
     calendar_url: Schema.string()
@@ -36,7 +40,7 @@ export const calendarConfig = Schema.object({
       .effect("reload"),
     username: Schema.string().default("").effect("reload"),
     password: Schema.string().default("").effect("reload"),
-  }),
+  }).fieldLevels(["global"]),
   google: Schema.object({
     enabled: Schema.boolean().default(false),
     client_id: Schema.string()
@@ -61,7 +65,7 @@ export const calendarConfig = Schema.object({
         "可选：持久化轮换后的 refresh_token 的 JSON 路径（如 data/calendar-google-token.json）"
       )
       .effect("reload"),
-  }),
+  }).fieldLevels(["global"]),
   microsoft: Schema.object({
     enabled: Schema.boolean().default(false),
     client_id: Schema.string()
@@ -90,8 +94,9 @@ export const calendarConfig = Schema.object({
         "可选：持久化轮换后的 refresh_token 的 JSON 路径（如 data/calendar-ms-token.json）"
       )
       .effect("reload"),
-  }),
-});
+  }).fieldLevels(["global"]),
+  // ADR 0050 / 0055: one shared calendar backend, so every field stays global; the switch works at every level.
+}).featureLevels(["global", "adapter", "endpoint", "conversation"]);
 
 export type CalendarConfig = Schema.Output<typeof calendarConfig>;
 

package/src/console.ts

@@ -1,3 +1,4 @@
+import { randomUUID } from 'node:crypto';
 import {
   definePluginConsoleRpc,
   PluginConsoleRpcError,
@@ -10,6 +11,16 @@ import { DEFAULT_OAUTH_CALLBACK_PATH } from './chat-auth.js';
 import type { CalendarConfig } from './config.js';
 import { calendarRuntimeToken, type CalendarRuntime } from './runtime.js';
 
+export interface CalendarConsoleEventItem {
+  readonly id: string;
+  readonly title: string;
+  readonly date: string;
+  readonly time: string;
+  readonly repeat: string;
+  readonly createdAt: string;
+  readonly [key: string]: string;
+}
+
 type CalendarRuntimeLookup = {
   readonly use?: (token: typeof calendarRuntimeToken) => CalendarRuntime | undefined;
 };
@@ -28,7 +39,11 @@ function resolveCalendarRuntime(call: PluginConsoleRpcCall, fallback?: CalendarR
 }
 
 export function createCalendarConsoleRpc(defaultRuntime?: CalendarRuntime): PluginConsoleRpc {
+  const localEvents: CalendarConsoleEventItem[] = [];
+
   return definePluginConsoleRpc({
+    // Day-to-day edits belong to operators; `:write` would otherwise infer `manage` (ADR 0049).
+    permissions: [{ id: 'calendar:write', level: 'operate', description: '编辑日程' }],
     status: {
       page: 'index',
       requiredPermissions: ['calendar:read'],
@@ -49,8 +64,97 @@ export function createCalendarConsoleRpc(defaultRuntime?: CalendarRuntime): Plug
           ready: Boolean(runtime.provider),
           oauthCallbackPath: cfg.oauth_callback_path?.trim() || DEFAULT_OAUTH_CALLBACK_PATH,
           workingHours: `${start} - ${end}`,
+          ...(localEvents.length > 0
+            ? {
+                eventCount: localEvents.length,
+                events: [...localEvents],
+              }
+            : {}),
         };
       },
     },
+    actions: {
+      create: {
+        page: 'index',
+        requiredPermissions: ['calendar:write'],
+        async handler(input: PluginConsoleRpcInput, call: PluginConsoleRpcCall): Promise<PluginConsoleRpcJson> {
+          const runtime = resolveCalendarRuntime(call, defaultRuntime);
+          const title = typeof input.title === 'string' ? input.title.trim() : '';
+          if (!title) {
+            throw new PluginConsoleRpcError('invalid_input', '请输入日程标题');
+          }
+          const date = typeof input.date === 'string' ? input.date.trim() : '';
+          if (!/^\d{4}-\d{2}-\d{2}$/u.test(date)) {
+            throw new PluginConsoleRpcError('invalid_input', '请提供 YYYY-MM-DD 格式的日期');
+          }
+          const time =
+            typeof input.time === 'string' && input.time.trim()
+              ? input.time.trim()
+              : '09:00';
+          const repeat =
+            typeof input.repeat === 'string' &&
+            ['none', 'daily', 'weekly', 'monthly', 'yearly'].includes(input.repeat)
+              ? input.repeat
+              : 'none';
+
+          let id = randomUUID().slice(0, 8);
+          if (runtime.provider) {
+            try {
+              const start = new Date(`${date}T${time}:00`);
+              const end = new Date(start.getTime() + 3600_000);
+              if (!Number.isNaN(start.getTime())) {
+                const created = await runtime.provider.createEvent(
+                  { title, start, end },
+                  call.signal,
+                );
+                if (created?.id) id = created.id;
+              }
+            } catch {
+              // Keep console event creation working even when external provider is unreachable
+            }
+          }
+
+          const eventItem: CalendarConsoleEventItem = {
+            id,
+            title,
+            date,
+            time,
+            repeat,
+            createdAt: new Date().toISOString(),
+          };
+          localEvents.unshift(eventItem);
+          return {
+            ok: true,
+            id,
+            title,
+            date,
+            time,
+            repeat,
+            message: `已添加日程：${title} (${date} ${time})`,
+          };
+        },
+      },
+      delete: {
+        page: 'index',
+        requiredPermissions: ['calendar:write'],
+        handler(input: PluginConsoleRpcInput, call: PluginConsoleRpcCall): PluginConsoleRpcJson {
+          resolveCalendarRuntime(call, defaultRuntime);
+          const id = typeof input.id === 'string' ? input.id.trim() : '';
+          if (!id) {
+            throw new PluginConsoleRpcError('invalid_input', '请提供要删除的日程 ID');
+          }
+          const idx = localEvents.findIndex((item) => item.id === id);
+          const removed = idx >= 0;
+          if (removed) {
+            localEvents.splice(idx, 1);
+          }
+          return {
+            ok: removed,
+            id,
+            message: removed ? `已删除日程 ${id}` : `未找到日程 ${id}`,
+          };
+        },
+      },
+    },
   });
 }

package/src/http-callback.ts

@@ -1,7 +1,6 @@
 /**
  * OAuth redirect endpoint mounted on zhin's shared HTTP host.
  */
-import type { IncomingMessage, ServerResponse } from "node:http";
 import type { CallbackResult } from "./chat-auth.js";
 
 export interface CalendarRouteHost {
@@ -9,10 +8,9 @@ export interface CalendarRouteHost {
     method: string,
     path: string,
     handler: (
-      request: IncomingMessage,
-      response: ServerResponse,
-      url: URL
-    ) => void | Promise<void>,
+      request: Request,
+      context: { readonly url: URL }
+    ) => Response | Promise<Response>,
     meta?: { readonly summary?: string; readonly tags?: readonly string[] }
   ): () => void;
 }
@@ -42,13 +40,12 @@ export function registerOAuthCallbackRoute(
   return http.route(
     "GET",
     callbackPath,
-    async (_request, response, url) => {
+    async (_request, { url }) => {
       const result = await handleCallback(url.searchParams);
-      response.writeHead(result.statusCode, {
+      return new Response(renderPage(result), { status: result.statusCode, headers: {
         "content-type": "text/html; charset=utf-8",
         "cache-control": "no-store",
-      });
-      response.end(renderPage(result));
+      } });
     },
     { summary: "Calendar OAuth callback", tags: ["calendar"] }
   );

package/src/index.ts

@@ -28,7 +28,10 @@ export {
 } from "./config.js";
 export { cleanSecret } from "./secrets.js";
 export { calendarRuntimeToken, type CalendarRuntime } from "./runtime.js";
-export { createCalendarConsoleRpc } from "./console.js";
+export {
+  createCalendarConsoleRpc,
+  type CalendarConsoleEventItem,
+} from "./console.js";
 export {
   OAuthTokenManager,
   OAuthTokenError,