@downcity/plugins 1.0.4

package/bin/chat/runtime/DirectDispatchParser.js

@@ -0,0 +1,133 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import { buildChatMessageText, parseChatMessageMarkup, } from "@downcity/agent/internal/executor/messages/ChatMessageMarkup.js";
+import { parseChatSendOptionsFromMetadata } from "../../chat/runtime/ChatSendMetadata.js";
+function normalizeText(value) {
+    return String(value ?? "").trim();
+}
+function parseBoolean(value) {
+    if (typeof value === "boolean")
+        return value;
+    const text = normalizeText(value).toLowerCase();
+    return text === "true" || text === "1" || text === "yes";
+}
+function parseReactionFromMetadata(value) {
+    if (typeof value === "string") {
+        const emoji = normalizeText(value);
+        return emoji ? { emoji } : null;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const raw = value;
+    const emoji = normalizeText(raw.emoji);
+    if (!emoji)
+        return null;
+    const big = parseBoolean(raw.big);
+    return {
+        emoji,
+        ...(big ? { big: true } : {}),
+    };
+}
+function parseReactionsFromMetadata(metadata) {
+    const out = [];
+    const raw = metadata.react;
+    if (!raw)
+        return out;
+    const list = Array.isArray(raw) ? raw : [raw];
+    for (const item of list) {
+        const parsed = parseReactionFromMetadata(item);
+        if (!parsed)
+            continue;
+        out.push(parsed);
+    }
+    return out;
+}
+function resolveTextPlan(params) {
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const text = buildChatMessageText({
+        segments: params.segments,
+    });
+    if (!chatKey || !text)
+        return null;
+    return {
+        text,
+        chatKey,
+        replyToMessage: sendOptions.replyToMessage === true,
+        ...(typeof sendOptions.messageId === "string" && sendOptions.messageId
+            ? { messageId: sendOptions.messageId }
+            : {}),
+        ...(typeof sendOptions.delayMs === "number"
+            ? { delayMs: sendOptions.delayMs }
+            : {}),
+        ...(typeof sendOptions.sendAtMs === "number"
+            ? { sendAtMs: sendOptions.sendAtMs }
+            : {}),
+    };
+}
+function resolveReactionPlans(params) {
+    const out = [];
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const messageId = normalizeText(sendOptions.messageId);
+    if (!chatKey)
+        return out;
+    for (const react of params.reacts) {
+        const emoji = normalizeText(react.emoji);
+        if (!emoji)
+            continue;
+        out.push({
+            emoji,
+            chatKey,
+            ...(messageId ? { messageId } : {}),
+            big: react.big === true,
+        });
+    }
+    return out;
+}
+/**
+ * 从 assistant 文本中解析 direct 出站执行计划。
+ *
+ * 协议（中文）
+ * - frontmatter metadata：与 `city chat send` 参数保持一致。
+ * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
+ * - `react` 仍仅用于 direct 模式的反应动作。
+ */
+export function parseDirectDispatchAssistantText(params) {
+    const source = String(params.assistantText ?? "");
+    const fallbackChatKey = normalizeText(params.fallbackChatKey);
+    if (!normalizeText(source) || !fallbackChatKey)
+        return null;
+    const parsed = parseChatMessageMarkup(source);
+    const reacts = parseReactionsFromMetadata(parsed.metadata);
+    const textPlan = resolveTextPlan({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        segments: parsed.segments,
+    });
+    const reactionPlans = resolveReactionPlans({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        reacts,
+    });
+    if (!textPlan && reactionPlans.length === 0)
+        return null;
+    return {
+        text: textPlan,
+        reactions: reactionPlans,
+    };
+}
+//# sourceMappingURL=DirectDispatchParser.js.map

package/bin/chat/runtime/DirectDispatchParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectDispatchParser.js","sourceRoot":"","sources":["../../../src/chat/runtime/DirectDispatchParser.ts"],"names":[],"mappings":"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"}

package/bin/chat/runtime/EnqueueDispatch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Chat enqueue dispatch helper。
+ *
+ * 关键点（中文）
+ * - 统一封装入队前/后的扩展点调用。
+ * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatEnqueueEffectInput, ChatEnqueuePipelineInput } from "../../chat/types/ChatPlugin.js";
+/**
+ * 入队前增强。
+ */
+export declare function prepareChatEnqueue(params: {
+    context: AgentContext;
+    input: ChatEnqueuePipelineInput;
+}): Promise<ChatEnqueuePipelineInput>;
+/**
+ * 入队后通知。
+ */
+export declare function emitChatEnqueueEffect(params: {
+    context: AgentContext;
+    input: ChatEnqueueEffectInput;
+}): Promise<void>;
+//# sourceMappingURL=EnqueueDispatch.d.ts.map

