@zhin.js/plugin-calendar 0.1.13 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @zhin.js/plugin-calendar
 
+## 0.1.14
+
+### Patch Changes
+
+- cbf1fb1: Unify Console page blueprints (`definePageBlueprint`, `defineAdapterPage`, `defineCommentReviewPage`, `projectBlueprintToImCard`, `projectBlueprintToCliPanel`) into `@zhin.js/console-contract` and `@zhin.js/page`, add zero-esbuild pure Blueprint synthesis + static client bundle mounting to `@zhin.js/pagemanager`, remove `@zhin.js/client` (React 19) and `.tsx` from all 30 server-side plugins and adapters (including `bilibili` and `juejin`), and remove legacy Era-1 Koa `PageManager` code.
+- 5419b88: Add generation-scoped `definePluginStore` (`PluginStore`), `Scope.get()`, declarative `PluginSetupCapabilities` return in `definePlugin()`, and `JsonSerializable<T>` typing on `PluginStateStore` to eliminate `as never` casts on TypeScript interfaces.
+- Updated dependencies [cbf1fb1]
+- Updated dependencies [008ccad]
+- Updated dependencies [a1f1028]
+  - @zhin.js/console-contract@1.1.4
+  - @zhin.js/page@1.1.16
+  - @zhin.js/im-contract@1.1.13
+  - @zhin.js/host-http@1.1.16
+  - @zhin.js/tool@1.1.17
+  - @zhin.js/skill@1.1.15
+
 ## 0.1.13
 
 ### Patch Changes

package/lib/credential-store.d.ts

@@ -1,4 +1,5 @@
 import type { Locale } from 'zhin.js/i18n';
+import type { JsonSerializable, JsonValue } from 'zhin.js';
 /**
  * Persists OAuth refresh tokens in the plugin's database state (never in .env).
  */
@@ -6,17 +7,17 @@ import type { OAuthProviderKind, RefreshTokenStore } from "./token-manager.js";
 /** The subset of zhin's PluginStateStore used by the calendar plugin. */
 export interface CalendarStateStore {
     get<T>(key: string): Promise<T | undefined>;
-    set(key: string, value: never): Promise<void>;
+    set<T>(key: string, value: T & JsonSerializable<T>): Promise<void>;
     delete(key: string): Promise<void>;
 }
 /** Who completed the chat authorization and where to notify them later. */
