@tencent-ai/agent-sdk 0.3.41 → 0.3.43

package/lib/utils/stream.d.ts

@@ -28,5 +28,24 @@ export declare class Stream<T, TReturn = void> implements AsyncGenerator<T, TRet
      * Returns the current number of items in the queue.
      */
     get length(): number;
+    /**
+     * Reset the stream state to allow re-iteration.
+     *
+     * This is needed when the stream's iterator is closed (e.g., by early loop exit
+     * or cancel operation) but the underlying data source (process, connection) is
+     * still active. After reset(), the stream can be iterated again.
+     *
+     * Note: This clears any queued values to ensure fresh state for new iteration.
+     * The previous turn's messages (like result messages from cancel) are discarded.
+     */
+    reset(): void;
+    /**
+     * Check if the stream has been started (iterated).
+     */
+    get isStarted(): boolean;
+    /**
+     * Check if the stream is done.
+     */
+    get isFinished(): boolean;
 }
 //# sourceMappingURL=stream.d.ts.map

package/lib/utils/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CACrC,YAAW,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAC,CAA+C;IACnE,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,CAAC,EAAE,MAAM,IAAI;IAIjC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IAQ7D,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAsB3C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAWvB,IAAI,IAAI,IAAI;IAUZ,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUzB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAQ7C,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAMrD;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACJ"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CACrC,YAAW,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IAE1C,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAC,CAA+C;IACnE,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,CAAC,EAAE,MAAM,IAAI;IAIjC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IAQ7D,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAsB3C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAWvB,IAAI,IAAI,IAAI;IAUZ,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUzB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAQ7C,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAMrD;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;;;;OASG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;CACJ"}

package/lib/utils/stream.js

@@ -92,6 +92,37 @@ class Stream {
     get length() {
         return this.queue.length;
     }
+    /**
+     * Reset the stream state to allow re-iteration.
+     *
+     * This is needed when the stream's iterator is closed (e.g., by early loop exit
+     * or cancel operation) but the underlying data source (process, connection) is
+     * still active. After reset(), the stream can be iterated again.
+     *
+     * Note: This clears any queued values to ensure fresh state for new iteration.
+     * The previous turn's messages (like result messages from cancel) are discarded.
+     */
+    reset() {
+        this.started = false;
+        this.isDone = false;
+        this.hasError = undefined;
+        this.readResolve = undefined;
+        this.readReject = undefined;
+        // Clear queue to discard stale messages from previous turn (e.g., result from cancel)
+        this.queue = [];
+    }
+    /**
+     * Check if the stream has been started (iterated).
+     */
+    get isStarted() {
+        return this.started;
+    }
+    /**
+     * Check if the stream is done.
+     */
+    get isFinished() {
+        return this.isDone;
+    }
 }
 exports.Stream = Stream;
 //# sourceMappingURL=stream.js.map

package/lib/utils/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/agent-sdk",
-  "version": "0.3.41",
+  "version": "0.3.43",
   "description": "CodeBuddy Code SDK for JavaScript/TypeScript",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/lib/acp/agent.d.ts

