@zhin.js/core 1.3.2 → 1.3.3

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,16 +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 { loadHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
-export { loadSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.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';
@@ -61,13 +69,11 @@ 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,16 +37,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 { loadHtmlRenderer, HTML_RENDERER_PACKAGE } from './built/html-renderer-loader.js';
-export { loadSpeechPipeline, SPEECH_PACKAGE } from './built/speech-loader.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';
@@ -59,12 +66,10 @@ 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";
 /**
@@ -17,11 +17,12 @@ export interface MessageChannel {
     id: string;
     type: MessageType;
     /**
-     * 私聊/子频道消息的来源场景（如 QQ 群临时会话：type=private + parent.group）。
-     * 出站时 adapter 据此选择 API（icqq → send_temp_msg）。
+     * 私聊/子频道消息的来源场景：
+     * - 群临时会话：type=private + parent.group
+     * - QQ 子频道：type=channel + parent.guild
      */
     parent?: {
-        type: 'group' | 'channel';
+        type: 'group' | 'channel' | 'guild';
         id: string;
     };
 }
@@ -58,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+$/, '')) {
@@ -103,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;
+    }
     /**
      * 插件名称
      */
@@ -212,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) {
@@ -291,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}`),
         };
     }
@@ -310,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)
@@ -573,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

package/lib/prompt.js

@@ -245,4 +245,3 @@ export class Prompt {
         }
     }
 }
-//# sourceMappingURL=prompt.js.map

package/lib/request.d.ts

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

package/lib/request.js

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

package/lib/tool-zod.d.ts

@@ -26,4 +26,3 @@ export interface CreateToolFromZodOptions {
  */
 export declare function createToolFromZod<T extends Record<string, any>>(name: string, description: string, schema: any, execute: (args: T, message?: Message<any>) => MaybePromise<any>, options?: CreateToolFromZodOptions): Tool;
 export {};
-//# sourceMappingURL=tool-zod.d.ts.map

package/lib/tool-zod.js

@@ -95,4 +95,3 @@ export function createToolFromZod(name, description, schema, execute, options) {
         kind: options?.kind,
     };
 }
-//# sourceMappingURL=tool-zod.js.map

package/lib/types-generator.d.ts

@@ -3,4 +3,3 @@
  * @param cwd 项目根目录
  */
 export declare function generateEnvTypes(cwd: string): Promise<void>;
-//# sourceMappingURL=types-generator.d.ts.map

package/lib/types-generator.js

@@ -69,4 +69,3 @@ export async function generateEnvTypes(cwd) {
         });
     }
 }
-//# sourceMappingURL=types-generator.js.map

package/lib/types.d.ts

@@ -1,11 +1,10 @@
-import { MessageChannel, Message } from "./message.js";
-import { Adapter, Adapters } from "./adapter.js";
-import { Endpoint } from "./endpoint.js";
-import { SystemLog } from "./models/system-log.js";
-import { User } from "./models/user.js";
-import { Databases, Registry } from "@zhin.js/database";
-import { MessageComponent } from "./message.js";
-import { ProcessAdapter } from "./built/adapter-process.js";
+import { MessageChannel, Message, MessageComponent } from './message.js';
+import { Adapter, Adapters } from './adapter.js';
+import { Endpoint } from './endpoint.js';
+import { SystemLog } from './models/system-log.js';
+import { User } from './models/user.js';
+import { Databases, Registry } from '@zhin.js/database';
+import { ProcessAdapter } from './built/adapter-process.js';
 export type { SenderRole } from "./built/roles.js";
 export type ArrayItem<T> = T extends Array<infer R> ? R : unknown;
 export interface Models extends Record<string, object> {
@@ -77,8 +76,27 @@ export interface QuotedMessagePayload {
 export interface QuotableEndpoint {
     $getMsg(messageId: string): Promise<QuotedMessagePayload>;
 }
-/** 出站回复来源（指令 / AI），仅当经 MessageDispatcher.replyWithPolish 发出时由框架填入异步上下文 */
-export type OutboundReplySource = 'command' | 'ai';
+/** 可选：编辑已发送消息（交互式棋盘更新） */
+export interface EditMessageOptions {
+    messageId: string;
+    context: string;
+    endpoint: string;
+    id: string;
+    type: 'private' | 'group' | 'channel';
+    content: SendContent;
+}
+export interface EditableEndpoint {
+    $editMessage?(options: EditMessageOptions): Promise<void>;
+}
+/** 出站回复来源（指令 / AI / proactive），仅当经 MessageDispatcher.replyWithPolish 或 runWithOutboundPolish 发出时由框架填入异步上下文 */
+export type OutboundReplySource = 'command' | 'ai' | 'proactive';
+export type OutboundReplyTrigger = 'inbound' | 'proactive';
+export interface OutboundReplyStore {
+    message: Message;
+    source: OutboundReplySource;
+    trigger: OutboundReplyTrigger;
+    proactiveSource?: string;
+}
 /**
  * 出站润色上下文（`dispatcher.addOutboundPolish` 的 handler 签名的同构类型）。
  * 与 {@link Adapter.sendMessage} → `before.sendMessage` 同一管道；需 `message`/`source` 时见 `getOutboundReplyStore`（dispatcher 导出）。
@@ -135,6 +153,8 @@ export interface SendOptions extends MessageChannel {
     context: string;
     endpoint: string;
     content: SendContent;
+    quoteId?: string;
+    threadId?: string;
 }
 /** `Adapter.sendMessage` 成功发出后由 core 分发的载荷 */
 export interface MessageSendPayload {
@@ -382,4 +402,3 @@ export interface PluginManifest {
 }
 /** @deprecated 使用 Tool 替代 */
 export type AITool = Tool;
-//# sourceMappingURL=types.d.ts.map