@zhin.js/core 1.3.1 → 1.3.3

package/lib/im-scene.js

@@ -0,0 +1,77 @@
+import { resolveIMSceneSessionId as resolveIMSceneSessionIdKernel, } from '@zhin.js/kernel';
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+/** Normalize legacy parent.type channel → guild. */
+export function normalizeIMSceneParentKind(value) {
+    if (value === 'group' || value === 'guild')
+        return value;
+    if (value === 'channel')
+        return 'guild';
+    return undefined;
+}
+export function sceneRefFromMessage(message) {
+    const platform = nonEmptyString(message.$adapter);
+    const endpointId = nonEmptyString(message.$endpoint);
+    const kind = message.$channel?.type;
+    if (!platform || !endpointId || !kind)
+        return undefined;
+    const senderId = nonEmptyString(message.$sender?.id);
+    const channelId = nonEmptyString(message.$channel?.id);
+    const sceneId = kind === 'private'
+        ? senderId ?? channelId
+        : channelId ?? senderId;
+    if (!sceneId)
+        return undefined;
+    const parentKind = message.$channel?.parent
+        ? normalizeIMSceneParentKind(message.$channel.parent.type)
+        : undefined;
+    const parent = parentKind && message.$channel?.parent
+        ? {
+            kind: parentKind,
+            sceneId: String(message.$channel.parent.id),
+        }
+        : undefined;
+    return {
+        platform,
+        endpointId,
+        sceneId,
+        kind,
+        ...(senderId ? { senderId } : {}),
+        ...(parent ? { parent } : {}),
+    };
+}
+export function sceneRefToSendOptions(target, content) {
+    const { scene } = target;
+    return {
+        context: scene.platform,
+        endpoint: scene.endpointId,
+        id: scene.sceneId,
+        type: scene.kind,
+        parent: scene.parent
+            ? { type: scene.parent.kind, id: scene.parent.sceneId }
+            : undefined,
+        content,
+        ...(target.quoteId ? { quoteId: target.quoteId } : {}),
+        ...(target.threadId ? { threadId: target.threadId } : {}),
+    };
+}
+export function resolveIMSceneSessionId(scene) {
+    return resolveIMSceneSessionIdKernel({
+        platform: scene.platform,
+        endpointId: scene.endpointId,
+        sceneId: scene.sceneId,
+        kind: scene.kind,
+    });
+}
+export function messageToIMDeliveryTarget(message) {
+    const scene = sceneRefFromMessage(message);
+    if (!scene)
+        return undefined;
+    const quoteId = nonEmptyString(message.$quote_id);
+    return {
+        channel: 'im',
+        scene,
+        ...(quoteId ? { quoteId } : {}),
+    };
+}

package/lib/im-session-id.d.ts

@@ -1,26 +1,39 @@
 /**
- * IM 会话 ID 解析（无 AI 依赖）
+ * IM 会话 ID 解析（SSOT 在 @zhin.js/kernel + im-scene）
  *
- * 格式：`platform:endpointId:scope:sceneId`
+ * 格式：`platform:endpointId:kind:sceneId`
  */
-export type IMSessionScope = 'private' | 'group' | 'channel';
-export interface ResolveIMSessionIdInput {
-    platform: string;
-    endpointId: string;
-    scope: IMSessionScope;
-    sceneId: string;
-}
+import { type ResolveIMSessionIdInput } from '@zhin.js/kernel';
+import { type IMSceneKind, type IMSceneRef } from './im-scene.js';
+export type { IMSceneKind, ResolveIMSessionIdInput };
 export declare function resolveIMSessionId(input: ResolveIMSessionIdInput): string;
-export declare function resolveIMSceneIdForSession(scope: IMSessionScope, sceneId?: string, senderId?: string): string;
+export declare function resolveIMSessionIdFromScene(scene: IMSceneRef): string;
+export declare function resolveIMSceneIdForSession(kind: IMSceneKind, sceneId?: string, senderId?: string): string;
 export declare function resolveIMSessionIdFromMessage(message: {
     $adapter?: string;
     $endpoint?: string;
     $channel?: {
-        type?: IMSessionScope;
+        type?: IMSceneKind;
         id?: string;
     };
     $sender?: {
         id?: string;
     };
 }): string;
