@google/adk 0.3.0 → 0.4.0

package/dist/esm/sessions/registry.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  DatabaseSessionService,
+  isDatabaseConnectionString
+} from "./database_session_service.js";
+import {
+  InMemorySessionService,
+  isInMemoryConnectionString
+} from "./in_memory_session_service.js";
+function getSessionServiceFromUri(uri) {
+  if (isInMemoryConnectionString(uri)) {
+    return new InMemorySessionService();
+  }
+  if (isDatabaseConnectionString(uri)) {
+    return new DatabaseSessionService(uri);
+  }
+  throw new Error(`Unsupported session service URI: ${uri}`);
+}
+export {
+  getSessionServiceFromUri
+};

package/dist/esm/tools/forwarding_artifact_service.js

@@ -35,6 +35,22 @@ class ForwardingArtifactService {
       request
     );
   }
+  listArtifactVersions(request) {
+    if (!this.toolContext.invocationContext.artifactService) {
+      throw new Error("Artifact service is not initialized.");
+    }
+    return this.toolContext.invocationContext.artifactService.listArtifactVersions(
+      request
+    );
+  }
+  getArtifactVersion(request) {
+    if (!this.toolContext.invocationContext.artifactService) {
+      throw new Error("Artifact service is not initialized.");
+    }
+    return this.toolContext.invocationContext.artifactService.getArtifactVersion(
+      request
+    );
+  }
 }
 export {
   ForwardingArtifactService

package/dist/esm/utils/env_aware_utils.js

@@ -40,9 +40,17 @@ function isBase64Encoded(data) {
     return false;
   }
 }
+function getBooleanEnvVar(envVar) {
+  if (!process.env) {
+    return false;
+  }
+  const envVarValue = (process.env[envVar] || "").toLowerCase();
+  return ["true", "1"].includes(envVarValue);
+}
 export {
   base64Decode,
   base64Encode,
+  getBooleanEnvVar,
   isBase64Encoded,
   isBrowser,
   randomUUID

package/dist/esm/utils/object_notation_utils.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function toCamelCase(obj, preserveKeys = []) {
+  return toNotation(obj, toCamelCaseKey, "", preserveKeys);
+}
+function toSnakeCase(obj, preserveKeys = []) {
+  return toNotation(obj, toSnakeCaseKey, "", preserveKeys);
+}
+const toCamelCaseKey = (key) => key.replace(
+  /_([a-z])/g,
+  (_match, letter) => letter.toUpperCase()
+);
+const toSnakeCaseKey = (key) => key.replace(/[A-Z]/g, (g) => "_" + g.toLowerCase());
+function toNotation(obj, converter, parentKey = "", preserveKeys = []) {
+  if (Array.isArray(obj)) {
+    return obj.map(
+      (item) => toNotation(item, converter, parentKey, preserveKeys)
+    );
+  }
+  if (typeof obj === "object" && obj !== null) {
+    const source = obj;
+    const result = {};
+    for (const key of Object.keys(source)) {
+      const convertedKey = converter(key);
+      const fullPath = parentKey !== "" ? parentKey + "." + key : key;
+      if (preserveKeys.includes(fullPath)) {
+        result[convertedKey] = source[key];
+      } else {
+        result[convertedKey] = toNotation(
+          source[key],
+          converter,
+          fullPath,
+          preserveKeys
+        );
+      }
+    }
+    return result;
+  }
+  return obj;
+}
+export {
+  toCamelCase,
+  toSnakeCase
+};

package/dist/esm/utils/variant_utils.js

@@ -3,6 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { getBooleanEnvVar } from "./env_aware_utils.js";
 var GoogleLLMVariant = /* @__PURE__ */ ((GoogleLLMVariant2) => {
   GoogleLLMVariant2["VERTEX_AI"] = "VERTEX_AI";
   GoogleLLMVariant2["GEMINI_API"] = "GEMINI_API";
@@ -11,13 +12,6 @@ var GoogleLLMVariant = /* @__PURE__ */ ((GoogleLLMVariant2) => {
 function getGoogleLlmVariant() {
   return getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI") ? "VERTEX_AI" /* VERTEX_AI */ : "GEMINI_API" /* GEMINI_API */;
 }
-function getBooleanEnvVar(envVar) {
-  if (!process.env) {
-    return false;
-  }
-  const envVarValue = (process.env[envVar] || "").toLowerCase();
-  return ["true", "1"].includes(envVarValue);
-}
 export {
   GoogleLLMVariant,
   getGoogleLlmVariant

package/dist/esm/version.js

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "0.3.0";
+const version = "0.4.0";
 export {
   version
 };

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/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.
      *
@@ -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/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[]>;
+    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/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';

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,8 +3,12 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-export * from './artifacts/gcs_artifact_service.js';
+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';