@vybestack/llxprt-code-agents 0.10.0-nightly.260613.1adad3b34

package/dist/src/core/chatSession.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content, GenerateContentConfig, GenerateContentResponse, SendMessageParameters, Tool, PartListUnion } from '@google/genai';
+import type { CompletedToolCall } from './coreToolScheduler.js';
+import type { HistoryService } from '@vybestack/llxprt-code-core/services/history/HistoryService.js';
+import type { IContent } from '@vybestack/llxprt-code-core/services/history/IContent.js';
+import type { RuntimeProvider as IProvider } from '@vybestack/llxprt-code-core/runtime/contracts/RuntimeProvider.js';
+import type { AgentRuntimeContext, ToolRegistryView } from '@vybestack/llxprt-code-core/runtime/AgentRuntimeContext.js';
+import type { ContentGenerator } from '@vybestack/llxprt-code-core/core/contentGenerator.js';
+export { StreamEventType, StreamEvent, } from '@vybestack/llxprt-code-core/core/chatSessionTypes.js';
+export { InvalidStreamError, EmptyStreamError, isSchemaDepthError, } from '@vybestack/llxprt-code-core/core/chatSessionTypes.js';
+export { aggregateTextWithSpacing, isValidNonThoughtTextPart, } from './MessageConverter.js';
+import type { StreamEvent } from '@vybestack/llxprt-code-core/core/chatSessionTypes.js';
+import type { PerformCompressionResult } from './turn.js';
+import type { Config } from '@vybestack/llxprt-code-core/config/config.js';
+/**
+ * Error thrown when agent execution is stopped by a hook.
+ */
+export declare class AgentExecutionStoppedError extends Error {
+    readonly reason: string;
+    readonly systemMessage?: string;
+    readonly contextCleared?: boolean;
+    constructor(reason: string, systemMessage?: string, contextCleared?: boolean);
+}
+/**
+ * Error thrown when agent execution is blocked by a hook.
+ */
+export declare class AgentExecutionBlockedError extends Error {
+    readonly reason: string;
+    readonly systemMessage?: string;
+    readonly syntheticResponse?: GenerateContentResponse;
+    readonly contextCleared?: boolean;
+    constructor(reason: string, syntheticResponse?: GenerateContentResponse, systemMessage?: string, contextCleared?: boolean);
+}
+/**
+ * Chat session that enables sending messages to the model with previous
+ * conversation context.
+ *
+ * @remarks
+ * The session maintains all the turns between user and model.
+ * Delegates to focused modules: CompressionHandler, ConversationManager,
+ * TurnProcessor, StreamProcessor, DirectMessageProcessor.
+ */
+export declare class ChatSession {
+    private logger;
+    private readonly runtimeState;
+    private readonly historyService;
+    private readonly runtimeContext;
+    private readonly generationConfig;
+    private readonly compressionHandler;
+    private readonly conversationManager;
+    private readonly turnProcessor;
+    private readonly streamProcessor;
+    private readonly directMessageProcessor;
+    private readonly compressionLoadBalancerRoundRobinIndexes;
+    constructor(view: AgentRuntimeContext, contentGenerator: ContentGenerator, generationConfig?: GenerateContentConfig, initialHistory?: Content[]);
+    private _buildMessageProcessors;
+    private static readonly DENSITY_WRAPPED;
+    private _installDensityWrapper;
+    private getActiveProvider;
+    private lookupProviderByName;
+    resolveProviderForRuntime(compressionProfileName: string): IProvider;
+    private resolveExplicitCompressionProvider;
+    providerSupportsIContent(provider: IProvider | undefined): boolean;
+    private resolveCompressionProvider;
+    private resolveLoadBalancedCompressionProvider;
+    private buildCompressionLoadBalancerCandidates;
+    private resolveStandardCompressionProvider;
+    private applyCompressionProfileSettings;
+    private applyCompressionProfileAuthSettings;
+    private copyProfileSettingAliases;
+    private applyCompressionProfileModelParams;
+    private applyCompressionProfileParentEphemerals;
+    private resolveProviderBaseUrl;
+    private buildProviderRuntime;
+    private buildCompressionProfileResolvedOptions;
+    private resolveCompressionProfileAuthToken;
+    private getStringSettingFromValues;
+    private expandProfilePath;
+    private buildCompressionProfileEphemeralsSnapshot;
+    private _makePositionMatcher;
+    sendMessage(params: SendMessageParameters, prompt_id: string): Promise<GenerateContentResponse>;
+    sendMessageStream(params: SendMessageParameters, prompt_id: string): Promise<AsyncGenerator<StreamEvent>>;
+    generateDirectMessage(params: SendMessageParameters, prompt_id: string): Promise<GenerateContentResponse>;
+    waitForIdle(): Promise<void>;
+    setSystemInstruction(sysInstr: string): void;
+    getHistoryService(): HistoryService;
+    getToolsView(): ToolRegistryView;
+    setTools(tools: Tool[]): void;
+    clearTools(): void;
+    getHistory(curated?: boolean): Content[];
+    clearHistory(): void;
+    addHistory(content: Content): void;
+    setHistory(history: Content[]): void;
+    setActiveTodosProvider(provider: () => Promise<string | undefined>): void;
+    performCompression(prompt_id: string, options?: {
+        bypassCooldown?: boolean;
+    }): Promise<PerformCompressionResult>;
+    wasRecentlyCompressed(): boolean;
+    getLastPromptTokenCount(): number;
+    recordCompletedToolCalls(_model: string, _toolCalls: CompletedToolCall[]): void;
+    convertPartListUnionToIContent(input: PartListUnion): IContent;
+    convertIContentToResponse(input: IContent): GenerateContentResponse;
+    estimatePendingTokens(contents: IContent[]): Promise<number>;
+    get densityDirty(): boolean;
+    set densityDirty(value: boolean);
+    get _suppressDensityDirty(): boolean;
+    set _suppressDensityDirty(value: boolean);
+    ensureDensityOptimized(): Promise<void>;
+    ensureCompressionBeforeSend(promptId: string, pendingTokens: number, source: 'send' | 'stream', trigger?: 'manual' | 'auto'): Promise<void>;
+    enforceContextWindow(pendingTokens: number, promptId: string): Promise<void>;
+    shouldCompress(pendingTokens?: number): boolean;
+    /**
+     * Returns the Config instance from the provider runtime.
+     * Used by Turn and other consumers to access ephemeral settings.
+     */
+    getConfig(): Config | undefined;
+}