@tencent-ai/agent-sdk 0.2.2 → 0.3.0

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/codebuddy-code",
-  "version": "2.37.2",
+  "version": "2.37.4",
   "description": "Use CodeBuddy, Tencent's AI assistant, right from your terminal. CodeBuddy can understand your codebase, edit files, run terminal commands, and handle entire workflows for you.",
   "main": "lib/node/index.js",
   "typings": "lib/node/index.d.ts",

package/cli/product.cloudhosted.json

@@ -323,6 +323,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
-  "date": "2026-01-19T16:12:04.475Z"
+  "commit": "f5ce19c20fa8ba5cb0e16078d668c72f12436508",
+  "date": "2026-01-20T10:57:59.728Z"
 }

package/cli/product.internal.json

@@ -325,6 +325,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
-  "date": "2026-01-19T16:12:01.839Z"
+  "commit": "f5ce19c20fa8ba5cb0e16078d668c72f12436508",
+  "date": "2026-01-20T10:57:56.993Z"
 }

package/cli/product.ioa.json

@@ -535,6 +535,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
-  "date": "2026-01-19T16:12:03.176Z"
+  "commit": "f5ce19c20fa8ba5cb0e16078d668c72f12436508",
+  "date": "2026-01-20T10:57:58.364Z"
 }

package/cli/product.json

@@ -1044,6 +1044,6 @@
       "description": "tool-structuredoutput-description"
     }
   ],
-  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
-  "date": "2026-01-19T16:12:00.512Z"
+  "commit": "f5ce19c20fa8ba5cb0e16078d668c72f12436508",
+  "date": "2026-01-20T10:57:55.654Z"
 }

package/cli/product.selfhosted.json

@@ -205,6 +205,6 @@
     "BillingNotice": false,
     "CustomModelsJSON": true
   },
-  "commit": "0a8844ff1682b4458baf0a8a7d5f60fc1b42e6bf",
-  "date": "2026-01-19T16:12:05.780Z"
+  "commit": "f5ce19c20fa8ba5cb0e16078d668c72f12436508",
+  "date": "2026-01-20T10:58:01.075Z"
 }

package/lib/acp/index.d.ts

@@ -1,16 +1,12 @@
 /**
- * ACP (Agent Client Protocol) Client Integration
+ * ACP (Agent Client Protocol) Integration
  *
- * This module provides utilities for creating ACP clients that work with
- * the agent SDK by converting ACP protocol messages to/from SDK format.
+ * This module provides a unified interface for ACP protocol integration:
+ * - AcpTransformer: Bidirectional conversion between SDK internal format and ACP format
+ * - Type definitions for ACP messages and tool calls
  *
- * Key Design Principles:
- * - NO DATA LOSS: All tool inputs preserved in rawInput
- * - Tool IDs maintained throughout conversion chain
- * - Error states properly tracked and propagated
+ * Uses official @agentclientprotocol/sdk types for full compatibility.
  */
-export { createAcpClient } from './acp-client';
-export type { AcpClientOptions, AcpMessage, AcpClientResult, ToolCallMessage, ToolResultMessage } from './acp-client';
-export { convertSdkToolUseToAcpToolCall, convertAcpToolResultToSdk, extractToolUseBlocks, extractTextContent, } from './tool-converter';
-export type { AcpToolCall, AcpToolKind, AcpContent, AcpDiff, AcpLocation, AcpToolResult, } from './tool-converter';
+export { AcpTransformer, } from './tool-converter';
+export type { AcpToolCall, AcpToolKind, AcpToolStatus, AcpLocation, AcpToolCallContent, AcpToolResult, AcpMessage, } from './tool-converter';
 //# sourceMappingURL=index.d.ts.map

package/lib/acp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtH,OAAO,EACH,8BAA8B,EAC9B,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,cAAc,GACjB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,UAAU,GACb,MAAM,kBAAkB,CAAC"}

package/lib/acp/index.js

