@softactivate/adk 1.1.0

package/dist/types/common.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { ActiveStreamingTool } from './agents/active_streaming_tool.js';
+export type { ActiveStreamingToolParams } from './agents/active_streaming_tool.js';
+export { BaseAgent, isBaseAgent } from './agents/base_agent.js';
+export type { AfterAgentCallback, BaseAgentConfig, BeforeAgentCallback, SingleAgentCallback, } from './agents/base_agent.js';
+export { Context } from './agents/context.js';
+export { functionsExportedForTestingOnly } from './agents/functions.js';
+export { InvocationContext } from './agents/invocation_context.js';
+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 as Agent, LlmAgent, isLlmAgent } 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';
+export { AgentTransferLlmRequestProcessor } from './agents/processors/agent_transfer_llm_request_processor.js';
+export { BaseLlmRequestProcessor, BaseLlmResponseProcessor, } from './agents/processors/base_llm_processor.js';
+export { CONTENT_REQUEST_PROCESSOR, ContentRequestProcessor, } from './agents/processors/content_request_processor.js';
+export { ContextCompactorRequestProcessor } from './agents/processors/context_compactor_request_processor.js';
+export { ReadonlyContext } from './agents/readonly_context.js';
+export { RoutedAgent, isRoutedAgent } from './agents/routed_agent.js';
+export type { AgentRouter, RoutedAgentConfig } from './agents/routed_agent.js';
+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';
+export { AuthHandler } from './auth/auth_handler.js';
+export { AuthProviderRegistry } from './auth/auth_provider_registry.js';
+export { OAuthGrantType } from './auth/auth_schemes.js';
+export type { AuthScheme, OpenIdConnectWithConfig } from './auth/auth_schemes.js';
+export type { AuthConfig } from './auth/auth_tool.js';
+export type { BaseAuthProvider } from './auth/base_auth_provider.js';
+export type { BaseCredentialService } from './auth/credential_service/base_credential_service.js';
+export { InMemoryCredentialService } from './auth/credential_service/in_memory_credential_service.js';
+export { SessionStateCredentialService } from './auth/credential_service/session_state_credential_service.js';
+export { CredentialExchangeError } from './auth/exchanger/base_credential_exchanger.js';
+export type { BaseCredentialExchanger, ExchangeResult, } from './auth/exchanger/base_credential_exchanger.js';
+export { OAuth2CredentialExchanger } from './auth/oauth2/oauth2_credential_exchanger.js';
+export { OAuth2DiscoveryManager } from './auth/oauth2/oauth2_discovery.js';
+export type { BaseCredentialRefresher } from './auth/refresher/base_credential_refresher.js';
+export { CredentialRefresherRegistry } from './auth/refresher/credential_refresher_registry.js';
+export { BaseCodeExecutor } from './code_executors/base_code_executor.js';
+export type { ExecuteCodeParams } from './code_executors/base_code_executor.js';
+export { BuiltInCodeExecutor } from './code_executors/built_in_code_executor.js';
+export { CodeExecutionLanguage, FileContentEncoding, type CodeExecutionInput, type CodeExecutionResult, type File, } from './code_executors/code_execution_utils.js';
+export type { BaseContextCompactor } from './context/base_context_compactor.js';
+export type { BaseSummarizer } from './context/summarizers/base_summarizer.js';
+export { LlmSummarizer } from './context/summarizers/llm_summarizer.js';
+export type { LlmSummarizerOptions } from './context/summarizers/llm_summarizer.js';
+export { TokenBasedContextCompactor } from './context/token_based_context_compactor.js';
+export type { TokenBasedContextCompactorOptions } from './context/token_based_context_compactor.js';
+export { TruncatingContextCompactor } from './context/truncating_context_compactor.js';
+export type { TruncatingContextCompactorOptions } from './context/truncating_context_compactor.js';
+export { isCompactedEvent } from './events/compacted_event.js';
+export type { CompactedEvent } from './events/compacted_event.js';
+export { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent, } from './events/event.js';
+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, 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';
+export { LLMRegistry } from './models/registry.js';
+export type { BaseLlmType } from './models/registry.js';
+export { RoutedLlm } from './models/routed_llm.js';
+export type { LlmRouter } from './models/routed_llm.js';
+export { BasePlugin, ContextCompactionTrigger } from './plugins/base_plugin.js';
+export { LoggingPlugin } from './plugins/logging_plugin.js';
+export { PluginManager } from './plugins/plugin_manager.js';
+export { InMemoryPolicyEngine, PolicyOutcome, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, SecurityPlugin, getAskUserConfirmationFunctionCalls, } from './plugins/security_plugin.js';
+export type { BasePolicyEngine, PolicyCheckResult, ToolCallPolicyContext, } from './plugins/security_plugin.js';
+export { InMemoryRunner } from './runner/in_memory_runner.js';
+export { Runner, isRunner } 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';
+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, isBaseToolset } from './tools/base_toolset.js';
+export type { ToolPredicate } from './tools/base_toolset.js';
+export { EXIT_LOOP, ExitLoopTool } from './tools/exit_loop_tool.js';
+export { FunctionTool, isFunctionTool } from './tools/function_tool.js';
+export type { ToolExecuteArgument, ToolExecuteFunction, ToolInputParameters, ToolOptions, } from './tools/function_tool.js';
+export { GOOGLE_MAPS_GROUNDING, GoogleMapsGroundingTool, } from './tools/google_maps_grounding_tool.js';
+export { GOOGLE_SEARCH, GoogleSearchTool } from './tools/google_search_tool.js';
+export { LOAD_ARTIFACTS, LoadArtifactsTool, } from './tools/load_artifacts_tool.js';
+export { LOAD_MEMORY, LoadMemoryTool } from './tools/load_memory_tool.js';
+export { LongRunningFunctionTool } from './tools/long_running_tool.js';
+export { PRELOAD_MEMORY, PreloadMemoryTool, } from './tools/preload_memory_tool.js';
+export { ToolConfirmation } from './tools/tool_confirmation.js';
+export { URL_CONTEXT, UrlContextTool } from './tools/url_context_tool.js';
+export { VertexAiSearchTool } from './tools/vertex_ai_search_tool.js';
+export type { DataStoreParams, SearchEngineParams, VertexAISearchConfig, VertexAISearchDataStoreSpec, VertexAiSearchToolParams, } from './tools/vertex_ai_search_tool.js';
+export { VertexRagRetrievalTool } from './tools/vertex_rag_retrieval_tool.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';
+export { version } from './version.js';
+export type { Frontmatter, Resources, Script, Skill } from './skills/skill.js';
+export { ListSkillsTool } from './tools/skill/list_skills_tool.js';
+export { LoadSkillResourceTool } from './tools/skill/load_skill_resource_tool.js';
+export { LoadSkillTool } from './tools/skill/load_skill_tool.js';
+export { SkillToolset } from './tools/skill/skill_toolset.js';
+export * from './artifacts/base_artifact_service.js';
+export * from './features/feature_registry.js';
+export * from './memory/base_memory_service.js';
+export * from './sessions/base_session_service.js';
+export * from './tools/base_tool.js';