package/bin/chat/runtime/EnqueueDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnqueueDispatch.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/EnqueueDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAQpC;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,wBAAwB,CAAC;CACjC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CASpC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/bin/chat/runtime/EnqueueDispatch.js

@@ -0,0 +1,28 @@
+/**
+ * Chat enqueue dispatch helper。
+ *
+ * 关键点（中文）
+ * - 统一封装入队前/后的扩展点调用。
+ * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../chat/runtime/PluginPoints.js";
+function normalizeText(value) {
+    return String(value || "").trim();
+}
+/**
+ * 入队前增强。
+ */
+export async function prepareChatEnqueue(params) {
+    const normalized = {
+        ...params.input,
+        text: normalizeText(params.input.text),
+    };
+    return params.context.plugins.pipeline(CHAT_PLUGIN_POINTS.beforeEnqueue, normalized);
+}
+/**
+ * 入队后通知。
+ */
+export async function emitChatEnqueueEffect(params) {
+    await params.context.plugins.effect(CHAT_PLUGIN_POINTS.afterEnqueue, params.input);
+}
+//# sourceMappingURL=EnqueueDispatch.js.map

package/bin/chat/runtime/EnqueueDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnqueueDispatch.js","sourceRoot":"","sources":["../../../src/chat/runtime/EnqueueDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAGxC;IACC,MAAM,UAAU,GAA6B;QAC3C,GAAG,MAAM,CAAC,KAAK;QACf,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;KACvC,CAAC;IACF,OAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CACrC,kBAAkB,CAAC,aAAa,EAChC,UAAkC,CACc,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAG3C;IACC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CACjC,kBAAkB,CAAC,YAAY,EAC/B,MAAM,CAAC,KAA6B,CACrC,CAAC;AACJ,CAAC"}

package/bin/chat/runtime/InboundAugment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Chat inbound augment helper。
+ *
+ * 关键点（中文）
+ * - chat plugin runtime 先构造基础输入，再交给 plugin pipeline 做增强。
+ * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatInboundAugmentInput } from "../../chat/types/ChatPlugin.js";
+/**
+ * 执行 chat 入站增强 pipeline。
+ */
+export declare function augmentChatInboundInput(params: {
+    context: AgentContext;
+    input: ChatInboundAugmentInput;
+}): Promise<ChatInboundAugmentInput>;
+/**
+ * 把增强后的 chat 入站输入拼成最终正文。
+ */
+export declare function buildChatInboundText(input: ChatInboundAugmentInput): string;
+//# sourceMappingURL=InboundAugment.d.ts.map

package/bin/chat/runtime/InboundAugment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAS1E;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,uBAAuB,CAAC;CAChC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsBnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAW3E"}

package/bin/chat/runtime/InboundAugment.js