@@ -1,427 +0,0 @@
-/**
- * AcpAgent - Implementation of the official ACP Agent interface
- *
- * This class bridges the @agentclientprotocol/sdk Agent interface with
- * the Genie Session for handling ACP protocol requests.
- *
- * Usage: Create via session.asAcpAgent(connection)
- *
- * Architecture:
- *   Browser -> HTTP -> AcpHttpTransport -> AgentSideConnection -> AcpAgent -> Session
- */
-import type { Agent, AgentCapabilities, AgentSideConnection, AuthenticateRequest, AuthenticateResponse, CancelNotification, Implementation, InitializeRequest, InitializeResponse, LoadSessionRequest, LoadSessionResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, SessionUpdate, SetSessionModelRequest, SetSessionModelResponse, SetSessionModeRequest, SetSessionModeResponse } from '@agentclientprotocol/sdk';
-import type { Session } from '../types';
-/**
- * Extension method for tool input requests (e.g., AskUserQuestion).
- * Matches ExtensionMethod.QUESTION from agent-client-protocol.
- */
-export declare const ACP_EXT_METHOD_QUESTION = "_codebuddy.ai/question";
-/**
- * Question option structure.
- * Matches QuestionOption from agent-client-protocol.
- */
-export interface QuestionOption {
-    /** Display text (1-5 words) */
-    label: string;
-    /** Option description */
-    description: string;
-}
-/**
- * Single question structure.
- * Matches UserQuestion from agent-client-protocol.
- */
-export interface UserQuestion {
-    /** Question ID */
-    id: string;
-    /** Question text */
-    question: string;
-    /** Short label (max 12 chars) */
-    header?: string;
-    /** Available options (2-4) */
-    options: QuestionOption[];
-    /** Allow multiple selections */
-    multiSelect?: boolean;
-}
-/**
- * Schema for 'question' inputType.
- * Matches QuestionInputSchema from agent-client-protocol.
- */
-export interface QuestionInputSchema {
-    /** Questions to ask (1-4) */
-    questions: UserQuestion[];
-}
-/**
- * Tool input request sent to client via extMethod.
- * Matches ToolInputRequest from agent-client-protocol.
- */
-export interface ToolInputRequest {
-    /** Session ID */
-    sessionId: string;
-    /** Associated tool call ID (links extMethod to tool_call for UI) */
-    toolCallId: string;
-    /** Type of input being requested */
-    inputType: 'question';
-    /** Input schema */
-    schema: QuestionInputSchema;
-    /** Request timeout in ms */
-    timeout?: number;
-    /** Additional metadata */
-    _meta?: Record<string, unknown>;
-}
-/**
- * Tool input response from client.
- * Matches ToolInputResponse from agent-client-protocol.
- */
-export interface ToolInputResponse {
-    /** Response outcome */
-    outcome: {
-        outcome: 'submitted';
-        data: QuestionInputData;
-    } | {
-        outcome: 'cancelled';
-        reason?: string;
-    };
-    /** Additional metadata */
-    _meta?: Record<string, unknown>;
-}
-/**
- * Response data for 'question' inputType.
- * Matches QuestionInputData from agent-client-protocol.
- */
-export interface QuestionInputData {
-    /** User's answers keyed by question ID */
-    answers: Record<string, string | string[]>;
-}
-/**
- * AskUserQuestion request parameters.
- * This is a higher-level wrapper around ToolInputRequest for convenience.
- */
-export interface AskUserQuestionRequest {
-    /** Session ID */
-    sessionId: string;
-    /** Tool use ID for tracking */
-    toolUseId: string;
-    /** Questions to ask the user */
-    questions: Array<{
-        question: string;
-        header: string;
-        options: Array<{
-            label: string;
-            description: string;
-        }>;
-        multiSelect: boolean;
-    }>;
-}
-/**
- * AskUserQuestion response.
- * This is a higher-level wrapper around ToolInputResponse for convenience.
- */
-export interface AskUserQuestionResponse {
-    /** User answers keyed by question text */
-    answers: Record<string, string>;
-}
-/**
- * Handler type for custom AskUserQuestion processing.
- * Return null to deny the question request.
- */
-export type OnAskUserQuestion = (request: AskUserQuestionRequest) => Promise<AskUserQuestionResponse | null>;
-/**
- * Handler for creating sessions when session/new is called.
- *
- * Session auto-generates its own sessionId internally, which can be accessed
- * via session.sessionId after creation. The AcpAgent will use this sessionId
- * when returning the NewSessionResponse.
- */
-export type OnNewSession = (params: NewSessionRequest) => Session | Promise<Session>;
-export type OnLoadSession = (params: LoadSessionRequest) => Session | Promise<Session>;
-/**
- * Options for creating an AcpAgent
- */
-export interface AcpAgentOptions {
-    /**
-     * Agent information returned in initialize response
-     */
-    agentInfo?: Implementation;
-    /**
-     * Protocol version to report (default: 1)
-     */
-    protocolVersion?: number;
-    /**
-     * Handler for creating new sessions when session/new is called.
-     * If provided, session will be created via this handler.
-     * If not provided, the session passed to constructor will be used.
-     */
-    onNewSession?: OnNewSession;
-    /**
-     * Handler for loading/resuming existing sessions when session/load is called.
-     * If provided, loadSession() will use this to resume sessions.
-     * The handler receives the sessionId and should return a resumed session.
-     */
-    onLoadSession?: OnLoadSession;
-    /**
-     * Custom handler for AskUserQuestion tool.
-     * If not provided, uses ACP extMethod '_codebuddy.ai/ask_user_question'.
-     *
-     * Return null from the handler to deny the question request.
-     *
-     * @example
-     * ```typescript
-     * const agent = new AcpAgent(connection, null, {
-     *     onAskUserQuestion: async (request) => {
-     *         const answers = await showQuestionDialog(request.questions);
-     *         return { answers };
-     *     },
-     * });
-     * ```
-     */
-    onAskUserQuestion?: OnAskUserQuestion;
-    /**
-     * Agent capabilities to advertise during initialization.
-     * Uses the official ACP AgentCapabilities type.
-     * These will be merged with the default capabilities.
-     * User-provided values will override defaults.
-     */
-    capabilities?: Partial<AgentCapabilities>;
-    /**
-     * Available permission modes configuration.
-     * If not provided, defaults to basic 'default' and 'plan' modes.
-     */
-    availableModes?: Array<{
-        id: string;
-        name: string;
-        description: string;
-    }>;
-    /**
-     * Maximum number of sessions to keep in memory.
-     * When exceeded, oldest inactive sessions will be removed.
-     * Default: no limit (undefined).
-     */
-    maxSessions?: number;
-    /**
-     * Callback invoked when a session update is about to be sent.
-     * Use this to intercept and broadcast updates to multiple connections.
-     * If not provided, updates are sent only to the agent's own connection.
-     *
-     * @param sessionId - The session ID
-     * @param update - The SessionUpdate to send
-     * @param meta - Optional metadata including mode ('stream' | 'history')
-     */
-    onSessionUpdate?: (sessionId: string, update: SessionUpdate, meta?: {
-        mode?: string;
-        toolName?: string;
-        requestId?: string;
-    }) => void;
-}
-/**
- * AcpAgent - Implements the official ACP Agent interface
- *
- * Created via session.asAcpAgent(connection). The session must be
- * created and connected before creating the AcpAgent.
- *
- * @example
- * ```typescript
- * const session = createSession({ cwd: '/workspace' });
- * await session.connect();
- *
- * const connection = new AgentSideConnection(
- *     (conn) => session.asAcpAgent(conn),
- *     stream
- * );
- * ```
- */
-export declare class AcpAgent implements Agent {
-    private connection;
-    private defaultSession;
-    private sessions;
-    private options;
-    private activePromptSessionId;
-    private promptAbortController;
-    /** Per-session converters for proper state management */
-    private sessionConverters;
-    /** Track session last activity time for LRU eviction */
-    private sessionLastActivity;
-    /** Track in-progress session loading to prevent race conditions */
-    private sessionLoadingPromises;
-    /** Track commands notification handlers per session for cleanup */
-    private sessionCommandsHandlers;
-    /**
-     * Create an AcpAgent.
-     *
-     * @param connection - The AgentSideConnection for communication
-     * @param session - Optional default session. If provided, it will be returned by newSession().
-     *                  If null, onNewSession must be provided in options.
-     * @param options - Configuration options including optional onNewSession
-     */
-    constructor(connection: AgentSideConnection, session: Session | null, options?: AcpAgentOptions);
-    /**
-     * Initialize the connection with the client.
-     * Returns protocol version and agent capabilities.
-     */
-    initialize(_params: InitializeRequest): Promise<InitializeResponse>;
-    /**
-     * Authenticate the client.
-     * Currently a no-op as we don't require authentication.
-     */
-    authenticate(_params: AuthenticateRequest): Promise<AuthenticateResponse | void>;
-    /**
-     * Create or return a session.
-     *
-     * Behavior depends on configuration:
-     * 1. If onNewSession is provided: Creates a new session via factory
-     * 2. If defaultSession is provided: Returns the first registered session
-     * 3. Otherwise: Throws an error
-     */
-    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
-    loadSession(params: LoadSessionRequest): Promise<LoadSessionResponse>;
-    /**
-     * Process a prompt request.
-     * Sends the prompt to the session and streams updates back to the client.
-     */
-    prompt(params: PromptRequest): Promise<PromptResponse>;
-    /**
-     * Cancel an ongoing prompt.
-     */
-    cancel(params: CancelNotification): Promise<void>;
-    /**
-     * Set the operational mode for a session.
-     *
-     * Maps ACP SessionModeId to SDK PermissionMode and delegates to Session.setPermissionMode().
-     * Errors are silently ignored - the mode just won't take effect.
-     */
-    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
-    /**
-     * Set the model for a session.
-     *
-     * Delegates to Session.setModel().
-     * Errors are silently ignored - the model just won't take effect.
-     *
-     * @experimental This capability is not part of the spec yet.
-     */
-    unstable_setSessionModel(params: SetSessionModelRequest): Promise<SetSessionModelResponse>;
-    extMethod?(_method: string, _params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    extNotification?(_method: string, _params: Record<string, unknown>): Promise<void>;
-    /**
-     * Get a session by ID, or the first session if no ID provided.
-     */
-    getSession(sessionId?: string): Session | undefined;
-    /**
-     * Alias for getSession() for compatibility.
-     */
-    getCurrentSession(): Session | undefined;
-    /**
-     * Get all session IDs.
-     */
-    getSessionIds(): string[];
-    /**
-     * Get the number of active sessions.
-     */
-    getSessionCount(): number;
-    /**
-     * Remove a session by ID and free associated resources.
-     * @param sessionId - The session ID to remove
-     * @param closeSession - Whether to close the session (default: true)
-     * @returns true if the session was removed, false if not found
-     */
-    removeSession(sessionId: string, closeSession?: boolean): boolean;
-    /**
-     * Remove all sessions and free resources.
-     * @param closeSessions - Whether to close sessions (default: true)
-     */
-    removeAllSessions(closeSessions?: boolean): void;
-    /**
-     * Get memory statistics for debugging.
-     */
-    getMemoryStats(): {
-        sessionCount: number;
-        converterCount: number;
-        oldestSessionAge: number | null;
-    };
-    /**
-     * Register a session with memory management.
-     * Injects canUseTool handler for AskUserQuestion support.
-     */
-    private registerSession;
-    /**
-     * Update session activity timestamp.
-     */
-    private touchSession;
-    /**
-     * Evict the oldest inactive session (LRU).
-     */
-    private evictOldestSession;
-    /**
-     * Get session modes configuration.
-     * Returns the available modes and current mode from the given session.
-     * @param session - Optional session to get current mode from. If not provided, uses default.
-     */
-    private getSessionModes;
-    /**
-     * Get session models configuration.
-     * Returns the available models and current model from the given session.
-     * Fetches available models from the session if supported.
-     * Full raw model configurations are included in _meta['codebuddy.ai'].availableModels.
-     * @param session - Optional session to get current model and available models from.
-     */
-    private getSessionModels;
-    /**
-     * Subscribe to commands channel and forward all updates to ACP client.
-     * Sets up a persistent listener that sends available_commands_update for each notification.
-     * This ensures no updates are missed when commands change multiple times.
-     * @param sessionId - The session ID to send the updates for
-     * @param session - The session to subscribe to commands channel
-     */
-    private subscribeToCommands;
-    /**
-     * Convert ACP ContentBlock[] to SDK UserMessage.
-     * Delegates to AcpConverter for the actual content block conversion.
-     */
-    private convertAcpPromptToUserMessage;
-    /**
-     * Get or create a converter for a session.
-     */
-    private getSessionConverter;
-    /**
-     * Send session updates to the client via AgentSideConnection.
-     *
-     * @param sessionId - Session ID
-     * @param message - SDK message to convert and send
-     * @param mode - Conversion mode: 'stream' for prompt(), 'history' for loadSession()
-     */
-    private sendUpdates;
-    /**
-     * Send system info notification when CLI reports model/permissionMode.
-     * Uses custom notification '_codebuddy.ai/system_init' with model and permissionMode.
-     */
-    private sendSystemInfoNotification;
-    /**
-     * Filter history messages: only keep the last topic message.
-     */
-    private filterHistoryMessages;
-    /**
-     * Create a canUseTool handler that wraps the original handler
-     * and intercepts AskUserQuestion requests.
-     *
-     * @param sessionId - The session ID for this handler
-     * @param originalHandler - Optional original canUseTool handler to delegate to
-     * @returns A wrapped canUseTool handler
-     */
-    private createCanUseToolHandler;
-    /**
-     * Handle AskUserQuestion tool requests.
-     *
-     * If onAskUserQuestion is provided, uses that handler.
-     * Otherwise, sends the request to the client via ACP extMethod (_codebuddy.ai/question).
-     *
-     * @param sessionId - The session ID
-     * @param input - The tool input (AskUserQuestionInput)
-     * @param options - Permission options including toolUseID
-     * @returns Permission result with answers or denial
-     */
-    private handleAskUserQuestion;
-    /**
-     * Clean up when the connection closes.
-     * Removes all sessions and frees memory.
-     */
-    private cleanup;
-}
-//# sourceMappingURL=agent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/acp/agent.ts"],"names":[],"mappings":"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"}