-//# sourceMappingURL=im-session-id.d.ts.map
+/** Canonical scene fields for transcript / session persistence (ADR 0028 SSOT). */
+export declare function resolveSceneFieldsFromMessage(message: {
+    $adapter?: string;
+    $endpoint?: string;
+    $channel?: {
+        type?: IMSceneKind;
+        id?: string;
+    };
+    $sender?: {
+        id?: string;
+    };
+}): {
+    platform: string;
+    endpointId: string;
+    sceneId: string;
+    sceneType: IMSceneKind;
+};

package/lib/im-session-id.js

@@ -1,29 +1,47 @@
 /**
- * IM 会话 ID 解析（无 AI 依赖）
+ * IM 会话 ID 解析（SSOT 在 @zhin.js/kernel + im-scene）
  *
- * 格式：`platform:endpointId:scope:sceneId`
+ * 格式：`platform:endpointId:kind:sceneId`
  */
+import { resolveIMSceneIdForSession as resolveIMSceneIdForSessionKernel, resolveIMSessionId as resolveIMSessionIdKernel, } from '@zhin.js/kernel';
+import { resolveIMSceneSessionId, sceneRefFromMessage, } from './im-scene.js';
 export function resolveIMSessionId(input) {
-    const platform = String(input.platform || 'unknown');
-    const endpointId = String(input.endpointId || 'default');
-    const scope = input.scope || 'private';
-    const sceneId = String(input.sceneId || 'unknown');
-    return `${platform}:${endpointId}:${scope}:${sceneId}`;
+    return resolveIMSessionIdKernel(input);
 }
