@tencent-ai/agent-sdk 0.3.36 → 0.3.38

package/lib/acp/session-manager.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * AcpSessionManager - Multi-Session Management for ACP
+ *
+ * Manages a collection of AcpSession instances with:
+ * - Lifecycle management (create, get, remove)
+ * - Session limits and LRU eviction
+ * - Idle timeout cleanup
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcpSessionManager = void 0;
+const session_1 = require("./session");
+class AcpSessionManager {
+    constructor(options = {}) {
+        var _a, _b, _c, _d;
+        this.sessions = new Map();
+        this.options = {
+            defaultOptions: (_a = options.defaultOptions) !== null && _a !== void 0 ? _a : {},
+            maxSessions: (_b = options.maxSessions) !== null && _b !== void 0 ? _b : 1000,
+            sessionIdleTimeout: (_c = options.sessionIdleTimeout) !== null && _c !== void 0 ? _c : 30 * 60 * 1000,
+            autoStartSessions: (_d = options.autoStartSessions) !== null && _d !== void 0 ? _d : true,
+        };
+        this.startCleanupTimer();
+    }
+    async getOrCreate(sessionId, options) {
+        var _a, _b, _c;
+        let session = this.sessions.get(sessionId);
+        if (!session) {
+            if (this.sessions.size >= this.options.maxSessions) {
+                this.evictOldest();
+            }
+            session = new session_1.AcpSession(sessionId, {
+                sdkOptions: (_a = options === null || options === void 0 ? void 0 : options.sdkOptions) !== null && _a !== void 0 ? _a : this.options.defaultOptions,
+                idleTimeout: (_b = options === null || options === void 0 ? void 0 : options.idleTimeout) !== null && _b !== void 0 ? _b : this.options.sessionIdleTimeout,
+                autoStart: (_c = options === null || options === void 0 ? void 0 : options.autoStart) !== null && _c !== void 0 ? _c : this.options.autoStartSessions,
+            });
+            this.sessions.set(sessionId, session);
+        }
+        return session;
+    }
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    has(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    async remove(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            await session.close();
+            this.sessions.delete(sessionId);
+            return true;
+        }
+        return false;
+    }
+    getSessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    get sessionCount() {
+        return this.sessions.size;
+    }
+    async shutdown() {
+        this.stopCleanupTimer();
+        const closePromises = Array.from(this.sessions.values()).map(s => s.close());
+        await Promise.allSettled(closePromises);
+        this.sessions.clear();
+    }
+    evictOldest() {
+        let oldest = null;
+        for (const [id, session] of this.sessions) {
+            if (!oldest || session.lastActivity < oldest.time) {
+                oldest = { id, time: session.lastActivity };
+            }
+        }
+        if (oldest) {
+            const session = this.sessions.get(oldest.id);
+            if (session) {
+                session.close();
+                this.sessions.delete(oldest.id);
+            }
+        }
+    }
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupIdleSessions();
+        }, 60000);
+    }
+    stopCleanupTimer() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    cleanupIdleSessions() {
+        const now = Date.now();
+        const timeout = this.options.sessionIdleTimeout;
+        for (const [id, session] of this.sessions) {
+            if (!session.hasObservers() && now - session.lastActivity > timeout) {
+                session.close();
+                this.sessions.delete(id);
+            }
+        }
+    }
+}
+exports.AcpSessionManager = AcpSessionManager;
+//# sourceMappingURL=session-manager.js.map

package/lib/acp/session-manager.js.map

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

package/lib/acp/session.d.ts

