@tencent-ai/agent-sdk 0.3.10 → 0.3.12

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

@@ -1,152 +0,0 @@
-/**
- * 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, Message } from '../types';
-import type { ToolCall, ToolKind, ToolCallStatus, ToolCallLocation, ToolCallContent } from '@agentclientprotocol/sdk';
-import type { ControlRequest } from '../types';
-/**
- * ACP message types (JSON-RPC 2.0 messages)
- */
-export interface AcpMessage {
-    jsonrpc: '2.0';
-    id?: string | number;
-    method?: string;
-    params?: unknown;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/**
- * 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?: ToolCallContent[];
-    locations?: AcpLocation[];
-    rawOutput?: unknown;
-}
-/**
- * Bidirectional converter between SDK internal format (JSON Lines) and ACP (Agent Client Protocol) format.
- *
- * This is an abstract utility class with only static methods - do not instantiate.
- *
- * 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 abstract class AcpTransformer {
-    /**
-     * Convert SDK ToolUseContentBlock to complete session/update params
-     * Returns an object that can be spread directly into AcpMessage params
-     *
-     * This is the preferred method for creating tool call messages that comply with ACP spec.
-     *
-     * @param toolUse - SDK tool use block
-     * @param sessionId - Session ID for the message
-     * @param messageId - Optional message ID (defaults to toolUse.id)
-     * @returns Complete params object ready to be used in session/update message
-     */
-    static convertSdkToolUseToSessionUpdate(toolUse: ToolUseContentBlock, sessionId: string, messageId?: string): {
-        sessionId: string;
-        update: {
-            sessionUpdate: "tool_call";
-            toolCallId: string;
-            status: "pending";
-            title: string;
-            kind: ToolKind;
-            rawInput: Record<string, unknown>;
-            content: ToolCallContent[] | undefined;
-            locations: ToolCallLocation[] | undefined;
-        };
-        _meta: {
-            'codebuddy.ai': {
-                toolName: string;
-                messageId: string;
-            };
-        };
-    };
-    /**
-     * 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
-     *
-     * @param message - SDK message to convert
-     * @param mode - Conversion mode:
-     *   - 'stream': Real-time streaming mode (session/prompt) - converts to incremental chunks
-     *   - 'history': History replay mode (session/load) - converts to complete messages
-     *
-     * Converts all SDK message types to corresponding ACP messages:
-     * - Stream mode: PartialAssistantMessage (stream_event) → streaming text/tool deltas
-     * - History mode: AssistantMessage/UserMessage → complete message objects
-     */
-    static sdkToAcp(message: Message, mode?: 'stream' | 'history'): 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 +0,0 @@
-{"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,EAGV,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;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gCAAgC,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;IA2B3G;;;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;IAgC7F;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,IAAI;IAyDxE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,QAAQ,GAAG,SAAoB,GAAG,UAAU,EAAE;IAyRtF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA8JhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAwD1B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAgElC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAwBnC,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"}