@google/adk 0.1.0 → 0.1.2

package/dist/esm/runner/runner.js

@@ -7,7 +7,7 @@ import { createPartFromText } from "@google/genai";
 import { trace } from "@opentelemetry/api";
 import { InvocationContext, newInvocationContextId } from "../agents/invocation_context.js";
 import { LlmAgent } from "../agents/llm_agent.js";
-import { RunConfig } from "../agents/run_config.js";
+import { createRunConfig } from "../agents/run_config.js";
 import { createEvent, getFunctionCalls } from "../events/event.js";
 import { createEventActions } from "../events/event_actions.js";
 import { PluginManager } from "../plugins/plugin_manager.js";
@@ -40,9 +40,10 @@ class Runner {
     sessionId,
     newMessage,
     stateDelta,
-    runConfig = new RunConfig()
+    runConfig
   }) {
     var _a;
+    runConfig = createRunConfig(runConfig);
     const span = trace.getTracer("gcp.vertex.agent").startSpan("invocation");
     try {
       const session = await this.sessionService.getSession({ appName: this.appName, userId, sessionId });

package/dist/types/agents/run_config.d.ts

@@ -15,7 +15,7 @@ export declare enum StreamingMode {
 /**
  * Configs for runtime behavior of agents.
  */
-export declare class RunConfig {
+export interface RunConfig {
     /**
      * Speech configuration for the live agent.
      */
@@ -27,7 +27,7 @@ export declare class RunConfig {
     /**
      * Whether or not to save the input blobs as artifacts.
      */
-    saveInputBlobsAsArtifacts: boolean;
+    saveInputBlobsAsArtifacts?: boolean;
     /**
      * Whether to support CFC (Compositional Function Calling). Only applicable
      * for StreamingMode.SSE. If it's true. the LIVE API will be invoked. Since
@@ -36,11 +36,11 @@ export declare class RunConfig {
      * WARNING: This feature is **experimental** and its API or behavior may
      * change in future releases.
      */
-    supportCfc: boolean;
+    supportCfc?: boolean;
     /**
      * Streaming mode, None or StreamingMode.SSE or StreamingMode.BIDI.
      */
-    streamingMode: StreamingMode;
+    streamingMode?: StreamingMode;
     /**
      * Output audio transcription config.
      */
@@ -53,7 +53,7 @@ export declare class RunConfig {
      * If enabled, the model will detect emotions and adapt its responses
      * accordingly.
      */
-    enableAffectiveDialog: boolean;
+    enableAffectiveDialog?: boolean;
     /**
      * Configures the proactivity of the model. This allows the model to respond
      * proactively to the input and to ignore irrelevant input.
@@ -71,6 +71,18 @@ export declare class RunConfig {
      *     calls is enforced, if the value is set in this range.
      *   - Less than or equal to 0: This allows for unbounded number of llm calls.
      */
-    maxLlmCalls: number;
-    constructor(params?: Partial<RunConfig>);
+    maxLlmCalls?: number;
 }
+export declare function createRunConfig(params?: Partial<RunConfig>): {
+    speechConfig?: SpeechConfig | undefined;
+    responseModalities?: Modality[] | undefined;
+    saveInputBlobsAsArtifacts: boolean;
+    supportCfc: boolean;
+    streamingMode: StreamingMode;
+    outputAudioTranscription?: AudioTranscriptionConfig | undefined;
+    inputAudioTranscription?: AudioTranscriptionConfig | undefined;
+    enableAffectiveDialog: boolean;
+    proactivity?: ProactivityConfig | undefined;
+    realtimeInputConfig?: RealtimeInputConfig | undefined;
+    maxLlmCalls: number;
+};

package/dist/types/common.d.ts

@@ -13,16 +13,19 @@ export { LlmAgent } from './agents/llm_agent.js';
 export type { AfterModelCallback, AfterToolCallback, BeforeModelCallback, BeforeToolCallback, SingleAfterModelCallback, SingleAfterToolCallback, SingleBeforeModelCallback, SingleBeforeToolCallback } from './agents/llm_agent.js';
 export { LoopAgent } from './agents/loop_agent.js';
 export { ParallelAgent } from './agents/parallel_agent.js';
-export { RunConfig, StreamingMode } from './agents/run_config.js';
+export type { RunConfig } from './agents/run_config.js';
+export { StreamingMode } from './agents/run_config.js';
 export { SequentialAgent } from './agents/sequential_agent.js';
 export { InMemoryArtifactService } from './artifacts/in_memory_artifact_service.js';
 export type { BaseCredentialService } from './auth/credential_service/base_credential_service.js';
-export { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse } from './events/event.js';
+export { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent } from './events/event.js';
 export type { Event } from './events/event.js';
 export type { EventActions } from './events/event_actions.js';
 export { InMemoryMemoryService } from './memory/in_memory_memory_service.js';
 export { BaseLlm } from './models/base_llm.js';
 export type { BaseLlmConnection } from './models/base_llm_connection.js';
+export { Gemini } 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 { BasePlugin } from './plugins/base_plugin.js';

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

@@ -75,6 +75,13 @@ 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.
  */

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

@@ -26,10 +26,11 @@ export declare abstract class BaseLlm {
      * Generates one content from the given contents and tools.
      *
      * @param llmRequest  LlmRequest, the request to send to the LLM.
+     * @param stream whether to do streaming call.
      * For non-streaming call, it will only yield one Content.
      * @return A generator of LlmResponse.
      */
-    abstract generateContentAsync(llmRequest: LlmRequest): AsyncGenerator<LlmResponse, void>;
+    abstract generateContentAsync(llmRequest: LlmRequest, stream?: boolean): AsyncGenerator<LlmResponse, void>;
     /**
      * Creates a live connection to the LLM.
      *

package/dist/web/agents/invocation_context.js

@@ -17,9 +17,7 @@ class InvocationCostManager {
   incrementAndEnforceLlmCallsLimit(runConfig) {
     this.numberOfLlmCalls++;
     if (runConfig && runConfig.maxLlmCalls > 0 && this.numberOfLlmCalls > runConfig.maxLlmCalls) {
-      throw new Error(
-        "Max number of llm calls limit of ".concat(runConfig.maxLlmCalls, " exceeded")
-      );
+      throw new Error("Max number of llm calls limit of ".concat(runConfig.maxLlmCalls, " exceeded"));
     }
   }
 }

package/dist/web/agents/llm_agent.js

@@ -53,6 +53,7 @@ import { getContents, getCurrentTurnContents } from "./content_processor_utils.j
 import { generateAuthEvent, generateRequestConfirmationEvent, getLongRunningFunctionCalls, handleFunctionCallList, handleFunctionCallsAsync, populateClientFunctionCallId, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME } from "./functions.js";
 import { injectSessionState } from "./instructions.js";
 import { ReadonlyContext } from "./readonly_context.js";
+import { StreamingMode } from "./run_config.js";
 const ADK_AGENT_NAME_LABEL_KEY = "adk_agent_name";
 async function convertToolUnionToTools(toolUnion, context) {
   if (toolUnion instanceof BaseTool) {
@@ -831,7 +832,7 @@ class LlmAgent extends BaseAgent {
   }
   callLlmAsync(invocationContext, llmRequest, modelResponseEvent) {
     return __asyncGenerator(this, null, function* () {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e;
       const beforeModelResponse = yield new __await(this.handleBeforeModelCallback(
         invocationContext,
         llmRequest,
@@ -851,7 +852,11 @@ class LlmAgent extends BaseAgent {
         throw new Error("CFC is not yet supported in callLlmAsync");
       } else {
         invocationContext.incrementLlmCallCount();
-        const responsesGenerator = llm.generateContentAsync(llmRequest);
+        const responsesGenerator = llm.generateContentAsync(
+          llmRequest,
+          /* stream= */
+          ((_e = invocationContext.runConfig) == null ? void 0 : _e.streamingMode) === StreamingMode.SSE
+        );
         try {
           for (var iter = __forAwait(this.runAndHandleError(
             responsesGenerator,

package/dist/web/agents/run_config.js

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -10,19 +26,14 @@ var StreamingMode = /* @__PURE__ */ ((StreamingMode2) => {
   StreamingMode2["BIDI"] = "bidi";
   return StreamingMode2;
 })(StreamingMode || {});
-class RunConfig {
-  constructor(params = {}) {
-    this.speechConfig = params.speechConfig;
-    this.responseModalities = params.responseModalities;
-    this.saveInputBlobsAsArtifacts = params.saveInputBlobsAsArtifacts || false;
-    this.supportCfc = params.supportCfc || false;
-    this.streamingMode = params.streamingMode || "none" /* NONE */;
-    this.outputAudioTranscription = params.outputAudioTranscription;
-    this.inputAudioTranscription = params.inputAudioTranscription;
-    this.enableAffectiveDialog = params.enableAffectiveDialog || false;
-    this.realtimeInputConfig = params.realtimeInputConfig;
-    this.maxLlmCalls = validateMaxLlmCalls(params.maxLlmCalls || 500);
-  }
+function createRunConfig(params = {}) {
+  return __spreadValues({
+    saveInputBlobsAsArtifacts: false,
+    supportCfc: false,
+    enableAffectiveDialog: false,
+    streamingMode: "none" /* NONE */,
+    maxLlmCalls: validateMaxLlmCalls(params.maxLlmCalls || 500)
+  }, params);
 }
 function validateMaxLlmCalls(value) {
   if (value > Number.MAX_SAFE_INTEGER) {
@@ -38,6 +49,6 @@ function validateMaxLlmCalls(value) {
   return value;
 }
 export {
-  RunConfig,
-  StreamingMode
+  StreamingMode,
+  createRunConfig
 };

package/dist/web/common.js

@@ -11,12 +11,13 @@ import { LiveRequestQueue } from "./agents/live_request_queue.js";
 import { LlmAgent } from "./agents/llm_agent.js";
 import { LoopAgent } from "./agents/loop_agent.js";
 import { ParallelAgent } from "./agents/parallel_agent.js";
-import { RunConfig, StreamingMode } from "./agents/run_config.js";
+import { StreamingMode } from "./agents/run_config.js";
 import { SequentialAgent } from "./agents/sequential_agent.js";
 import { InMemoryArtifactService } from "./artifacts/in_memory_artifact_service.js";
-import { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse } from "./events/event.js";
+import { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent } from "./events/event.js";
 import { InMemoryMemoryService } from "./memory/in_memory_memory_service.js";
 import { BaseLlm } from "./models/base_llm.js";
+import { Gemini } from "./models/google_llm.js";
 import { BasePlugin } from "./plugins/base_plugin.js";
 import { LoggingPlugin } from "./plugins/logging_plugin.js";
 import { PluginManager } from "./plugins/plugin_manager.js";
@@ -49,6 +50,7 @@ export {
   CallbackContext,
   FunctionTool,
   GOOGLE_SEARCH,
+  Gemini,
   InMemoryArtifactService,
   InMemoryMemoryService,
   InMemoryPolicyEngine,
@@ -65,7 +67,6 @@ export {
   PluginManager,
   PolicyOutcome,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
-  RunConfig,
   Runner,
   SecurityPlugin,
   SequentialAgent,
@@ -81,5 +82,6 @@ export {
   hasTrailingCodeExecutionResult,
   isFinalResponse,
   setLogLevel,
+  stringifyContent,
   zodObjectToSchema
 };

package/dist/web/events/event.js

@@ -70,6 +70,16 @@ function hasTrailingCodeExecutionResult(event) {
   }
   return false;
 }
+function stringifyContent(event) {
+  var _a;
+  if (!((_a = event.content) == null ? void 0 : _a.parts)) {
+    return "";
+  }
+  return event.content.parts.map((part) => {
+    var _a2;
+    return (_a2 = part.text) != null ? _a2 : "";
+  }).join("");
+}
 const ASCII_LETTERS_AND_NUMBERS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 function createNewEventId() {
   let id = "";
@@ -86,5 +96,6 @@ export {
   getFunctionCalls,
   getFunctionResponses,
   hasTrailingCodeExecutionResult,
-  isFinalResponse
+  isFinalResponse,
+  stringifyContent
 };