@@ -0,0 +1,67 @@
+import type { SessionUpdate } from '@agentclientprotocol/sdk';
+import type { CanUseTool, PermissionMode, Session as SdkSession, SessionOptions } from '../types';
+import { type ConversionMode } from './converter';
+export type AcpSessionState = 'idle' | 'running' | 'processing' | 'error' | 'closed';
+export interface UpdateMeta {
+    mode: ConversionMode;
+    toolName?: string;
+    requestId?: string;
+}
+export interface AcpSessionObserver {
+    readonly id: string;
+    onUpdate(update: SessionUpdate, meta?: UpdateMeta): void;
+    onError(error: Error): void;
+}
+export interface AcpSessionOptions {
+    sdkOptions: Partial<SessionOptions>;
+    idleTimeout?: number;
+    autoStart?: boolean;
+}
+export declare class AcpSession {
+    readonly sessionId: string;
+    private _state;
+    private _sdkSession;
+    private readonly _observers;
+    private readonly _options;
+    private readonly _converter;
+    private _isRunning;
+    private _lastActivity;
+    private _idleTimer?;
+    private readonly _history;
+    private _sessionFactory;
+    constructor(sessionId: string, options: AcpSessionOptions);
+    get state(): AcpSessionState;
+    get lastActivity(): number;
+    get historyLength(): number;
+    get isRunning(): boolean;
+    get sdkSession(): SdkSession | null;
+    setSessionFactory(factory: (sessionId: string, options: SessionOptions) => SdkSession): void;
+    addObserver(observer: AcpSessionObserver, replayHistory?: boolean): void;
+    removeObserver(observerId: string): void;
+    getObserverIds(): string[];
+    hasObservers(): boolean;
+    storeUpdate(update: SessionUpdate, meta?: {
+        mode?: string;
+        toolName?: string;
+        requestId?: string;
+    }): void;
+    initialize(resume?: boolean): Promise<void>;
+    close(): Promise<void>;
+    start(): void;
+    stop(): void;
+    streamSdkHistory(observer: AcpSessionObserver): Promise<void>;
+    setCanUseTool(handler: CanUseTool): void;
+    getCanUseTool(): CanUseTool | undefined;
+    setPermissionMode(mode: PermissionMode): Promise<void>;
+    getPermissionMode(): PermissionMode;
+    setModel(model: string): Promise<void>;
+    getModel(): string | undefined;
+    private setState;
+    private replayHistoryToObserver;
+    private touch;
+    private startIdleTimer;
+    private stopIdleTimer;
+    private resetIdleTimer;
+    private onIdleTimeout;
+}
+//# sourceMappingURL=session.d.ts.map

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

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

package/lib/acp/session.js