@@ -0,0 +1,50 @@
+/**
+ * Chat inbound augment helper。
+ *
+ * 关键点（中文）
+ * - chat plugin runtime 先构造基础输入，再交给 plugin pipeline 做增强。
+ * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../chat/runtime/PluginPoints.js";
+function normalizeText(value) {
+    const text = String(value || "").trim();
+    return text || undefined;
+}
+/**
+ * 执行 chat 入站增强 pipeline。
+ */
+export async function augmentChatInboundInput(params) {
+    const normalized = {
+        ...params.input,
+        ...(params.input.chatType ? { chatType: params.input.chatType } : {}),
+        ...(params.input.chatKey ? { chatKey: params.input.chatKey } : {}),
+        ...(params.input.messageId ? { messageId: params.input.messageId } : {}),
+        ...(normalizeText(params.input.attachmentText)
+            ? { attachmentText: normalizeText(params.input.attachmentText) }
+            : {}),
+        ...(normalizeText(params.input.bodyText)
+            ? { bodyText: normalizeText(params.input.bodyText) }
+            : {}),
+        pluginSections: Array.isArray(params.input.pluginSections)
+            ? params.input.pluginSections.map((item) => String(item || "").trim()).filter(Boolean)
+            : [],
+        attachments: Array.isArray(params.input.attachments) ? params.input.attachments : [],
+    };
+    return params.context.plugins.pipeline(CHAT_PLUGIN_POINTS.augmentInbound, normalized);
+}
+/**
+ * 把增强后的 chat 入站输入拼成最终正文。
+ */
+export function buildChatInboundText(input) {
+    return [
+        normalizeText(input.attachmentText),
+        ...(Array.isArray(input.pluginSections)
+            ? input.pluginSections.map((item) => normalizeText(item)).filter(Boolean)
+            : []),
+        normalizeText(input.bodyText),
+    ]
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+//# sourceMappingURL=InboundAugment.js.map

package/bin/chat/runtime/InboundAugment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.js","sourceRoot":"","sources":["../../../src/chat/runtime/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,SAAS,aAAa,CAAC,KAAyB;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAG7C;IACC,MAAM,UAAU,GAA4B;QAC1C,GAAG,MAAM,CAAC,KAAK;QACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;YAC5C,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE;YAChE,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACtC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;YACxD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACtF,CAAC,CAAC,EAAE;QACN,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;KACrF,CAAC;IAEF,OAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CACrC,kBAAkB,CAAC,cAAc,EACjC,UAAkC,CACa,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,OAAO;QACL,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC;QACnC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;YACrC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACzE,CAAC,CAAC,EAAE,CAAC;QACP,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;KAC9B;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/bin/chat/runtime/PluginDispatch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PluginDispatch：chat 领域的 plugin 调用辅助。
+ *
+ * 关键点（中文）
+ * - chat plugin runtime 只依赖这里，不直接依赖某个具体 plugin 模块路径。
+ * - 这里封装 chat 领域的 plugin 点调用语义，保持 service 边界稳定。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatAuthorizationEvaluateInput, ChatAuthorizationRole } from "../../auth/types/AuthPlugin.js";
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+/**
+ * 观测入站主体。
+ */
+export declare function observeIncomingChatPrincipal(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    chatType?: string;
+    chatTitle?: string;
+    userId?: string;
+    username?: string;
+}): Promise<void>;
+/**
+ * 校验入站消息是否允许执行。
+ *
+ * 关键点（中文）
+ * - 这是 guard 语义：允许则静默返回，拒绝则直接抛错。
+ * - 这样 chat plugin runtime 可以像处理中间件一样串联 guard 点。
+ */
+export declare function guardIncomingChat(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    input: ChatAuthorizationEvaluateInput;
+}): Promise<void>;
+/**
+ * 解析用户角色。
+ */
+export declare function resolveIncomingChatUserRole(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    userId?: string;
+}): Promise<ChatAuthorizationRole | undefined>;
+//# sourceMappingURL=PluginDispatch.d.ts.map

package/bin/chat/runtime/PluginDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginDispatch.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/PluginDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EAEV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAQ1E;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,8BAA8B,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAW7C"}

package/bin/chat/runtime/PluginDispatch.js