@@ -1,22 +1,15 @@
 "use strict";
 /**
- * ACP (Agent Client Protocol) Client Integration
+ * ACP (Agent Client Protocol) Integration
  *
- * This module provides utilities for creating ACP clients that work with
- * the agent SDK by converting ACP protocol messages to/from SDK format.
+ * This module provides a unified interface for ACP protocol integration:
+ * - AcpTransformer: Bidirectional conversion between SDK internal format and ACP format
+ * - Type definitions for ACP messages and tool calls
  *
- * Key Design Principles:
- * - NO DATA LOSS: All tool inputs preserved in rawInput
- * - Tool IDs maintained throughout conversion chain
- * - Error states properly tracked and propagated
+ * Uses official @agentclientprotocol/sdk types for full compatibility.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractTextContent = exports.extractToolUseBlocks = exports.convertAcpToolResultToSdk = exports.convertSdkToolUseToAcpToolCall = exports.createAcpClient = void 0;
-var acp_client_1 = require("./acp-client");
-Object.defineProperty(exports, "createAcpClient", { enumerable: true, get: function () { return acp_client_1.createAcpClient; } });
+exports.AcpTransformer = void 0;
 var tool_converter_1 = require("./tool-converter");
-Object.defineProperty(exports, "convertSdkToolUseToAcpToolCall", { enumerable: true, get: function () { return tool_converter_1.convertSdkToolUseToAcpToolCall; } });
-Object.defineProperty(exports, "convertAcpToolResultToSdk", { enumerable: true, get: function () { return tool_converter_1.convertAcpToolResultToSdk; } });
-Object.defineProperty(exports, "extractToolUseBlocks", { enumerable: true, get: function () { return tool_converter_1.extractToolUseBlocks; } });
-Object.defineProperty(exports, "extractTextContent", { enumerable: true, get: function () { return tool_converter_1.extractTextContent; } });
+Object.defineProperty(exports, "AcpTransformer", { enumerable: true, get: function () { return tool_converter_1.AcpTransformer; } });
 //# sourceMappingURL=index.js.map

package/lib/acp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAGxB,mDAK0B;AAJtB,gIAAA,8BAA8B,OAAA;AAC9B,2HAAA,yBAAyB,OAAA;AACzB,sHAAA,oBAAoB,OAAA;AACpB,oHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mDAE0B;AADtB,gHAAA,cAAc,OAAA"}

package/lib/acp/tool-converter.d.ts

@@ -1,78 +1,123 @@
 /**
- * Tool Converter Utility
+ * ACP Message Transformer
  *
  * Converts SDK internal tool formats to ACP (Agent Client Protocol) format and vice versa.
  *
+ * Uses official @agentclientprotocol/sdk types for compatibility with the ACP specification.
+ *
  * Critical Design Principle: NO DATA LOSS
  * - SDK tool inputs are preserved completely in rawInput
  * - Tool IDs are maintained throughout the conversion
  * - Tool results are preserved with error state tracking
  */
-import type { ToolUseContentBlock, ToolResultContentBlock } from '../types';
+import type { ToolUseContentBlock, ToolResultContentBlock, Message } from '../types';
+import type { ToolCall, ToolKind, ToolCallStatus, ToolCallLocation, ToolCallContent } from '@agentclientprotocol/sdk';
+import type { ControlRequest } from '../types';
 /**
- * ACP Tool Call representation (not JSON-RPC wrapped)
- * This is the actual tool call information sent to ACP client
+ * ACP message types (JSON-RPC 2.0 messages)
  */
-export interface AcpToolCall {
-    toolCallId: string;
-    status: 'pending' | 'in_progress' | 'completed' | 'failed';
-    title: string;
-    kind: AcpToolKind;
-    rawInput: Record<string, unknown>;
-    content?: AcpContent[];
-    locations?: AcpLocation[];
-    rawOutput?: unknown;
-}
-export type AcpToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'other';
-export interface AcpContent {
-    type: 'text' | 'diff' | 'terminal';
-    content?: {
-        type: string;
-        text: string;
-    } | AcpDiff;
-}
-export interface AcpDiff {
-    path: string;
-    oldText: string | null;
-    newText: string;
-}
-export interface AcpLocation {
-    path: string;
-    line?: number;
+export interface AcpMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
 }
 /**
- * ACP Tool Result representation
+ * ACP Tool Call representation using official @agentclientprotocol/sdk types.
+ *
+ * See: https://agentclientprotocol.com/protocol/tool-calls
+ */
+export type AcpToolCall = ToolCall;
+/**
+ * Tool kind categories using official ACP types.
+ * Includes: 'read', 'edit', 'delete', 'move', 'search', 'execute', 'think', 'fetch', 'switch_mode', 'other'
+ *
+ * See: https://agentclientprotocol.com/protocol/tool-calls#creating
+ */
+export type AcpToolKind = ToolKind;
+/**
+ * Tool call status using official ACP types.
+ */
+export type AcpToolStatus = ToolCallStatus;
+/**
+ * File location information using official ACP types.
+ */
+export type AcpLocation = ToolCallLocation;
+/**
+ * Tool call content using official ACP types.
+ */
+export type AcpToolCallContent = ToolCallContent;
+/**
+ * ACP Tool Result representation for reporting tool execution results.
  */
 export interface AcpToolResult {
     toolCallId: string;
     status: 'completed' | 'failed';
-    content?: AcpContent[];
+    content?: ToolCallContent[];
     locations?: AcpLocation[];
     rawOutput?: unknown;
 }
 /**
- * Convert SDK ToolUseContentBlock to ACP Tool Call
- * Preserves all input data in rawInput field
+ * Bidirectional converter between SDK internal format (JSON Lines) and ACP (Agent Client Protocol) format.
  *
- * @param toolUse - SDK tool use block
- * @returns ACP tool call with complete data preservation
- */
-export declare function convertSdkToolUseToAcpToolCall(toolUse: ToolUseContentBlock): AcpToolCall;
-/**
- * Convert ACP Tool Result to SDK ToolResultContentBlock
- * Preserves tool_use_id and ensures error state is tracked
+ * This is an abstract utility class with only static methods - do not instantiate.
  *
- * @param toolCallId - Original tool call ID
- * @param acpResult - ACP tool result
- * @returns SDK ToolResultContentBlock
- */
-export declare function convertAcpToolResultToSdk(toolCallId: string, acpResult: AcpToolResult): ToolResultContentBlock;
-/**
- * Extract tool use blocks from content blocks array
+ * Key features:
+ * - Converts SDK tool use/result to ACP format
+ * - Converts ACP messages to SDK format
+ * - Extracts and manipulates tool/text blocks
+ * - Complete data preservation in roundtrip conversions
+ * - Type-safe message routing
  */
