@downcity/agent 1.1.73 → 1.1.79

package/src/plugin/types/PluginApi.ts

@@ -2,7 +2,7 @@
  * plugin catalog / availability / action API 类型。
  *
  * 关键点（中文）
- * - 统一描述 CLI -> daemon 的 plugin 管理协议。
+ * - 统一描述 Town CLI -> Agent runtime 的 plugin 管理协议。
  * - 当前阶段支持 list / availability / action 三类调用。
  */
 

package/src/plugin/types/PluginState.ts

@@ -8,4 +8,4 @@ export type {
   PluginStateControlResult,
   PluginStateRecord,
   PluginStateSnapshot,
-} from "@/plugin/types/Plugin.js";
+} from "@/types/plugin/PluginState.js";

package/src/rpc/Client.ts

@@ -30,187 +30,19 @@ import type {
 } from "@/plugin/types/Plugin.js";
 import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
-import type { ControlSessionExecuteAttachmentInput } from "@/runtime/control/types/ControlSessionExecute.js";
-import type { AuthControlPayload } from "@/runtime/control/types/AuthControl.js";
-
-type RpcClientRequest =
-  | {
-      id: string;
-      method: "sdk.sessions.list";
-      params?: AgentListSessionsInput;
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.create";
-      params?: AgentCreateSessionInput;
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.get";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.prompt";
-      params: {
-        sessionId: string;
-        input: AgentSessionPromptInput;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.history";
-      params: {
-        sessionId: string;
-        input?: AgentSessionHistoryInput;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.system";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.fork";
-      params: {
-        sessionId: string;
-        messageId?: string;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.subscribe";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "sdk.sessions.unsubscribe";
-      params: {
-        subscriptionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.status.get";
-    }
-  | {
-      id: string;
-      method: "internal.sessions.execute";
-      params: {
-        sessionId: string;
-        instructions: string;
-        attachments?: ControlSessionExecuteAttachmentInput[];
-      };
-    }
-  | {
-      id: string;
-      method: "internal.sessions.clear_messages";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.sessions.clear_chat_history";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.sessions.resolve_system_prompt";
-      params: {
-        sessionId: string;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.plugins.catalog";
-    }
-  | {
-      id: string;
-      method: "internal.plugins.list";
-    }
-  | {
-      id: string;
-      method: "internal.plugins.control";
-      params: {
-        pluginName: string;
-        action: PluginStateControlAction;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.plugins.command";
-      params: {
-        pluginName: string;
-        command: string;
-        payload?: JsonValue;
-        schedule?: JsonValue;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.plugins.availability";
-      params: {
-        pluginName: string;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.plugins.action";
-      params: {
-        pluginName: string;
-        actionName: string;
-        payload?: JsonValue;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.authorization.get";
-    }
-  | {
-      id: string;
-      method: "internal.authorization.config";
-      params: {
-        config: JsonObject;
-      };
-    }
-  | {
-      id: string;
-      method: "internal.authorization.action";
-      params: {
-        action: string;
-        channel: string;
-        userId?: string;
-        roleId?: string;
-      };
-    };
-
-type RpcResponseFrame = {
-  id: string;
-  success: boolean;
-  data?: unknown;
-  error?: string;
-};
-
-type RpcReadyFrame = {
-  type: "ready";
-  subscriptionId: string;
-};
-
-type RpcEventFrame = {
-  type: "event";
-  subscriptionId: string;
-  event: AgentSessionEvent;
-};
+import type {
+  RpcClientEndpoint,
+  RpcClientFrame,
+  RpcRequest,
+  RpcSessionSubscription,
+  RpcSystemPromptPayload,
+} from "@/types/rpc/RpcProtocol.js";
+
+export type {
+  RpcClientEndpoint,
+  RpcSessionSubscription,
+  RpcSystemPromptPayload,
+} from "@/types/rpc/RpcProtocol.js";
 
 type PendingRequest = {
   resolve: (value: any) => void;
@@ -222,80 +54,6 @@ type RpcSubscription = {
   on_event: (event: AgentSessionEvent) => void;
 };
 
-/**
- * RPC endpoint。
- */
-export interface RpcClientEndpoint {
-  /** RPC host。 */
-  host: string;
-  /** RPC port。 */
-  port: number;
-}
-
-/**
- * RPC Session 订阅句柄。
- */
-export interface RpcSessionSubscription {
-  /** 当前订阅 id。 */
-  subscription_id: string;
-  /** 取消订阅。 */
-  unsubscribe(): Promise<void>;
-}
-
-/**
- * RPC system prompt 分段条目。
- */
-export interface RpcSystemPromptSectionItem {
-  /** 消息序号。 */
-  index: number;
-  /** system message 文本内容。 */
-  content: string;
-}
-
-/**
- * RPC system prompt 分段。
- */
-export interface RpcSystemPromptSection {
-  /** 分段稳定 key。 */
-  key: string;
-  /** 分段展示标题。 */
-  title: string;
-  /** 分段内消息条目。 */
-  items: RpcSystemPromptSectionItem[];
-}
-
-/**
- * RPC system prompt 响应。
- */
-export interface RpcSystemPromptPayload {
-  /** 请求是否成功。 */
-  success?: boolean;
-  /** 当前 session id。 */
-  sessionId: string;
-  /** system message 总数。 */
-  totalMessages: number;
-  /** system message 总字符数。 */
-  totalChars: number;
-  /** system message 分段。 */
-  sections: RpcSystemPromptSection[];
-}
-
-/**
- * RPC session execute 响应。
- */
-export interface RpcSessionExecuteResult {
-  /** 执行是否成功。 */
-  success: boolean;
-  /** 失败错误信息。 */
-  error?: string;
-  /** assistant 原始消息。 */
-  assistantMessage?: unknown;
-  /** 用户可见文本。 */
-  userVisible: string;
-  /** 是否进入队列。 */
-  queued: boolean;
-}
-
 /**
  * RPC Client。
  */
@@ -461,27 +219,6 @@ export class RpcClient {
     });
   }
 
-  /**
-   * 在 Agent runtime 内执行一轮 session 指令。
-   */
-  async execute_internal_session(params: {
-    session_id: string;
-    instructions: string;
-    attachments?: ControlSessionExecuteAttachmentInput[];
-  }): Promise<{ sessionId: string; result: RpcSessionExecuteResult }> {
-    return await this.request<{
-      sessionId: string;
-      result: RpcSessionExecuteResult;
-    }>({
-      method: "internal.sessions.execute",
-      params: {
-        sessionId: params.session_id,
-        instructions: params.instructions,
-        ...(params.attachments !== undefined ? { attachments: params.attachments } : {}),
-      },
-    });
-  }
-
   /**
    * 清空 Agent runtime 内指定 session 的消息。
    */
@@ -621,49 +358,6 @@ export class RpcClient {
     });
   }
 
-  /**
-   * 读取 Agent runtime 内 authorization 控制面快照。
-   */
-  async get_internal_authorization(): Promise<AuthControlPayload> {
-    return await this.request<AuthControlPayload>({
-      method: "internal.authorization.get",
-    });
-  }
-
-  /**
-   * 写入 Agent runtime 内 authorization 配置。
-   */
-  async write_internal_authorization_config(
-    config: JsonObject,
-  ): Promise<AuthControlPayload> {
-    return await this.request<AuthControlPayload>({
-      method: "internal.authorization.config",
-      params: {
-        config,
-      },
-    });
-  }
-
-  /**
-   * 执行 Agent runtime 内 authorization 动作。
-   */
-  async run_internal_authorization_action(params: {
-    action: string;
-    channel: string;
-    user_id?: string;
-    role_id?: string;
-  }): Promise<AuthControlPayload> {
-    return await this.request<AuthControlPayload>({
-      method: "internal.authorization.action",
-      params: {
-        action: params.action,
-        channel: params.channel,
-        ...(params.user_id ? { userId: params.user_id } : {}),
-        ...(params.role_id ? { roleId: params.role_id } : {}),
-      },
-    });
-  }
-
   /**
    * 关闭底层连接。
    */
@@ -684,7 +378,7 @@ export class RpcClient {
   }
 
   private async request<TData = unknown>(input: {
-    method: RpcClientRequest["method"];
+    method: RpcRequest["method"];
     params?: unknown;
   }): Promise<TData> {
     await this.ensure_connected();
@@ -704,7 +398,7 @@ export class RpcClient {
             method: input.method,
             params: input.params as never,
           }
-    ) as RpcClientRequest;
+    ) as RpcRequest;
     const result = await new Promise<TData>((resolve, reject) => {
       this.pending_requests.set(id, { resolve, reject });
       socket.write(`${JSON.stringify(request)}\n`, (error) => {
@@ -781,7 +475,7 @@ export class RpcClient {
   }
 
   private consume_line(line: string): void {
-    const payload = JSON.parse(line) as RpcResponseFrame | RpcReadyFrame | RpcEventFrame;
+    const payload = JSON.parse(line) as RpcClientFrame;
     if ("type" in payload && payload.type === "ready") {
       const subscription = this.subscriptions.get(payload.subscriptionId);
       subscription?.on_ready();