@@ -0,0 +1,57 @@
+/**
+ * PluginDispatch：chat 领域的 plugin 调用辅助。
+ *
+ * 关键点（中文）
+ * - chat plugin runtime 只依赖这里，不直接依赖某个具体 plugin 模块路径。
+ * - 这里封装 chat 领域的 plugin 点调用语义，保持 service 边界稳定。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../chat/runtime/PluginPoints.js";
+function toRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return value;
+}
+/**
+ * 观测入站主体。
+ */
+export async function observeIncomingChatPrincipal(params) {
+    await params.context.plugins.effect(CHAT_PLUGIN_POINTS.observePrincipal, {
+        channel: params.channel,
+        chatId: params.chatId,
+        ...(params.chatType ? { chatType: params.chatType } : {}),
+        ...(params.chatTitle ? { chatTitle: params.chatTitle } : {}),
+        ...(params.userId ? { userId: params.userId } : {}),
+        ...(params.username ? { username: params.username } : {}),
+    });
+}
+/**
+ * 校验入站消息是否允许执行。
+ *
+ * 关键点（中文）
+ * - 这是 guard 语义：允许则静默返回，拒绝则直接抛错。
+ * - 这样 chat plugin runtime 可以像处理中间件一样串联 guard 点。
+ */
+export async function guardIncomingChat(params) {
+    await params.context.plugins.guard(CHAT_PLUGIN_POINTS.authorizeIncoming, {
+        channel: params.channel,
+        chatId: params.input.chatId,
+        ...(params.input.chatType ? { chatType: params.input.chatType } : {}),
+        ...(params.input.userId ? { userId: params.input.userId } : {}),
+        ...(params.input.username ? { username: params.input.username } : {}),
+        ...(params.input.chatTitle ? { chatTitle: params.input.chatTitle } : {}),
+    });
+}
+/**
+ * 解析用户角色。
+ */
+export async function resolveIncomingChatUserRole(params) {
+    const result = await params.context.plugins.resolve(CHAT_PLUGIN_POINTS.resolveUserRole, {
+        channel: params.channel,
+        ...(params.userId ? { userId: params.userId } : {}),
+    });
+    const role = toRecord(result);
+    if (!role.roleId)
+        return undefined;
+    return role;
+}
+//# sourceMappingURL=PluginDispatch.js.map

package/bin/chat/runtime/PluginDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginDispatch.js","sourceRoot":"","sources":["../../../src/chat/runtime/PluginDispatch.ts"],"names":[],"mappings":"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"}

package/bin/chat/runtime/PluginPoints.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Chat plugin 点定义。
+ *
+ * 关键点（中文）
+ * - plugin 点由 chat plugin runtime 定义，不由具体 plugin 定义。
+ * - chat plugin runtime 只依赖这些稳定点名，具体 plugin 负责实现其中某些点。
+ * - 后续新增 chat 生命周期 plugin 点，也应统一收敛到这里。
+ */
+/**
+ * Chat runtime 对外暴露的 plugin 点目录。
+ */
+export declare const CHAT_PLUGIN_POINTS: {
+    /**
+     * 增强入站消息正文。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 先构造基础 attachment/body 文本。
+     * - plugin 通过 pipeline 往 `pluginSections` 中追加中间块。
+     */
+    readonly augmentInbound: "chat.augmentInbound";
+    /**
+     * 回复前文本增强。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在真正回发到 channel 前调用。
+     * - plugin 可在这里做收尾改写、格式整理、签名注入等。
+     */
+    readonly beforeReply: "chat.beforeReply";
+    /**
+     * 回复后事件通知。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在一次回复发送完成后触发。
+     * - plugin 可在这里做审计、统计、回执同步等副作用。
+     */
+    readonly afterReply: "chat.afterReply";
+    /**
+     * 入队前数据增强。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在 append ingress / enqueue 之前调用。
+     * - plugin 可在这里改写入队文本或补充 extra metadata。
+     */
+    readonly beforeEnqueue: "chat.beforeEnqueue";
+    /**
+     * 入队后事件通知。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在消息真正入队完成后调用。
+     * - plugin 可在这里做统计、观测、调试落点。
+     */
+    readonly afterEnqueue: "chat.afterEnqueue";
+    /**
+     * 观测入站主体信息。
+     *
+     * 说明（中文）
+     * - 仅做副作用记录，不返回值。
+     * - 典型实现方是 auth plugin。
+     */
+    readonly observePrincipal: "chat.observePrincipal";
+    /**
+     * 判定当前入站消息是否允许执行。
+     *
+     * 说明（中文）
+     * - 由 chat plugin runtime 在 ingress 阶段显式调用。
+     * - 典型实现方是 auth plugin。
+     */
+    readonly authorizeIncoming: "chat.authorizeIncoming";
+    /**
+     * 解析当前用户角色。
+     *
+     * 说明（中文）
+     * - 主要用于在 history / queue metadata 中补齐授权上下文。
+     * - 典型实现方是 auth plugin。
+     */
+    readonly resolveUserRole: "chat.resolveUserRole";
+};
+//# sourceMappingURL=PluginPoints.d.ts.map

