@softactivate/adk 1.1.0

package/dist/esm/agents/readonly_context.js

@@ -0,0 +1,55 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { State } from "../sessions/state.js";
+class ReadonlyContext {
+  constructor(invocationContext) {
+    this.invocationContext = invocationContext;
+  }
+  /**
+   * The user content that started this invocation.
+   */
+  get userContent() {
+    return this.invocationContext.userContent;
+  }
+  /**
+   * The current invocation id.
+   */
+  get invocationId() {
+    return this.invocationContext.invocationId;
+  }
+  /**
+   * The user ID of the current session.
+   */
+  get userId() {
+    return this.invocationContext.userId;
+  }
+  /**
+   * The ID of the current session.
+   */
+  get sessionId() {
+    return this.invocationContext.session.id;
+  }
+  /**
+   * The current agent name.
+   */
+  get agentName() {
+    return this.invocationContext.agent.name;
+  }
+  /**
+   * The state of the current session.
+   */
+  get state() {
+    return new State(
+      this.invocationContext.session.state,
+      {}
+    );
+  }
+}
+export {
+  ReadonlyContext
+};

package/dist/esm/agents/routed_agent.js

@@ -0,0 +1,70 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a, _b;
+import { BaseAgent } from "./base_agent.js";
+import { experimental } from "../utils/experimental.js";
+import { runWithRouting } from "../utils/failover_utils.js";
+const ROUTED_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.routedAgent");
+function isRoutedAgent(obj) {
+  return typeof obj === "object" && obj !== null && ROUTED_AGENT_SIGNATURE_SYMBOL in obj && obj[ROUTED_AGENT_SIGNATURE_SYMBOL] === true;
+}
+let RoutedAgent = class extends (_b = BaseAgent, _a = ROUTED_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor(config) {
+    const agentsArray = Array.isArray(config.agents) ? config.agents : Object.values(config.agents);
+    super({
+      ...config,
+      subAgents: agentsArray
+    });
+    this[_a] = true;
+    if (Array.isArray(config.agents)) {
+      this.agents = Object.fromEntries(config.agents.map((a) => [a.name, a]));
+    } else {
+      this.agents = config.agents;
+    }
+    this.router = config.router;
+  }
+  /**
+   * Runs the selected agent via text-based conversation.
+   */
+  async *runAsyncImpl(context) {
+    yield* runWithRouting(
+      this.agents,
+      context,
+      this.router,
+      (agent) => agent.runAsync(context)
+    );
+  }
+  /**
+   * Runs the selected agent via video/audio-based conversation.
+   */
+  async *runLiveImpl(context) {
+    yield* runWithRouting(
+      this.agents,
+      context,
+      this.router,
+      (agent) => agent.runLive(context)
+    );
+  }
+};
+RoutedAgent = __decorateClass([
+  experimental
+], RoutedAgent);
+export {
+  RoutedAgent,
+  isRoutedAgent
+};

package/dist/esm/agents/run_config.js

@@ -0,0 +1,42 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from "../utils/logger.js";
+var StreamingMode = /* @__PURE__ */ ((StreamingMode2) => {
+  StreamingMode2["NONE"] = "none";
+  StreamingMode2["SSE"] = "sse";
+  StreamingMode2["BIDI"] = "bidi";
+  return StreamingMode2;
+})(StreamingMode || {});
+function createRunConfig(params = {}) {
+  return {
+    saveInputBlobsAsArtifacts: false,
+    supportCfc: false,
+    enableAffectiveDialog: false,
+    streamingMode: "none" /* NONE */,
+    maxLlmCalls: validateMaxLlmCalls(params.maxLlmCalls || 500),
+    pauseOnToolCalls: false,
+    ...params
+  };
+}
+function validateMaxLlmCalls(value) {
+  if (value > Number.MAX_SAFE_INTEGER) {
+    throw new Error(
+      `maxLlmCalls should be less than ${Number.MAX_SAFE_INTEGER}.`
+    );
+  }
+  if (value <= 0) {
+    logger.warn(
+      "maxLlmCalls is less than or equal to 0. This will result in no enforcement on total number of llm calls that will be made for a run. This may not be ideal, as this could result in a never ending communication between the model and the agent in certain cases."
+    );
+  }
+  return value;
+}
+export {
+  StreamingMode,
+  createRunConfig
+};

package/dist/esm/agents/sequential_agent.js

@@ -0,0 +1,77 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a, _b;
+import { FunctionTool } from "../tools/function_tool.js";
+import { BaseAgent } from "./base_agent.js";
+import { isLlmAgent } from "./llm_agent.js";
+import { ReadonlyContext } from "./readonly_context.js";
+const TASK_COMPLETED_TOOL_NAME = "task_completed";
+const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.sequentialAgent"
+);
+function isSequentialAgent(obj) {
+  return typeof obj === "object" && obj !== null && SEQUENTIAL_AGENT_SIGNATURE_SYMBOL in obj && obj[SEQUENTIAL_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class SequentialAgent extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK sequential agent class.
+     */
+    this[_a] = true;
+  }
+  async *runAsyncImpl(context) {
+    for (const subAgent of this.subAgents) {
+      for await (const event of subAgent.runAsync(context)) {
+        yield event;
+      }
+    }
+  }
+  /**
+   * Implementation for live SequentialAgent.
+   *
+   * Compared to the non-live case, live agents process a continuous stream of
+   * audio or video, so there is no way to tell if it's finished and should pass
+   * to the next agent or not. So we introduce a task_completed() function so
+   * the model can call this function to signal that it's finished the task and
+   * we can move on to the next agent.
+   *
+   * @param context The invocation context of the agent.
+   */
+  async *runLiveImpl(context) {
+    for (const subAgent of this.subAgents) {
+      if (isLlmAgent(subAgent)) {
+        const agentTools = await subAgent.canonicalTools(
+          new ReadonlyContext(context)
+        );
+        const taskCompletedToolAlreadyAdded = agentTools.some(
+          (tool) => tool.name === TASK_COMPLETED_TOOL_NAME
+        );
+        if (!taskCompletedToolAlreadyAdded) {
+          subAgent.tools.push(
+            new FunctionTool({
+              name: TASK_COMPLETED_TOOL_NAME,
+              description: `Signals that the model has successfully completed the user's question or task.`,
+              execute: () => "Task completion signaled."
+            })
+          );
+          subAgent.instruction += `If you finished the user's request according to its description, call the ${TASK_COMPLETED_TOOL_NAME} function to exit so the next agents can take over. When calling this function, do not generate any text other than the function call.`;
+        }
+      }
+    }
+    for (const subAgent of this.subAgents) {
+      for await (const event of subAgent.runLive(context)) {
+        yield event;
+      }
+    }
+  }
+}
+export {
+  SequentialAgent,
+  isSequentialAgent
+};

package/dist/esm/agents/transcription_entry.js

@@ -0,0 +1,7 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/esm/artifacts/base_artifact_service.js

@@ -0,0 +1,7 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */