@google/adk 0.2.5 → 0.4.0

package/dist/types/a2a/part_converter_utils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DataPart as A2ADataPart, FilePart as A2AFilePart, Part as A2APart, TextPart as A2ATextPart } from '@a2a-js/sdk';
+import { Part as GenAIPart } from '@google/genai';
+/**
+ * Converts GenAI Parts to A2A Parts.
+ */
+export declare function toA2AParts(parts: GenAIPart[], longRunningToolIDs?: string[]): A2APart[];
+/**
+ * Converts a GenAI Part to an A2A Part.
+ */
+export declare function toA2APart(part: GenAIPart, longRunningToolIDs?: string[]): A2APart;
+/**
+ * Converts a GenAI Text Part to an A2A Text Part.
+ */
+export declare function toA2ATextPart(part: GenAIPart): A2APart;
+/**
+ * Converts a GenAI File Part to an A2A File Part.
+ */
+export declare function toA2AFilePart(part: GenAIPart): A2APart;
+/**
+ * Converts a GenAI Data Part to an A2A Data Part.
+ */
+export declare function toA2ADataPart(part: GenAIPart, longRunningToolIDs?: string[]): A2APart;
+/**
+ * Converts an A2A Part to a GenAI Part.
+ */
+export declare function toGenAIParts(a2aParts: A2APart[]): GenAIPart[];
+/**
+ * Converts an A2A Part to a GenAI Part.
+ */
+export declare function toGenAIPart(a2aPart: A2APart): GenAIPart;
+/**
+ * Converts an A2A Text Part to a GenAI Part.
+ */
+export declare function toGenAIPartText(a2aPart: A2ATextPart): GenAIPart;
+/**
+ * Converts an A2A File Part to a GenAI Part.
+ */
+export declare function toGenAIPartFile(a2aPart: A2AFilePart): GenAIPart;
+/**
+ * Converts an A2A Data Part to a GenAI Part.
+ */
+export declare function toGenAIPartData(a2aPart: A2ADataPart): GenAIPart;

package/dist/types/agents/base_agent.d.ts

@@ -66,8 +66,9 @@ export declare abstract class BaseAgent {
     readonly description?: string;
     /**
      * Root agent of this agent.
+     * Computed dynamically by traversing up the parent chain.
      */
-    readonly rootAgent: BaseAgent;
+    get rootAgent(): BaseAgent;
     /**
      * The parent agent of this agent.
      *

package/dist/types/agents/callback_context.d.ts

@@ -14,7 +14,7 @@ import { ReadonlyContext } from './readonly_context.js';
 export declare class CallbackContext extends ReadonlyContext {
     private readonly _state;
     readonly eventActions: EventActions;
-    constructor({ invocationContext, eventActions }: {
+    constructor({ invocationContext, eventActions, }: {
         invocationContext: InvocationContext;
         eventActions?: EventActions;
     });

package/dist/types/agents/llm_agent.d.ts

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { GenerateContentConfig, Schema } from '@google/genai';
+import { z as z3 } from 'zod/v3';
+import { z as z4 } from 'zod/v4';
 import { BaseCodeExecutor } from '../code_executors/base_code_executor.js';
 import { Event } from '../events/event.js';
 import { BaseExampleProvider } from '../examples/base_example_provider.js';
@@ -19,6 +21,10 @@ import { BaseLlmRequestProcessor, BaseLlmResponseProcessor } from './base_llm_pr
 import { CallbackContext } from './callback_context.js';
 import { InvocationContext } from './invocation_context.js';
 import { ReadonlyContext } from './readonly_context.js';
+/**
+ * Input/output schema type for agent.
+ */
+export type LlmAgentSchema = z3.ZodObject<z3.ZodRawShape> | z4.ZodObject<z4.ZodRawShape> | Schema;
 /** An object that can provide an instruction string. */
 export type InstructionProvider = (context: ReadonlyContext) => string | Promise<string>;
 /**
@@ -159,15 +165,9 @@ export interface LlmAgentConfig extends BaseAgentConfig {
      */
     includeContents?: 'default' | 'none';
     /** The input schema when agent is used as a tool. */
-    inputSchema?: Schema;
-    /**
-     * The output schema when agent replies.
-     *
-     * NOTE:
-     *   When this is set, agent can ONLY reply and CANNOT use any tools, such as
-     *   function tools, RAGs, agent transfer, etc.
-     */
-    outputSchema?: Schema;
+    inputSchema?: LlmAgentSchema;
+    /** The output schema when agent replies. */
+    outputSchema?: LlmAgentSchema;
     /**
      * The key in session state to store the output of the agent.
      *
@@ -207,7 +207,7 @@ export interface LlmAgentConfig extends BaseAgentConfig {
 }
 declare class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
     /** Handles tool confirmation information to build the LLM request. */
-    runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
+    runAsync(invocationContext: InvocationContext): AsyncGenerator<Event, void, void>;
 }
 export declare const REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: RequestConfirmationLlmRequestProcessor;
 /**
@@ -360,9 +360,9 @@ export declare class LlmAgent extends BaseAgent {
      * @throws Error if the agent is not found.
      */
     private getAgentByName;
-    private callLlmAsync;
+    protected callLlmAsync(invocationContext: InvocationContext, llmRequest: LlmRequest, modelResponseEvent: Event): AsyncGenerator<LlmResponse, void, void>;
     private handleBeforeModelCallback;
     private handleAfterModelCallback;
-    private runAndHandleError;
+    protected runAndHandleError<T extends LlmResponse | Event>(responseGenerator: AsyncGenerator<T, void, void>, invocationContext: InvocationContext, llmRequest: LlmRequest, modelResponseEvent: Event): AsyncGenerator<T, void, void>;
 }
 export {};

package/dist/types/agents/loop_agent.d.ts

@@ -42,6 +42,6 @@ export declare class LoopAgent extends BaseAgent {
     private readonly maxIterations;
     constructor(config: LoopAgentConfig);
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
-    protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    protected runLiveImpl(_context: InvocationContext): AsyncGenerator<Event, void, void>;
 }
 export {};

package/dist/types/agents/parallel_agent.d.ts

@@ -32,6 +32,6 @@ export declare class ParallelAgent extends BaseAgent {
      */
     readonly [PARALLEL_AGENT_SIGNATURE_SYMBOL] = true;
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
-    protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    protected runLiveImpl(_context: InvocationContext): AsyncGenerator<Event, void, void>;
 }
 export {};

package/dist/types/agents/readonly_context.d.ts

@@ -20,6 +20,14 @@ export declare class ReadonlyContext {
      * The current invocation id.
      */
     get invocationId(): string;
+    /**
+     * The user ID of the current session.
+     */
+    get userId(): string;
+    /**
+     * The ID of the current session.
+     */
+    get sessionId(): string;
     /**
      * The current agent name.
      */

package/dist/types/agents/run_config.d.ts

@@ -72,6 +72,11 @@ export interface RunConfig {
      *   - Less than or equal to 0: This allows for unbounded number of llm calls.
      */
     maxLlmCalls?: number;
+    /**
+     * If true, the agent loop will suspend on ANY tool call, allowing the client
+     * to intercept and execute tools (Client-Side Tool Execution).
+     */
+    pauseOnToolCalls?: boolean;
 }
 export declare function createRunConfig(params?: Partial<RunConfig>): {
     speechConfig?: SpeechConfig | undefined;
@@ -85,4 +90,5 @@ export declare function createRunConfig(params?: Partial<RunConfig>): {
     proactivity?: ProactivityConfig | undefined;
     realtimeInputConfig?: RealtimeInputConfig | undefined;
     maxLlmCalls: number;
+    pauseOnToolCalls: boolean;
 };

package/dist/types/artifacts/base_artifact_service.d.ts

@@ -18,6 +18,10 @@ export interface SaveArtifactRequest {
     filename: string;
     /** The artifact to save. */
     artifact: Part;
+    /**
+     * Optional custom metadata to save with the artifact.
+     */
+    customMetadata?: Record<string, unknown>;
 }
 /**
  * The parameters for `loadArtifact`.
@@ -74,6 +78,19 @@ export interface ListVersionsRequest {
     /** The filename of the artifact. */
     filename: string;
 }
+/**
+ * Metadata for a file artifact version.
+ */
+export interface ArtifactVersion {
+    /** The version number. */
+    version: number;
+    /** The canonical URI of the artifact. */
+    canonicalUri?: string;
+    /** Custom metadata associated with the artifact. */
+    customMetadata?: Record<string, unknown>;
+    /** The MIME type of the artifact. */
+    mimeType?: string;
+}
 /**
  *  Interface for artifact services.
  */
@@ -124,4 +141,18 @@ export interface BaseArtifactService {
      *     artifact.
      */
     listVersions(request: ListVersionsRequest): Promise<number[]>;
+    /**
+     * Lists metadata for each artifact version.
+     *
+     * @param request The request to list artifact versions.
+     * @return A promise that resolves to a list of artifact version metadata.
+     */
+    listArtifactVersions(request: ListVersionsRequest): Promise<ArtifactVersion[]>;
+    /**
+     * Gets metadata for a specific artifact version.
+     *
+     * @param request The request to get an artifact version.
+     * @return A promise that resolves to the artifact version metadata or undefined.
+     */
+    getArtifactVersion(request: LoadArtifactRequest): Promise<ArtifactVersion | undefined>;
 }

package/dist/types/artifacts/file_artifact_service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Part } from '@google/genai';
+import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
+/**
+ * Service for managing artifacts stored on the local filesystem.
+ *
+ * Stores filesystem-backed artifacts beneath a configurable root directory.
+ *
+ * Storage layout matches the cloud and in-memory services:
+ * root/
+ * └── users/
+ *     └── {userId}/
+ *         ├── sessions/
+ *         │   └── {sessionId}/
+ *         │       └── artifacts/
+ *         │           └── {artifactPath}/  // derived from filename
+ *         │               └── versions/
+ *         │                   └── {version}/
+ *         │                       ├── {originalFilename}
+ *         │                       └── metadata.json
+ *         └── artifacts/
+ *             └── {artifactPath}/...
+ *
+ * Artifact paths are derived from the provided filenames: separators create
+ * nested directories, and path traversal is rejected to keep the layout
+ * portable across filesystems. `{artifactPath}` therefore mirrors the
+ * sanitized, scope-relative path derived from each filename.
+ */
+export declare class FileArtifactService implements BaseArtifactService {
+    private readonly rootDir;
+    constructor(rootDirOrUri: string);
+    saveArtifact({ userId, sessionId, filename, artifact, customMetadata, }: SaveArtifactRequest): Promise<number>;
+    loadArtifact({ userId, sessionId, filename, version, }: LoadArtifactRequest): Promise<Part | undefined>;
+    listArtifactKeys({ userId, sessionId, }: ListArtifactKeysRequest): Promise<string[]>;
+    deleteArtifact({ userId, sessionId, filename, }: DeleteArtifactRequest): Promise<void>;
+    listVersions({ userId, sessionId, filename, }: ListVersionsRequest): Promise<number[]>;
+    listArtifactVersions({ userId, sessionId, filename, }: ListVersionsRequest): Promise<ArtifactVersion[]>;
+    getArtifactVersion({ userId, sessionId, filename, version, }: LoadArtifactRequest): Promise<ArtifactVersion | undefined>;
+}

package/dist/types/artifacts/gcs_artifact_service.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Part } from '@google/genai';
-import { BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
+import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
 export declare class GcsArtifactService implements BaseArtifactService {
     private readonly bucket;
     constructor(bucket: string);
@@ -13,4 +13,6 @@ export declare class GcsArtifactService implements BaseArtifactService {
     listArtifactKeys(request: ListArtifactKeysRequest): Promise<string[]>;
     deleteArtifact(request: DeleteArtifactRequest): Promise<void>;
     listVersions(request: ListVersionsRequest): Promise<number[]>;
+    listArtifactVersions(request: ListVersionsRequest): Promise<ArtifactVersion[]>;
+    getArtifactVersion(request: LoadArtifactRequest): Promise<ArtifactVersion | undefined>;
 }

package/dist/types/artifacts/in_memory_artifact_service.d.ts

@@ -4,15 +4,18 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Part } from '@google/genai';
-import { BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
+import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
+export declare function isInMemoryConnectionString(uri: string): boolean;
 /**
  * An in-memory implementation of the ArtifactService.
  */
 export declare class InMemoryArtifactService implements BaseArtifactService {
     private readonly artifacts;
-    saveArtifact({ appName, userId, sessionId, filename, artifact, }: SaveArtifactRequest): Promise<number>;
+    saveArtifact({ appName, userId, sessionId, filename, artifact, customMetadata, }: SaveArtifactRequest): Promise<number>;
     loadArtifact({ appName, userId, sessionId, filename, version, }: LoadArtifactRequest): Promise<Part | undefined>;
-    listArtifactKeys({ appName, userId, sessionId }: ListArtifactKeysRequest): Promise<string[]>;
-    deleteArtifact({ appName, userId, sessionId, filename }: DeleteArtifactRequest): Promise<void>;
-    listVersions({ appName, userId, sessionId, filename }: ListVersionsRequest): Promise<number[]>;
+    listArtifactKeys({ appName, userId, sessionId, }: ListArtifactKeysRequest): Promise<string[]>;
+    deleteArtifact({ appName, userId, sessionId, filename, }: DeleteArtifactRequest): Promise<void>;
+    listVersions({ appName, userId, sessionId, filename, }: ListVersionsRequest): Promise<number[]>;
+    listArtifactVersions({ appName, userId, sessionId, filename, }: ListVersionsRequest): Promise<ArtifactVersion[]>;
+    getArtifactVersion({ appName, userId, sessionId, filename, version, }: LoadArtifactRequest): Promise<ArtifactVersion | undefined>;
 }

package/dist/types/artifacts/registry.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseArtifactService } from './base_artifact_service.js';
+export declare function getArtifactServiceFromUri(uri: string): BaseArtifactService;

package/dist/types/code_executors/built_in_code_executor.d.ts

@@ -26,7 +26,7 @@ export declare function isBuiltInCodeExecutor(obj: unknown): obj is BuiltInCodeE
 export declare class BuiltInCodeExecutor extends BaseCodeExecutor {
     /** A unique symbol to identify BuiltInCodeExecutor class. */
     readonly [BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL] = true;
-    executeCode(params: ExecuteCodeParams): Promise<CodeExecutionResult>;
+    executeCode(_params: ExecuteCodeParams): Promise<CodeExecutionResult>;
     processLlmRequest(llmRequest: LlmRequest): void;
 }
 export {};

package/dist/types/code_executors/code_executor_context.d.ts

@@ -78,10 +78,8 @@ export declare class CodeExecutorContext {
      */
     updateCodeExecutionResult({ invocationId, code, resultStdout, resultStderr, }: UpdateCodeExecutionResultParams): void;
     /**
-     * Gets the code executor context from the session state.
-     * @param invocationId The session state to get the code executor context
-     *     from.
+     * Gets the code execution context from the session state.
      * @return The code execution context for the given invocation ID.
      */
-    getCodeExecutionContext(invocationId: string): Record<string, unknown>;
+    getCodeExecutionContext(): Record<string, unknown>;
 }

package/dist/types/common.d.ts

@@ -15,7 +15,7 @@ export type { InvocationContextParams } from './agents/invocation_context.js';
 export { LiveRequestQueue } from './agents/live_request_queue.js';
 export type { LiveRequest } from './agents/live_request_queue.js';
 export { LlmAgent, isLlmAgent } from './agents/llm_agent.js';
-export type { AfterModelCallback, AfterToolCallback, BeforeModelCallback, BeforeToolCallback, InstructionProvider, LlmAgentConfig, SingleAfterModelCallback, SingleAfterToolCallback, SingleBeforeModelCallback, SingleBeforeToolCallback, ToolUnion, } from './agents/llm_agent.js';
+export type { AfterModelCallback, AfterToolCallback, BeforeModelCallback, BeforeToolCallback, InstructionProvider, LlmAgentConfig, LlmAgentSchema, SingleAfterModelCallback, SingleAfterToolCallback, SingleBeforeModelCallback, SingleBeforeToolCallback, ToolUnion, } from './agents/llm_agent.js';
 export { LoopAgent, isLoopAgent } from './agents/loop_agent.js';
 export type { LoopAgentConfig } from './agents/loop_agent.js';
 export { ParallelAgent, isParallelAgent } from './agents/parallel_agent.js';
@@ -24,6 +24,7 @@ export { StreamingMode } from './agents/run_config.js';
 export type { RunConfig } from './agents/run_config.js';
 export { SequentialAgent, isSequentialAgent } from './agents/sequential_agent.js';
 export type { TranscriptionEntry } from './agents/transcription_entry.js';
+export type { BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest, } from './artifacts/base_artifact_service.js';
 export { InMemoryArtifactService } from './artifacts/in_memory_artifact_service.js';
 export { AuthCredentialTypes } from './auth/auth_credential.js';
 export type { AuthCredential, HttpAuth, HttpCredentials, OAuth2Auth, ServiceAccount, ServiceAccountCredential, } from './auth/auth_credential.js';
@@ -38,13 +39,18 @@ export { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExe
 export type { Event } from './events/event.js';
 export { createEventActions } from './events/event_actions.js';
 export type { EventActions } from './events/event_actions.js';
+export { EventType, toStructuredEvents } from './events/structured_events.js';
+export type { ActivityEvent, CallCodeEvent, CodeResultEvent, ContentEvent, ErrorEvent, FinishedEvent, StructuredEvent, ThoughtEvent, ToolCallEvent, ToolConfirmationEvent, ToolResultEvent, } from './events/structured_events.js';
 export { BaseExampleProvider, isBaseExampleProvider, } from './examples/base_example_provider.js';
 export type { Example } from './examples/example.js';
+export type { BaseMemoryService, SearchMemoryRequest, SearchMemoryResponse, } from './memory/base_memory_service.js';
 export { InMemoryMemoryService } from './memory/in_memory_memory_service.js';
 export type { MemoryEntry } from './memory/memory_entry.js';
+export { ApigeeLlm } from './models/apigee_llm.js';
+export type { ApigeeLlmParams } from './models/apigee_llm.js';
 export { BaseLlm, isBaseLlm } from './models/base_llm.js';
 export type { BaseLlmConnection } from './models/base_llm_connection.js';
-export { Gemini } from './models/google_llm.js';
+export { Gemini, geminiInitParams } from './models/google_llm.js';
 export type { GeminiParams } from './models/google_llm.js';
 export type { LlmRequest } from './models/llm_request.js';
 export type { LlmResponse } from './models/llm_response.js';
@@ -58,6 +64,8 @@ export type { BasePolicyEngine, PolicyCheckResult, ToolCallPolicyContext, } from
 export { InMemoryRunner } from './runner/in_memory_runner.js';
 export { Runner } from './runner/runner.js';
 export type { RunnerConfig } from './runner/runner.js';
+export { BaseSessionService } from './sessions/base_session_service.js';
+export type { AppendEventRequest, CreateSessionRequest, DeleteSessionRequest, GetSessionConfig, GetSessionRequest, ListSessionsRequest, ListSessionsResponse, } from './sessions/base_session_service.js';
 export { InMemorySessionService } from './sessions/in_memory_session_service.js';
 export { createSession } from './sessions/session.js';
 export type { Session } from './sessions/session.js';
@@ -65,6 +73,7 @@ export { State } from './sessions/state.js';
 export { AgentTool, isAgentTool } from './tools/agent_tool.js';
 export type { AgentToolConfig } from './tools/agent_tool.js';
 export { BaseTool, isBaseTool } from './tools/base_tool.js';
+export type { BaseToolParams, RunAsyncToolRequest, ToolProcessLlmRequest, } from './tools/base_tool.js';
 export { BaseToolset } from './tools/base_toolset.js';
 export type { ToolPredicate } from './tools/base_toolset.js';
 export { FunctionTool, isFunctionTool } from './tools/function_tool.js';
@@ -73,7 +82,8 @@ export { GOOGLE_SEARCH, GoogleSearchTool } from './tools/google_search_tool.js';
 export { LongRunningFunctionTool } from './tools/long_running_tool.js';
 export { ToolConfirmation } from './tools/tool_confirmation.js';
 export { ToolContext } from './tools/tool_context.js';
-export { LogLevel, setLogLevel } from './utils/logger.js';
+export { LogLevel, getLogger, setLogLevel, setLogger } from './utils/logger.js';
+export type { Logger } from './utils/logger.js';
 export { isGemini2OrAbove } from './utils/model_name.js';
 export { zodObjectToSchema } from './utils/simple_zod_to_json.js';
 export { GoogleLLMVariant } from './utils/variant_utils.js';

package/dist/types/events/event.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FunctionCall, FunctionResponse } from '@google/genai';
@@ -86,3 +86,17 @@ export declare function stringifyContent(event: Event): string;
  * Generates a new unique ID for the event.
  */
 export declare function createNewEventId(): string;
+/**
+ * Transforms a snake_cased event object to a camelCased Event object.
+ *
+ * @param event The snake_cased event object.
+ * @returns The camelCased Event object.
+ */
+export declare function transformToCamelCaseEvent(event: Record<string, unknown>): Event;
+/**
+ * Transforms a camelCased event object to a snake_cased Event object.
+ *
+ * @param event The camelCased event object.
+ * @returns The snake_cased Event object.
+ */
+export declare function transformToSnakeCaseEvent(event: Event): Record<string, unknown>;

package/dist/types/events/event_actions.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ToolConfirmation } from '../tools/tool_confirmation.js';

