@downcity/plugins 1.0.216 → 1.0.236

package/bin/chat/config/ChatPluginConfig.js

@@ -0,0 +1,237 @@
+/**
+ * Chat Plugin 的结构化配置协议。
+ *
+ * 关键点（中文）
+ * - Zod Schema 是内建 Chat 行为配置与 Resource 配置的唯一源码。
+ * - Plugin config 只描述 queue 行为，完整渠道配置由独立 Resource Item 承载。
+ * - `readOnly` 字段由 Resource Resolver 写入，`writeOnly` 字段由 CLI 安全采集和脱敏。
+ */
+import { z } from "zod";
+import { resolveChatChannelBotInfo } from "../../chat/channels/BotInfoProvider.js";
+const resource_id_schema = z.string()
+    .trim()
+    .min(1)
+    .max(80)
+    .regex(/^[a-z0-9][a-z0-9_-]*$/u)
+    .meta({
+    title: "Resource ID",
+    description: "Stable Resource ID generated by City.",
+    readOnly: true,
+});
+const resource_name_schema = z.string()
+    .trim()
+    .min(1)
+    .meta({
+    title: "Name",
+    description: "Display name written by the Resource Resolver.",
+    readOnly: true,
+});
+const secret_schema = z.string()
+    .trim()
+    .min(1)
+    .meta({ writeOnly: true });
+/** Telegram Resource 完整配置 Schema。 */
+const telegram_resource_schema = z.object({
+    id: resource_id_schema,
+    type: z.literal("telegram").meta({ title: "Type" }),
+    name: resource_name_schema,
+    bot_token: secret_schema.meta({
+        title: "Bot Token",
+        description: "Telegram Bot API Token.",
+        writeOnly: true,
+    }),
+    username: z.string().trim().min(1).optional().meta({
+        title: "Username",
+        description: "Telegram username written by the Resource Resolver.",
+        readOnly: true,
+    }),
+    bot_user_id: z.string().trim().min(1).optional().meta({
+        title: "Bot User ID",
+        description: "Telegram Bot user ID written by the Resource Resolver.",
+        readOnly: true,
+    }),
+}).strict().meta({
+    title: "Telegram",
+    description: "Telegram Bot Resource.",
+});
+/** Feishu / Lark Resource 完整配置 Schema。 */
+const feishu_resource_schema = z.object({
+    id: resource_id_schema,
+    type: z.literal("feishu").meta({ title: "Type" }),
+    name: resource_name_schema,
+    app_id: z.string().trim().min(1).meta({
+        title: "App ID",
+        description: "Feishu or Lark App ID.",
+    }),
+    app_secret: secret_schema.meta({
+        title: "App Secret",
+        description: "Feishu or Lark App Secret.",
+        writeOnly: true,
+    }),
+    domain: z.url().optional().meta({
+        title: "Open API Domain",
+        description: "Optional Feishu or Lark Open API domain.",
+    }),
+    identity: z.string().trim().min(1).optional().meta({
+        title: "Identity",
+        readOnly: true,
+    }),
+    owner: z.string().trim().min(1).optional().meta({
+        title: "Owner",
+        readOnly: true,
+    }),
+    creator: z.string().trim().min(1).optional().meta({
+        title: "Creator",
+        readOnly: true,
+    }),
+    bot_user_id: z.string().trim().min(1).optional().meta({
+        title: "Bot User ID",
+        readOnly: true,
+    }),
+}).strict().meta({
+    title: "Feishu / Lark",
+    description: "Feishu or Lark Bot Resource.",
+});
+/** QQ Resource 完整配置 Schema。 */
+const qq_resource_schema = z.object({
+    id: resource_id_schema,
+    type: z.literal("qq").meta({ title: "Type" }),
+    name: resource_name_schema,
+    app_id: z.string().trim().min(1).meta({
+        title: "App ID",
+        description: "QQ Bot App ID.",
+    }),
+    app_secret: secret_schema.meta({
+        title: "App Secret",
+        description: "QQ Bot App Secret.",
+        writeOnly: true,
+    }),
+    sandbox: z.boolean().optional().meta({
+        title: "Sandbox",
+        description: "Whether to use the QQ sandbox environment.",
+        default: false,
+    }),
+    identity: z.string().trim().min(1).optional().meta({
+        title: "Identity",
+        readOnly: true,
+    }),
+    bot_user_id: z.string().trim().min(1).optional().meta({
+        title: "Bot User ID",
+        readOnly: true,
+    }),
+}).strict().meta({
+    title: "QQ",
+    description: "QQ Bot Resource.",
+});
+/** Chat Plugin 单个完整 Resource Item Schema。 */
+export const chat_plugin_resource_schema = z.discriminatedUnion("type", [
+    telegram_resource_schema,
+    feishu_resource_schema,
+    qq_resource_schema,
+]);
+/** Chat Plugin 完整配置 Schema。 */
+export const chat_plugin_config_schema = z.object({
+    queue: z.object({
+        max_concurrency: z.number()
+            .int()
+            .min(1)
+            .max(32)
+            .optional()
+            .meta({
+            title: "Maximum concurrency",
+            description: "Maximum number of chat lanes executed concurrently.",
+        }),
+        merge_debounce_ms: z.number()
+            .int()
+            .min(0)
+            .max(60_000)
+            .optional()
+            .meta({
+            title: "Merge debounce",
+            description: "Debounce window used to merge consecutive inbound messages.",
+        }),
+        merge_max_wait_ms: z.number()
+            .int()
+            .min(0)
+            .max(120_000)
+            .optional()
+            .meta({
+            title: "Maximum merge wait",
+            description: "Maximum time to wait before executing a merged inbound burst.",
+        }),
+    }).strict().optional().meta({
+        title: "Queue",
+        description: "Chat queue scheduling and inbound message merge behavior.",
+    }),
+}).strict().meta({
+    title: "Chat Plugin",
+    description: "Chat queue behavior. Messaging channels are Plugin Resources.",
+});
+/** 供 City Plugin Catalog 使用的标准 JSON Schema。 */
+export const CHAT_PLUGIN_CONFIG_JSON_SCHEMA = z.toJSONSchema(chat_plugin_config_schema, { target: "draft-2020-12" });
+/** 供 City Plugin Catalog 使用的完整 Resource Item JSON Schema。 */
+export const CHAT_PLUGIN_RESOURCE_JSON_SCHEMA = z.toJSONSchema(chat_plugin_resource_schema, { target: "draft-2020-12" });
+/** 在运行时装配边界解析并收窄 Chat Plugin 配置。 */
+export function parse_chat_plugin_config(input) {
+    return chat_plugin_config_schema.parse(input);
+}
+/** 解析一个完整 Chat Plugin Resource Item。 */
+export function parse_chat_plugin_resource(input) {
+    return chat_plugin_resource_schema.parse(input);
+}
+/** 读取一个 Chat Resource 类型分支的标准 JSON Schema。 */
+export function get_chat_plugin_resource_json_schema(resource_type) {
+    const variants = Array.isArray(CHAT_PLUGIN_RESOURCE_JSON_SCHEMA.oneOf)
+        ? CHAT_PLUGIN_RESOURCE_JSON_SCHEMA.oneOf
+        : [];
+    for (const value of variants) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            continue;
+        const variant = value;
+        const properties = variant.properties;
+        if (!properties || typeof properties !== "object" || Array.isArray(properties))
+            continue;
+        const type_schema = properties.type;
+        if (type_schema
+            && typeof type_schema === "object"
+            && !Array.isArray(type_schema)
+            && type_schema.const === resource_type) {
+            return JSON.parse(JSON.stringify(variant));
+        }
+    }
+    throw new Error(`Missing Chat Resource schema: ${resource_type}`);
+}
+/**
+ * 根据用户字段解析并返回 Resolver 可写的动态字段。
+ *
+ * 关键点（中文）：返回值不包含 `id`、`type` 和凭据，字段所有权由 City 按 Schema 校验。
+ */
+export async function resolve_chat_plugin_resource(input) {
+    const type = String(input.type || "").trim();
+    if (type !== "telegram" && type !== "feishu" && type !== "qq") {
+        throw new Error(`Unsupported Chat Resource type: ${type}`);
+    }
+    const result = await resolveChatChannelBotInfo({
+        channel: type,
+        credentials: {
+            botToken: typeof input.bot_token === "string" ? input.bot_token : undefined,
+            appId: typeof input.app_id === "string" ? input.app_id : undefined,
+            appSecret: typeof input.app_secret === "string" ? input.app_secret : undefined,
+            domain: typeof input.domain === "string" ? input.domain : undefined,
+            sandbox: input.sandbox === true,
+        },
+    });
+    const identity = String(result.identity || "").trim();
+    const bot_user_id = String(result.botUserId || "").trim();
+    const owner = String(result.owner || "").trim();
+    const creator = String(result.creator || "").trim();
+    return {
+        name: result.name,
+        ...(type === "telegram" && identity ? { username: identity } : {}),
+        ...(type !== "telegram" && identity ? { identity } : {}),
+        ...(bot_user_id ? { bot_user_id } : {}),
+        ...(type === "feishu" && owner ? { owner } : {}),
+        ...(type === "feishu" && creator ? { creator } : {}),
+    };
+}
+//# sourceMappingURL=ChatPluginConfig.js.map

