@downcity/agent 1.1.287 → 1.1.310

package/src/remote/transports/HttpRemoteAgentTransport.ts

@@ -16,8 +16,10 @@ import type {
   AgentCleanArchiveResult,
   AgentSessionForkInput,
   AgentSessionInfo,
+  AgentSessionStatus,
   AgentSessionSummaryPage,
   AgentSessionSystemSnapshot,
+  RemoteSessionSetInput,
 } from "@/types/agent/SessionTypes.js";
 import type {
   ListSessionMessagesInput,
@@ -35,12 +37,10 @@ import type {
   TransportSubscription,
 } from "@/remote/RemoteTransport.js";
 import type {
-  ResolveSessionApprovalInput,
-  SessionApproval,
-  SessionApprovalModeSnapshot,
-  SessionApprovalResult,
-  SetSessionApprovalModeInput,
-} from "@/types/session/SessionApproval.js";
+  RespondSessionInteractionInput,
+  SessionInteractionResult,
+  SessionPendingInteraction,
+} from "@/types/session/SessionInteraction.js";
 
 type SdkEventsReadyFrame = {
   /** SDK HTTP events 连接内部 ready 标记。 */
@@ -78,10 +78,10 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
         "Content-Type": "application/json",
       }),
       body: JSON.stringify({
-        ...(input?.sessionId ? { sessionId: input.sessionId } : {}),
+        ...(input?.session_id ? { session_id: input.session_id } : {}),
       }),
     });
-    if (!payload.success || !payload.session?.sessionId) {
+    if (!payload.success || !payload.session?.session_id) {
       throw new Error(String(payload.error || "Remote session create failed"));
     }
     return payload.session;
@@ -95,7 +95,7 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}`, {
       headers: this.headers(),
     });
-    if (!payload.success || !payload.session?.sessionId) {
+    if (!payload.success || !payload.session?.session_id) {
       throw new Error(String(payload.error || "Remote session info failed"));
     }
     return payload.session;
@@ -144,19 +144,21 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     return payload.result;
   }
 
-  async compact(session_id: string): Promise<void> {
+  async compact(session_id: string): Promise<{ id: string }> {
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
+      compact?: { id: string };
     }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/compact`, {
       method: "POST",
       headers: this.headers({
         "Content-Type": "application/json",
       }),
     });
-    if (!payload.success) {
+    if (!payload.success || !payload.compact?.id) {
       throw new Error(String(payload.error || "Remote session compact failed"));
     }
+    return payload.compact;
   }
 
   async subscribe(params: {
@@ -255,7 +257,7 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     const message_id =
       typeof input === "string"
         ? String(input || "").trim() || undefined
-        : String(input?.messageId || "").trim() || undefined;
+        : String(input?.message_id || "").trim() || undefined;
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
@@ -266,10 +268,10 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
         "Content-Type": "application/json",
       }),
       body: JSON.stringify({
-        ...(message_id ? { messageId: message_id } : {}),
+        ...(message_id ? { message_id: message_id } : {}),
       }),
     });
-    if (!payload.success || !payload.session?.sessionId) {
+    if (!payload.success || !payload.session?.session_id) {
       throw new Error(String(payload.error || "Remote session fork failed"));
     }
     return payload.session;
@@ -306,8 +308,8 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
-      sessionId?: string;
-      archivedAt?: number;
+      session_id?: string;
+      archived_at?: number;
     }>(
       `${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/archive`,
       {
@@ -317,14 +319,14 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
         }),
       },
     );
-    if (!payload.success || !payload.sessionId) {
+    if (!payload.success || !payload.session_id) {
       throw new Error(String(payload.error || "Remote session archive failed"));
     }
     return {
-      sessionId: payload.sessionId,
-      archivedAt:
-        typeof payload.archivedAt === "number" && Number.isFinite(payload.archivedAt)
-          ? payload.archivedAt
+      session_id: payload.session_id,
+      archived_at:
+        typeof payload.archived_at === "number" && Number.isFinite(payload.archived_at)
+          ? payload.archived_at
           : Date.now(),
     };
   }