-export interface CredentialOwner<Target = unknown> {
+export interface CredentialOwner<Target = JsonValue> {
     readonly sender_id: string;
     /** Fixed when authorization starts; token rotation preserves it. */
     readonly locale?: Locale;
     readonly target: Target;
 }
-export interface StoredCredential<Target = unknown> {
+export interface StoredCredential<Target = JsonValue> {
     readonly refresh_token: string;
     readonly authorized_at: string;
     readonly authorized_by: CredentialOwner<Target> | null;

package/lib/credential-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACxD;AAMD,qBAAa,uBAAuB;;gBAGtB,KAAK,EAAE,kBAAkB;IAI/B,GAAG,CACP,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAUlC,IAAI,CACR,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,eAAe,GAAG,IAAI,GACnC,OAAO,CAAC,IAAI,CAAC;IASV,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,6EAA6E;IAC7E,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB;CAalE"}
+{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3D;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,SAAS;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,SAAS;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACxD;AAMD,qBAAa,uBAAuB;;gBAGtB,KAAK,EAAE,kBAAkB;IAI/B,GAAG,CACP,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAUlC,IAAI,CACR,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,eAAe,GAAG,IAAI,GACnC,OAAO,CAAC,IAAI,CAAC;IASV,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,6EAA6E;IAC7E,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB;CAalE"}

package/lib/credential-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AA2BA,SAAS,aAAa,CAAC,QAA2B;IAChD,OAAO,SAAS,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,OAAO,uBAAuB;IACzB,MAAM,CAAqB;IAEpC,YAAY,KAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CACP,QAA2B;QAE3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAClC,aAAa,CAAC,QAAQ,CAAC,CACxB,CAAC;QACF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAA2B,EAC3B,YAAoB,EACpB,YAAoC;QAEpC,MAAM,UAAU,GAAqB;YACnC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvC,aAAa,EAAE,YAAY;SAC5B,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,UAAmB,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAA2B;QACtC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAC7E,iBAAiB,CAAC,QAA2B;QAC3C,OAAO;YACL,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5C,OAAO,UAAU,EAAE,aAAa,CAAC;YACnC,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;gBAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,YAAY,GAAG,QAAQ,EAAE,aAAa,IAAI,IAAI,CAAC;gBACrD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YACxD,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AA4BA,SAAS,aAAa,CAAC,QAA2B;IAChD,OAAO,SAAS,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,OAAO,uBAAuB;IACzB,MAAM,CAAqB;IAEpC,YAAY,KAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CACP,QAA2B;QAE3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAClC,aAAa,CAAC,QAAQ,CAAC,CACxB,CAAC;QACF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAA2B,EAC3B,YAAoB,EACpB,YAAoC;QAEpC,MAAM,UAAU,GAAqB;YACnC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvC,aAAa,EAAE,YAAY;SAC5B,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAA2B;QACtC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAC7E,iBAAiB,CAAC,QAA2B;QAC3C,OAAO;YACL,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5C,OAAO,UAAU,EAAE,aAAa,CAAC;YACnC,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;gBAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,YAAY,GAAG,QAAQ,EAAE,aAAa,IAAI,IAAI,CAAC;gBACrD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YACxD,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/lib/runtime.d.ts

@@ -7,5 +7,6 @@ export interface CalendarRuntime {
     /** Chat authorization flow used by the `calendar` commands. */
     readonly auth: CalendarAuthService<unknown>;
 }
-export declare const calendarRuntimeToken: import("zhin.js").Token<CalendarRuntime>;
+export declare const calendarRuntimeStore: import("zhin.js").PluginStore<CalendarRuntime, unknown>;
+export declare const calendarRuntimeToken: import("zhin.js").PluginStore<CalendarRuntime, unknown>;
 //# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,oBAAoB,0CAGhC,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,oBAAoB,yDAGhC,CAAC;AACF,eAAO,MAAM,oBAAoB,yDAAuB,CAAC"}

package/lib/runtime.js

@@ -1,3 +1,4 @@
-import { createToken } from "zhin.js";
-export const calendarRuntimeToken = createToken("zhin.calendar.runtime", "Owner-scoped calendar provider and config");
+import { definePluginStore } from "zhin.js";
+export const calendarRuntimeStore = definePluginStore("zhin.calendar.runtime", "Owner-scoped calendar provider and config");
+export const calendarRuntimeToken = calendarRuntimeStore;
 //# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAYtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAC7C,uBAAuB,EACvB,2CAA2C,CAC5C,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAY5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CACnD,uBAAuB,EACvB,2CAA2C,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-calendar",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "CalDAV / Google / Microsoft calendar tools for Zhin Agent",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,28 +40,27 @@
     "url": "https://github.com/lc-cn"
   },
   "dependencies": {
-    "@zhin.js/client": "1.1.25",
-    "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/host-http": "1.1.15",
-    "@zhin.js/im-contract": "1.1.12",
-    "@zhin.js/page": "1.1.15",
-    "@zhin.js/skill": "1.1.14",
-    "@zhin.js/tool": "1.1.16"
+    "@zhin.js/console-contract": "1.1.4",
+    "@zhin.js/host-http": "1.1.16",
+    "@zhin.js/im-contract": "1.1.13",
+    "@zhin.js/page": "1.1.16",
+    "@zhin.js/skill": "1.1.15",
+    "@zhin.js/tool": "1.1.17"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/command": "1.1.15",
-    "zhin.js": "1.1.22"
+    "@zhin.js/command": "1.1.16",
+    "zhin.js": "1.1.23"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/command": "^1.1.15",
-    "@zhin.js/page": "^1.1.15",
-    "@zhin.js/skill": "^1.1.14",
-    "@zhin.js/tool": "^1.1.16",
-    "zhin.js": "^1.1.22"
+    "@zhin.js/command": "^1.1.16",
+    "@zhin.js/page": "^1.1.16",
+    "@zhin.js/skill": "^1.1.15",
+    "@zhin.js/tool": "^1.1.17",
+    "zhin.js": "^1.1.23"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/pages/index/index.js

@@ -1,6 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { definePage } from '@zhin.js/console-contract';
-import { createDeclarativePage } from '@zhin.js/client';
+import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
 export const meta = definePage({
     title: '日历日程',
     titleI18n: { en: 'Calendar' },

package/pages/index/index.ts

@@ -1,5 +1,4 @@
-import { definePage } from '@zhin.js/console-contract';
-import { createDeclarativePage } from '@zhin.js/client';
+import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
 
 export interface CalendarConsoleStatus {
   readonly provider: 'none' | 'google' | 'microsoft' | 'caldav' | 'ics';

package/plugin.js

@@ -1,15 +1,25 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { projectLocaleToken } from 'zhin.js/i18n';
-import { databaseHostToken, definePlugin, outboundHostToken, pluginConsoleRpcToken, } from "zhin.js";
+import { databaseHostToken, definePlugin, definePluginCapabilityGraph, outboundHostToken, pluginConsoleRpcToken, } from "zhin.js";
 import { httpHostToken } from "@zhin.js/host-http";
 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";
 import { registerOAuthCallbackRoute } from "./lib/http-callback.js";
-import { calendarRuntimeToken } from "./lib/runtime.js";
+import { calendarRuntimeStore } from "./lib/runtime.js";
 export default definePlugin({
     name: "calendar",
     metadata: { displayName: "日历" },
+    capabilityGraph: definePluginCapabilityGraph({
+        provides: [calendarRuntimeStore, pluginConsoleRpcToken],
+        injects: [databaseHostToken, outboundHostToken, httpHostToken, projectLocaleToken],
+        features: {
+            commands: ["calendar/auth", "calendar/logout", "calendar/status"],
+            skills: ["calendar-scheduling"],
+            tools: ["create_event", "find_free_time", "list_events"],
+            pages: ["index"],
+        },
+    }),
     setup(context) {
         const config = context.config.get();
         assertCalendarTimezone(config.timezone);
@@ -59,16 +69,18 @@ export default definePlugin({
             provider,
             auth: auth,
         };
-        context.resources.provide(calendarRuntimeToken, runtime);
-        context.resources.provide(pluginConsoleRpcToken, createCalendarConsoleRpc(runtime));
+        calendarRuntimeStore.provide(context, runtime);
         if (config.provider !== "none" && !provider) {
             console.warn("[calendar] provider 已配置但凭据为空，日历工具将不可用；Google/Microsoft 请先配置 client_id，再在聊天中发送 calendar auth <provider>");
         }
         const releaseRoute = http
             ? registerOAuthCallbackRoute(http, callbackPath, (searchParams) => auth.handleCallback(searchParams))
             : undefined;
-        return () => {
-            releaseRoute?.();
+        return {
+            consoleRpc: createCalendarConsoleRpc(runtime),
+            dispose: () => {
+                releaseRoute?.();
+            },
         };
     },
 });

package/src/credential-store.ts

@@ -1,4 +1,5 @@
 import type { Locale } from 'zhin.js/i18n';
+import type { JsonSerializable, JsonValue } from 'zhin.js';
 /**
  * Persists OAuth refresh tokens in the plugin's database state (never in .env).
  */
@@ -7,19 +8,19 @@ import type { OAuthProviderKind, RefreshTokenStore } from "./token-manager.js";
 /** The subset of zhin's PluginStateStore used by the calendar plugin. */
 export interface CalendarStateStore {
   get<T>(key: string): Promise<T | undefined>;
-  set(key: string, value: never): Promise<void>;
+  set<T>(key: string, value: T & JsonSerializable<T>): Promise<void>;
   delete(key: string): Promise<void>;
 }
 
 /** Who completed the chat authorization and where to notify them later. */
-export interface CredentialOwner<Target = unknown> {
+export interface CredentialOwner<Target = JsonValue> {
   readonly sender_id: string;
   /** Fixed when authorization starts; token rotation preserves it. */
   readonly locale?: Locale;
   readonly target: Target;
 }
 
-export interface StoredCredential<Target = unknown> {
+export interface StoredCredential<Target = JsonValue> {
   readonly refresh_token: string;
   readonly authorized_at: string;
   readonly authorized_by: CredentialOwner<Target> | null;
@@ -58,7 +59,7 @@ export class CalendarCredentialStore {
       authorized_at: new Date().toISOString(),
       authorized_by: authorizedBy,
     };
-    await this.#state.set(credentialKey(provider), credential as never);
+    await this.#state.set(credentialKey(provider), credential);
   }
 
   async delete(provider: OAuthProviderKind): Promise<void> {

package/src/runtime.ts

@@ -1,4 +1,4 @@
-import { createToken } from "zhin.js";
+import { definePluginStore } from "zhin.js";
 import type { CalendarConfig } from "./config.js";
 import type { CalendarProvider } from "./types.js";
 import type { CalendarAuthService } from "./chat-auth.js";
@@ -10,7 +10,8 @@ export interface CalendarRuntime {
   readonly auth: CalendarAuthService<unknown>;
 }
 
-export const calendarRuntimeToken = createToken<CalendarRuntime>(
+export const calendarRuntimeStore = definePluginStore<CalendarRuntime>(
   "zhin.calendar.runtime",
   "Owner-scoped calendar provider and config"
 );
+export const calendarRuntimeToken = calendarRuntimeStore;