@google/adk 1.2.0 → 1.4.0

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

@@ -39,20 +39,33 @@ export interface GeminiParams {
      * Headers to merge with internally crafted headers.
      */
     headers?: Record<string, string>;
+    /**
+     * Whether to use the Interactions API for stateful conversations.
+     */
+    useInteractionsApi?: boolean;
 }
+declare const GEMINI_MODEL_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of Gemini.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of Gemini, false otherwise.
+ */
+export declare function isGemini(obj: unknown): obj is Gemini;
 /**
  * Integration for Gemini models.
  */
 export declare class Gemini extends BaseLlm {
+    readonly [GEMINI_MODEL_SYMBOL] = true;
     private readonly apiKey?;
     protected readonly vertexai: boolean;
     private readonly project?;
     private readonly location?;
     private readonly headers?;
+    readonly useInteractionsApi: boolean;
     /**
      * @param params The parameters for creating a Gemini instance.
      */
-    constructor({ model, apiKey, vertexai, project, location, headers, }: GeminiParams);
+    constructor({ model, apiKey, vertexai, project, location, headers, useInteractionsApi, }: GeminiParams);
     /**
      * A list of model name patterns that are supported by this LLM.
      *
@@ -88,3 +101,4 @@ export declare class Gemini extends BaseLlm {
     private preprocessRequest;
 }
 export declare function geminiInitParams({ model, vertexai, project, location, apiKey, }: GeminiParams): GeminiParams;
+export {};

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

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Content, GenerateContentConfig, GoogleGenAI, Interactions, Part } from '@google/genai';
+import { LlmRequest } from './llm_request.js';
+import { LlmResponse } from './llm_response.js';
+export interface ExtendedInteraction extends Interactions.Interaction {
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ExtendedInteractionStatusUpdate extends Omit<Interactions.InteractionStatusUpdate, 'error'> {
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ExtendedFunctionCallStep extends Interactions.FunctionCallStep {
+    signature?: string;
+}
+export interface ExtendedInteractionSSEEvent extends Omit<Interactions.InteractionSSEEvent, 'error' | 'interaction_id' | 'status' | 'event_type'> {
+    event_type?: string;
+    eventType?: string;
+    delta?: {
+        type: string;
+        text?: string;
+        name?: string;
+        id?: string;
+        arguments?: Record<string, unknown>;
+        thought_signature?: string;
+        signature?: string;
+        data?: string;
+        uri?: string;
+        mime_type: string;
+    };
+    status?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+    code?: string;
+    message?: string;
+    interaction_id?: string;
+    interactionId?: string;
+    interaction?: {
+        id: string;
+    };
+    id?: string;
+}
+/**
+ * Extracts the latest turn contents for interactions API.
+ */
+export declare function getLatestUserContents(contents: Content[]): Content[];
+/**
+ * Convert a Content to a list of Steps.
+ */
+export declare function convertContentToSteps(content: Content): Interactions.Step[];
+/**
+ * Convert a Step to a list of Parts.
+ */
+export declare function convertStepToParts(step: Interactions.Step): Part[];
+/**
+ * Convert tools config to interactions format.
+ */
+export declare function convertToolsConfigToInteractionsFormat(config: GenerateContentConfig): Interactions.Tool[];
+/**
+ * Extract the latest model generated parts from a list of steps.
+ */
+export declare function getLatestModelParts(steps: Interactions.Step[]): Part[];
+/**
+ * Convert Interaction response to an LlmResponse.
+ */
+export declare function convertInteractionToLlmResponse(interaction: ExtendedInteraction): LlmResponse;
+/**
+ * Convert InteractionSSEEvent to LlmResponse.
+ */
+export declare function convertInteractionEventToLlmResponse(event: ExtendedInteractionSSEEvent, aggregatedParts: Part[], interactionId?: string): LlmResponse | null;
+/**
+ * Build generation config.
+ */
+export declare function buildGenerationConfig(config: GenerateContentConfig): Record<string, unknown>;
+/**
+ * Extract system instruction.
+ */
+export declare function extractSystemInstruction(config: GenerateContentConfig): string | undefined;
+/**
+ * Generate content using the interactions API.
+ */
+export declare function generateContentViaInteractions(apiClient: GoogleGenAI, llmRequest: LlmRequest, stream: boolean): AsyncGenerator<LlmResponse, void, void>;

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

@@ -34,6 +34,10 @@ export interface LlmRequest {
      * The set of allowed tools, populated by request processors.
      */
     allowedTools?: string[];
+    /**
+     * The interaction ID from the previous turn, if any.
+     */
+    previousInteractionId?: string;
 }
 /**
  * Appends instructions to the system instruction.

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

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { CitationMetadata, Content, FinishReason, GenerateContentResponse, GenerateContentResponseUsageMetadata, GroundingMetadata, LiveServerSessionResumptionUpdate, Transcription } from '@google/genai';
+import { CitationMetadata, Content, FinishReason, GenerateContentResponse, GenerateContentResponseUsageMetadata, GroundingMetadata, LiveServerGoAway, LiveServerSessionResumptionUpdate, Transcription } from '@google/genai';
 /**
  * LLM response class that provides the first candidate response from the
  * model if available. Otherwise, returns error code and message.
@@ -64,6 +64,11 @@ export interface LlmResponse {
      * The session resumption update of the LlmResponse
      */
     liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate;
+    /**
+     * Server-side signal that the live connection will be closed soon. The
+     * caller should reconnect using the latest session resumption handle.
+     */
+    goAway?: LiveServerGoAway;
     /**
      * Audio transcription of user input.
      */
@@ -72,6 +77,14 @@ export interface LlmResponse {
      * Audio transcription of model output.
      */
     outputTranscription?: Transcription;
+    /**
+     * The interaction ID returned by the model, if any.
+     */
+    interactionId?: string;
+    /** The model version used to generate the response. */
+    modelVersion?: string;
+    /** The session ID of the Live session. */
+    liveSessionId?: string;
 }
 /**
  * Creates an LlmResponse from a GenerateContentResponse.

package/dist/types/plugins/base_plugin.d.ts

@@ -16,7 +16,8 @@ import { BaseTool } from '../tools/base_tool.js';
  */
 export declare enum ContextCompactionTrigger {
     Manual = "Manual",
-    Auto = "Auto"
+    Auto = "Auto",
+    AgentControlled = "AgentControlled"
 }
 /**
  * Base class for creating plugins.

package/dist/types/plugins/security_plugin.d.ts

@@ -17,18 +17,37 @@ export declare enum PolicyOutcome {
     CONFIRM = "CONFIRM",
     ALLOW = "ALLOW"
 }
+/** The result returned by a policy engine after evaluating a tool call. */
 export interface PolicyCheckResult {
+    /** The policy decision: `ALLOW`, `DENY`, or `CONFIRM`. */
     outcome: string;
+    /** Optional human-readable explanation of the decision. */
     reason?: string;
 }
+/** Context passed to a policy engine when evaluating a tool call. */
 export interface ToolCallPolicyContext {
+    /** The tool being invoked. */
     tool: BaseTool;
+    /** The arguments supplied to the tool call. */
     toolArgs: Record<string, unknown>;
 }
+/** Interface for policy engines that gate tool call execution. */
 export interface BasePolicyEngine {
+    /**
+     * Evaluates whether a tool call should be allowed, denied, or confirmed.
+     *
+     * @param context - The tool and its arguments to evaluate.
+     * @returns A promise resolving to the policy decision.
+     */
     evaluate(context: ToolCallPolicyContext): Promise<PolicyCheckResult>;
 }
+/** In-memory policy engine that permits all tool calls. Intended for prototyping. */
 export declare class InMemoryPolicyEngine implements BasePolicyEngine {
+    /**
+     * Always returns {@link PolicyOutcome.ALLOW} for every tool call.
+     *
+     * @returns A promise resolving to an ALLOW result.
+     */
     evaluate(): Promise<PolicyCheckResult>;
 }
 /**
@@ -36,9 +55,20 @@ export declare class InMemoryPolicyEngine implements BasePolicyEngine {
  */
 export declare class SecurityPlugin extends BasePlugin {
     private readonly policyEngine;
+    /**
+     * @param params - Optional configuration. Defaults to {@link InMemoryPolicyEngine}
+     *   when no policy engine is provided.
+     */
     constructor(params?: {
         policyEngine?: BasePolicyEngine;
     });
+    /**
+     * Intercepts tool calls, evaluating them against the policy engine before
+     * execution and handling confirmation flows for calls that require it.
+     *
+     * @returns A partial or error response object if the call is blocked or
+     *   awaiting confirmation, or `undefined` to allow execution to proceed.
+     */
     beforeToolCallback({ tool, toolArgs, toolContext, }: {
         tool: BaseTool;
         toolArgs: {

package/dist/types/runner/in_memory_runner.d.ts

@@ -4,6 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { BaseAgent } from '../agents/base_agent.js';
+import { App } from '../apps/app.js';
+import { ResumabilityConfig } from '../apps/resumability_config.js';
 import { BasePlugin } from '../plugins/base_plugin.js';
 import { Runner } from './runner.js';
 /**
@@ -30,13 +32,17 @@ export declare class InMemoryRunner extends Runner {
      * Creates a new InMemoryRunner instance.
      *
      * @param params The configuration for the runner.
+     * @param params.app An optional application instance to run.
      * @param params.agent The root agent to run.
      * @param params.appName The application name. Defaults to `'InMemoryRunner'`.
      * @param params.plugins An optional list of plugins.
+     * @param params.resumabilityConfig An optional resumability configuration.
      */
     constructor(params: {
-        agent: BaseAgent;
+        app?: App;
+        agent?: BaseAgent;
         appName?: string;
         plugins?: BasePlugin[];
+        resumabilityConfig?: ResumabilityConfig;
     });
 }

package/dist/types/runner/runner.d.ts

@@ -6,6 +6,8 @@
 import { Content } from '@google/genai';
 import { BaseAgent } from '../agents/base_agent.js';
 import { RunConfig } from '../agents/run_config.js';
+import { App } from '../apps/app.js';
+import { ResumabilityConfig } from '../apps/resumability_config.js';
 import { BaseArtifactService } from '../artifacts/base_artifact_service.js';
 import { BaseCredentialService } from '../auth/credential_service/base_credential_service.js';
 import { Event } from '../events/event.js';
@@ -13,18 +15,23 @@ import { BaseMemoryService } from '../memory/base_memory_service.js';
 import { BasePlugin } from '../plugins/base_plugin.js';
 import { PluginManager } from '../plugins/plugin_manager.js';
 import { BaseSessionService } from '../sessions/base_session_service.js';
+import { Session } from '../sessions/session.js';
 /**
  * The configuration parameters for the Runner.
  */
 export interface RunnerConfig {
     /**
-     * The application name.
+     * The application object. If provided, `appName`, `agent`, and `plugins` will default from this app.
      */
-    appName: string;
+    app?: App;
     /**
-     * The agent to run.
+     * The application name. Required if `app` is not provided.
      */
-    agent: BaseAgent;
+    appName?: string;
+    /**
+     * The agent to run. Required if `app` is not provided.
+     */
+    agent?: BaseAgent;
     /**
      * An optional list of plugins to apply globally across all agents.
      */
@@ -45,6 +52,10 @@ export interface RunnerConfig {
      * An optional service for managing authentication credentials.
      */
     credentialService?: BaseCredentialService;
+    /**
+     * An optional resumability configuration applied to the runner.
+     */
+    resumabilityConfig?: ResumabilityConfig;
 }
 /**
  * A unique symbol to identify ADK agent classes.
@@ -91,6 +102,7 @@ export declare class Runner {
     readonly sessionService: BaseSessionService;
     readonly memoryService?: BaseMemoryService;
     readonly credentialService?: BaseCredentialService;
+    readonly resumabilityConfig?: ResumabilityConfig;
     /**
      * Creates a new Runner instance.
      *
@@ -147,18 +159,40 @@ export declare class Runner {
      * Determines the next agent to run to continue the session. This is primarily
      * used for session resumption.
      */
+    /**
+     * Determines the next agent to run to continue the session. This is primarily
+     * used for session resumption across tool and LRO boundaries.
+     */
     private determineAgentForResumption;
     /**
      * Whether the agent to run can transfer to any other agent in the agent tree.
      *
-     * An agent is transferable if:
-     *  - It is an instance of `LlmAgent`.
-     *  - All its ancestors are also transferable (i.e., they have
-     *    `disallowTransferToParent` set to false).
-     *
      * @param agentToRun The agent to check for transferability.
      * @returns True if the agent can transfer, False otherwise.
      */
     private isRoutableLlmAgent;
 }
+/**
+ * Determines the next agent to run to continue the session. This is primarily
+ * used for session resumption across tool and LRO boundaries.
+ */
+export declare function determineAgentForResumption(session: Session, rootAgent: BaseAgent, resumabilityConfig?: ResumabilityConfig): BaseAgent;
+/**
+ * Whether the agent to run can transfer to any other agent in the agent tree.
+ *
+ * An agent is transferable if:
+ *  - It is an instance of `LlmAgent`.
+ *  - All its ancestors are also transferable (i.e., they have
+ *    `disallowTransferToParent` set to false).
+ *
+ * @param agentToRun The agent to check for transferability.
+ * @returns True if the agent can transfer, False otherwise.
+ */
+export declare function isRoutableLlmAgent(agentToRun: BaseAgent): boolean;
+/**
+ * It iterates through the events in reverse order, and returns the event
+ * containing a function call with a functionCall.id matching the
+ * functionResponse.id from the last event in the session.
+ */
+export declare function findEventByLastFunctionResponseId(events: Event[]): Event | null;
 export {};

package/dist/types/sessions/base_session_service.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Event } from '../events/event.js';
-import { Session } from './session.js';
+import { CompositeSessionKey, Session } from './session.js';
 /**
  * The configuration of getting a session.
  */
@@ -30,13 +30,7 @@ export interface CreateSessionRequest {
 /**
  * The parameters for `getSession`.
  */
-export interface GetSessionRequest {
-    /** The name of the application. */
-    appName: string;
-    /** The ID of the user. */
-    userId: string;
-    /** The ID of the session. */
-    sessionId: string;
+export interface GetSessionRequest extends CompositeSessionKey {
     /** The configurations for getting the session. */
     config?: GetSessionConfig;
 }
@@ -60,14 +54,7 @@ export interface ListSessionsRequest {
 /**
  * The parameters for `deleteSession`.
  */
-export interface DeleteSessionRequest {
-    /** The name of the application. */
-    appName: string;
-    /** The ID of the user. */
-    userId: string;
-    /** The ID of the session. */
-    sessionId: string;
-}
+export type DeleteSessionRequest = CompositeSessionKey;
 /**
  * The parameters for `appendEvent`.
  */
@@ -156,6 +143,10 @@ export declare abstract class BaseSessionService {
  * Removes temporary state delta keys from the event.
  */
 export declare function trimTempDeltaState(event: Event): Event;
+/**
+ * Removes temporary state keys from the state.
+ */
+export declare function trimTempState(state: Record<string, unknown>): Record<string, unknown>;
 /**
  * Merges app state, user state, and session state.
  *

package/dist/types/sessions/db/schema.d.ts

@@ -7,6 +7,7 @@ import { PrimaryKey } from '@mikro-orm/core';
 import { Event } from '../../events/event.js';
 export declare const SCHEMA_VERSION_KEY = "schema_version";
 export declare const SCHEMA_VERSION_1_JSON = "1";
+export declare const STORAGE_KEY_COLUMN_LENGTH = 191;
 export declare class StorageMetadata {
     key: string;
     value: string;

package/dist/types/sessions/session.d.ts

@@ -4,6 +4,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Event } from '../events/event.js';
+/**
+ * Represents a unified composite session key grouping application, user, and session identifiers.
+ */
+export interface CompositeSessionKey {
+    /** The name of the application. */
+    appName: string;
+    /** The ID of the user. */
+    userId: string;
+    /** The ID of the session. */
+    sessionId: string;
+}
 /**
  * Represents a session in a conversation between agents and users.
  */

package/dist/types/sessions/vertex_ai_session_service.d.ts

@@ -11,6 +11,14 @@ import { Session } from './session.js';
  * Checks if the given URI is a Vertex AI session service URI.
  */
 export declare function isVertexAiConnectionString(uri?: string): boolean;
+/**
+ * Quotes a value for safe use as a Google AIP-160 filter string literal.
+ *
+ * Backslashes are escaped first, then double quotes, so that caller-controlled
+ * input stays inside the quoted value and cannot break out to inject additional
+ * filter predicates. See https://google.aip.dev/160.
+ */
+export declare function quoteFilterLiteral(value: string): string;
 export interface VertexAiSessionServiceOptions {
     projectId?: string;
     location?: string;
@@ -32,6 +40,6 @@ export declare class VertexAiSessionService extends BaseSessionService {
     createSession({ appName, userId, state, sessionId, }: CreateSessionRequest): Promise<Session>;
     getSession({ appName, userId, sessionId, config, }: GetSessionRequest): Promise<Session | undefined>;
     listSessions({ appName, userId, limit, offset, page, order, }: ListSessionsRequest): Promise<ListSessionsResponse>;
-    deleteSession({ appName, userId: _userId, sessionId, }: DeleteSessionRequest): Promise<void>;
+    deleteSession({ appName, userId, sessionId, }: DeleteSessionRequest): Promise<void>;
     appendEvent({ session, event, }: AppendEventRequest): Promise<Event>;
 }

package/dist/types/skills/gcp_skill_registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Client } from '@google-cloud/vertexai';
+import { Frontmatter, Skill } from './skill.js';
+import { SkillRegistry } from './skill_registry.js';
+export interface GCPSkillRegistryOptions {
+    projectId?: string;
+    location?: string;
+    client?: Client;
+}
+/**
+ * GCP implementation of SkillRegistry using GCP Skill Registry API.
+ */
+export declare class GCPSkillRegistry implements SkillRegistry {
+    private readonly projectId?;
+    private readonly location?;
+    private readonly client;
+    constructor(options?: GCPSkillRegistryOptions);
+    getSkill(name: string): Promise<Skill>;
+    searchSkills(query: string): Promise<Frontmatter[]>;
+}

package/dist/types/skills/loader.d.ts

@@ -36,3 +36,10 @@ export declare function validateSkillDir(skillDir: string): Promise<string[]>;
  * @returns A promise that resolves to a map of skill names to their corresponding Skill objects.
  */
 export declare function loadAllSkillsInDir(skillsBasePath: string): Promise<Record<string, Skill>>;
+/**
+ * Loads a complete skill directly from in-memory zip file buffer.
+ *
+ * @param zipBuffer - The raw Buffer of the zip file containing the skill.
+ * @returns A Skill object with all components loaded.
+ */
+export declare function loadSkillFromZipBuffer(zipBuffer: Buffer): Skill;

package/dist/types/skills/skill.d.ts

@@ -8,7 +8,7 @@ export declare const SNAKE_OR_KEBAB_NAME_PATTERN: RegExp;
 /**
  * Schema and Type for Skill Frontmatter metadata.
  */
-export declare const FrontmatterSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+export declare const FrontmatterSchema: z.ZodPreprocess<z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
     license: z.ZodOptional<z.ZodString>;

package/dist/types/skills/skill_registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Frontmatter, Skill } from './skill.js';
+/**
+ * Interface for a skill registry.
+ */
+export interface SkillRegistry {
+    /**
+     * Fetches a skill from the registry.
+     *
+     * @param name The name of the skill.
+     * @returns A Promise resolving to a Skill object.
+     */
+    getSkill(name: string): Promise<Skill>;
+    /**
+     * Searches for skills in the registry.
+     *
+     * @param query The search query.
+     * @returns A Promise resolving to a list of Frontmatter objects for discovery.
+     */
+    searchSkills(query: string): Promise<Frontmatter[]>;
+    /**
+     * Returns the description for the search_skills tool.
+     */
+    searchToolDescription?(): string | undefined;
+}

package/dist/types/tools/consolidate_context_tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FunctionDeclaration } from '@google/genai';
+import { BaseTool, RunAsyncToolRequest } from './base_tool.js';
+/**
+ * Tool for requesting context consolidation (compaction).
+ *
+ * When called by an LLM agent, this tool sets the state flags
+ * `temp:consolidate_context` and optionally `temp:consolidate_context_detail`,
+ * signalling the context compactor to trigger compaction.
+ */
+export declare class ConsolidateContextTool extends BaseTool {
+    constructor();
+    _getDeclaration(): FunctionDeclaration;
+    runAsync({ args, toolContext, }: RunAsyncToolRequest): Promise<unknown>;
+}

package/dist/types/tools/forwarding_artifact_service.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Part } from '@google/genai';
-import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from '../artifacts/base_artifact_service.js';
+import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from '../artifacts/base_artifact_service.js';
 import { Context } from '../agents/context.js';
 /**
  * Artifact service that forwards to the parent tool context.
@@ -15,7 +15,8 @@ export declare class ForwardingArtifactService implements BaseArtifactService {
     constructor(toolContext: Context);
     saveArtifact(request: SaveArtifactRequest): Promise<number>;
     loadArtifact(request: LoadArtifactRequest): Promise<Part | undefined>;
-    listArtifactKeys(): Promise<string[]>;
+    listArtifactKeys(_request: ListArtifactKeysRequest): Promise<string[]>;
+    private getArtifactService;
     deleteArtifact(request: DeleteArtifactRequest): Promise<void>;
     listVersions(request: ListVersionsRequest): Promise<number[]>;
     listArtifactVersions(request: ListVersionsRequest): Promise<ArtifactVersion[]>;

package/dist/types/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { OpenAPIV3 } from 'openapi-types';
+import { ApiParameter } from './operation_parser.js';
+export interface OperationEndpoint {
+    baseUrl: string;
+    path: string;
+    method: string;
+}
+export interface ParsedOperation {
+    name: string;
+    description: string;
+    endpoint: OperationEndpoint;
+    operation: OpenAPIV3.OperationObject;
+    parameters: ApiParameter[];
+    returnValue?: ApiParameter;
+    authScheme?: OpenAPIV3.SecuritySchemeObject;
+}
+export declare class OpenApiSpecParser {
+    private preservePropertyNames;
+    constructor(options?: {
+        preservePropertyNames?: boolean;
+    });
+    /**
+     * Parses an OpenAPI specification document and extracts a list of operations.
+     *
+     * @param openapiSpec The OpenAPI V3 document to parse.
+     * @returns An array of parsed operations.
+     */
+    parse(openapiSpec: OpenAPIV3.Document): ParsedOperation[];
+}