@zhin.js/core 1.3.2 → 1.3.3

package/lib/built/optional-peer-import.js

@@ -0,0 +1,33 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** 从应用根（ZHIN_PROJECT_ROOT / cwd）解析 optional peer，避免 core 包目录下 dynamic import 失败 */
+export function resolveOptionalPeerPackage(packageName) {
+    const roots = new Set();
+    const envRoot = process.env.ZHIN_PROJECT_ROOT?.trim();
+    if (envRoot)
+        roots.add(path.resolve(envRoot));
+    roots.add(process.cwd());
+    for (const root of roots) {
+        try {
+            const req = createRequire(path.join(root, 'package.json'));
+            return req.resolve(packageName);
+        }
+        catch {
+            // try next root
+        }
+    }
+    try {
+        return createRequire(import.meta.url).resolve(packageName);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function importOptionalPeerPackage(packageName) {
+    const resolved = resolveOptionalPeerPackage(packageName);
+    if (resolved) {
+        return import(pathToFileURL(resolved).href);
+    }
+    return import(packageName);
+}

package/lib/built/outbound-media-contract.d.ts

@@ -20,4 +20,3 @@ export type OutboundMediaMaterializer = (content: SendContent, ctx: OutboundMedi
 export declare function assertAdapterDeclaresRichSegmentPolicy(adapterClass: {
     outboundRichSegmentPolicy?: Record<string, string>;
 }): void;
-//# sourceMappingURL=outbound-media-contract.d.ts.map

package/lib/built/outbound-media-contract.js

@@ -8,4 +8,3 @@ export function assertAdapterDeclaresRichSegmentPolicy(adapterClass) {
         throw new Error('outboundRichSegmentPolicy must be a non-empty object');
     }
 }
-//# sourceMappingURL=outbound-media-contract.js.map

package/lib/built/outbound-media-utils.d.ts

@@ -7,4 +7,3 @@ export declare function resolveLocalMediaPath(data: Record<string, unknown>): st
 export declare function asMessageElements(content: SendContent): MessageElement[];
 export declare function isMediaSegmentType(type: string): boolean;
 export declare function collectOutboundMediaKinds(content: SendContent | undefined): string[];
-//# sourceMappingURL=outbound-media-utils.d.ts.map

package/lib/built/outbound-media-utils.js

@@ -60,4 +60,3 @@ export function collectOutboundMediaKinds(content) {
     }
     return [...kinds];
 }
-//# sourceMappingURL=outbound-media-utils.js.map

package/lib/built/permission.d.ts

@@ -53,4 +53,3 @@ export declare namespace Permissions {
  * @deprecated Use PermissionFeature instead
  */
 export declare const PermissionService: typeof PermissionFeature;
-//# sourceMappingURL=permission.d.ts.map

package/lib/built/permission.js

@@ -4,7 +4,6 @@
  */
 import { Feature } from "@zhin.js/kernel";
 import logger, { formatCompact } from "@zhin.js/logger";
-import { getPlugin } from "../plugin.js";
 import { isBuiltinPermit, parsePermitName } from "./permit-parse.js";
 import { checkBuiltinPermit } from "./permit-check.js";
 import { senderRolesFromMessage } from "./message-enrich.js";
@@ -81,7 +80,7 @@ export class PermissionFeature extends Feature {
         const feature = this;
         return {
             addPermission(permission) {
-                const plugin = getPlugin();
+                const plugin = this;
                 const dispose = feature.add(permission, plugin.name);
                 const permName = permission.name instanceof RegExp ? permission.name.source : permission.name;
                 plugin.recordFeatureContribution(feature.name, permName);
@@ -102,4 +101,3 @@ export var Permissions;
  * @deprecated Use PermissionFeature instead
  */
 export const PermissionService = PermissionFeature;
-//# sourceMappingURL=permission.js.map

package/lib/built/permit-check.d.ts

@@ -5,4 +5,3 @@ import type { Message } from '../message.js';
 import type { SenderRole } from './roles.js';
 export declare function checkBuiltinPermit(name: string, message: Message<any>, roles: readonly SenderRole[]): boolean;
 export declare function checkBuiltinPermitList(permits: readonly string[], message: Message<any>, roles: readonly SenderRole[]): boolean;
-//# sourceMappingURL=permit-check.d.ts.map

package/lib/built/permit-check.js

@@ -33,4 +33,3 @@ export function checkBuiltinPermit(name, message, roles) {
 export function checkBuiltinPermitList(permits, message, roles) {
     return permits.every((p) => checkBuiltinPermit(p, message, roles));
 }
-//# sourceMappingURL=permit-check.js.map

package/lib/built/permit-parse.d.ts

@@ -14,4 +14,3 @@ export interface ParsedPlatformPermit {
 }
 export declare function parsePlatformPermitName(name: string): ParsedPlatformPermit | null;
 export declare function isPlatformPermit(name: string): boolean;
-//# sourceMappingURL=permit-parse.d.ts.map

package/lib/built/permit-parse.js

@@ -30,4 +30,3 @@ export function parsePlatformPermitName(name) {
 export function isPlatformPermit(name) {
     return PLATFORM_PERMIT_RE.test(name);
 }
-//# sourceMappingURL=permit-parse.js.map

package/lib/built/platform-permit.d.ts

@@ -1,5 +1,5 @@
 /**
- * Platform permit — 适配器注册的平台级权限校验（群管、频道身份等）
+ * Platform permit — 适配器注册的平台级权限校验（场景治理、频道身份等）
  */
 import type { Message } from '../message.js';
 export type PlatformPermitChecker = (perm: string, message: Message<any>) => boolean;
@@ -14,8 +14,7 @@ export declare function applyQqSenderRoleToMessageSender(sender: {
     role?: string;
     permissions?: string[];
 }, role?: string): void;
-/** 常见 IM 平台群身份：$sender.role 为 owner / admin */
-export declare function createGroupRolePlatformChecker(): PlatformPermitChecker;
-/** 为适配器注册默认群管 platform checker（幂等） */
-export declare function registerDefaultGroupPlatformPermitChecker(adapter: string): () => void;
-//# sourceMappingURL=platform-permit.d.ts.map
+/** 常见 IM 平台场景身份：$sender.role 为 owner / admin */
+export declare function createSceneRolePlatformChecker(): PlatformPermitChecker;
+/** 为适配器注册默认场景治理 platform checker（幂等） */
+export declare function registerDefaultScenePlatformPermitChecker(adapter: string): () => void;

package/lib/built/platform-permit.js

@@ -1,6 +1,6 @@
 import { parsePlatformPermitName, isPlatformPermit } from './permit-parse.js';
 const checkers = new Map();
-const registeredDefaultGroupCheckers = new Set();
+const registeredDefaultSceneCheckers = new Set();
 export function registerPlatformPermitChecker(adapter, checker) {
     const key = String(adapter);
     checkers.set(key, checker);
@@ -12,7 +12,7 @@ export function registerPlatformPermitChecker(adapter, checker) {
 }
 export function clearPlatformPermitCheckers() {
     checkers.clear();
-    registeredDefaultGroupCheckers.clear();
+    registeredDefaultSceneCheckers.clear();
 }
 export function checkPlatformPermit(name, message) {
     const parsed = parsePlatformPermitName(name);
@@ -44,24 +44,23 @@ export function applyQqSenderRoleToMessageSender(sender, role) {
     sender.role = normalized;
     sender.permissions = [normalized];
 }
-/** 常见 IM 平台群身份：$sender.role 为 owner / admin */
-export function createGroupRolePlatformChecker() {
+/** 常见 IM 平台场景身份：$sender.role 为 owner / admin */
+export function createSceneRolePlatformChecker() {
     return (perm, message) => {
         const role = message.$sender?.role;
-        if (perm === 'group_admin')
+        if (perm === 'scene_admin')
             return role === 'admin' || role === 'owner';
-        if (perm === 'group_owner')
+        if (perm === 'scene_owner')
             return role === 'owner';
         return false;
     };
 }
-/** 为适配器注册默认群管 platform checker（幂等） */
-export function registerDefaultGroupPlatformPermitChecker(adapter) {
+/** 为适配器注册默认场景治理 platform checker（幂等） */
+export function registerDefaultScenePlatformPermitChecker(adapter) {
     const key = String(adapter);
-    if (registeredDefaultGroupCheckers.has(key)) {
+    if (registeredDefaultSceneCheckers.has(key)) {
         return () => { };
     }
-    registeredDefaultGroupCheckers.add(key);
-    return registerPlatformPermitChecker(key, createGroupRolePlatformChecker());
+    registeredDefaultSceneCheckers.add(key);
+    return registerPlatformPermitChecker(key, createSceneRolePlatformChecker());
 }
-//# sourceMappingURL=platform-permit.js.map

package/lib/built/prepend-quote-context.d.ts

@@ -32,4 +32,3 @@ export declare function resolveQuoteContextBlock(message: Message<any>, root: Pl
 export declare function prependQuoteContext(message: Message<any>, root: Plugin, userText: string, options?: {
     enabled?: boolean;
 }): Promise<string>;
-//# sourceMappingURL=prepend-quote-context.d.ts.map

package/lib/built/prepend-quote-context.js

@@ -128,4 +128,3 @@ export async function prependQuoteContext(message, root, userText, options) {
     const quoteBlock = await resolveQuoteContextBlock(message, root, options);
     return buildUserTurnWithQuoteContext(userText, quoteBlock);
 }
-//# sourceMappingURL=prepend-quote-context.js.map

package/lib/built/qrcode-segment.d.ts

@@ -16,4 +16,3 @@ export declare function resolveQrcodeSegmentsToImages(content: SendContent | und
 export declare function resolveQrcodeSegmentsToTerminal(content: SendContent | undefined): Promise<SendContent | undefined>;
 /** 不支持图片的平台：仅输出链接文本 */
 export declare function coerceQrcodeSegmentsToText(content: SendContent): SendContent;
-//# sourceMappingURL=qrcode-segment.d.ts.map

package/lib/built/qrcode-segment.js

@@ -76,4 +76,3 @@ export function coerceQrcodeSegmentsToText(content) {
     }
     return packSegments(out);
 }
-//# sourceMappingURL=qrcode-segment.js.map

package/lib/built/queue-im-field-contract.d.ts

@@ -1,5 +1,6 @@
 import type { MessageType } from '../message.js';
 import type { SendContent, SendOptions } from '../types.js';
+import { type IMDeliveryTarget } from '../im-scene.js';
 export interface QueueEnvelope<TDetail extends Record<string, unknown> = Record<string, unknown>> {
     kind: string;
     type: string;
@@ -23,5 +24,9 @@ export declare function isMessageType(value: unknown): value is MessageType;
 /** Normalize queue outbound detail into the canonical queue-IM shape. */
 export declare function normalizeQueueOutboundDetail(record: Record<string, unknown>): NormalizedQueueOutboundDetail;
 export declare function toSendOptions(detail: NormalizedQueueOutboundDetail): SendOptions;
+export interface QueueIMSceneTargetDetail {
+    target: IMDeliveryTarget;
+    content: SendContent;
+}
+export declare function sceneTargetToSendOptions(detail: QueueIMSceneTargetDetail): SendOptions;
 export declare function normalizeRecordToSendOptions(record: Record<string, unknown>): SendOptions;
-//# sourceMappingURL=queue-im-field-contract.d.ts.map

package/lib/built/queue-im-field-contract.js

@@ -1,3 +1,4 @@
+import { sceneRefToSendOptions } from '../im-scene.js';
 export class QueueIMFieldContractError extends Error {
     code;
     field;
@@ -52,7 +53,15 @@ export function toSendOptions(detail) {
         content: detail.content,
     };
 }
+export function sceneTargetToSendOptions(detail) {
+    return sceneRefToSendOptions(detail.target, detail.content);
+}
 export function normalizeRecordToSendOptions(record) {
+    if (record.target && typeof record.target === 'object') {
+        return sceneTargetToSendOptions({
+            target: record.target,
+            content: requireContent(record.content),
+        });
+    }
     return toSendOptions(normalizeQueueOutboundDetail(record));
 }
-//# sourceMappingURL=queue-im-field-contract.js.map

package/lib/built/rich-segments/adapter-policies.d.ts

@@ -1,4 +1,4 @@
-import type { OutboundRichSegmentPolicy } from './types.js';
+import { type OutboundRichSegmentPolicy } from './types.js';
 /** 全功能 IM：html/markdown/qrcode→image，tts→audio */
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL: OutboundRichSegmentPolicy;
 /** 仅文本降级（无富媒体出站能力） */
@@ -7,4 +7,3 @@ export declare const OUTBOUND_RICH_SEGMENT_POLICY_TEXT_ONLY: OutboundRichSegment
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_IM_DEFAULT: OutboundRichSegmentPolicy;
 /** 无音频出站（tts 降级 text） */
 export declare const OUTBOUND_RICH_SEGMENT_POLICY_NO_AUDIO: OutboundRichSegmentPolicy;
-//# sourceMappingURL=adapter-policies.d.ts.map

package/lib/built/rich-segments/adapter-policies.js

@@ -25,4 +25,3 @@ export const OUTBOUND_RICH_SEGMENT_POLICY_NO_AUDIO = {
     ...OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL,
     [BUILTIN_RICH_SEGMENT_KINDS.TTS]: RICH_SEGMENT_MODE.TEXT,
 };
-//# sourceMappingURL=adapter-policies.js.map

package/lib/built/rich-segments/base.d.ts

@@ -9,4 +9,3 @@ export declare abstract class RichSegment<TData> {
 }
 export declare function isRichSegment(item: unknown): item is RichSegment<unknown>;
 export declare function richSegmentKind(item: MessageElement | string): string | null;
-//# sourceMappingURL=base.d.ts.map

package/lib/built/rich-segments/base.js

@@ -22,4 +22,3 @@ export function richSegmentKind(item) {
     }
     return null;
 }
-//# sourceMappingURL=base.js.map

package/lib/built/rich-segments/builtins.d.ts

@@ -2,4 +2,3 @@
 export declare const DEFAULT_OUTBOUND_RICH_SEGMENT_POLICY: import("./types.js").OutboundRichSegmentPolicy;
 /** 测试：清空 registry 后重新注册内置 kind */
 export declare function resetBuiltinRichSegmentKindsForTests(): void;
-//# sourceMappingURL=builtins.d.ts.map

package/lib/built/rich-segments/builtins.js

@@ -38,4 +38,3 @@ export function resetBuiltinRichSegmentKindsForTests() {
     richSegmentRegistry.clearForTests();
     registerBuiltinRichSegmentKinds();
 }
-//# sourceMappingURL=builtins.js.map

package/lib/built/rich-segments/capabilities.d.ts

@@ -4,4 +4,3 @@ export declare function registerRichSegmentCapabilityLoader(id: string, loader:
 /** 测试隔离 */
 export declare function resetRichSegmentCapabilityLoadersForTests(): void;
 export declare function createRichSegmentRenderContext(options?: RichSegmentCapabilityLoaderOptions): RichSegmentRenderContext;
-//# sourceMappingURL=capabilities.d.ts.map

package/lib/built/rich-segments/capabilities.js

@@ -37,4 +37,3 @@ export function createRichSegmentRenderContext(options = {}) {
         logContentChain: options.logContentChain,
     };
 }
-//# sourceMappingURL=capabilities.js.map

package/lib/built/rich-segments/html-segment.d.ts

@@ -1,5 +1,5 @@
 import { RichSegment } from './base.js';
-import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+import { type RichSegmentRenderContext, type RichSegmentRenderResult } from './types.js';
 export interface HtmlSegmentData {
     html: string;
     text?: string;
@@ -13,4 +13,3 @@ export declare class HtmlSegment extends RichSegment<HtmlSegmentData> {
     render(mode: string, ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
 }
 export declare function wrapHtmlSegment(data: Record<string, unknown>): HtmlSegment;
-//# sourceMappingURL=html-segment.d.ts.map

package/lib/built/rich-segments/html-segment.js

@@ -63,4 +63,3 @@ export function wrapHtmlSegment(data) {
         fileName: typeof data.fileName === 'string' ? data.fileName : undefined,
     });
 }
-//# sourceMappingURL=html-segment.js.map

package/lib/built/rich-segments/index.d.ts

@@ -11,4 +11,3 @@ export * from './tts-segment.js';
 export * from './markdown-to-text.js';
 export * from './resolve.js';
 export * from './adapter-policies.js';
-//# sourceMappingURL=index.d.ts.map

package/lib/built/rich-segments/index.js

@@ -11,4 +11,3 @@ export * from './tts-segment.js';
 export * from './markdown-to-text.js';
 export * from './resolve.js';
 export * from './adapter-policies.js';
-//# sourceMappingURL=index.js.map

package/lib/built/rich-segments/markdown-segment.d.ts

@@ -1,5 +1,5 @@
 import { RichSegment } from './base.js';
-import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+import { type RichSegmentRenderContext, type RichSegmentRenderResult } from './types.js';
 export interface MarkdownSegmentData {
     content: string;
     width?: number;
@@ -12,4 +12,3 @@ export declare class MarkdownSegment extends RichSegment<MarkdownSegmentData> {
     render(mode: string, ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
 }
 export declare function wrapMarkdownSegment(data: Record<string, unknown>): MarkdownSegment;
-//# sourceMappingURL=markdown-segment.d.ts.map

package/lib/built/rich-segments/markdown-segment.js

@@ -59,4 +59,3 @@ export function wrapMarkdownSegment(data) {
         fileName: typeof data.fileName === 'string' ? data.fileName : undefined,
     });
 }
-//# sourceMappingURL=markdown-segment.js.map

package/lib/built/rich-segments/markdown-to-text.d.ts

@@ -1,4 +1,3 @@
 /** 将 Markdown 转为可读纯文本（出站 text 降级用） */
 export declare function markdownToPlainText(md: string): string;
 export declare function markdownToHtmlForRender(md: string): string;
-//# sourceMappingURL=markdown-to-text.d.ts.map

package/lib/built/rich-segments/markdown-to-text.js

@@ -25,4 +25,3 @@ export function markdownToHtmlForRender(md) {
         .replace(/>/g, '>');
     return `<pre style="white-space:pre-wrap;font-family:sans-serif;font-size:14px;line-height:1.5;padding:16px;">${escaped}</pre>`;
 }
-//# sourceMappingURL=markdown-to-text.js.map

package/lib/built/rich-segments/qrcode-segment.d.ts

@@ -1,7 +1,7 @@
 import type { MessageElement } from '../../types.js';
 import { type GenerateQrCodeOptions } from '../generated-qrcode.js';
 import { RichSegment } from './base.js';
-import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+import { type RichSegmentRenderContext, type RichSegmentRenderResult } from './types.js';
 export interface QrcodeSegmentData extends GenerateQrCodeOptions {
     text: string;
     /** process origin 模式终端渲染时使用 */
@@ -16,4 +16,3 @@ export declare class QrcodeSegment extends RichSegment<QrcodeSegmentData> {
 export declare function wrapQrcodeSegment(data: Record<string, unknown>): QrcodeSegment;
 /** process endpoint：origin qrcode 段 → 终端 ASCII + 文本占位 */
 export declare function interpretOriginQrcodeForProcess(content: MessageElement | string | (MessageElement | string)[]): Promise<MessageElement | string | (MessageElement | string)[]>;
-//# sourceMappingURL=qrcode-segment.d.ts.map

package/lib/built/rich-segments/qrcode-segment.js

@@ -71,4 +71,3 @@ export async function interpretOriginQrcodeForProcess(content) {
         return out[0];
     return out;
 }
-//# sourceMappingURL=qrcode-segment.js.map

package/lib/built/rich-segments/registry.d.ts

@@ -14,4 +14,3 @@ export declare class RichSegmentRegistry {
 export declare const RICH_SEGMENT_FALLBACK_MODE = "origin";
 export declare const richSegmentRegistry: RichSegmentRegistry;
 export declare function registerRichSegmentKind(definition: RichSegmentKindDefinition): void;
-//# sourceMappingURL=registry.d.ts.map

package/lib/built/rich-segments/registry.js

@@ -50,4 +50,3 @@ export const richSegmentRegistry = new RichSegmentRegistry();
 export function registerRichSegmentKind(definition) {
     richSegmentRegistry.register(definition);
 }
-//# sourceMappingURL=registry.js.map

package/lib/built/rich-segments/resolve.d.ts

@@ -1,6 +1,5 @@
 import type { SendContent } from '../../types.js';
-import type { OutboundRichSegmentPolicy, RichSegmentRenderContext } from './types.js';
+import { type OutboundRichSegmentPolicy, type RichSegmentRenderContext } from './types.js';
 export declare function hasRichSegment(content: SendContent | undefined): boolean;
 /** 按 Adapter 出站策略在 renderSendMessage 首步统一渲染富媒体段 */
 export declare function resolveRichSegments(content: SendContent, policy: OutboundRichSegmentPolicy, ctx?: RichSegmentRenderContext): Promise<SendContent>;
-//# sourceMappingURL=resolve.d.ts.map

package/lib/built/rich-segments/resolve.js

@@ -85,4 +85,3 @@ export async function resolveRichSegments(content, policy, ctx) {
     }
     return packSegments(out);
 }
-//# sourceMappingURL=resolve.js.map

package/lib/built/rich-segments/tts-segment.d.ts

@@ -1,5 +1,5 @@
 import { RichSegment } from './base.js';
-import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+import { type RichSegmentRenderContext, type RichSegmentRenderResult } from './types.js';
 export interface TtsSegmentData {
     text: string;
     voice?: string;
@@ -11,4 +11,3 @@ export declare class TtsSegment extends RichSegment<TtsSegmentData> {
     render(mode: string, ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
 }
 export declare function wrapTtsSegment(data: Record<string, unknown>): TtsSegment;
-//# sourceMappingURL=tts-segment.d.ts.map

package/lib/built/rich-segments/tts-segment.js

@@ -49,4 +49,3 @@ export function wrapTtsSegment(data) {
         provider: typeof data.provider === 'string' ? data.provider : undefined,
     });
 }
-//# sourceMappingURL=tts-segment.js.map

package/lib/built/rich-segments/types.d.ts

@@ -82,4 +82,3 @@ export interface RichSegmentCapabilityLoaderOptions {
     logContentChain?: RichSegmentRenderContext['logContentChain'];
 }
 export type RichSegmentCapabilityLoader = (options: RichSegmentCapabilityLoaderOptions) => Promise<unknown>;
-//# sourceMappingURL=types.d.ts.map

package/lib/built/rich-segments/types.js

@@ -15,4 +15,3 @@ export const RICH_SEGMENT_MODE = {
     AUDIO: 'audio',
     VIDEO: 'video',
 };
-//# sourceMappingURL=types.js.map

package/lib/built/roles.d.ts

@@ -12,4 +12,3 @@ export declare function hasSenderRole(roles: Iterable<SenderRole>, role: SenderR
 export declare function formatSenderRolesForLabel(roles: readonly SenderRole[]): string;
 /** 剥离用户正文里自造的发送者前缀 */
 export declare function stripUserSpoofedSenderPrefix(rawContent: string): string;
-//# sourceMappingURL=roles.d.ts.map

package/lib/built/roles.js

@@ -60,4 +60,3 @@ export function stripUserSpoofedSenderPrefix(rawContent) {
     }
     return text;
 }
-//# sourceMappingURL=roles.js.map

package/lib/built/runtime-io.d.ts

@@ -7,4 +7,3 @@ export declare function shouldBindProcessStdin(): boolean;
 export declare function isInteractiveStdin(): boolean;
 export declare function isDenoDeploy(): boolean;
 export declare function bindStdin(onChunk: (chunk: string) => void): () => void;
-//# sourceMappingURL=runtime-io.d.ts.map

package/lib/built/runtime-io.js

@@ -65,4 +65,3 @@ export function bindStdin(onChunk) {
     process.stdin.on("data", handler);
     return () => process.stdin.removeListener("data", handler);
 }
-//# sourceMappingURL=runtime-io.js.map

package/lib/built/schedule.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ScheduleFeature — 管理插件注册的内存定时任务
+ */
+import { Feature, FeatureJSON, type ScheduleKind } from '@zhin.js/kernel';
+import type { HolidayInput, ScatterInput } from '@zhin.js/kernel';
+export interface ScheduleDescriptor {
+    kind: ScheduleKind | 'every' | 'at';
+    /** 6 段 cron（solar/lunar/workday/freeDay/holiday） */
+    cron?: string;
+    everyMs?: number;
+    atMs?: number;
+    scatterInput?: ScatterInput;
+    holidayInput?: HolidayInput;
+    tz?: string;
+}
+export interface ScheduleHandle {
+    id: string;
+    descriptor: ScheduleDescriptor;
+    dispose: () => void;
+}
+export interface ScheduleContextExtensions {
+    addSchedule(descriptor: ScheduleDescriptor, callback: () => void | Promise<void>, id?: string): () => void;
+}
+declare module '../plugin.js' {
+    namespace Plugin {
+        interface Extensions extends ScheduleContextExtensions {
+        }
+        interface Contexts {
+            schedule: ScheduleFeature;
+        }
+    }
+}
+export declare class ScheduleFeature extends Feature<ScheduleHandle> {
+    readonly name: "schedule";
+    readonly icon = "Clock";
+    readonly desc = "\u65E5\u5386\u8C03\u5EA6";
+    readonly byName: Map<string, ScheduleHandle>;
+    add(handle: ScheduleHandle, pluginName: string): () => void;
+    remove(handle: ScheduleHandle): boolean;
+    get(id: string): ScheduleHandle | undefined;
+    stopAll(): void;
+    getStatus(): Array<{
+        id: string;
+        kind: string;
+        expression?: string;
+        running: boolean;
+        nextExecution: Date | null;
+        plugin: string;
+    }>;
+    dispose(): void;
+    toJSON(pluginName?: string): FeatureJSON;
+    get extensions(): {
+        addSchedule(descriptor: ScheduleDescriptor, callback: () => void | Promise<void>, id?: string): () => void;
+    };
+}