package/dist/types/events/structured_events.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CodeExecutionResult, ExecutableCode, FunctionCall, FunctionResponse } from '@google/genai';
+import { Event } from './event.js';
+/**
+ * The types of events that can be parsed from a raw Event.
+ */
+export declare enum EventType {
+    THOUGHT = "thought",
+    CONTENT = "content",
+    TOOL_CALL = "tool_call",
+    TOOL_RESULT = "tool_result",
+    CALL_CODE = "call_code",
+    CODE_RESULT = "code_result",
+    ERROR = "error",
+    ACTIVITY = "activity",
+    TOOL_CONFIRMATION = "tool_confirmation",
+    FINISHED = "finished"
+}
+/**
+ * Represents a reasoning trace (thought) from the agent.
+ */
+export interface ThoughtEvent {
+    type: EventType.THOUGHT;
+    content: string;
+}
+/**
+ * Represents partial content (text delta) intended for the user.
+ */
+export interface ContentEvent {
+    type: EventType.CONTENT;
+    content: string;
+}
+/**
+ * Represents a request to execute a tool.
+ */
+export interface ToolCallEvent {
+    type: EventType.TOOL_CALL;
+    call: FunctionCall;
+}
+/**
+ * Represents the result of a tool execution.
+ */
+export interface ToolResultEvent {
+    type: EventType.TOOL_RESULT;
+    result: FunctionResponse;
+}
+/**
+ * Represents a request to execute code.
+ */
+export interface CallCodeEvent {
+    type: EventType.CALL_CODE;
+    code: ExecutableCode;
+}
+/**
+ * Represents the result of code execution.
+ */
+export interface CodeResultEvent {
+    type: EventType.CODE_RESULT;
+    result: CodeExecutionResult;
+}
+/**
+ * Represents a runtime error.
+ */
+export interface ErrorEvent {
+    type: EventType.ERROR;
+    error: Error;
+}
+/**
+ * Represents a generic activity or status update.
+ */
+export interface ActivityEvent {
+    type: EventType.ACTIVITY;
+    kind: string;
+    detail: Record<string, unknown>;
+}
+/**
+ * Represents a request for tool confirmation.
+ */
+export interface ToolConfirmationEvent {
+    type: EventType.TOOL_CONFIRMATION;
+    confirmations: Record<string, unknown>;
+}
+/**
+ * Represents the final completion of the agent's task.
+ */
+export interface FinishedEvent {
+    type: EventType.FINISHED;
+    output?: unknown;
+}
+/**
+ * A standard structured event parsed from the raw Event stream.
+ */
+export type StructuredEvent = ThoughtEvent | ContentEvent | ToolCallEvent | ToolResultEvent | CallCodeEvent | CodeResultEvent | ErrorEvent | ActivityEvent | ToolConfirmationEvent | FinishedEvent;
+/**
+ * Converts an internal Event to a list of structured events.
+ * This is an optional utility for callers who want to easily identify
+ * the type of event they are handling.
+ *
+ * @param event - The raw event to convert.
+ * @returns The structured events.
+ */
+export declare function toStructuredEvents(event: Event): StructuredEvent[];