@@ -0,0 +1,263 @@
+"use strict";
+// AcpSession - Persistent ACP Session with Observer Pattern
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcpSession = void 0;
+const converter_1 = require("./converter");
+// ============= AcpSession =============
+class AcpSession {
+    constructor(sessionId, options) {
+        this.sessionId = sessionId;
+        this._state = 'idle';
+        this._sdkSession = null;
+        this._observers = new Map();
+        this._isRunning = false;
+        this._lastActivity = Date.now();
+        this._history = [];
+        this._sessionFactory = null;
+        this._options = {
+            idleTimeout: 30 * 60 * 1000,
+            autoStart: true,
+            ...options,
+        };
+        this._converter = new converter_1.AcpConverter();
+    }
+    // ========== Getters ==========
+    get state() {
+        return this._state;
+    }
+    get lastActivity() {
+        return this._lastActivity;
+    }
+    get historyLength() {
+        return this._history.length;
+    }
+    get isRunning() {
+        return this._isRunning;
+    }
+    get sdkSession() {
+        return this._sdkSession;
+    }
+    // ========== Session Factory ==========
+    setSessionFactory(factory) {
+        this._sessionFactory = factory;
+    }
+    // ========== Observer Management ==========
+    addObserver(observer, replayHistory = true) {
+        this._observers.set(observer.id, observer);
+        this.touch();
+        if (replayHistory && this._history.length > 0) {
+            this.replayHistoryToObserver(observer);
+        }
+    }
+    removeObserver(observerId) {
+        this._observers.delete(observerId);
+    }
+    getObserverIds() {
+        return Array.from(this._observers.keys());
+    }
+    hasObservers() {
+        return this._observers.size > 0;
+    }
+    storeUpdate(update, meta) {
+        this._history.push({
+            updates: [{
+                    update,
+                    _meta: meta ? {
+                        'codebuddy.ai': {
+                            toolName: meta.toolName,
+                            requestId: meta.requestId,
+                        },
+                    } : undefined,
+                }],
+            timestamp: Date.now(),
+        });
+    }
+    // ========== Lifecycle ==========
+    async initialize(resume = false) {
+        if (this._sdkSession) {
+            return;
+        }
+        const { unstable_v2_createSession, unstable_v2_resumeSession } = await Promise.resolve().then(() => __importStar(require('../index')));
+        const sdkOptions = {
+            ...this._options.sdkOptions,
+            sessionId: this.sessionId,
+        };
+        if (this._sessionFactory) {
+            this._sdkSession = this._sessionFactory(this.sessionId, sdkOptions);
+        }
+        else if (resume) {
+            this._sdkSession = unstable_v2_resumeSession(this.sessionId, sdkOptions);
+        }
+        else {
+            this._sdkSession = unstable_v2_createSession(sdkOptions);
+        }
+        await this._sdkSession.connect();
+        this.touch();
+        this.startIdleTimer();
+        if (this._options.autoStart) {
+            this.start();
+        }
+    }
+    async close() {
+        this.stop();
+        this.stopIdleTimer();
+        this.setState('closed');
+        if (this._sdkSession) {
+            this._sdkSession.close();
+            this._sdkSession = null;
+        }
+        this._observers.clear();
+        this._history.length = 0;
+        this._converter.reset();
+    }
+    // ========== Detach Mode ==========
+    start() {
+        if (this._isRunning || this._state === 'closed') {
+            return;
+        }
+        this._isRunning = true;
+        this.setState('running');
+    }
+    stop() {
+        this._isRunning = false;
+        if (this._state === 'running') {
+            this.setState('idle');
+        }
+    }
+    // ========== History Streaming ==========
+    async streamSdkHistory(observer) {
+        var _a, _b, _c;
+        if (!((_a = this._sdkSession) === null || _a === void 0 ? void 0 : _a.hasPendingHistory())) {
+            return;
+        }
+        try {
+            for await (const message of this._sdkSession.stream()) {
+                const updates = this._converter.convertToUpdates(message, { mode: 'history' });
+                for (const { update, _meta } of updates) {
+                    observer.onUpdate(update, {
+                        mode: 'history',
+                        toolName: (_b = _meta === null || _meta === void 0 ? void 0 : _meta['codebuddy.ai']) === null || _b === void 0 ? void 0 : _b.toolName,
+                        requestId: (_c = _meta === null || _meta === void 0 ? void 0 : _meta['codebuddy.ai']) === null || _c === void 0 ? void 0 : _c.requestId,
+                    });
+                }
+                if (message.type === 'result' || message.type === 'error') {
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            observer.onError(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    // ========== Permission Handler ==========
+    setCanUseTool(handler) {
+        if (this._sdkSession) {
+            this._sdkSession.setCanUseTool(handler);
+        }
+    }
+    getCanUseTool() {
+        var _a;
+        return (_a = this._sdkSession) === null || _a === void 0 ? void 0 : _a.getCanUseTool();
+    }
+    // ========== Mode/Model ==========
+    async setPermissionMode(mode) {
+        if (this._sdkSession) {
+            await this._sdkSession.setPermissionMode(mode);
+        }
+    }
+    getPermissionMode() {
+        var _a, _b;
+        return (_b = (_a = this._sdkSession) === null || _a === void 0 ? void 0 : _a.getPermissionMode()) !== null && _b !== void 0 ? _b : 'default';
+    }
+    async setModel(model) {
+        if (this._sdkSession) {
+            await this._sdkSession.setModel(model);
+        }
+    }
+    getModel() {
+        var _a;
+        return (_a = this._sdkSession) === null || _a === void 0 ? void 0 : _a.getModel();
+    }
+    // ========== Private: State Management ==========
+    setState(state) {
+        this._state = state;
+    }
+    // ========== Private: History Replay ==========
+    replayHistoryToObserver(observer) {
+        var _a, _b;
+        for (const entry of this._history) {
+            for (const { update, _meta } of entry.updates) {
+                observer.onUpdate(update, {
+                    mode: 'history',
+                    toolName: (_a = _meta === null || _meta === void 0 ? void 0 : _meta['codebuddy.ai']) === null || _a === void 0 ? void 0 : _a.toolName,
+                    requestId: (_b = _meta === null || _meta === void 0 ? void 0 : _meta['codebuddy.ai']) === null || _b === void 0 ? void 0 : _b.requestId,
+                });
+            }
+        }
+    }
+    // ========== Private: Activity Tracking ==========
+    touch() {
+        this._lastActivity = Date.now();
+        this.resetIdleTimer();
+    }
+    startIdleTimer() {
+        if (this._options.idleTimeout && this._options.idleTimeout > 0) {
+            this._idleTimer = setTimeout(() => {
+                this.onIdleTimeout();
+            }, this._options.idleTimeout);
+        }
+    }
+    stopIdleTimer() {
+        if (this._idleTimer) {
+            clearTimeout(this._idleTimer);
+            this._idleTimer = undefined;
+        }
+    }
+    resetIdleTimer() {
+        this.stopIdleTimer();
+        this.startIdleTimer();
+    }
+    onIdleTimeout() {
+        if (!this.hasObservers()) {
+            this.close();
+        }
+        else {
+            this.startIdleTimer();
+        }
+    }
+}
+exports.AcpSession = AcpSession;
+//# sourceMappingURL=session.js.map

package/lib/acp/session.js.map

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

package/lib/index.d.ts

@@ -32,7 +32,7 @@ export type { Options, SessionOptions } from './types';
 export type { PermissionMode, PermissionBehavior, PermissionResult, PermissionUpdate, CanUseTool, CanUseToolOptions, } from './types';
 export type { HookEvent, HookCallback, HookCallbackMatcher, HookInput, HookJSONOutput, SyncHookJSONOutput, AsyncHookJSONOutput, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, NotificationHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PermissionRequestHookInput, CheckpointHookInput, } from './types';
 export type { Checkpoint, CheckpointFileChangeStats, FileVersion, } from './types';
-export type { Message, SystemMessage, UserMessage, AssistantMessage, PartialAssistantMessage, ResultMessage, CompactBoundaryMessage, StatusMessage, ToolProgressMessage, ErrorMessage, PermissionDenial, } from './types';
+export type { Message, SystemMessage, UserMessage, AssistantMessage, PartialAssistantMessage, ResultMessage, CompactBoundaryMessage, StatusMessage, ToolProgressMessage, ErrorMessage, TopicMessage, PermissionDenial, } from './types';
 export type { ContentBlock, TextContentBlock, ToolUseContentBlock, ToolResultContentBlock, ImageContentBlock, ImageMediaType, Base64ImageSource, UrlImageSource, } from './types';
 export type { SlashCommand, ModelInfo, AccountInfo, McpServerStatus, RawLanguageModel, } from './types';
 export type { OutputFormat, JsonSchemaOutputFormat } from './types';
@@ -45,5 +45,11 @@ export type { Session } from './types';
 export { AcpAgent, ACP_EXT_METHOD_QUESTION, } from './acp/agent';
 export type { AcpAgentOptions, OnNewSession, OnLoadSession, AskUserQuestionRequest, AskUserQuestionResponse, OnAskUserQuestion, ToolInputRequest, ToolInputResponse, QuestionInputSchema, QuestionInputData, QuestionOption, UserQuestion, } from './acp/agent';
 export { AcpConverter, } from './acp/converter';
-export type { ToolResult, } from './acp/converter';
+export type { ToolResult, SessionUpdateWithMeta, ConversionMode, } from './acp/converter';
+export { AcpSession } from './acp/session';
+export type { AcpSessionOptions, AcpSessionObserver, AcpSessionState, UpdateMeta, } from './acp/session';
+export { AcpSessionManager } from './acp/session-manager';
+export type { AcpSessionManagerOptions } from './acp/session-manager';
+export { AcpAgentServer } from './acp/server';
+export type { AcpAgentServerOptions, SessionContext, } from './acp/server';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -17,7 +17,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AcpConverter = exports.ACP_EXT_METHOD_QUESTION = exports.AcpAgent = exports.disablePlugin = exports.enablePlugin = exports.installPlugin = exports.removeMarketplace = exports.installMarketplace = exports.ExecutionError = exports.AbortError = exports.EXIT_REASONS = exports.HOOK_EVENTS = exports.tool = exports.createSdkMcpServer = exports.unstable_v2_logout = exports.unstable_v2_authenticate = exports.unstable_v2_resumeSession = exports.unstable_v2_createSession = exports.clearConnectedTransport = exports.connectCLI = exports.Query = exports.query = void 0;
+exports.AcpAgentServer = exports.AcpSessionManager = exports.AcpSession = exports.AcpConverter = exports.ACP_EXT_METHOD_QUESTION = exports.AcpAgent = exports.disablePlugin = exports.enablePlugin = exports.installPlugin = exports.removeMarketplace = exports.installMarketplace = exports.ExecutionError = exports.AbortError = exports.EXIT_REASONS = exports.HOOK_EVENTS = exports.tool = exports.createSdkMcpServer = exports.unstable_v2_logout = exports.unstable_v2_authenticate = exports.unstable_v2_resumeSession = exports.unstable_v2_createSession = exports.clearConnectedTransport = exports.connectCLI = exports.Query = exports.query = void 0;
 // ============= Main API =============
 var query_1 = require("./query");
 Object.defineProperty(exports, "query", { enumerable: true, get: function () { return query_1.query; } });
@@ -63,4 +63,13 @@ Object.defineProperty(exports, "ACP_EXT_METHOD_QUESTION", { enumerable: true, ge
 // AcpConverter - stateful session-level message converter
 var converter_1 = require("./acp/converter");
 Object.defineProperty(exports, "AcpConverter", { enumerable: true, get: function () { return converter_1.AcpConverter; } });
+// AcpSession - persistent session with observer pattern
+var session_2 = require("./acp/session");
+Object.defineProperty(exports, "AcpSession", { enumerable: true, get: function () { return session_2.AcpSession; } });
+// AcpSessionManager - multi-session management
+var session_manager_1 = require("./acp/session-manager");
+Object.defineProperty(exports, "AcpSessionManager", { enumerable: true, get: function () { return session_manager_1.AcpSessionManager; } });
+// AcpAgentServer - multi-session, multi-connection server
+var server_1 = require("./acp/server");
+Object.defineProperty(exports, "AcpAgentServer", { enumerable: true, get: function () { return server_1.AcpAgentServer; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,uCAAuC;AAEvC,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,iBAAiB;AACjB,qCAAgE;AAAvD,qGAAA,UAAU,OAAA;AAAE,kHAAA,uBAAuB,OAAA;AAG5C,oBAAoB;AACpB,qCAImB;AAHf,oHAAA,aAAa,OAA6B;AAC1C,oHAAA,aAAa,OAA6B;AAC1C,6GAAA,MAAM,OAAsB;AAGhC,gCAAgC;AAChC,+BAAgG;AAAvF,gHAAA,YAAY,OAA4B;AAAE,0GAAA,MAAM,OAAsB;AAG/E,6CAA6C;AAE7C,6BAAiD;AAAxC,yGAAA,kBAAkB,OAAA;AAAE,2FAAA,IAAI,OAAA;AAUjC,wCAAwC;AAExC,iCAAoD;AAA3C,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAElC,qCAAqC;AAErC,mCAAsD;AAA7C,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAEnC,yCAAyC;AAEzC,mCAMkB;AALd,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AA8HjB,8CAA8C;AAE9C,mFAAmF;AACnF,qCAGqB;AAFjB,iGAAA,QAAQ,OAAA;AACR,gHAAA,uBAAuB,OAAA;AAoB3B,0DAA0D;AAC1D,6CAEyB;AADrB,yGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,uCAAuC;AAEvC,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,iBAAiB;AACjB,qCAAgE;AAAvD,qGAAA,UAAU,OAAA;AAAE,kHAAA,uBAAuB,OAAA;AAG5C,oBAAoB;AACpB,qCAImB;AAHf,oHAAA,aAAa,OAA6B;AAC1C,oHAAA,aAAa,OAA6B;AAC1C,6GAAA,MAAM,OAAsB;AAGhC,gCAAgC;AAChC,+BAAgG;AAAvF,gHAAA,YAAY,OAA4B;AAAE,0GAAA,MAAM,OAAsB;AAG/E,6CAA6C;AAE7C,6BAAiD;AAAxC,yGAAA,kBAAkB,OAAA;AAAE,2FAAA,IAAI,OAAA;AAUjC,wCAAwC;AAExC,iCAAoD;AAA3C,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAElC,qCAAqC;AAErC,mCAAsD;AAA7C,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAEnC,yCAAyC;AAEzC,mCAMkB;AALd,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AA+HjB,8CAA8C;AAE9C,mFAAmF;AACnF,qCAGqB;AAFjB,iGAAA,QAAQ,OAAA;AACR,gHAAA,uBAAuB,OAAA;AAoB3B,0DAA0D;AAC1D,6CAEyB;AADrB,yGAAA,YAAY,OAAA;AAShB,wDAAwD;AACxD,yCAA2C;AAAlC,qGAAA,UAAU,OAAA;AASnB,+CAA+C;AAC/C,yDAA0D;AAAjD,oHAAA,iBAAiB,OAAA;AAG1B,0DAA0D;AAC1D,uCAA8C;AAArC,wGAAA,cAAc,OAAA"}

package/lib/types.d.ts

@@ -593,10 +593,19 @@ export interface ErrorMessage {
     error: string;
     session_id?: string;
 }
+/**
+ * Topic message for session title/topic updates.
+ * Used to update the session's human-readable title.
+ */
+export interface TopicMessage {
+    type: 'topic';
+    topic: string;
+    session_id: string;
+}
 /**
  * @experimental _requestId is an experimental field that may change in future versions.
  */
-export type Message = (SystemMessage | UserMessage | AssistantMessage | PartialAssistantMessage | ResultMessage | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | ErrorMessage) & {
+export type Message = (SystemMessage | UserMessage | AssistantMessage | PartialAssistantMessage | ResultMessage | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | ErrorMessage | TopicMessage) & {
     /** @experimental */
     _requestId?: string;
 };