-export function resolveIMSceneIdForSession(scope, sceneId, senderId) {
-    if (scope === 'group' || scope === 'channel') {
-        return sceneId || senderId || 'unknown';
-    }
-    return senderId || sceneId || 'unknown';
+export function resolveIMSessionIdFromScene(scene) {
+    return resolveIMSceneSessionId(scene);
+}
+export function resolveIMSceneIdForSession(kind, sceneId, senderId) {
+    return resolveIMSceneIdForSessionKernel(kind, sceneId, senderId);
 }
 export function resolveIMSessionIdFromMessage(message) {
-    const scope = (message.$channel?.type || 'private');
-    const sceneId = resolveIMSceneIdForSession(scope, message.$channel?.id, message.$sender?.id);
+    const scene = sceneRefFromMessage(message);
+    if (scene)
+        return resolveIMSceneSessionId(scene);
+    const kind = (message.$channel?.type || 'private');
     return resolveIMSessionId({
         platform: String(message.$adapter || ''),
         endpointId: String(message.$endpoint || ''),
-        scope,
-        sceneId,
+        kind,
+        sceneId: resolveIMSceneIdForSession(kind, message.$channel?.id, message.$sender?.id),
     });
 }
-//# sourceMappingURL=im-session-id.js.map
+/** Canonical scene fields for transcript / session persistence (ADR 0028 SSOT). */
+export function resolveSceneFieldsFromMessage(message) {
+    const scene = sceneRefFromMessage(message);
+    if (scene) {
+        return {
+            platform: scene.platform,
+            endpointId: scene.endpointId,
+            sceneId: scene.sceneId,
+            sceneType: scene.kind,
+        };
+    }
+    const sceneType = (message.$channel?.type || 'private');
+    return {
+        platform: String(message.$adapter || ''),
+        endpointId: String(message.$endpoint || ''),
+        sceneType,
+        sceneId: resolveIMSceneIdForSession(sceneType, message.$channel?.id, message.$sender?.id),
+    };
+}

package/lib/index.d.ts

@@ -5,6 +5,7 @@ export * from './command.js';
 export * from './component.js';
 export * from './adapter.js';
 export * from './message.js';
+export * from './im-scene.js';
 export * from './notice.js';
 export * from './request.js';
 export * from './prompt.js';
@@ -14,7 +15,8 @@ export * from './utils.js';
 export * from './errors.js';
 export * from './built/config.js';
 export * from './built/command.js';
-export * from './built/cron.js';
+export * from './built/schedule.js';
+export type { ScheduleDescriptor, ScheduleHandle, ScheduleContextExtensions } from './built/schedule.js';
 export * from './models/system-log.js';
 export * from './models/user.js';
 export * from './built/permission.js';
@@ -34,9 +36,22 @@ export * from './built/common-adapter-tools.js';
 export * from './built/roles.js';
 export * from './im-session-id.js';
 export * from './built/ai-trigger.js';
+export * from './built/ai-access.js';
 export * from './built/dispatcher.js';
 export * from './built/schema-feature.js';
 export * from './built/login-assist.js';
+export * from './built/generated-qrcode.js';
+export * from './built/qrcode-segment.js';
+export * from './built/rich-segments/index.js';
+export * from './built/interactive-segments/index.js';
+export * from './built/ai-outbound/index.js';
+export { loadHtmlRenderer, seedHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
+export { loadSpeechPipeline, seedSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
+export * from './built/outbound-media-utils.js';
+export * from './built/outbound-media-contract.js';
+export * from './built/interactive-segment-contract.js';
+export * from './built/segment-contract/index.js';
+export * from './built/generic-segment-mapper.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/inbound-runner.js';
@@ -45,15 +60,20 @@ export * from './built/connect-endpoint-instance.js';
 export type { ConnectEndpointInstanceOptions } from './built/connect-endpoint-instance.js';
 export * from './built/endpoint-lifecycle.js';
 export type { EndpointLifecycleKind, EndpointLifecyclePayload } from './built/endpoint-lifecycle.js';
+export * from './built/endpoint-manager.js';
+export type { EndpointConfigRecord, EndpointManager, ProvisionContext } from './built/endpoint-manager.js';
+export * from './built/endpoint-lifecycle-service.js';
+export * from './built/schema-endpoint-manager.js';
+export * from './built/endpoint-commands.js';
+export * from './built/introspection-format.js';
+export * from './built/management-command-guard.js';
 export * from './built/html-to-text.js';
 export * from './built/html-segment-fallback.js';
-export * from './built/mcp-mesh-registrar.js';
 export * from './built/prepend-quote-context.js';
 export * from './message-quote.js';
 export * from '@zhin.js/database';
 export * from '@zhin.js/logger';
 export { Schema } from '@zhin.js/schema';
 export type { PluginLike } from '@zhin.js/kernel';
-export { Feature, Cron, Scheduler, getScheduler, setScheduler } from '@zhin.js/kernel';
-export type { FeatureJSON, FeatureListener, Schedule, JobPayload, JobState, ScheduledJob, JobStore, JobCallback, AddJobOptions, IScheduler, SchedulerOptions, } from '@zhin.js/kernel';
-//# sourceMappingURL=index.d.ts.map
+export { Feature, ScheduleEngine, getScheduleEngine, setScheduleEngine, Scheduler, getScheduler, setScheduler, } from '@zhin.js/kernel';
+export type { FeatureJSON, FeatureListener, Schedule, JobPayload, JobState, ScheduledJob, JobStore, JobCallback, AddJobOptions, IScheduler, SchedulerOptions, ScheduleFireCallback, MemoryScheduleRegistration, ScheduleEngineOptions, JobContext, ResolvedJob, ScheduleKind, } from '@zhin.js/kernel';

package/lib/index.js

@@ -6,6 +6,7 @@ export * from './command.js';
 export * from './component.js';
 export * from './adapter.js';
 export * from './message.js';
+export * from './im-scene.js';
 export * from './notice.js';
 export * from './request.js';
 export * from './prompt.js';
@@ -16,7 +17,7 @@ export * from './errors.js';
 // ── Built 模块 ──────────────────────────────────────────────────────
 export * from './built/config.js';
 export * from './built/command.js';
-export * from './built/cron.js';
+export * from './built/schedule.js';
 // Models
 export * from './models/system-log.js';
 export * from './models/user.js';
@@ -36,22 +37,39 @@ export * from './built/common-adapter-tools.js';
 export * from './built/roles.js';
 export * from './im-session-id.js';
 export * from './built/ai-trigger.js';
+export * from './built/ai-access.js';
 export * from './built/dispatcher.js';
 export * from './built/schema-feature.js';
 export * from './built/login-assist.js';
+export * from './built/generated-qrcode.js';
+export * from './built/qrcode-segment.js';
+export * from './built/rich-segments/index.js';
+export * from './built/interactive-segments/index.js';
+export * from './built/ai-outbound/index.js';
+export { loadHtmlRenderer, seedHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
+export { loadSpeechPipeline, seedSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.js';
+export * from './built/outbound-media-utils.js';
+export * from './built/outbound-media-contract.js';
+export * from './built/interactive-segment-contract.js';
+export * from './built/segment-contract/index.js';
+export * from './built/generic-segment-mapper.js';
 export * from './built/adapter-process.js';
 export * from './built/component.js';
 export * from './built/inbound-runner.js';
 export * from './built/connect-endpoint-instance.js';
 export * from './built/endpoint-lifecycle.js';
+export * from './built/endpoint-manager.js';
+export * from './built/endpoint-lifecycle-service.js';
+export * from './built/schema-endpoint-manager.js';
+export * from './built/endpoint-commands.js';
+export * from './built/introspection-format.js';
+export * from './built/management-command-guard.js';
 export * from './built/html-to-text.js';
 export * from './built/html-segment-fallback.js';
-export * from './built/mcp-mesh-registrar.js';
 export * from './built/prepend-quote-context.js';
 export * from './message-quote.js';
 // ── 外部库 re-export ──────────────────────────────────────────────────
 export * from '@zhin.js/database';
 export * from '@zhin.js/logger';
 export { Schema } from '@zhin.js/schema';
-export { Feature, Cron, Scheduler, getScheduler, setScheduler } from '@zhin.js/kernel';
-//# sourceMappingURL=index.js.map
+export { Feature, ScheduleEngine, getScheduleEngine, setScheduleEngine, Scheduler, getScheduler, setScheduler, } from '@zhin.js/kernel';

package/lib/jsx-dev-runtime.d.ts

@@ -1,3 +1,2 @@
 export * from './jsx-runtime.js';
 export { jsx as jsxDEV } from './jsx.js';
-//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/lib/jsx-dev-runtime.js

@@ -1,3 +1,2 @@
 export * from './jsx-runtime.js';
 export { jsx as jsxDEV } from './jsx.js';
-//# sourceMappingURL=jsx-dev-runtime.js.map

package/lib/jsx-runtime.d.ts

@@ -9,4 +9,3 @@ declare const _default: {
     renderJSX: typeof renderJSX;
 };
 export default _default;
-//# sourceMappingURL=jsx-runtime.d.ts.map

package/lib/jsx-runtime.js

@@ -8,4 +8,3 @@ export default {
     Fragment,
     renderJSX
 };
-//# sourceMappingURL=jsx-runtime.js.map

package/lib/jsx.d.ts

@@ -30,4 +30,3 @@ declare global {
 export declare function jsx(type: JSXElementType, data: JSXProps): MessageComponent<any>;
 export declare function jsxs(type: JSXElementType, props: JSXProps): MessageElement;
 export declare function renderJSX(element: MessageComponent<any>, context?: ComponentContext): Promise<SendContent>;
-//# sourceMappingURL=jsx.d.ts.map

package/lib/jsx.js

@@ -91,4 +91,3 @@ async function renderChildren(children, context) {
     }
     return '';
 }
-//# sourceMappingURL=jsx.js.map

package/lib/message-quote.d.ts

@@ -6,6 +6,5 @@ export declare function quoteIdFromContent(content: MessageElement[]): string |
 export declare function quoteIdFromRaw(raw: unknown): string | undefined;
 /** 无 $quote_id 时从 $content / $raw 回填 */
 export declare function syncQuoteId(message: Message<any>): void;
-/** 将 reply 段的 id / message_id 与 $quote_id 对齐 */
+/** 将 reply 段与 $quote_id 对齐（canonical 仅保留 message_id） */
 export declare function alignReplySegments(content: MessageElement[], quoteId?: string): void;
-//# sourceMappingURL=message-quote.d.ts.map

package/lib/message-quote.js

@@ -75,7 +75,7 @@ export function syncQuoteId(message) {
     if (id)
         message.$quote_id = id;
 }
-/** 将 reply 段的 id / message_id 与 $quote_id 对齐 */
+/** 将 reply 段与 $quote_id 对齐（canonical 仅保留 message_id） */
 export function alignReplySegments(content, quoteId) {
     const id = quoteId ?? quoteIdFromContent(content);
     if (!id)
@@ -84,8 +84,7 @@ export function alignReplySegments(content, quoteId) {
         if (seg.type !== 'reply' || !seg.data || typeof seg.data !== 'object')
             continue;
         const data = seg.data;
-        data.id = id;
         data.message_id = id;
+        delete data.id;
     }
 }
-//# sourceMappingURL=message-quote.js.map

package/lib/message.d.ts

@@ -1,4 +1,4 @@
-import { MessageElement, MessageSender, SendContent } from "./types";
+import { MessageElement, MessageSender, SendContent } from "./types.js";
 import { Component } from "./component.js";
 import { Adapters } from "./adapter.js";
 /**
@@ -16,6 +16,15 @@ export type MessageComponent<T extends object> = {
 export interface MessageChannel {
     id: string;
     type: MessageType;
+    /**
+     * 私聊/子频道消息的来源场景：
+     * - 群临时会话：type=private + parent.group
+     * - QQ 子频道：type=channel + parent.guild
+     */
+    parent?: {
+        type: 'group' | 'channel' | 'guild';
+        id: string;
+    };
 }
 /**
  * 消息类型枚举
@@ -50,5 +59,6 @@ export declare namespace Message {
     function quoteIdFromContent(content: MessageElement[]): string | undefined;
     function syncQuoteId(message: Message<any>): void;
     function alignReplySegments(content: MessageElement[], quoteId?: string): void;
+    function actionPayload(message: Message<any>): string | undefined;
+    function isAction(message: Message<any>): boolean;
 }
-//# sourceMappingURL=message.d.ts.map

package/lib/message.js

@@ -1,4 +1,5 @@
 import { alignReplySegments as alignReplySegmentsImpl, quoteIdFromContent as quoteIdFromContentImpl, syncQuoteId as syncQuoteIdImpl, } from "./message-quote.js";
+import { isActionMessage as isActionMessageImpl } from "./built/interactive-segments/action.js";
 export var Message;
 (function (Message) {
     /**
@@ -20,5 +21,19 @@ export var Message;
         alignReplySegmentsImpl(content, quoteId);
     }
     Message.alignReplySegments = alignReplySegments;
+    function actionPayload(message) {
+        for (const item of message.$content ?? []) {
+            if (typeof item === 'string')
+                continue;
+            if (item.type === 'action' && item.data?.payload) {
+                return String(item.data.payload);
+            }
+        }
+        return undefined;
+    }
+    Message.actionPayload = actionPayload;
+    function isAction(message) {
+        return isActionMessageImpl(message);
+    }
+    Message.isAction = isAction;
 })(Message || (Message = {}));
-//# sourceMappingURL=message.js.map

package/lib/models/system-log.d.ts

@@ -8,4 +8,3 @@ export interface SystemLog {
     timestamp: Date;
 }
 export declare const SystemLogDefinition: Definition<SystemLog>;
-//# sourceMappingURL=system-log.d.ts.map

package/lib/models/system-log.js

@@ -6,4 +6,3 @@ export const SystemLogDefinition = {
     source: { type: 'text', nullable: false },
     timestamp: { type: 'date', nullable: false }
 };
-//# sourceMappingURL=system-log.js.map

package/lib/models/user.d.ts

@@ -7,4 +7,3 @@ export interface User {
     permissions?: string[];
 }
 export declare const UserDefinition: Definition<User>;
-//# sourceMappingURL=user.d.ts.map

package/lib/models/user.js

@@ -5,4 +5,3 @@ export const UserDefinition = {
     third_part: { type: 'json', default: [] },
     permissions: { type: 'json', default: [] }
 };
-//# sourceMappingURL=user.js.map

package/lib/notice.d.ts

@@ -79,4 +79,3 @@ export declare namespace Notice {
      */
     function from<T extends object>(input: T, format: NoticeBase): Notice<T>;
 }
-//# sourceMappingURL=notice.d.ts.map

package/lib/notice.js

@@ -8,4 +8,3 @@ export var Notice;
     }
     Notice.from = from;
 })(Notice || (Notice = {}));