package/bin/chat/runtime/PluginPoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPoints.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/PluginPoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;CAEK,CAAC"}

package/bin/chat/runtime/PluginPoints.js

@@ -0,0 +1,78 @@
+/**
+ * Chat plugin 点定义。
+ *
+ * 关键点（中文）
+ * - plugin 点由 chat plugin runtime 定义，不由具体 plugin 定义。
+ * - chat plugin runtime 只依赖这些稳定点名，具体 plugin 负责实现其中某些点。
+ * - 后续新增 chat 生命周期 plugin 点，也应统一收敛到这里。
+ */
+/**
+ * Chat runtime 对外暴露的 plugin 点目录。
+ */
+export const CHAT_PLUGIN_POINTS = {
+    /**
+     * 增强入站消息正文。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 先构造基础 attachment/body 文本。
+     * - plugin 通过 pipeline 往 `pluginSections` 中追加中间块。
+     */
+    augmentInbound: "chat.augmentInbound",
+    /**
+     * 回复前文本增强。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在真正回发到 channel 前调用。
+     * - plugin 可在这里做收尾改写、格式整理、签名注入等。
+     */
+    beforeReply: "chat.beforeReply",
+    /**
+     * 回复后事件通知。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在一次回复发送完成后触发。
+     * - plugin 可在这里做审计、统计、回执同步等副作用。
+     */
+    afterReply: "chat.afterReply",
+    /**
+     * 入队前数据增强。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在 append ingress / enqueue 之前调用。
+     * - plugin 可在这里改写入队文本或补充 extra metadata。
+     */
+    beforeEnqueue: "chat.beforeEnqueue",
+    /**
+     * 入队后事件通知。
+     *
+     * 说明（中文）
+     * - chat plugin runtime 在消息真正入队完成后调用。
+     * - plugin 可在这里做统计、观测、调试落点。
+     */
+    afterEnqueue: "chat.afterEnqueue",
+    /**
+     * 观测入站主体信息。
+     *
+     * 说明（中文）
+     * - 仅做副作用记录，不返回值。
+     * - 典型实现方是 auth plugin。
+     */
+    observePrincipal: "chat.observePrincipal",
+    /**
+     * 判定当前入站消息是否允许执行。
+     *
+     * 说明（中文）
+     * - 由 chat plugin runtime 在 ingress 阶段显式调用。
+     * - 典型实现方是 auth plugin。
+     */
+    authorizeIncoming: "chat.authorizeIncoming",
+    /**
+     * 解析当前用户角色。
+     *
+     * 说明（中文）
+     * - 主要用于在 history / queue metadata 中补齐授权上下文。
+     * - 典型实现方是 auth plugin。
+     */
+    resolveUserRole: "chat.resolveUserRole",
+};
+//# sourceMappingURL=PluginPoints.js.map

package/bin/chat/runtime/PluginPoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPoints.js","sourceRoot":"","sources":["../../../src/chat/runtime/PluginPoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;;;;;;OAMG;IACH,cAAc,EAAE,qBAAqB;IACrC;;;;;;OAMG;IACH,WAAW,EAAE,kBAAkB;IAC/B;;;;;;OAMG;IACH,UAAU,EAAE,iBAAiB;IAC7B;;;;;;OAMG;IACH,aAAa,EAAE,oBAAoB;IACnC;;;;;;OAMG;IACH,YAAY,EAAE,mBAAmB;IACjC;;;;;;OAMG;IACH,gBAAgB,EAAE,uBAAuB;IACzC;;;;;;OAMG;IACH,iBAAiB,EAAE,wBAAwB;IAC3C;;;;;;OAMG;IACH,eAAe,EAAE,sBAAsB;CAC/B,CAAC"}