package/dist/types/index.d.ts

@@ -3,10 +3,14 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+export { FileArtifactService } from './artifacts/file_artifact_service.js';
+export { GcsArtifactService } from './artifacts/gcs_artifact_service.js';
+export { getArtifactServiceFromUri } from './artifacts/registry.js';
 export * from './common.js';
+export { DatabaseSessionService } from './sessions/database_session_service.js';
+export { getSessionServiceFromUri } from './sessions/registry.js';
+export * from './telemetry/google_cloud.js';
+export * from './telemetry/setup.js';
 export * from './tools/mcp/mcp_session_manager.js';
 export * from './tools/mcp/mcp_tool.js';
 export * from './tools/mcp/mcp_toolset.js';
-export * from './artifacts/gcs_artifact_service.js';
-export * from './telemetry/setup.js';
-export * from './telemetry/google_cloud.js';

package/dist/types/models/apigee_llm.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpOptions } from '@google/genai';
+import { BaseLlmConnection } from './base_llm_connection.js';
+import { Gemini, GeminiParams } from './google_llm.js';
+import { LlmRequest } from './llm_request.js';
+import { LlmResponse } from './llm_response.js';
+export interface ApigeeLlmParams extends GeminiParams {
+    /**
+     * The name of the model to use. The model string specifies the LLM provider
+     * (e.g., Vertex AI, Gemini), API version, and the model ID. Supported format:
+     *     `apigee/[<provider>/][<version>/]<model_id>`
+     *     Components:
+     *       `provider` (optional): `vertex_ai` or `gemini`.
+     *       `version` (optional): The API version (e.g., `v1`, `v1beta`). If not
+     *         provided, a default version will selected based on the provider.
+     *       `model_id` (required): The model identifier (e.g.,
+     *         `gemini-2.5-flash`).
+     *     Examples:
+     *       - `apigee/gemini-2.5-flash`
+     *       - `apigee/v1/gemini-2.5-flash`
+     *       - `apigee/vertex_ai/gemini-2.5-flash`
+     *       - `apigee/gemini/v1/gemini-2.5-flash`
+     *       - `apigee/vertex_ai/v1beta/gemini-2.5-flash`
+     */
+    model: string;
+    /**
+     * The proxy URL for the provider API. If not provided, it will look for
+     * the APIGEE_PROXY_URL environment variable.
+     */
+    proxyUrl?: string;
+    /**
+     * API key to use. If not provided, it will look for
+     * the GOOGLE_GENAI_API_KEY or GEMINI_API_KEY environment variable. If gemini
+     * provider is selected and no key is provided, the fake key "-" will be
+     * used for the "x-goog-api-key" header.
+     */
+    apiKey?: string;
+}
+export declare class ApigeeLlm extends Gemini {
+    private readonly proxyUrl;
+    /**
+     * A list of model name patterns that are supported by this LLM.
+     *
+     * @returns A list of supported models.
+     */
+    static readonly supportedModels: Array<string | RegExp>;
+    constructor({ model, proxyUrl, apiKey, vertexai, location, project, headers, }: ApigeeLlmParams);
+    protected getHttpOptions(): HttpOptions;
+    protected getLiveHttpOptions(): HttpOptions;
+    private identifyApiVersion;
+    private _apigeeLiveApiVersion?;
+    get liveApiVersion(): string;
+    generateContentAsync(llmRequest: LlmRequest, stream?: boolean): AsyncGenerator<LlmResponse, void>;
+    connect(llmRequest: LlmRequest): Promise<BaseLlmConnection>;
+}

package/dist/types/models/base_llm_connection.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Content, Blob } from '@google/genai';
+import { Blob, Content } from '@google/genai';
 import { LlmResponse } from './llm_response.js';
 /**
  * The base class for a live model connection.