package/dist/types/context/base_context_compactor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+/**
+ * Interface for compacting the context history in an agent session.
+ */
+export interface BaseContextCompactor {
+    /**
+     * Determines whether the context should be compacted.
+     *
+     * @param invocationContext The current invocation context.
+     * @returns A boolean or a promise resolving to a boolean indicating if compaction should occur.
+     */
+    shouldCompact(invocationContext: InvocationContext): boolean | Promise<boolean>;
+    /**
+     * Compacts the context in place.
+     *
+     * @param invocationContext The current invocation context.
+     */
+    compact(invocationContext: InvocationContext): void | Promise<void>;
+}

package/dist/types/context/summarizers/base_summarizer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Event } from '../../events/event.js';
+import { CompactedEvent } from '../../events/compacted_event.js';
+/**
+ * Interface for summarizing a list of events into a single CompactedEvent.
+ */
+export interface BaseSummarizer {
+    /**
+     * Summarizes the given events into a CompactedEvent.
+     *
+     * @param events The events to summarize.
+     * @returns A promise resolving to the CompactedEvent representation of the events.
+     */
+    summarize(events: Event[]): Promise<CompactedEvent>;
+}

package/dist/types/context/summarizers/llm_summarizer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CompactedEvent } from '../../events/compacted_event.js';
+import { Event } from '../../events/event.js';
+import { BaseLlm } from '../../models/base_llm.js';
+import { BaseSummarizer } from './base_summarizer.js';
+export interface LlmSummarizerOptions {
+    llm: BaseLlm;
+    prompt?: string;
+}
+/**
+ * A summarizer that uses an LLM to generate a compacted representation
+ * of existing events.
+ */
+export declare class LlmSummarizer implements BaseSummarizer {
+    private readonly llm;
+    private readonly prompt;
+    constructor(options: LlmSummarizerOptions);
+    summarize(events: Event[]): Promise<CompactedEvent>;
+}

