@ai-sdk/google 4.0.0-canary.68 → 4.0.0-canary.69

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/google
 
+## 4.0.0-canary.69
+
+### Patch Changes
+
+- 7f04802: feat(provider/google): add support for managed agents in the Interactions API
+
 ## 4.0.0-canary.68
 
 ### Patch Changes

package/dist/index.d.ts

@@ -318,6 +318,29 @@ declare const googleInteractionsLanguageModelOptions: _ai_sdk_provider_utils.Laz
     signature?: string | null | undefined;
     interactionId?: string | null | undefined;
     pollingTimeoutMs?: number | null | undefined;
+    background?: boolean | null | undefined;
+    environment?: string | {
+        type: "remote";
+        sources?: ({
+            type: "gcs";
+            source: string;
+            target?: string | null | undefined;
+        } | {
+            type: "repository";
+            source: string;
+            target?: string | null | undefined;
+        } | {
+            type: "inline";
+            content: string;
+            target: string;
+        })[] | null | undefined;
+        network?: "disabled" | {
+            allowlist: {
+                domain: string;
+                transform?: Record<string, string>[] | null | undefined;
+            }[];
+        } | null | undefined;
+    } | null | undefined;
 }>;
 type GoogleLanguageModelInteractionsOptions = InferSchema<typeof googleInteractionsLanguageModelOptions>;
 
@@ -347,14 +370,12 @@ type GoogleInteractionsProviderMetadata = {
  * Type-only module: declares the union of supported Gemini Interactions agent
  * names. Used by the `google.interactions({ agent })` factory branch.
  *
- * Sourced from `googleapis/js-genai` `src/interactions/resources/interactions.ts`
- * (`Interaction.agent` enum). Subject to expansion as Google adds new agents.
- *
- * This is a strict string-literal union (no `string` escape hatch) so that
- * passing an unknown agent name is a compile-time error. Add new agents here
- * as Google publishes them.
+ * Strict string-literal union: unknown agent names are a compile-time error.
+ * User-defined agents (created via the `/agents` endpoint) are addressed by
+ * a separate `{ managedAgent: string }` factory shape — see
+ * `GoogleInteractionsModelInput`.
  */
-type GoogleInteractionsAgentName = 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026';
+type GoogleInteractionsAgentName = 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026' | 'antigravity-preview-05-2026';
 
 declare const googleTools: {
     /**
@@ -486,11 +507,16 @@ interface GoogleProvider extends ProviderV4 {
     files(): FilesV4;
     /**
      * Creates a language model targeting the Gemini Interactions API
-     * (`POST /v1beta/interactions`). Pass either a model ID (string) or
-     * `{ agent: <name> }` to use a Gemini agent preset.
+     * (`POST /v1beta/interactions`). Pass:
+     *   - a model ID (string),
+     *   - `{ agent: <name> }` to use a known Gemini agent preset, or
+     *   - `{ managedAgent: <name> }` to use a user-defined agent created via
+     *     the `/v1beta/agents` endpoint.
      */
     interactions(modelIdOrAgent: GoogleInteractionsModelId | {
         agent: GoogleInteractionsAgentName;
+    } | {
+        managedAgent: string;
     }): LanguageModelV4;
     tools: typeof googleTools;
 }

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "4.0.0-canary.68" : "0.0.0-test";
+var VERSION = true ? "4.0.0-canary.69" : "0.0.0-test";
 
 // src/google-embedding-model.ts
 import {
@@ -5049,7 +5049,61 @@ var googleInteractionsLanguageModelOptions = lazySchema17(
        * call) before giving up. Defaults to 30 minutes. Long-running agents
        * such as deep research can take tens of minutes — increase if needed.
        */
-      pollingTimeoutMs: z19.number().int().positive().nullish()
+      pollingTimeoutMs: z19.number().int().positive().nullish(),
+      /**
+       * Run the interaction in the background. Required for agents whose
+       * server-side workflow cannot complete within a single request/response.
+       * When `true`, the POST returns with a non-terminal status and the SDK
+       * polls `GET /interactions/{id}` until the work completes. Some agents
+       * reject `true`; see the agent's documentation for which mode it
+       * requires.
+       */
+      background: z19.boolean().nullish(),
+      /**
+       * Environment configuration for the agent sandbox. Only applies to agent
+       * calls (`google.interactions({ agent })`); ignored on model-id calls.
+       *
+       *   - `"remote"`: provision a fresh sandbox for this call.
+       *   - any other string: an existing `environment_id` to reuse.
+       *   - object: provision a fresh sandbox and optionally preload `sources`
+       *     and/or constrain outbound traffic via `network`.
+       */
+      environment: z19.union([
+        z19.string(),
+        z19.object({
+          type: z19.literal("remote"),
+          sources: z19.array(
+            z19.union([
+              z19.object({
+                type: z19.literal("gcs"),
+                source: z19.string(),
+                target: z19.string().nullish()
+              }),
+              z19.object({
+                type: z19.literal("repository"),
+                source: z19.string(),
+                target: z19.string().nullish()
+              }),
+              z19.object({
+                type: z19.literal("inline"),
+                content: z19.string(),
+                target: z19.string()
+              })
+            ])
+          ).nullish(),
+          network: z19.union([
+            z19.literal("disabled"),
+            z19.object({
+              allowlist: z19.array(
+                z19.object({
+                  domain: z19.string(),
+                  transform: z19.array(z19.record(z19.string(), z19.string())).nullish()
+                })
+              )
+            })
+          ]).nullish()
+        })
+      ]).nullish()
     })
   )
 );
@@ -5786,6 +5840,9 @@ var GoogleInteractionsLanguageModel = class _GoogleInteractionsLanguageModel {
     if (typeof modelOrAgent === "string") {
       this.modelId = modelOrAgent;
       this.agent = void 0;
+    } else if ("managedAgent" in modelOrAgent) {
+      this.modelId = modelOrAgent.managedAgent;
+      this.agent = modelOrAgent.managedAgent;
     } else {
       this.modelId = modelOrAgent.agent;
       this.agent = modelOrAgent.agent;
@@ -5826,7 +5883,7 @@ var GoogleInteractionsLanguageModel = class _GoogleInteractionsLanguageModel {
     };
   }
   async getArgs(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
     const warnings = [];
     const opts = await parseProviderOptions6({
       provider: "google",
@@ -5983,6 +6040,55 @@ var GoogleInteractionsLanguageModel = class _GoogleInteractionsLanguageModel {
         agentConfig = { type: "dynamic" };
       }
     }
+    let environment;
+    if ((opts == null ? void 0 : opts.environment) != null) {
+      if (!isAgent) {
+        warnings.push({
+          type: "other",
+          message: "google.interactions: environment is only supported when an agent is set; environment will be omitted from the request body."
+        });
+      } else if (typeof opts.environment === "string") {
+        environment = opts.environment;
+      } else {
+        const env = opts.environment;
+        const sources = (_u = env.sources) == null ? void 0 : _u.map((s) => {
+          var _a2;
+          if (s.type === "inline") {
+            return {
+              type: "inline",
+              content: s.content,
+              target: s.target
+            };
+          }
+          return pruneUndefined({
+            type: s.type,
+            source: s.source,
+            target: (_a2 = s.target) != null ? _a2 : void 0
+          });
+        });
+        let network;
+        if (env.network === "disabled") {
+          network = "disabled";
+        } else if (env.network != null) {
+          network = {
+            allowlist: env.network.allowlist.map(
+              (entry) => {
+                var _a2;
+                return pruneUndefined({
+                  domain: entry.domain,
+                  transform: (_a2 = entry.transform) != null ? _a2 : void 0
+                });
+              }
+            )
+          };
+        }
+        environment = pruneUndefined({
+          type: "remote",
+          sources: sources != null && sources.length > 0 ? sources : void 0,
+          network
+        });
+      }
+    }
     const args = pruneUndefined({
       ...isAgent ? { agent: this.agent } : { model: this.modelId },
       input,
@@ -5990,18 +6096,20 @@ var GoogleInteractionsLanguageModel = class _GoogleInteractionsLanguageModel {
       tools: toolsForBody,
       response_format: responseFormatEntries.length > 0 ? responseFormatEntries : void 0,
       response_modalities: (opts == null ? void 0 : opts.responseModalities) != null ? opts.responseModalities : void 0,
-      previous_interaction_id: (_u = opts == null ? void 0 : opts.previousInteractionId) != null ? _u : void 0,
-      service_tier: (_v = opts == null ? void 0 : opts.serviceTier) != null ? _v : void 0,
-      store: (_w = opts == null ? void 0 : opts.store) != null ? _w : void 0,
+      previous_interaction_id: (_v = opts == null ? void 0 : opts.previousInteractionId) != null ? _v : void 0,
+      service_tier: (_w = opts == null ? void 0 : opts.serviceTier) != null ? _w : void 0,
+      store: (_x = opts == null ? void 0 : opts.store) != null ? _x : void 0,
       generation_config: generationConfig != null && Object.keys(generationConfig).length > 0 ? generationConfig : void 0,
       agent_config: agentConfig,
-      ...isAgent ? { background: true } : {}
+      environment,
+      background: (_y = opts == null ? void 0 : opts.background) != null ? _y : void 0
     });
     return {
       args,
       warnings,
       isAgent,
-      pollingTimeoutMs: (_x = opts == null ? void 0 : opts.pollingTimeoutMs) != null ? _x : void 0
+      isBackground: (opts == null ? void 0 : opts.background) === true,
+      pollingTimeoutMs: (_z = opts == null ? void 0 : opts.pollingTimeoutMs) != null ? _z : void 0
     };
   }
   async doGenerate(options) {
@@ -6087,14 +6195,14 @@ var GoogleInteractionsLanguageModel = class _GoogleInteractionsLanguageModel {
   }
   async doStream(options) {
     var _a;
-    const { args, warnings, isAgent, pollingTimeoutMs } = await this.getArgs(options);
+    const { args, warnings, isBackground, pollingTimeoutMs } = await this.getArgs(options);
     const url = `${this.config.baseURL}/interactions`;
     const mergedHeaders = combineHeaders7(
       INTERACTIONS_API_REVISION_HEADER,
       this.config.headers ? await resolve5(this.config.headers) : void 0,
       options.headers
     );
-    if (isAgent) {
+    if (isBackground) {
       return this.doStreamBackground({
         args,
         warnings,