-export declare function extractToolUseBlocks(contentBlocks: unknown[]): ToolUseContentBlock[];
-/**
- * Extract text content from content blocks array
- */
-export declare function extractTextContent(contentBlocks: unknown[]): string;
+export declare abstract class AcpTransformer {
+    /**
+     * Convert SDK ToolUseContentBlock to ACP Tool Call
+     * Preserves all input data in rawInput field
+     */
+    static convertSdkToolUseToAcpToolCall(toolUse: ToolUseContentBlock): AcpToolCall;
+    /**
+     * Convert ACP Tool Result to SDK ToolResultContentBlock
+     * Preserves tool_use_id and ensures error state is tracked
+     */
+    static convertAcpToolResultToSdk(toolCallId: string, acpResult: AcpToolResult): ToolResultContentBlock;
+    /**
+     * Convert SDK ToolResultContentBlock to ACP ToolResult
+     * Enables bidirectional conversion for tool results
+     */
+    static convertSdkToolResultToAcpToolResult(toolResult: ToolResultContentBlock): AcpToolResult;
+    /**
+     * Convert ACP message to SDK internal format (JSON Lines)
+     *
+     * Converts all ACP message types to corresponding SDK messages:
+     * - session/prompt: User input → UserMessage
+     * - session/cancel: Cancellation request → ControlRequest
+     * - session/update (tool_call_update): Tool result → UserMessage with tool_result block
+     */
+    static acpToSdk(acpMessage: AcpMessage): Message | ControlRequest | null;
+    /**
+     * Convert SDK internal message to ACP format
+     *
+     * Converts all SDK message types to corresponding ACP messages:
+     * - AssistantMessage with tool_use blocks → tool_call messages
+     * - AssistantMessage with text → session/text messages
+     * - Other message types are skipped
+     */
+    static sdkToAcp(message: Message): AcpMessage[];
+    private static generateToolTitle;
+    private static getToolKind;
+    private static generateToolContent;
+    private static extractToolLocations;
+    private static formatAcpContentForSdk;
+    private static formatDiffHunk;
+    private static privateExtractPromptText;
+    private static privateExtractToolUseBlocks;
+    private static privateExtractTextContent;
+    private static privateCreateToolResultMessage;
+}
 //# sourceMappingURL=tool-converter.d.ts.map

package/lib/acp/tool-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-converter.d.ts","sourceRoot":"","sources":["../../src/acp/tool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAkC,MAAM,UAAU,CAAC;AAI5G;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACnC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAID;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAaxF;AAqTD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACzB,sBAAsB,CAUxB;AAyFD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAUpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CAanE"}
+{"version":3,"file":"tool-converter.d.ts","sourceRoot":"","sources":["../../src/acp/tool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACR,mBAAmB,EACnB,sBAAsB,EAItB,OAAO,EAEV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACR,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,eAAe,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACL;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAID;;;;;;;;;;;GAWG;AACH,8BAAsB,cAAc;IAGhC;;;OAGG;IACH,MAAM,CAAC,8BAA8B,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW;IAiBhF;;;OAGG;IACH,MAAM,CAAC,yBAAyB,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACzB,sBAAsB;IAYzB;;;OAGG;IACH,MAAM,CAAC,mCAAmC,CAAC,UAAU,EAAE,sBAAsB,GAAG,aAAa;IAkC7F;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,IAAI;IAyDxE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE;IAwG/C,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA4JhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAwD1B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAgElC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAuBnC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA8CrC,OAAO,CAAC,MAAM,CAAC,cAAc;IAoB7B,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAcvC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAY1C,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAexC,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAgBhD"}