package/dist/types/context/token_based_context_compactor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+import { BaseContextCompactor } from './base_context_compactor.js';
+import { BaseSummarizer } from './summarizers/base_summarizer.js';
+export interface TokenBasedContextCompactorOptions {
+    /** The maximum number of tokens to retain in the session history before compaction. */
+    tokenThreshold: number;
+    /**
+     * The minimum number of raw events to keep at the end of the session.
+     * Compaction will not affect these tail events (unless needed for tool splits).
+     */
+    eventRetentionSize: number;
+    /** The summarizer used to create the compacted event content. */
+    summarizer: BaseSummarizer;
+}
+/**
+ * A context compactor that uses token count to determine when to compact events.
+ * Oldest events are summarized into a CompactedEvent when the session
+ * history exceeds the token threshold.
+ */
+export declare class TokenBasedContextCompactor implements BaseContextCompactor {
+    private readonly tokenThreshold;
+    private readonly eventRetentionSize;
+    private readonly summarizer;
+    constructor(options: TokenBasedContextCompactorOptions);
+    private getActiveEvents;
+    shouldCompact(invocationContext: InvocationContext): boolean | Promise<boolean>;
+    compact(invocationContext: InvocationContext): Promise<void>;
+}

package/dist/types/context/truncating_context_compactor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+import { BaseContextCompactor } from './base_context_compactor.js';
+export interface TruncatingContextCompactorOptions {
+    /** The maximum number of events to retain in the session history. */
+    threshold: number;
+    /** Keep the first X events in the history, which often act as the initial grounding prompt. */
+    preserveLeadingEvents?: number;
+}
+/**
+ * A simple context compactor that truncates the oldest events to get under
+ * the given threshold limit.
+ */
+export declare class TruncatingContextCompactor implements BaseContextCompactor {
+    private readonly threshold;
+    private readonly preserveLeadingEvents;
+    constructor(options: TruncatingContextCompactorOptions);
+    shouldCompact(invocationContext: InvocationContext): boolean;
+    compact(invocationContext: InvocationContext): void;
+}

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Event } from './event.js';
+/**
+ * A specialized Event type that represents a synthesized summary of past events.
+ * This is used to compress session history without losing critical context.
+ */
+export interface CompactedEvent extends Event {
+    /**
+     * Identifies this event as a compacted event.
+     */
+    readonly isCompacted: true;
+    /**
+     * The start time of the context that was compacted.
+     */
+    startTime: number;
+    /**
+     * The end time of the context that was compacted.
+     */
+    endTime: number;
+    /**
+     * The summarized content of the compacted events.
+     */
+    compactedContent: string;
+}
+/**
+ * Type guard to check if an event is a CompactedEvent.
+ */
+export declare function isCompactedEvent(event: Event): event is CompactedEvent;
+export declare function createCompactedEvent(params?: Partial<CompactedEvent>): CompactedEvent;

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

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FunctionCall, FunctionResponse } from '@google/genai';
+import { LlmResponse } from '../models/llm_response.js';
+import { EventActions } from './event_actions.js';
+/**
+ * Represents an event in a conversation between agents and users.
+
+  It is used to store the content of the conversation, as well as the actions
+  taken by the agents like function calls, etc.
+ */
+export interface Event extends LlmResponse {
+    /**
+     * The unique identifier of the event.
+     * Do not assign the ID. It will be assigned by the session.
+     */
+    id: string;
+    /**
+     * The invocation ID of the event. Should be non-empty before appending to a
+     * session.
+     */
+    invocationId: string;
+    /**
+     * "user" or the name of the agent, indicating who appended the event to the
+     * session.
+     */
+    author?: string;
+    /**
+     * The actions taken by the agent.
+     */
+    actions: EventActions;
+    /**
+     * Set of ids of the long running function calls. Agent client will know from
+     * this field about which function call is long running. Only valid for
+     * function call event
+     */
+    longRunningToolIds?: string[];
+    /**
+     * The branch of the event.
+     * The format is like agent_1.agent_2.agent_3, where agent_1 is the parent of
+     * agent_2, and agent_2 is the parent of agent_3.
+     *
+     * Branch is used when multiple sub-agent shouldn't see their peer agents'
+     * conversation history.
+     */
+    branch?: string;
+    /**
+     * The timestamp of the event.
+     */
+    timestamp: number;
+}
+/**
+ * Creates an event from a partial event.
+ *
+ * @param params The partial event to create the event from.
+ * @returns The event.
+ */
+export declare function createEvent(params?: Partial<Event>): Event;
+/**
+ * Returns whether the event is the final response of the agent.
+ */
+export declare function isFinalResponse(event: Event): boolean;
+/**
+ * Returns the function calls in the event.
+ */
+export declare function getFunctionCalls(event: Event): FunctionCall[];
+/**
+ * Returns the function responses in the event.
+ */
+export declare function getFunctionResponses(event: Event): FunctionResponse[];
+/**
+ * Returns whether the event has a trailing code execution result.
+ */
+export declare function hasTrailingCodeExecutionResult(event: Event): boolean;
+/**
+ * Extracts and concatenates all text from the parts of a `Event` object.
+ * @param event The `Event` object to process.
+ *
+ * @returns A single string with the combined text.
+ */
+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

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ToolConfirmation } from '../tools/tool_confirmation.js';
+type AuthConfig = any;
+/**
+ * Represents the actions attached to an event.
+ */
+export interface EventActions {
+    /**
+     * If true, it won't call model to summarize function response.
+     * Only used for function_response event.
+     */
+    skipSummarization?: boolean;
+    /**
+     * Indicates that the event is updating the state with the given delta.
+     */
+    stateDelta: {
+        [key: string]: unknown;
+    };
+    /**
+     * Indicates that the event is updating an artifact. key is the filename,
+     * value is the version.
+     */
+    artifactDelta: {
+        [key: string]: number;
+    };
+    /**
+     * If set, the event transfers to the specified agent.
+     */
+    transferToAgent?: string;
+    /**
+     * The agent is escalating to a higher level agent.
+     */
+    escalate?: boolean;
+    /**
+     * Authentication configurations requested by tool responses.
+     *
+     * This field will only be set by a tool response event indicating tool
+     * request auth credential.
+     * - Keys: The function call id. Since one function response event could
+     * contain multiple function responses that correspond to multiple function
+     * calls. Each function call could request different auth configs. This id is
+     * used to identify the function call.
+     * - Values: The requested auth config.
+     */
+    requestedAuthConfigs: {
+        [key: string]: AuthConfig;
+    };
+    /**
+     * A dict of tool confirmation requested by this event, keyed by the function
+     * call id.
+     */
+    requestedToolConfirmations: {
+        [key: string]: ToolConfirmation;
+    };
+}
+/**
+ * Creates an EventActions object.
+ */
+export declare function createEventActions(state?: Partial<EventActions>): EventActions;
+/**
+ * Merges a list of EventActions objects into a single EventActions object.
+ *
+ * 1. It merges dictionaries (stateDelta, artifactDelta, requestedAuthConfigs)
+ * by adding all the properties from each source.
+ *
+ * 2. For other properties (skipSummarization,transferToAgent, escalate), the
+ * last one wins.
+ */
+export declare function mergeEventActions(sources: Array<Partial<EventActions>>, target?: EventActions): EventActions;
+export {};

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/examples/base_example_provider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Example } from './example.js';
+/**
+ * A unique symbol to identify ADK agent classes.
+ * Defined once and shared by all BaseExampleProvider instances.
+ */
+declare const BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of BaseExampleProvider.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of BaseExampleProvider, false otherwise.
+ */
+export declare function isBaseExampleProvider(obj: unknown): obj is BaseExampleProvider;
+/**
+ * Base class for example providers.
+ *
+ *  This class defines the interface for providing examples for a given query.
+ */
+export declare abstract class BaseExampleProvider {
+    /**
+     * A unique symbol to identify ADK example provider classes.
+     */
+    readonly [BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL] = true;
+    /**
+     * Returns a list of examples for a given query.
+     *
+     * @param query The query to get examples for.
+     * @return A list of Example objects.
+     */
+    abstract getExamples(query: string): Example[];
+}
+export {};

package/dist/types/examples/example.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Content } from '@google/genai';
+/**
+ * A few-shot example.
+ */
+export interface Example {
+    /**
+     * The input content for the example.
+     */
+    input: Content;
+    /**
+     * The expected output content for the example.
+     */
+    output: Content[];
+}

package/dist/types/examples/example_util.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseExampleProvider } from './base_example_provider.js';
+import { Example } from './example.js';
+/**
+ * Converts a list of examples to a string that can be used in a system
+ * instruction.
+ */
+export declare function convertExamplesToText(examples: Example[], model?: string): string;
+export declare function buildExampleSi(examples: Example[] | BaseExampleProvider, query: string, model?: string): string;