package/bin/chat/runtime/QueuedUserMessage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * QueuedUserMessage：构造入队执行消息文本。
+ *
+ * 关键点（中文）
+ * - 统一生成 `<info>...</info>` 头部，供模型读取用户与本次请求元信息。
+ * - chat 路由环境不再放入 `<info>`，改由 system prompt 注入。
+ * - 供 chat 入站执行与其他复用入口共用，避免重复实现。
+ */
+import type { QueuedUserInfoInput } from "../../chat/types/ChatPromptContext.js";
+/**
+ * 构造“入队 user message”文本。
+ *
+ * 说明（中文）
+ * - 顶部 `<info>` 为内部语义块，仅记录 user/request 元信息。
+ * - 正文为用户原始输入（可为空）。
+ */
+export declare function buildQueuedUserMessageWithInfo(params: {
+    text: string;
+} & QueuedUserInfoInput): string;
+//# sourceMappingURL=QueuedUserMessage.d.ts.map

package/bin/chat/runtime/QueuedUserMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueuedUserMessage.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/QueuedUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAQ7E;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,mBAAmB,GAAG,MAAM,CAgB/B"}

package/bin/chat/runtime/QueuedUserMessage.js

@@ -0,0 +1,40 @@
+/**
+ * QueuedUserMessage：构造入队执行消息文本。
+ *
+ * 关键点（中文）
+ * - 统一生成 `<info>...</info>` 头部，供模型读取用户与本次请求元信息。
+ * - chat 路由环境不再放入 `<info>`，改由 system prompt 注入。
+ * - 供 chat 入站执行与其他复用入口共用，避免重复实现。
+ */
+function normalizeInfoValue(value) {
+    const text = String(value ?? "").replace(/\r?\n/g, " ").trim();
+    if (!text)
+        return "";
+    return text.replace(/</g, "&#60;").replace(/>/g, "&#62;");
+}
+/**
+ * 构造“入队 user message”文本。
+ *
+ * 说明（中文）
+ * - 顶部 `<info>` 为内部语义块，仅记录 user/request 元信息。
+ * - 正文为用户原始输入（可为空）。
+ */
+export function buildQueuedUserMessageWithInfo(params) {
+    const infoLines = [
+        `message_id: ${normalizeInfoValue(params.messageId || "unknown")}`,
+        `user_id: ${normalizeInfoValue(params.userId || "unknown")}`,
+        `username: ${normalizeInfoValue(params.username || "unknown")}`,
+        `role_id: ${normalizeInfoValue(params.roleId || "unknown")}`,
+        `permissions: ${normalizeInfoValue((params.permissions || []).join(",") || "none")}`,
+        `received_at: ${normalizeInfoValue(params.receivedAt || new Date().toISOString())}`,
+    ];
+    if (normalizeInfoValue(params.userTimezone)) {
+        infoLines.push(`user_timezone: ${normalizeInfoValue(params.userTimezone)}`);
+    }
+    const infoBlock = `<info>\n${infoLines.join("\n")}\n</info>`;
+    const body = String(params.text ?? "").trim();
+    if (!body)
+        return infoBlock;
+    return `${infoBlock}\n\n${body}`;
+}
+//# sourceMappingURL=QueuedUserMessage.js.map

package/bin/chat/runtime/QueuedUserMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueuedUserMessage.js","sourceRoot":"","sources":["../../../src/chat/runtime/QueuedUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAExB;IACrB,MAAM,SAAS,GAAG;QAChB,eAAe,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE;QAClE,YAAY,kBAAkB,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;QAC5D,aAAa,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,EAAE;QAC/D,YAAY,kBAAkB,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;QAC5D,gBAAgB,kBAAkB,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE;QACpF,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE;KACpF,CAAC;IACF,IAAI,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,SAAS,CAAC,IAAI,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,GAAG,SAAS,OAAO,IAAI,EAAE,CAAC;AACnC,CAAC"}