art-framework 0.3.4 → 0.3.6

package/dist/index.d.cts

@@ -4126,10 +4126,24 @@ declare class GeminiAdapter implements ProviderAdapter {
      *
      * Handles both streaming and non-streaming requests based on `options.stream`.
      *
+     * Thinking tokens (Gemini):
+     * - On supported Gemini models (e.g., `gemini-2.5-*`), you can enable thought output via `config.thinkingConfig`.
+     * - This adapter reads provider-specific flags from the call options:
+     *   - `options.gemini.thinking.includeThoughts: boolean` — when `true`, requests thought (reasoning) output.
+     *   - `options.gemini.thinking.thinkingBudget?: number` — optional token budget for thinking.
+     * - When enabled and supported, the adapter will attempt to differentiate thought vs response parts and set
+     *   `StreamEvent.tokenType` accordingly:
+     *   - For planning calls (`callContext === 'AGENT_THOUGHT'`): `AGENT_THOUGHT_LLM_THINKING` or `AGENT_THOUGHT_LLM_RESPONSE`.
+     *   - For synthesis calls (`callContext === 'FINAL_SYNTHESIS'`): `FINAL_SYNTHESIS_LLM_THINKING` or `FINAL_SYNTHESIS_LLM_RESPONSE`.
+     * - `LLMMetadata.thinkingTokens` will be populated if the provider reports separate thinking token usage.
+     * - If the SDK/model does not expose thought parts, the adapter falls back to labeling tokens as `...LLM_RESPONSE`.
+     *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
      * @param {CallOptions} options - Options for the LLM call, including streaming preference, model override, and execution context.
      * @returns {Promise<AsyncIterable<StreamEvent>>} An async iterable that yields `StreamEvent` objects.
      *   - `TOKEN`: Contains a chunk of the response text. `tokenType` indicates if it's part of agent thought or final synthesis.
+     *             When Gemini thinking is enabled and available, `tokenType` may be one of the `...LLM_THINKING` or
+     *             `...LLM_RESPONSE` variants to separate thought vs response tokens.
      *   - `METADATA`: Contains information like stop reason, token counts, and timing, yielded once at the end.
      *   - `ERROR`: Contains any error encountered during translation, SDK call, or response processing.
      *   - `END`: Signals the completion of the stream.
@@ -4138,6 +4152,23 @@ declare class GeminiAdapter implements ProviderAdapter {
      * @see {StreamEvent}
      * @see {LLMMetadata}
      * @see https://ai.google.dev/api/rest/v1beta/models/generateContent
+     *
+     * @example
+     * // Enable Gemini thinking (if supported by the selected model)
+     * const stream = await geminiAdapter.call(prompt, {
+     *   threadId,
+     *   stream: true,
+     *   callContext: 'FINAL_SYNTHESIS',
+     *   providerConfig, // your RuntimeProviderConfig
+     *   gemini: {
+     *     thinking: { includeThoughts: true, thinkingBudget: 8096 }
+     *   }
+     * });
+     * for await (const evt of stream) {
+     *   if (evt.type === 'TOKEN') {
+     *     // evt.tokenType may be FINAL_SYNTHESIS_LLM_THINKING or FINAL_SYNTHESIS_LLM_RESPONSE
+     *   }
+     * }
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
@@ -5205,6 +5236,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.3";
+declare const VERSION = "0.3.5";
 
 export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, type AgentFinalResponse, type AgentOptions, type AgentPersona, type AgentProps, type AgentState, AnthropicAdapter, type AnthropicAdapterOptions, ApiKeyStrategy, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, AuthManager, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, ConversationSocket, type CreateA2ATaskRequest, DeepSeekAdapter, type DeepSeekAdapterOptions, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, type IA2ATaskRepository, type IAgentCore, type IAuthStrategy, type IConversationRepository, type IObservationRepository, type IProviderManager, type IStateRepository, type IToolExecutor, type ITypedSocket, InMemoryStorageAdapter, IndexedDBStorageAdapter, type JsonObjectSchema, type JsonSchema, type LLMMetadata, LLMStreamSocket, LocalInstanceBusyError, LocalProviderConflictError, LogLevel, Logger, type LoggerConfig, type ManagedAdapterAccessor, McpClientController, McpManager, type McpManagerConfig, McpProxyTool, type McpResource, type McpResourceTemplate, type McpServerConfig, type McpServerStatus, type McpToolDefinition, type MessageOptions, MessageRole, ModelCapability, type OAuthConfig, type Observation, type ObservationFilter, type ObservationManager, ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, type OpenAIAdapterOptions, OpenRouterAdapter, type OpenRouterAdapterOptions, type OutputParser, PESAgent, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type StreamEventTypeFilter, SupabaseStorageAdapter, type SystemPromptMergeStrategy, type SystemPromptOverride, type SystemPromptResolver, type SystemPromptSpec, type SystemPromptsRegistry, type TaskDelegationConfig, TaskDelegationService, type TaskStatusResponse, type ThreadConfig, type ThreadContext, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };

package/dist/index.d.ts

@@ -4126,10 +4126,24 @@ declare class GeminiAdapter implements ProviderAdapter {
      *
      * Handles both streaming and non-streaming requests based on `options.stream`.
      *
+     * Thinking tokens (Gemini):
+     * - On supported Gemini models (e.g., `gemini-2.5-*`), you can enable thought output via `config.thinkingConfig`.
+     * - This adapter reads provider-specific flags from the call options:
+     *   - `options.gemini.thinking.includeThoughts: boolean` — when `true`, requests thought (reasoning) output.
+     *   - `options.gemini.thinking.thinkingBudget?: number` — optional token budget for thinking.
+     * - When enabled and supported, the adapter will attempt to differentiate thought vs response parts and set
+     *   `StreamEvent.tokenType` accordingly:
+     *   - For planning calls (`callContext === 'AGENT_THOUGHT'`): `AGENT_THOUGHT_LLM_THINKING` or `AGENT_THOUGHT_LLM_RESPONSE`.
+     *   - For synthesis calls (`callContext === 'FINAL_SYNTHESIS'`): `FINAL_SYNTHESIS_LLM_THINKING` or `FINAL_SYNTHESIS_LLM_RESPONSE`.
+     * - `LLMMetadata.thinkingTokens` will be populated if the provider reports separate thinking token usage.
+     * - If the SDK/model does not expose thought parts, the adapter falls back to labeling tokens as `...LLM_RESPONSE`.
+     *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
      * @param {CallOptions} options - Options for the LLM call, including streaming preference, model override, and execution context.
      * @returns {Promise<AsyncIterable<StreamEvent>>} An async iterable that yields `StreamEvent` objects.
      *   - `TOKEN`: Contains a chunk of the response text. `tokenType` indicates if it's part of agent thought or final synthesis.
+     *             When Gemini thinking is enabled and available, `tokenType` may be one of the `...LLM_THINKING` or
+     *             `...LLM_RESPONSE` variants to separate thought vs response tokens.
      *   - `METADATA`: Contains information like stop reason, token counts, and timing, yielded once at the end.
      *   - `ERROR`: Contains any error encountered during translation, SDK call, or response processing.
      *   - `END`: Signals the completion of the stream.
@@ -4138,6 +4152,23 @@ declare class GeminiAdapter implements ProviderAdapter {
      * @see {StreamEvent}
      * @see {LLMMetadata}
      * @see https://ai.google.dev/api/rest/v1beta/models/generateContent
+     *
+     * @example
+     * // Enable Gemini thinking (if supported by the selected model)
+     * const stream = await geminiAdapter.call(prompt, {
+     *   threadId,
+     *   stream: true,
+     *   callContext: 'FINAL_SYNTHESIS',
+     *   providerConfig, // your RuntimeProviderConfig
+     *   gemini: {
+     *     thinking: { includeThoughts: true, thinkingBudget: 8096 }
+     *   }
+     * });
+     * for await (const evt of stream) {
+     *   if (evt.type === 'TOKEN') {
+     *     // evt.tokenType may be FINAL_SYNTHESIS_LLM_THINKING or FINAL_SYNTHESIS_LLM_RESPONSE
+     *   }
+     * }
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
@@ -5205,6 +5236,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.3";
+declare const VERSION = "0.3.5";
 
 export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, type AgentFinalResponse, type AgentOptions, type AgentPersona, type AgentProps, type AgentState, AnthropicAdapter, type AnthropicAdapterOptions, ApiKeyStrategy, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, AuthManager, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, ConversationSocket, type CreateA2ATaskRequest, DeepSeekAdapter, type DeepSeekAdapterOptions, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, type IA2ATaskRepository, type IAgentCore, type IAuthStrategy, type IConversationRepository, type IObservationRepository, type IProviderManager, type IStateRepository, type IToolExecutor, type ITypedSocket, InMemoryStorageAdapter, IndexedDBStorageAdapter, type JsonObjectSchema, type JsonSchema, type LLMMetadata, LLMStreamSocket, LocalInstanceBusyError, LocalProviderConflictError, LogLevel, Logger, type LoggerConfig, type ManagedAdapterAccessor, McpClientController, McpManager, type McpManagerConfig, McpProxyTool, type McpResource, type McpResourceTemplate, type McpServerConfig, type McpServerStatus, type McpToolDefinition, type MessageOptions, MessageRole, ModelCapability, type OAuthConfig, type Observation, type ObservationFilter, type ObservationManager, ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, type OpenAIAdapterOptions, OpenRouterAdapter, type OpenRouterAdapterOptions, type OutputParser, PESAgent, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type StreamEventTypeFilter, SupabaseStorageAdapter, type SystemPromptMergeStrategy, type SystemPromptOverride, type SystemPromptResolver, type SystemPromptSpec, type SystemPromptsRegistry, type TaskDelegationConfig, TaskDelegationService, type TaskStatusResponse, type ThreadConfig, type ThreadContext, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };