Namespace: googleAdkAgentsWorkflow

Workflow-safe API for the Google ADK Temporal plugin — importable from Workflow code running in the V8 sandbox.

The Google ADK plugin is an experimental feature; APIs may change without notice.

License

Copyright 2025 Temporal Technologies Inc. SPDX-License-Identifier: MIT

Classes

• TemporalMCPToolset
• TemporalModel

Interfaces

• ActivityAsToolOptions
• TemporalMCPToolsetOptions
• TemporalModelOptions

References

MCPToolsetFactory

Re-exports MCPToolsetFactory

Variables

MCP_ERROR_FAILURE_TYPE

• Const MCP_ERROR_FAILURE_TYPE: "GoogleAdkMCPError"

Error type for a failed MCP listTools or callTool call. Raised inside an Activity, so wherever you catch it, it arrives wrapped in an ActivityFailure: match it through the .cause chain, never against the caught error's own .type.

An HTTP status, when present, is appended and classified exactly as for MODEL_ERROR_FAILURE_TYPE — but an MCP failure rarely carries one, so a rejected token or an unreachable server classifies as retryable rather than failing fast, and the plugin sets no retry policy: the call retries indefinitely until the caller bounds it with TemporalMCPToolsetOptions.activity.retry.maximumAttempts.

---

MCP_TOOL_NOT_FOUND_FAILURE_TYPE

• Const MCP_TOOL_NOT_FOUND_FAILURE_TYPE: "GoogleAdkMCPToolNotFound"

Error type when the <name>-callTool Activity finds no tool by the requested name in the BaseToolset its factory returned. Non-retryable, and raised inside that Activity, so it arrives wrapped in an ActivityFailure: match it through the .cause chain, never against the caught error's own .type. It reaches code that calls the tool's runAsync itself.

A factory returning MCPConnectionParams never raises it: the plugin calls the tool without resolving the name first, so the caller gets whatever the server answers.

---

MODEL_ERROR_FAILURE_TYPE

• Const MODEL_ERROR_FAILURE_TYPE: "GoogleAdkModelError"

Error type for a failed model call. Raised inside an Activity, so it arrives wrapped in an ActivityFailure: match it through the .cause chain. It reaches code that awaits TemporalModel.generateContentAsync itself.

A failure that carries an HTTP status has it appended as .<status>, for example GoogleAdkModelError.429, so match with startsWith, not ===; such a failure is retryable for 408, 409, 429 and 5xx and non-retryable otherwise. One carrying no status is the bare type and retryable. An x-should-retry response header overrides either verdict.

---

STREAMING_TOPIC_REQUIRED_FAILURE_TYPE

• Const STREAMING_TOPIC_REQUIRED_FAILURE_TYPE: "GoogleAdkStreamingTopicRequired"

Error type when streaming is requested but TemporalModelOptions.streamingTopic is unset. Non-retryable, and thrown in the Workflow, so code calling TemporalModel directly catches it unwrapped.

---

UNSUPPORTED_FAILURE_TYPE

• Const UNSUPPORTED_FAILURE_TYPE: "GoogleAdkUnsupported"

Error type when BaseLlm.connect (BIDI live streaming) is called inside a Workflow. Non-retryable, and thrown in the Workflow to whoever called connect, so it arrives unwrapped.

Functions

activityAsTool

▸ activityAsTool(options): BaseTool

Wraps an existing Temporal Activity (by registered name) as an ADK BaseTool. Add the returned tool to an agent's tools[].

Parameters

Name	Type
options	ActivityAsToolOptions

Returns

BaseTool