-//# sourceMappingURL=notice.js.map

package/lib/plugin-context.d.ts

@@ -27,4 +27,3 @@ export declare function getCurrentFile(metaUrl?: string): string;
  * @see docs/guide/plugin-development.md#getplugin-与-useplugin
  */
 export declare function getPlugin(): Plugin;
-//# sourceMappingURL=plugin-context.d.ts.map

package/lib/plugin-context.js

@@ -59,4 +59,3 @@ export function getPlugin() {
     }
     return plugin;
 }
-//# sourceMappingURL=plugin-context.js.map

package/lib/plugin.d.ts

@@ -7,6 +7,7 @@
  * - 中间件系统、适配器管理、useContext 等
  */
 import type { PluginManifest } from "./types.js";
+import type { InteractiveHandler } from "./built/interactive-segments/types.js";
 import { MessageMiddleware, RegisteredAdapter, MaybePromise, ArrayItem, SendOptions, MessageSendPayload } from "./types.js";
 import { Adapter, Adapters } from "./adapter.js";
 import { PluginBase, PluginBaseLifecycle } from "@zhin.js/kernel";
@@ -64,6 +65,10 @@ export declare class Plugin extends PluginBase implements PluginLike {
      * 中间件用于处理消息流转
      */
     addMiddleware<T extends RegisteredAdapter>(middleware: MessageMiddleware<T>, name?: string): () => void;
+    /**
+     * 注册交互式 action 回调处理器（自动安装根中间件，优先于 Dispatcher）
+     */
+    registerInteractiveHandler(prefix: string, handler: InteractiveHandler): () => void;
     /**
      * 插件名称
      */
@@ -159,7 +164,7 @@ export declare namespace Plugin {
     interface Features {
         commands: string[];
         components: string[];
-        crons: string[];
+        schedules: string[];
         middlewares: string[];
     }
     /**
@@ -193,6 +198,8 @@ export declare namespace Plugin {
         "ai.response": [Plugin.AIEventPayload];
         "ai.typing.start": [Plugin.AIEventPayload];
         "ai.typing.stop": [Plugin.AIEventPayload];
+        "ai.activity.queued.start": [Plugin.AIEventPayload];
+        "ai.activity.queued.clear": [Plugin.AIEventPayload];
         "ai.subagent.spawn": [Plugin.AIEventPayload];
         "ai.subagent.start": [Plugin.AIEventPayload];
         "ai.subagent.finish": [Plugin.AIEventPayload];
@@ -204,6 +211,9 @@ export declare namespace Plugin {
         "ai.session.new": [Plugin.AIEventPayload];
         "ai.session.compact": [Plugin.AIEventPayload];
         "ai.hook": [Plugin.AIEventPayload];
+        "schedule.start": [Plugin.AIEventPayload];
+        "schedule.finish": [Plugin.AIEventPayload];
+        "schedule.error": [Plugin.AIEventPayload];
     }
     interface AIEventPayload {
         sessionId: string;
@@ -257,4 +267,3 @@ export declare namespace Plugin {
     interface Extensions {
     }
 }
-//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.js

@@ -11,6 +11,7 @@ import * as path from "node:path";
 import { pathToFileURL } from "node:url";
 import { formatCompact } from "@zhin.js/logger";
 import { compose, remove, resolveEntry } from "./utils.js";
+import { ensureInteractiveMiddleware, registerInteractiveHandler as registerInteractiveHandlerCore, } from "./built/interactive-segments/handlers.js";
 import { Adapter } from "./adapter.js";
 import { Feature } from "@zhin.js/kernel";
 import { PluginBase, resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy, } from "@zhin.js/kernel";
@@ -36,7 +37,9 @@ function pluginCreateRequire() {
  * 同一上下文中同一文件多次调用返回同一实例
  */
 export function usePlugin() {
-    const callerFile = getCurrentFile();
+    // 必须传入 plugin.ts 的 import.meta.url：getCurrentFile 默认锚定在 plugin-context.ts，
+    // 否则会多跳一层 usePlugin 帧，把调用方误判为 plugin.ts（plugin.name === "plugin"）。
+    const callerFile = getCurrentFile(import.meta.url);
     // 如果当前 store 已是同一文件创建的插件，直接返回
     const current = storage.getStore();
     if (current && current.filePath.replace(/\?t=\d+$/, '') === callerFile.replace(/\?t=\d+$/, '')) {
@@ -72,22 +75,9 @@ export class Plugin extends PluginBase {
     get root() {
         return super.root;
     }
-    // 插件功能
-    #messageMiddleware = async (message, next) => {
-        const commandService = this.inject('command');
-        if (!commandService)
-            return await next();
-        const result = await commandService.handle(message, this);
-        if (result === undefined || result === null)
-            return await next();
-        const adapter = this.inject(message.$adapter);
-        if (!adapter || !(adapter instanceof Adapter))
-            return await next();
-        if (!message.$reply) {
-            this.logger.warn(`command result cannot be sent: endpoint ${message.$endpoint} has no outbound capability`);
-            return;
-        }
-        await message.$reply(result);
+    // 默认中间件：将入站消息交给 compose 链末端的 MessageDispatcher（命令/AI 路由在 dispatcher 内完成）
+    #messageMiddleware = async (_message, next) => {
+        await next();
     };
     #middlewares = [this.#messageMiddleware];
     get middleware() {
@@ -116,6 +106,15 @@ export class Plugin extends PluginBase {
         this.onDispose(dispose);
         return dispose;
     }
+    /**
+     * 注册交互式 action 回调处理器（自动安装根中间件，优先于 Dispatcher）
+     */
+    registerInteractiveHandler(prefix, handler) {
+        ensureInteractiveMiddleware((mw) => this.root.addMiddleware(mw));
+        const dispose = registerInteractiveHandlerCore(prefix, handler);
+        this.onDispose(dispose);
+        return dispose;
+    }
     /**
      * 插件名称
      */
@@ -225,7 +224,8 @@ export class Plugin extends PluginBase {
         contextReadyCallback();
     }
     inject(name) {
-        const context = this.root.contexts.get(name);
+        const resolved = name === 'cron' ? 'schedule' : name;
+        const context = this.root.contexts.get(resolved);
         return context?.value;
     }
     injectAdapter(name) {
@@ -304,11 +304,11 @@ export class Plugin extends PluginBase {
     get features() {
         const commandService = this.inject('command');
         const componentService = this.inject('component');
-        const cronService = this.inject('cron');
+        const scheduleService = this.inject('schedule');
         return {
             commands: commandService ? commandService.items.map(c => c.pattern) : [],
             components: componentService ? componentService.getAllNames() : [],
-            crons: cronService ? cronService.items.map(c => c.cronExpression) : [],
+            schedules: scheduleService ? scheduleService.items.map(s => s.id) : [],
             middlewares: this.#middlewares.map((m, i) => m.name || `middleware_${i}`),
         };
     }
@@ -323,8 +323,8 @@ export class Plugin extends PluginBase {
             result.push({ name: 'command', count: f.commands.length });
         if (f.components.length > 0)
             result.push({ name: 'component', count: f.components.length });
-        if (f.crons.length > 0)
-            result.push({ name: 'cron', count: f.crons.length });
+        if (f.schedules.length > 0)
+            result.push({ name: 'schedule', count: f.schedules.length });
         // #middlewares includes the default command middleware, only count user-added ones
         const userMiddlewareCount = this.#middlewares.length - 1; // subtract default #messageMiddleware
         if (userMiddlewareCount > 0)
@@ -586,4 +586,3 @@ export class Plugin extends PluginBase {
 export function defineContext(options) {
     return options;
 }
-//# sourceMappingURL=plugin.js.map

package/lib/prompt.d.ts

@@ -115,4 +115,3 @@ export declare namespace Prompt {
     };
     export {};
 }
-//# sourceMappingURL=prompt.d.ts.map