@@ -356,7 +358,7 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
-      removedSessionIds?: string[];
+      removed_session_ids?: string[];
     }>(`${this.base_url}/api/sdk/archived-sessions`, {
       method: "DELETE",
       headers: this.headers(),
@@ -365,8 +367,8 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
       throw new Error(String(payload.error || "Remote clean archive failed"));
     }
     return {
-      removedSessionIds: Array.isArray(payload.removedSessionIds)
-        ? payload.removedSessionIds
+      removed_session_ids: Array.isArray(payload.removed_session_ids)
+        ? payload.removed_session_ids
         : [],
     };
   }
@@ -382,8 +384,8 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
           "Content-Type": "application/json",
         }),
         body: JSON.stringify({
-          pluginName: input.plugin,
-          actionName: input.action,
+          plugin_name: input.plugin,
+          action_name: input.action,
           ...(input.payload !== undefined ? { payload: input.payload } : {}),
         }),
       },
@@ -394,75 +396,73 @@ export class HttpRemoteAgentTransport implements RemoteAgentTransport {
     return payload;
   }
 
-  async approvals(session_id: string): Promise<SessionApproval[]> {
+  async interactions(session_id: string): Promise<SessionPendingInteraction[]> {
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
-      approvals?: SessionApproval[];
-    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/approvals`, {
+      interactions?: SessionPendingInteraction[];
+    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/interactions`, {
       headers: this.headers(),
     });
-    if (!payload.success || !Array.isArray(payload.approvals)) {
-      throw new Error(String(payload.error || "Remote shell approvals failed"));
+    if (!payload.success || !Array.isArray(payload.interactions)) {
+      throw new Error(String(payload.error || "Remote session interactions failed"));
     }
-    return payload.approvals;
+    return payload.interactions;
   }
 
-  async approval_mode(session_id: string): Promise<SessionApprovalModeSnapshot> {
+  async status(session_id: string): Promise<AgentSessionStatus> {
     const payload = await read_http_json<{
       success?: boolean;
       error?: string;
-      session_id?: string;
-      mode?: SessionApprovalModeSnapshot["mode"];
-    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/approval-mode`, {
+      status?: AgentSessionStatus;
+    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/status`, {
       headers: this.headers(),
     });
-    if (!payload.success || !payload.session_id || !payload.mode) {
-      throw new Error(String(payload.error || "Remote shell approval mode failed"));
+    if (!payload.success || !payload.status) {
+      throw new Error(String(payload.error || "Remote session status failed"));
     }
-    return {
-      session_id: payload.session_id,
-      mode: payload.mode,
-    };
+    return payload.status;
   }
 
-  async set_approval_mode(
+  async set(
     session_id: string,
-    input: SetSessionApprovalModeInput,
-  ): Promise<SessionApprovalModeSnapshot> {
-    const payload = await read_http_json<SessionApprovalModeSnapshot & {
+    input: RemoteSessionSetInput,
+  ): Promise<void> {
+    const payload = await read_http_json<{
       success?: boolean;
       error?: string;
-    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/approval-mode`, {
+      queued?: boolean;
+    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/set`, {
       method: "POST",
       headers: this.headers({
         "Content-Type": "application/json",
       }),
-      body: JSON.stringify({ mode: input.mode }),
+      body: JSON.stringify(input),
     });
-    if (payload.success !== true) {
-      throw new Error(String(payload.error || "Remote shell approval mode update failed"));
+    if (payload.success !== true || payload.queued !== true) {
+      throw new Error(String(payload.error || "Remote session set failed"));
     }
-    return payload;
   }
 
-  async resolve_approval(
+  async respond(
     session_id: string,
-    input: ResolveSessionApprovalInput,
-  ): Promise<SessionApprovalResult> {
-    const payload = await read_http_json<SessionApprovalResult & {
+    input: RespondSessionInteractionInput,
+  ): Promise<SessionInteractionResult> {
+    const payload = await read_http_json<{
+      success?: boolean;
+      result?: SessionInteractionResult;
       error?: string;
-    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/approval`, {
+    }>(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/respond`, {
       method: "POST",
       headers: this.headers({
         "Content-Type": "application/json",
       }),
       body: JSON.stringify(input),
     });
-    if (typeof payload.success !== "boolean") {
-      throw new Error(String(payload.error || "Remote session approval failed"));
+    if (!payload.success || !payload.result) {
+      throw new Error(String(payload.error || "Remote session interaction response failed"));
     }
-    return payload;
+    return payload.result;
   }
 }
 

package/src/remote/transports/RpcClient.ts

@@ -17,8 +17,10 @@ import type {
   AgentArchiveSessionsResult,
   AgentCleanArchiveResult,
   AgentSessionInfo,
+  AgentSessionStatus,
   AgentSessionSummaryPage,
   AgentSessionSystemSnapshot,
+  RemoteSessionSetInput,
 } from "@/types/agent/SessionTypes.js";
 import type {
   ListSessionMessagesInput,
@@ -30,21 +32,14 @@ import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 import type {
   PluginActionResult,
 } from "@/types/plugin/PluginAction.js";
-import type { PluginCommandResult } from "@/types/plugin/PluginCommand.js";
 import type { PluginAvailability, PluginView } from "@/types/plugin/PluginRuntime.js";
-import type {
-  PluginControlAction,
-  PluginControlResult,
-  PluginSnapshot,
-} from "@/types/plugin/PluginState.js";
+import type { PluginSnapshot } from "@/types/plugin/PluginState.js";
 import type { SessionMutation } from "@/types/session/SessionMutation.js";
 import type {
-  ResolveSessionApprovalInput,
-  SessionApproval,
-  SessionApprovalModeSnapshot,
-  SessionApprovalResult,
-  SetSessionApprovalModeInput,
-} from "@/types/session/SessionApproval.js";
+  RespondSessionInteractionInput,
+  SessionInteractionResult,
+  SessionPendingInteraction,
+} from "@/types/session/SessionInteraction.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type {
   RpcClientEndpoint,
@@ -124,7 +119,7 @@ export class RpcClient {
     const data = await this.request<{ result: AgentArchiveSessionResult }>({
       method: "sdk.sessions.archive",
       params: {
-        sessionId: input.id,
+        session_id: input.id,
       },
     });
     return data.result;
@@ -147,12 +142,12 @@ export class RpcClient {
    * 清空远程已归档 session。
    */
   async clean_archive(): Promise<AgentCleanArchiveResult> {
-    const data = await this.request<{ removedSessionIds: string[] }>({
+    const data = await this.request<{ removed_session_ids: string[] }>({
       method: "sdk.sessions.archived.clean",
     });
     return {
-      removedSessionIds: Array.isArray(data.removedSessionIds)
-        ? data.removedSessionIds
+      removed_session_ids: Array.isArray(data.removed_session_ids)
+        ? data.removed_session_ids
         : [],
     };
   }
@@ -164,7 +159,7 @@ export class RpcClient {
     const data = await this.request<{ session: AgentSessionInfo }>({
       method: "sdk.sessions.get",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
     return data.session;
@@ -180,7 +175,7 @@ export class RpcClient {
     const data = await this.request<{ turn: { id: string } }>({
       method: "sdk.sessions.prompt",
       params: {
-        sessionId: params.session_id,
+        session_id: params.session_id,
         input: params.input,
       },
     });
@@ -194,7 +189,7 @@ export class RpcClient {
     const data = await this.request<{ result: AgentSessionStopResult }>({
       method: "sdk.sessions.stop",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
     return data.result;
@@ -203,13 +198,14 @@ export class RpcClient {
   /**
    * 把一次显式历史压缩加入远程 Session 的有序输入队列。
    */
-  async compact_session(session_id: string): Promise<void> {
-    await this.request<{ queued: true }>({
+  async compact_session(session_id: string): Promise<{ id: string }> {
+    const data = await this.request<{ compact: { id: string } }>({
       method: "sdk.sessions.compact",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
+    return data.compact;
   }
 
   /**
@@ -222,7 +218,7 @@ export class RpcClient {
     const data = await this.request<{ messages: SessionMessagePage }>({
       method: "sdk.sessions.messages",
       params: {
-        sessionId: params.session_id,
+        session_id: params.session_id,
         input: params.input,
       },
     });
@@ -236,46 +232,45 @@ export class RpcClient {
     const data = await this.request<{ system: AgentSessionSystemSnapshot }>({
       method: "sdk.sessions.system",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
     return data.system;
   }
 
-  async get_session_approvals(session_id: string): Promise<SessionApproval[]> {
-    const data = await this.request<{ approvals: SessionApproval[] }>({
-      method: "sdk.sessions.approvals",
-      params: { sessionId: session_id },
+  async get_session_interactions(session_id: string): Promise<SessionPendingInteraction[]> {
+    const data = await this.request<{ interactions: SessionPendingInteraction[] }>({
+      method: "sdk.sessions.interactions",
+      params: { session_id: session_id },
     });
-    return data.approvals;
+    return data.interactions;
   }
 
-  async get_session_approval_mode(session_id: string): Promise<SessionApprovalModeSnapshot> {
-    const data = await this.request<{ approval_mode: SessionApprovalModeSnapshot }>({
-      method: "sdk.sessions.approvalMode",
-      params: { sessionId: session_id },
+  async get_session_status(session_id: string): Promise<AgentSessionStatus> {
+    const data = await this.request<{ status: AgentSessionStatus }>({
+      method: "sdk.sessions.status",
+      params: { session_id: session_id },
     });
-    return data.approval_mode;
+    return data.status;
   }
 
-  async set_session_approval_mode(
+  async set_session(
     session_id: string,
-    input: SetSessionApprovalModeInput,
-  ): Promise<SessionApprovalModeSnapshot> {
-    const data = await this.request<{ approval_mode: SessionApprovalModeSnapshot }>({
-      method: "sdk.sessions.setApprovalMode",
-      params: { sessionId: session_id, input },
+    input: RemoteSessionSetInput,
+  ): Promise<void> {
+    await this.request<{ queued: true }>({
+      method: "sdk.sessions.set",
+      params: { session_id: session_id, input },
     });
-    return data.approval_mode;
   }
 
-  async resolve_session_approval(
+  async respond_session_interaction(
     session_id: string,
-    input: ResolveSessionApprovalInput,
-  ): Promise<SessionApprovalResult> {
-    const data = await this.request<{ result: SessionApprovalResult }>({
-      method: "sdk.sessions.resolveApproval",
-      params: { sessionId: session_id, input },
+    input: RespondSessionInteractionInput,
+  ): Promise<SessionInteractionResult> {
+    const data = await this.request<{ result: SessionInteractionResult }>({
+      method: "sdk.sessions.respond",
+      params: { session_id: session_id, input },
     });
     return data.result;
   }
@@ -290,8 +285,8 @@ export class RpcClient {
     const data = await this.request<{ session: AgentSessionInfo }>({
       method: "sdk.sessions.fork",
       params: {
-        sessionId: params.session_id,
-        ...(params.message_id ? { messageId: params.message_id } : {}),
+        session_id: params.session_id,
+        ...(params.message_id ? { message_id: params.message_id } : {}),
       },
     });
     return data.session;
@@ -306,15 +301,15 @@ export class RpcClient {
     on_event: (event: SessionMutation) => void;
     on_close: (error?: unknown) => void;
   }): Promise<RpcSessionSubscription> {
-    const data = await this.request<{ subscriptionId: string }>({
+    const data = await this.request<{ subscription_id: string }>({
       method: "sdk.sessions.subscribe",
       params: {
-        sessionId: params.session_id,
+        session_id: params.session_id,
       },
     });
-    const subscription_id = String(data.subscriptionId || "").trim();
+    const subscription_id = String(data.subscription_id || "").trim();
     if (!subscription_id) {
-      throw new Error("RPC subscription did not return subscriptionId");
+      throw new Error("RPC subscription did not return subscription_id");
     }
     this.subscriptions.set(subscription_id, {
       on_ready: params.on_ready,
@@ -329,7 +324,7 @@ export class RpcClient {
         await this.request({
           method: "sdk.sessions.unsubscribe",
           params: {
-            subscriptionId: subscription_id,
+            subscription_id: subscription_id,
           },
         });
       },
@@ -350,11 +345,11 @@ export class RpcClient {
    */
   async clear_internal_session_messages(
     session_id: string,
-  ): Promise<{ sessionId: string; cleared: boolean }> {
-    return await this.request<{ sessionId: string; cleared: boolean }>({
+  ): Promise<{ session_id: string; cleared: boolean }> {
+    return await this.request<{ session_id: string; cleared: boolean }>({
       method: "internal.sessions.clear_messages",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
   }
@@ -364,11 +359,11 @@ export class RpcClient {
    */
   async clear_internal_chat_history(
     session_id: string,
-  ): Promise<{ sessionId: string; cleared: boolean }> {
-    return await this.request<{ sessionId: string; cleared: boolean }>({
+  ): Promise<{ session_id: string; cleared: boolean }> {
+    return await this.request<{ session_id: string; cleared: boolean }>({
       method: "internal.sessions.clear_chat_history",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
   }
@@ -382,7 +377,7 @@ export class RpcClient {
     return await this.request<RpcSystemPromptPayload>({
       method: "internal.sessions.resolve_system_prompt",
       params: {
-        sessionId: session_id,
+        session_id: session_id,
       },
     });
   }
@@ -407,42 +402,6 @@ export class RpcClient {
     return Array.isArray(data.plugins) ? data.plugins : [];
   }
 
-  /**
-   * 控制 Agent runtime 内 plugin 生命周期。
-   */
-  async control_internal_plugin(params: {
-    plugin_name: string;
-    action: PluginControlAction;
-  }): Promise<PluginControlResult> {
-    return await this.request<PluginControlResult>({
-      method: "internal.plugins.control",
-      params: {
-        pluginName: params.plugin_name,
-        action: params.action,
-      },
-    });
-  }
-
-  /**
-   * 执行 Agent runtime 内 plugin command。
-   */
-  async run_internal_plugin_command(params: {
-    plugin_name: string;
-    command: string;
-    payload?: JsonValue;
-    schedule?: JsonValue;
-  }): Promise<PluginCommandResult & { plugin?: PluginSnapshot }> {
-    return await this.request<PluginCommandResult & { plugin?: PluginSnapshot }>({
-      method: "internal.plugins.command",
-      params: {
-        pluginName: params.plugin_name,
-        command: params.command,
-        ...(params.payload !== undefined ? { payload: params.payload } : {}),
-        ...(params.schedule !== undefined ? { schedule: params.schedule } : {}),
-      },
-    });
-  }
-
   /**
    * 检查 Agent runtime 内 plugin 可用性。
    */
@@ -454,7 +413,7 @@ export class RpcClient {
     }>({
       method: "internal.plugins.availability",
       params: {
-        pluginName: plugin_name,
+        plugin_name: plugin_name,
       },
     });
     return data.availability;
@@ -468,17 +427,17 @@ export class RpcClient {
     action_name: string;
     payload?: JsonValue;
   }): Promise<PluginActionResult<JsonValue> & {
-    pluginName?: string;
-    actionName?: string;
+    plugin_name?: string;
+    action_name?: string;
   }> {
     return await this.request<PluginActionResult<JsonValue> & {
-      pluginName?: string;
-      actionName?: string;
+      plugin_name?: string;
+      action_name?: string;
     }>({
       method: "internal.plugins.action",
       params: {
-        pluginName: params.plugin_name,
-        actionName: params.action_name,
+        plugin_name: params.plugin_name,
+        action_name: params.action_name,
         ...(params.payload !== undefined ? { payload: params.payload } : {}),
       },
     });
@@ -603,12 +562,12 @@ export class RpcClient {
   private consume_line(line: string): void {
     const payload = JSON.parse(line) as RpcClientFrame;
     if ("type" in payload && payload.type === "ready") {
-      const subscription = this.subscriptions.get(payload.subscriptionId);
+      const subscription = this.subscriptions.get(payload.subscription_id);
       subscription?.on_ready();
       return;
     }
     if ("type" in payload && payload.type === "event") {
-      const subscription = this.subscriptions.get(payload.subscriptionId);
+      const subscription = this.subscriptions.get(payload.subscription_id);
       subscription?.on_event(payload.event);
       return;
     }