package/bin/chat/config/ChatPluginConfig.js.map

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

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

@@ -1,12 +1,12 @@
 /**
- * ChannelContextStore：渠道目标与 sessionId 映射存储。
+ * ChannelContextStore：渠道目标与 session_id 映射存储。
  *
  * 关键点（中文）
  * - 映射文件位于 `.downcity/channel/meta.json`。
- * - sessionId 由服务端随机生成并持久化，不依赖字符串拼接规则。
- * - 统一提供“按目标找 sessionId / 按 sessionId 找目标”能力。
+ * - session_id 由服务端随机生成并持久化，不依赖字符串拼接规则。
+ * - 统一提供“按目标找 session_id / 按 session_id 找目标”能力。
  */
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ChannelContextRouteV1, ChannelContextTarget } from "../../chat/types/ChannelContext.js";
 /**
  * 构造目标键。
@@ -16,61 +16,61 @@ import type { ChannelContextRouteV1, ChannelContextTarget } from "../../chat/typ
  */
 export declare function buildChannelTargetKey(target: ChannelContextTarget): string;
 /**
- * 通过 sessionId 读取路由信息。
+ * 通过 session_id 读取路由信息。
  */
 export declare function readChannelSessionRouteBySessionId(params: {
-    context: AgentContext;
-    sessionId: string;
+    context: PluginContext;
+    session_id: string;
 }): Promise<ChannelContextRouteV1 | null>;
 /**
  * 列出当前 agent 已记录的所有渠道路由条目。
  *
  * 关键点（中文）
  * - 数据源为 `.downcity/channel/meta.json` 的 `routesBySessionId`。
- * - 默认按 `updatedAt` 倒序返回，便于展示“最近活跃”会话。
+ * - 默认按 `updated_at` 倒序返回，便于展示“最近活跃”会话。
  */
 export declare function listChannelSessionRoutes(params: {
-    context: AgentContext;
+    context: PluginContext;
 }): Promise<{
-    updatedAt: number;
+    updated_at: number;
     routes: ChannelContextRouteV1[];
 }>;
 /**
- * 根据渠道目标查找已有 sessionId（不自动创建）。
+ * 根据渠道目标查找已有 session_id（不自动创建）。
  */
 export declare function resolveChannelSessionIdByTarget(params: {
-    context: AgentContext;
+    context: PluginContext;
     target: ChannelContextTarget;
 }): Promise<string | null>;
 /**
- * 根据渠道目标解析或创建 sessionId。
+ * 根据渠道目标解析或创建 session_id。
  */
 export declare function resolveOrCreateChannelSessionIdByTarget(params: {
-    context: AgentContext;
+    context: PluginContext;
     target: ChannelContextTarget;
 }): Promise<string | null>;
 /**
- * 更新指定 sessionId 的渠道路由信息。
+ * 更新指定 session_id 的渠道路由信息。
  */
 export declare function upsertChannelSessionRouteBySessionId(params: {
-    context: AgentContext;
-    sessionId: string;
+    context: PluginContext;
+    session_id: string;
     target: ChannelContextTarget;
-    messageId?: string;
+    message_id?: string;
     actorId?: string;
     actorName?: string;
     chatTitle?: string;
 }): Promise<void>;
 /**
- * 删除指定 sessionId 的渠道路由映射。
+ * 删除指定 session_id 的渠道路由映射。
  *
  * 关键点（中文）
  * - 会同步清理 `routesBySessionId` 与 `sessionIdByTargetKey` 双索引。
  * - 仅影响 chat 路由，不触碰 context / chat 历史文件。
  */
 export declare function removeChannelSessionRouteBySessionId(params: {
-    context: AgentContext;
-    sessionId: string;
+    context: PluginContext;
+    session_id: string;
 }): Promise<{
     removed: boolean;
     route: ChannelContextRouteV1 | null;

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

@@ -1 +1 @@
-{"version":3,"file":"ChannelContextStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChannelContextStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAiHxC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAS1E;AAoBD;;GAEG;AACH,wBAAsB,kCAAkC,CAAC,MAAM,EAAE;IAC/D,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAQxC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,CAAC,CAmBD;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAsB,uCAAuC,CAAC,MAAM,EAAE;IACpE,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwCzB;AAED;;GAEG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhB;AAED;;;;;;GAMG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC,CAAC,CAwCD"}
+{"version":3,"file":"ChannelContextStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChannelContextStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAiHxC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAS1E;AAoBD;;GAEG;AACH,wBAAsB,kCAAkC,CAAC,MAAM,EAAE;IAC/D,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAQxC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,CAAC,CAmBD;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAsB,uCAAuC,CAAC,MAAM,EAAE;IACpE,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwCzB;AAED;;GAEG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhB;AAED;;;;;;GAMG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC,CAAC,CAwCD"}