@downcity/plugins 1.0.215 → 1.0.233

package/src/chat/access/ChatAccessActions.ts

@@ -6,7 +6,7 @@
  * - CLI 可以直接复用 ChatAccessService，不依赖运行中 Agent。
  */
 
-import { createAction } from "@downcity/agent";
+import { create_action } from "@downcity/agent";
 import type { PluginActions } from "@downcity/agent";
 import type { JsonValue } from "@downcity/agent";
 import { z } from "zod";
@@ -19,7 +19,7 @@ const scope_schema = z.enum(["direct", "group", "all"]);
 /** 创建 Chat Access Action 集合。 */
 export function create_chat_access_actions(): PluginActions {
   return {
-    [CHAT_ACCESS_ACTIONS.snapshot]: createAction({
+    [CHAT_ACCESS_ACTIONS.snapshot]: create_action({
       description: "Read Chat Access principals, grants, and requests for the current Agent.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -30,7 +30,7 @@ export function create_chat_access_actions(): PluginActions {
         data: create_chat_access_service(context).snapshot() as unknown as JsonValue,
       }),
     }),
-    [CHAT_ACCESS_ACTIONS.approve]: createAction({
+    [CHAT_ACCESS_ACTIONS.approve]: create_action({
       description: "Approve a pending Chat Access request.",
       input_schema: {
         zod: z.object({
@@ -60,7 +60,7 @@ export function create_chat_access_actions(): PluginActions {
         };
       },
     }),
-    [CHAT_ACCESS_ACTIONS.deny]: createAction({
+    [CHAT_ACCESS_ACTIONS.deny]: create_action({
       description: "Deny a pending Chat Access request.",
       input_schema: {
         zod: z.object({
@@ -90,7 +90,7 @@ export function create_chat_access_actions(): PluginActions {
         };
       },
     }),
-    [CHAT_ACCESS_ACTIONS.set]: createAction({
+    [CHAT_ACCESS_ACTIONS.set]: create_action({
       description: "Set allow or deny for a known Chat Access principal.",
       input_schema: {
         zod: z.object({
@@ -123,7 +123,7 @@ export function create_chat_access_actions(): PluginActions {
         };
       },
     }),
-    [CHAT_ACCESS_ACTIONS.revoke]: createAction({
+    [CHAT_ACCESS_ACTIONS.revoke]: create_action({
       description: "Revoke Chat Access grants for a known principal.",
       input_schema: {
         zod: z.object({

package/src/chat/access/ChatAccessRuntime.ts

@@ -6,7 +6,7 @@
  * - Channel Adapter、Plugin Action 和 CLI 共享同一个 Service 构造规则。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import { ChatAccessService } from "@/chat/access/ChatAccessService.js";
 import { resolveChannelAccount } from "@/chat/runtime/ChatChannelCore.js";
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
@@ -15,7 +15,7 @@ const CHANNELS: ChatDispatchChannel[] = ["telegram", "feishu", "qq"];
 
 /** 解析当前 Agent 各渠道的稳定 Issuer。 */
 export function resolve_chat_access_issuer_map(
-  context: AgentContext,
+  context: PluginContext,
 ): Partial<Record<ChatDispatchChannel, string>> {
   const issuer_by_channel: Partial<Record<ChatDispatchChannel, string>> = {};
   for (const channel of CHANNELS) {
@@ -26,15 +26,15 @@ export function resolve_chat_access_issuer_map(
 }
 
 /** 创建当前 Agent 的 ChatAccessService。 */
-export function create_chat_access_service(context: AgentContext): ChatAccessService {
+export function create_chat_access_service(context: PluginContext): ChatAccessService {
   return new ChatAccessService({
-    project_root: context.rootPath,
+    project_root: context.workspace_path,
   });
 }
 
 /** 解析指定渠道当前稳定 Issuer。 */
 export function resolve_chat_access_issuer(
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatDispatchChannel,
 ): string {
   return String(resolve_chat_access_issuer_map(context)[channel] || "").trim();

package/src/chat/access/ChatAccessStore.ts

@@ -10,7 +10,7 @@
 import Database from "better-sqlite3";
 import fs from "fs-extra";
 import path from "node:path";
-import { generateId } from "@downcity/agent";
+import { generate_id } from "@downcity/agent";
 import { ensure_chat_access_schema } from "@/chat/access/ChatAccessSchema.js";
 import type {
   ChatAccessEffect,
@@ -216,7 +216,7 @@ export class ChatAccessStore {
   upsert_principal(input: UpsertChatAccessPrincipalInput): ChatAccessPrincipal {
     const existing = this.get_principal_by_identity(input);
     const current_time = now_iso();
-    const principal_id = existing?.principal_id || `principal_${generateId()}`;
+    const principal_id = existing?.principal_id || `principal_${generate_id()}`;
     const first_seen_at = normalize_text(input.first_seen_at) || existing?.first_seen_at || current_time;
     const last_seen_at = normalize_text(input.last_seen_at) || current_time;
     this.database.prepare(`
@@ -259,7 +259,7 @@ export class ChatAccessStore {
   upsert_grant(input: UpsertChatAccessGrantInput): ChatAccessGrant {
     const existing = this.get_grant(input.principal_id, input.scope);
     const current_time = now_iso();
-    const grant_id = existing?.grant_id || `grant_${generateId()}`;
+    const grant_id = existing?.grant_id || `grant_${generate_id()}`;
     this.database.prepare(`
       INSERT INTO chat_access_grants (
         grant_id, principal_id, scope, effect, created_by, created_at, updated_at
@@ -336,7 +336,7 @@ export class ChatAccessStore {
       return { request: updated, created: false };
     }
 
-    const request_id = `req_${generateId()}`;
+    const request_id = `req_${generate_id()}`;
     this.database.prepare(`
       INSERT INTO chat_access_requests (
         request_id, principal_id, scope, chat_id, chat_type, status,
@@ -448,7 +448,7 @@ export class ChatAccessStore {
         decision, operator, detail_json, created_at
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
     `).run(
-      `audit_${generateId()}`,
+      `audit_${generate_id()}`,
       optional_text(input.principal_id) || null,
       optional_text(input.request_id) || null,
       normalize_text(input.action),

package/src/chat/channels/BaseChatChannel.ts

@@ -15,7 +15,7 @@ import type {
   ChatDispatcher,
 } from "@/chat/types/ChatDispatcher.js";
 import type { Logger } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import { resolveChatQueueStore } from "@/chat/runtime/ChatQueue.js";
 import { deleteChatSessionById } from "@/chat/runtime/ChatSessionDelete.js";
 import {
@@ -34,7 +34,7 @@ import {
 } from "./BaseChatChannelQueue.js";
 
 /**
- * Channel chatKey 计算入参。
+ * Channel chat_key 计算入参。
  *
  * 说明（中文）
  * - chatId 必填；其余字段用于区分 topic/thread/消息上下文。
@@ -44,12 +44,12 @@ export type ChannelChatKeyParams = {
   chatId: string;
   messageThreadId?: number;
   chatType?: string;
-  messageId?: string;
+  message_id?: string;
 };
 
 export type ChannelSendTextParams = ChannelChatKeyParams & {
   text: string;
-  replyToMessage?: boolean;
+  reply_to_message?: boolean;
 };
 
 export type ChannelSendActionParams = ChannelChatKeyParams & {
@@ -62,7 +62,7 @@ export type ChannelSendActionParams = ChannelChatKeyParams & {
  * 入站消息统一结构（跨平台最小公共字段）。
  *
  * 说明（中文）
- * - chatId 是平台原始会话标识（非 sessionId）。
+ * - chatId 是平台原始会话标识（非 session_id）。
  * - messageThreadId 用于支持 topic / thread 细粒度并发。
  * - 该结构只描述“接收侧”，不包含平台发送参数。
  */
@@ -70,9 +70,9 @@ export type IncomingChatMessage = {
   chatId: string;
   text: string;
   chatType?: string;
-  messageId?: string;
+  message_id?: string;
   messageThreadId?: number;
-  userId?: string;
+  user_id?: string;
   username?: string;
   /**
    * 当前消息接收时间。
@@ -114,7 +114,7 @@ export type IncomingChatMessage = {
 export type IncomingChatAccessParams = {
   chatId: string;
   chatType?: string;
-  userId?: string;
+  user_id?: string;
   username?: string;
   chatTitle?: string;
 };
@@ -129,18 +129,18 @@ export type IncomingChatAccessResult = ChatAccessDecision;
  */
 export abstract class BaseChatChannel {
   readonly channel: ChatDispatchChannel;
-  protected readonly context: AgentContext;
+  protected readonly context: PluginContext;
   protected readonly rootPath: string;
   protected readonly logger: Logger;
   private readonly access_notice_sent_at = new Map<string, number>();
 
   protected constructor(params: {
     channel: ChatDispatchChannel;
-    context: AgentContext;
+    context: PluginContext;
   }) {
     this.channel = params.channel;
     this.context = params.context;
-    this.rootPath = params.context.rootPath;
+    this.rootPath = params.context.workspace_path;
     this.logger = params.context.logger;
 
     const dispatcher: ChatDispatcher = {
@@ -231,7 +231,7 @@ export abstract class BaseChatChannel {
     return create_chat_access_service(this.context).evaluate({
       channel: this.channel,
       issuer,
-      subject_id: String(params.userId || "").trim(),
+      subject_id: String(params.user_id || "").trim(),
       display_name: String(params.username || "").trim() || undefined,
       chat_id: String(params.chatId || "").trim(),
       chat_type: String(params.chatType || "").trim() || undefined,
@@ -259,7 +259,7 @@ export abstract class BaseChatChannel {
     }
     const displayed_request_id = this.format_access_code(request_id);
     const approval_command = this.format_access_command(
-      `downcity chat access approve ${request_id} --agent ${agent_id}`,
+      `city plugin action chat access-approve ${agent_id} --input '{"request_id":"${request_id}"}' --token <token>`,
     );
     return [
       `当前账号尚未获准访问 Agent "${displayed_agent_id}"。`,
@@ -310,8 +310,8 @@ export abstract class BaseChatChannel {
           chatType: normalized.chatType,
           messageThreadId: normalized.messageThreadId,
           text: normalized.text,
-          ...(typeof normalized.messageId === "string"
-            ? { messageId: normalized.messageId }
+          ...(typeof normalized.message_id === "string"
+            ? { message_id: normalized.message_id }
             : {}),
         });
       }
@@ -348,7 +348,7 @@ export abstract class BaseChatChannel {
         action,
         messageThreadId: params.messageThreadId,
         chatType: params.chatType,
-        messageId: params.messageId,
+        message_id: params.message_id,
         reactionEmoji: params.reactionEmoji,
         reactionIsBig: params.reactionIsBig,
       });
@@ -359,20 +359,20 @@ export abstract class BaseChatChannel {
   }
 
   /**
-   * 清理某个 sessionId 对应的 agent 会话状态。
+   * 清理某个 session_id 对应的 agent 会话状态。
    *
    * 说明（中文）
    * - 只清理 runtime / context 层状态，不直接删历史文件。
    * - 常用于用户触发“重置对话”类命令。
    */
-  clearChat(sessionId: string): void {
-    const key = String(sessionId || "").trim();
+  clearChat(session_id: string): void {
+    const key = String(session_id || "").trim();
     if (!key) return;
     resolveChatQueueStore(this.context).enqueue({
       kind: "control",
       channel: this.channel,
       targetId: key,
-      sessionId: key,
+      session_id: key,
       text: "",
       control: { type: "clear" },
     });
@@ -380,19 +380,19 @@ export abstract class BaseChatChannel {
   }
 
   /**
-   * 按渠道目标清理会话（映射到内部 sessionId）。
+   * 按渠道目标清理会话（映射到内部 session_id）。
    */
   protected async clearChatByTarget(params: ChannelChatKeyParams): Promise<void> {
     const chatId = String(params.chatId || "").trim();
     if (!chatId) return;
-    const sessionId = await resolveChannelSessionId({
+    const session_id = await resolveChannelSessionId({
       context: this.context,
       channel: this.channel,
       chatId,
       chatType: params.chatType,
       messageThreadId: params.messageThreadId,
     });
-    if (!sessionId) {
+    if (!session_id) {
       this.logger.info("Skip clear chat: context mapping not found", {
         channel: this.channel,
         chatId,
@@ -403,13 +403,13 @@ export abstract class BaseChatChannel {
     }
     const deleted = await deleteChatSessionById({
       context: this.context,
-      sessionId,
+      session_id,
     });
     if (!deleted.success) {
       this.logger.warn("Failed to delete chat context by target", {
         channel: this.channel,
         chatId,
-        sessionId,
+        session_id,
         error: deleted.error || "delete failed",
       });
       return;
@@ -417,7 +417,7 @@ export abstract class BaseChatChannel {
     this.logger.info("Deleted chat context by target", {
       channel: this.channel,
       chatId,
-      sessionId,
+      session_id,
       removedMeta: deleted.removedMeta,
       removedChatDir: deleted.removedChatDir,
       removedSessionDir: deleted.removedSessionDir,
@@ -429,8 +429,8 @@ export abstract class BaseChatChannel {
    */
   protected async enqueueAuditMessage(params: {
     chatId: string;
-    messageId?: string;
-    userId?: string;
+    message_id?: string;
+    user_id?: string;
     text: string;
     meta?: ChannelUserMessageMeta;
   }): Promise<void> {
@@ -439,8 +439,8 @@ export abstract class BaseChatChannel {
       channel: this.channel,
       chatId: params.chatId,
       text: params.text,
-      ...(typeof params.messageId === "string" ? { messageId: params.messageId } : {}),
-      ...(typeof params.userId === "string" ? { userId: params.userId } : {}),
+      ...(typeof params.message_id === "string" ? { message_id: params.message_id } : {}),
+      ...(typeof params.user_id === "string" ? { user_id: params.user_id } : {}),
       ...(params.meta ? { meta: params.meta } : {}),
     });
   }
@@ -449,12 +449,12 @@ export abstract class BaseChatChannel {
    * 将消息送入会话调度器队列。
    *
    * 返回值语义（中文）
-   * - chatKey: lane 归属键（同 key 串行）。
+   * - chat_key: lane 归属键（同 key 串行）。
    * - position: 当前 lane 中排队位置（便于日志与观测）。
    */
   protected async enqueueMessage(
     msg: IncomingChatMessage,
-  ): Promise<{ chatKey: string; position: number }> {
+  ): Promise<{ chat_key: string; position: number }> {
     return await enqueueExecChannelMessage({
       context: this.context,
       channel: this.channel,

package/src/chat/channels/BaseChatChannelQueue.ts

@@ -14,7 +14,7 @@ import {
   prepareChatEnqueue,
 } from "@/chat/runtime/EnqueueDispatch.js";
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject } from "@downcity/agent";
 import type { IncomingChatMessage } from "./BaseChatChannel.js";
 import {
@@ -32,7 +32,7 @@ export interface EnqueueAuditChannelMessageParams {
   /**
    * 当前 execution runtime。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 当前渠道。
    */
@@ -48,11 +48,11 @@ export interface EnqueueAuditChannelMessageParams {
   /**
    * 可选消息 id。
    */
-  messageId?: string;
+  message_id?: string;
   /**
    * 可选用户 id。
    */
-  userId?: string;
+  user_id?: string;
   /**
    * 可选扩展 meta。
    */
@@ -66,7 +66,7 @@ export interface EnqueueExecChannelMessageParams {
   /**
    * 当前 execution runtime。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 当前渠道。
    */
@@ -92,40 +92,40 @@ export async function enqueueAuditChannelMessage(
   const chatType = typeof meta.chatType === "string" ? meta.chatType : undefined;
   const chatTitle =
     typeof meta.chatTitle === "string" ? meta.chatTitle.trim() || undefined : undefined;
-  const sessionId = await resolveOrCreateChannelSessionId({
+  const session_id = await resolveOrCreateChannelSessionId({
     context: params.context,
     channel: params.channel,
     chatId: params.chatId,
     chatType,
     messageThreadId,
   });
-  if (!sessionId) return;
+  if (!session_id) return;
 
   const extra = stripUndefinedMeta(meta);
   await appendInboundChannelHistory({
     context: params.context,
     logger: params.context.logger,
     channel: params.channel,
-    sessionId,
+    session_id,
     chatId: params.chatId,
     ingressKind: "audit",
     text: params.text,
     targetType: chatType,
     threadId: messageThreadId,
-    messageId: params.messageId,
-    actorId: params.userId,
+    message_id: params.message_id,
+    actorId: params.user_id,
     actorName: username,
     extra,
   });
   await updateChannelChatMeta({
     context: params.context,
     channel: params.channel,
-    sessionId,
+    session_id,
     chatId: params.chatId,
     targetType: chatType,
     threadId: messageThreadId,
-    messageId: params.messageId,
-    actorId: params.userId,
+    message_id: params.message_id,
+    actorId: params.user_id,
     actorName: username,
     chatTitle,
   });
@@ -135,13 +135,13 @@ export async function enqueueAuditChannelMessage(
     input: {
       kind: "audit",
       channel: params.channel,
-      chatKey: sessionId,
+      chat_key: session_id,
       chatId: params.chatId,
       text: params.text,
       ...(chatType ? { chatType } : {}),
       ...(typeof messageThreadId === "number" ? { threadId: messageThreadId } : {}),
-      ...(typeof params.messageId === "string" ? { messageId: params.messageId } : {}),
-      ...(typeof params.userId === "string" ? { actorId: params.userId } : {}),
+      ...(typeof params.message_id === "string" ? { message_id: params.message_id } : {}),
+      ...(typeof params.user_id === "string" ? { actorId: params.user_id } : {}),
       ...(typeof username === "string" ? { actorName: username } : {}),
       extra,
     },
@@ -150,15 +150,15 @@ export async function enqueueAuditChannelMessage(
     kind: "audit",
     channel: params.channel,
     targetId: params.chatId,
-    sessionId,
+    session_id,
     ...(typeof preparedAudit.actorId === "string"
       ? { actorId: preparedAudit.actorId }
       : {}),
     ...(typeof preparedAudit.actorName === "string"
       ? { actorName: preparedAudit.actorName }
       : {}),
-    ...(typeof preparedAudit.messageId === "string"
-      ? { messageId: preparedAudit.messageId }
+    ...(typeof preparedAudit.message_id === "string"
+      ? { message_id: preparedAudit.message_id }
       : {}),
     text: preparedAudit.text,
     ...(typeof preparedAudit.threadId === "number"
@@ -187,26 +187,26 @@ export async function enqueueAuditChannelMessage(
  */
 export async function enqueueExecChannelMessage(
   params: EnqueueExecChannelMessageParams,
-): Promise<{ chatKey: string; position: number }> {
+): Promise<{ chat_key: string; position: number }> {
   const msg = params.message;
   const inboundExtra =
     msg.extra && typeof msg.extra === "object" ? stripUndefinedMeta(msg.extra) : {};
   const mergedExtra: JsonObject = { ...inboundExtra };
 
-  const chatKey = await resolveOrCreateChannelSessionId({
+  const chat_key = await resolveOrCreateChannelSessionId({
     context: params.context,
     channel: params.channel,
     chatId: msg.chatId,
     chatType: msg.chatType,
     messageThreadId: msg.messageThreadId,
   });
-  if (!chatKey) {
-    throw new Error("Failed to resolve sessionId for incoming chat message");
+  if (!chat_key) {
+    throw new Error("Failed to resolve session_id for incoming chat message");
   }
 
   const rawQueuedText = buildQueuedUserMessageWithInfo({
-    messageId: msg.messageId,
-    userId: msg.userId,
+    message_id: msg.message_id,
+    user_id: msg.user_id,
     username: msg.username,
     receivedAt: msg.receivedAt,
     userTimezone: msg.userTimezone,
@@ -217,15 +217,15 @@ export async function enqueueExecChannelMessage(
     input: {
       kind: "exec",
       channel: params.channel,
-      chatKey,
+      chat_key,
       chatId: msg.chatId,
       text: rawQueuedText,
       ...(msg.chatType ? { chatType: msg.chatType } : {}),
       ...(typeof msg.messageThreadId === "number"
         ? { threadId: msg.messageThreadId }
         : {}),
-      ...(typeof msg.messageId === "string" ? { messageId: msg.messageId } : {}),
-      ...(typeof msg.userId === "string" ? { actorId: msg.userId } : {}),
+      ...(typeof msg.message_id === "string" ? { message_id: msg.message_id } : {}),
+      ...(typeof msg.user_id === "string" ? { actorId: msg.user_id } : {}),
       ...(typeof msg.username === "string" ? { actorName: msg.username } : {}),
       extra: mergedExtra,
     },
@@ -238,7 +238,7 @@ export async function enqueueExecChannelMessage(
 
   await appendExecIngress({
     context: params.context,
-    sessionId: chatKey,
+    session_id: chat_key,
     channel: params.channel,
     chatId: msg.chatId,
     text: queuedText,
@@ -248,8 +248,8 @@ export async function enqueueExecChannelMessage(
     ...(typeof preparedExec.threadId === "number"
       ? { threadId: preparedExec.threadId }
       : {}),
-    ...(typeof preparedExec.messageId === "string"
-      ? { messageId: preparedExec.messageId }
+    ...(typeof preparedExec.message_id === "string"
+      ? { message_id: preparedExec.message_id }
       : {}),
     ...(typeof preparedExec.actorId === "string"
       ? { actorId: preparedExec.actorId }
@@ -263,12 +263,12 @@ export async function enqueueExecChannelMessage(
   await updateChannelChatMeta({
     context: params.context,
     channel: params.channel,
-    sessionId: chatKey,
+    session_id: chat_key,
     chatId: msg.chatId,
     targetType: msg.chatType,
     threadId: msg.messageThreadId,
-    messageId: msg.messageId,
-    actorId: msg.userId,
+    message_id: msg.message_id,
+    actorId: msg.user_id,
     actorName: msg.username,
     chatTitle: msg.chatTitle,
   });
@@ -277,7 +277,7 @@ export async function enqueueExecChannelMessage(
     kind: "exec",
     channel: params.channel,
     targetId: msg.chatId,
-    sessionId: chatKey,
+    session_id: chat_key,
     text: queuedText,
     ...(typeof preparedExec.chatType === "string"
       ? { targetType: preparedExec.chatType }
@@ -285,8 +285,8 @@ export async function enqueueExecChannelMessage(
     ...(typeof preparedExec.threadId === "number"
       ? { threadId: preparedExec.threadId }
       : {}),
-    ...(typeof preparedExec.messageId === "string"
-      ? { messageId: preparedExec.messageId }
+    ...(typeof preparedExec.message_id === "string"
+      ? { message_id: preparedExec.message_id }
       : {}),
     ...(typeof preparedExec.actorId === "string"
       ? { actorId: preparedExec.actorId }
@@ -305,5 +305,5 @@ export async function enqueueExecChannelMessage(
     },
   });
 
-  return { chatKey, position: execEnqueued.lanePosition };
+  return { chat_key, position: execEnqueued.lanePosition };
 }