@paean-ai/adk 0.2.13 → 0.2.15

package/dist/esm/agents/loop_agent.js

@@ -1,38 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { BaseAgent } from "./base_agent.js";
-class LoopAgent extends BaseAgent {
-  constructor(config) {
-    var _a;
-    super(config);
-    this.maxIterations = (_a = config.maxIterations) != null ? _a : Number.MAX_SAFE_INTEGER;
-  }
-  async *runAsyncImpl(context) {
-    let iteration = 0;
-    while (iteration < this.maxIterations) {
-      for (const subAgent of this.subAgents) {
-        let shouldExit = false;
-        for await (const event of subAgent.runAsync(context)) {
-          yield event;
-          if (event.actions.escalate) {
-            shouldExit = true;
-          }
-        }
-        if (shouldExit) {
-          return;
-        }
-      }
-      iteration++;
-    }
-    return;
-  }
-  async *runLiveImpl(context) {
-    throw new Error("This is not supported yet for LoopAgent.");
-  }
-}
-export {
-  LoopAgent
-};

package/dist/esm/agents/parallel_agent.js

@@ -1,48 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { BaseAgent } from "./base_agent.js";
-import { InvocationContext } from "./invocation_context.js";
-class ParallelAgent extends BaseAgent {
-  async *runAsyncImpl(context) {
-    const agentRuns = this.subAgents.map(
-      (subAgent) => subAgent.runAsync(
-        createBranchCtxForSubAgent(this, subAgent, context)
-      )
-    );
-    for await (const event of mergeAgentRuns(agentRuns)) {
-      yield event;
-    }
-  }
-  async *runLiveImpl(context) {
-    throw new Error("This is not supported yet for ParallelAgent.");
-  }
-}
-function createBranchCtxForSubAgent(agent, subAgent, originalContext) {
-  const invocationContext = new InvocationContext(originalContext);
-  const branchSuffix = `${agent.name}.${subAgent.name}`;
-  invocationContext.branch = invocationContext.branch ? `${invocationContext.branch}.${branchSuffix}` : branchSuffix;
-  return invocationContext;
-}
-async function* mergeAgentRuns(agentRuns) {
-  const pendingPromises = /* @__PURE__ */ new Map();
-  for (const [index, generator] of agentRuns.entries()) {
-    const promise = generator.next().then((result) => ({ result, index }));
-    pendingPromises.set(index, promise);
-  }
-  while (pendingPromises.size > 0) {
-    const { result, index } = await Promise.race(pendingPromises.values());
-    if (result.done) {
-      pendingPromises.delete(index);
-      continue;
-    }
-    yield result.value;
-    const nextPromise = agentRuns[index].next().then((result2) => ({ result: result2, index }));
-    pendingPromises.set(index, nextPromise);
-  }
-}
-export {
-  ParallelAgent
-};

package/dist/esm/agents/readonly_context.js

@@ -1,38 +0,0 @@
-/**
- * @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 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/run_config.js

@@ -1,39 +0,0 @@
-/**
- * @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),
-    ...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

@@ -1,54 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { FunctionTool } from "../tools/function_tool.js";
-import { BaseAgent } from "./base_agent.js";
-import { LlmAgent } from "./llm_agent.js";
-import { ReadonlyContext } from "./readonly_context.js";
-const TASK_COMPLETED_TOOL_NAME = "task_completed";
-class SequentialAgent extends BaseAgent {
-  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 (subAgent instanceof LlmAgent) {
-        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
-};

package/dist/esm/agents/transcription_entry.js

@@ -1,5 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */

package/dist/esm/artifacts/base_artifact_service.js

@@ -1,5 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */

package/dist/esm/artifacts/gcs_artifact_service.js

@@ -1,110 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Storage } from "@google-cloud/storage";
-import { createPartFromBase64, createPartFromText } from "@google/genai";
-class GcsArtifactService {
-  constructor(bucket) {
-    this.bucket = new Storage().bucket(bucket);
-  }
-  async saveArtifact(request) {
-    const versions = await this.listVersions(request);
-    const version = versions.length > 0 ? Math.max(...versions) + 1 : 0;
-    const file = this.bucket.file(getFileName({
-      ...request,
-      version
-    }));
-    if (request.artifact.inlineData) {
-      await file.save(JSON.stringify(request.artifact.inlineData.data), {
-        contentType: request.artifact.inlineData.mimeType
-      });
-      return version;
-    }
-    if (request.artifact.text) {
-      await file.save(request.artifact.text, {
-        contentType: "text/plain"
-      });
-      return version;
-    }
-    throw new Error("Artifact must have either inlineData or text.");
-  }
-  async loadArtifact(request) {
-    let version = request.version;
-    if (version === void 0) {
-      const versions = await this.listVersions(request);
-      if (versions.length === 0) {
-        return void 0;
-      }
-      version = Math.max(...versions);
-    }
-    const file = this.bucket.file(getFileName({
-      ...request,
-      version
-    }));
-    const [[metadata], [rawDataBuffer]] = await Promise.all([file.getMetadata(), file.download()]);
-    if (metadata.contentType === "text/plain") {
-      return createPartFromText(rawDataBuffer.toString("utf-8"));
-    }
-    return createPartFromBase64(
-      rawDataBuffer.toString("base64"),
-      metadata.contentType
-    );
-  }
-  async listArtifactKeys(request) {
-    const fileNames = [];
-    const sessionPrefix = `${request.appName}/${request.userId}/${request.sessionId}/`;
-    const usernamePrefix = `${request.appName}/${request.userId}/user/`;
-    const [
-      [sessionFiles],
-      [userSessionFiles]
-    ] = await Promise.all([
-      this.bucket.getFiles({ prefix: sessionPrefix }),
-      this.bucket.getFiles({ prefix: usernamePrefix })
-    ]);
-    for (const file of sessionFiles) {
-      fileNames.push(file.name.split("/").pop());
-    }
-    for (const file of userSessionFiles) {
-      fileNames.push(file.name.split("/").pop());
-    }
-    return fileNames.sort((a, b) => a.localeCompare(b));
-  }
-  async deleteArtifact(request) {
-    const versions = await this.listVersions(request);
-    await Promise.all(versions.map((version) => {
-      const file = this.bucket.file(getFileName({
-        ...request,
-        version
-      }));
-      return file.delete();
-    }));
-    return;
-  }
-  async listVersions(request) {
-    const prefix = getFileName(request);
-    const [files] = await this.bucket.getFiles({ prefix });
-    const versions = [];
-    for (const file of files) {
-      const version = file.name.split("/").pop();
-      versions.push(parseInt(version, 10));
-    }
-    return versions;
-  }
-}
-function getFileName({
-  appName,
-  userId,
-  sessionId,
-  filename,
-  version
-}) {
-  if (filename.startsWith("user:")) {
-    return `${appName}/${userId}/user/${filename}/${version}`;
-  }
-  return `${appName}/${userId}/${sessionId}/${filename}/${version}`;
-}
-export {
-  GcsArtifactService
-};

package/dist/esm/artifacts/in_memory_artifact_service.js

@@ -1,89 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class InMemoryArtifactService {
-  constructor() {
-    this.artifacts = {};
-  }
-  saveArtifact({
-    appName,
-    userId,
-    sessionId,
-    filename,
-    artifact
-  }) {
-    const path = artifactPath(appName, userId, sessionId, filename);
-    if (!this.artifacts[path]) {
-      this.artifacts[path] = [];
-    }
-    const version = this.artifacts[path].length;
-    this.artifacts[path].push(artifact);
-    return Promise.resolve(version);
-  }
-  loadArtifact({
-    appName,
-    userId,
-    sessionId,
-    filename,
-    version
-  }) {
-    const path = artifactPath(appName, userId, sessionId, filename);
-    const versions = this.artifacts[path];
-    if (!versions) {
-      return Promise.resolve(void 0);
-    }
-    if (version === void 0) {
-      version = versions.length - 1;
-    }
-    return Promise.resolve(versions[version]);
-  }
-  listArtifactKeys({ appName, userId, sessionId }) {
-    const sessionPrefix = `${appName}/${userId}/${sessionId}/`;
-    const usernamespacePrefix = `${appName}/${userId}/user/`;
-    const filenames = [];
-    for (const path in this.artifacts) {
-      if (path.startsWith(sessionPrefix)) {
-        const filename = path.replace(sessionPrefix, "");
-        filenames.push(filename);
-      } else if (path.startsWith(usernamespacePrefix)) {
-        const filename = path.replace(usernamespacePrefix, "");
-        filenames.push(filename);
-      }
-    }
-    return Promise.resolve(filenames.sort());
-  }
-  deleteArtifact({ appName, userId, sessionId, filename }) {
-    const path = artifactPath(appName, userId, sessionId, filename);
-    if (!this.artifacts[path]) {
-      return Promise.resolve();
-    }
-    delete this.artifacts[path];
-    return Promise.resolve();
-  }
-  listVersions({ appName, userId, sessionId, filename }) {
-    const path = artifactPath(appName, userId, sessionId, filename);
-    const artifacts = this.artifacts[path];
-    if (!artifacts) {
-      return Promise.resolve([]);
-    }
-    let versions = [];
-    for (let i = 0; i < artifacts.length; i++) {
-      versions.push(i);
-    }
-    return Promise.resolve(versions);
-  }
-}
-function artifactPath(appName, userId, sessionId, filename) {
-  if (fileHasUserNamespace(filename)) {
-    return `${appName}/${userId}/user/${filename}`;
-  }
-  return `${appName}/${userId}/${sessionId}/${filename}`;
-}
-function fileHasUserNamespace(filename) {
-  return filename.startsWith("user:");
-}
-export {
-  InMemoryArtifactService
-};

package/dist/esm/auth/auth_credential.js

@@ -1,16 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-var AuthCredentialTypes = /* @__PURE__ */ ((AuthCredentialTypes2) => {
-  AuthCredentialTypes2["API_KEY"] = "apiKey";
-  AuthCredentialTypes2["HTTP"] = "http";
-  AuthCredentialTypes2["OAUTH2"] = "oauth2";
-  AuthCredentialTypes2["OPEN_ID_CONNECT"] = "openIdConnect";
-  AuthCredentialTypes2["SERVICE_ACCOUNT"] = "serviceAccount";
-  return AuthCredentialTypes2;
-})(AuthCredentialTypes || {});
-export {
-  AuthCredentialTypes
-};

package/dist/esm/auth/auth_handler.js

@@ -1,62 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class AuthHandler {
-  constructor(authConfig) {
-    this.authConfig = authConfig;
-  }
-  getAuthResponse(state) {
-    const credentialKey = "temp:" + this.authConfig.credentialKey;
-    return state.get(credentialKey);
-  }
-  generateAuthRequest() {
-    var _a, _b;
-    const authSchemeType = this.authConfig.authScheme.type;
-    if (!["oauth2", "openIdConnect"].includes(authSchemeType)) {
-      return this.authConfig;
-    }
-    if ((_b = (_a = this.authConfig.exchangedAuthCredential) == null ? void 0 : _a.oauth2) == null ? void 0 : _b.authUri) {
-      return this.authConfig;
-    }
-    if (!this.authConfig.rawAuthCredential) {
-      throw new Error(`Auth Scheme ${authSchemeType} requires authCredential.`);
-    }
-    if (!this.authConfig.rawAuthCredential.oauth2) {
-      throw new Error(
-        `Auth Scheme ${authSchemeType} requires oauth2 in authCredential.`
-      );
-    }
-    if (this.authConfig.rawAuthCredential.oauth2.authUri) {
-      return {
-        credentialKey: this.authConfig.credentialKey,
-        authScheme: this.authConfig.authScheme,
-        rawAuthCredential: this.authConfig.rawAuthCredential,
-        exchangedAuthCredential: this.authConfig.rawAuthCredential
-      };
-    }
-    if (!this.authConfig.rawAuthCredential.oauth2.clientId || !this.authConfig.rawAuthCredential.oauth2.clientSecret) {
-      throw new Error(`Auth Scheme ${authSchemeType} requires both clientId and clientSecret in authCredential.oauth2.`);
-    }
-    return {
-      credentialKey: this.authConfig.credentialKey,
-      authScheme: this.authConfig.authScheme,
-      rawAuthCredential: this.authConfig.rawAuthCredential,
-      exchangedAuthCredential: this.generateAuthUri()
-    };
-  }
-  /**
-   * Generates an response containing the auth uri for user to sign in.
-   *
-   * @return An AuthCredential object containing the auth URI and state.
-   * @throws Error: If the authorization endpoint is not configured in the
-   *     auth scheme.
-   */
-  generateAuthUri() {
-    return this.authConfig.rawAuthCredential;
-  }
-}
-export {
-  AuthHandler
-};

package/dist/esm/auth/auth_schemes.js

@@ -1,31 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-var OAuthGrantType = /* @__PURE__ */ ((OAuthGrantType2) => {
-  OAuthGrantType2["CLIENT_CREDENTIALS"] = "client_credentials";
-  OAuthGrantType2["AUTHORIZATION_CODE"] = "authorization_code";
-  OAuthGrantType2["IMPLICIT"] = "implicit";
-  OAuthGrantType2["PASSWORD"] = "password";
-  return OAuthGrantType2;
-})(OAuthGrantType || {});
-function getOAuthGrantTypeFromFlow(flow) {
-  if (flow.clientCredentials) {
-    return "client_credentials" /* CLIENT_CREDENTIALS */;
-  }
-  if (flow.authorizationCode) {
-    return "authorization_code" /* AUTHORIZATION_CODE */;
-  }
-  if (flow.implicit) {
-    return "implicit" /* IMPLICIT */;
-  }
-  if (flow.password) {
-    return "password" /* PASSWORD */;
-  }
-  return void 0;
-}
-export {
-  OAuthGrantType,
-  getOAuthGrantTypeFromFlow
-};

package/dist/esm/auth/auth_tool.js

@@ -1,5 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */

package/dist/esm/auth/credential_service/base_credential_service.js

@@ -1,5 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */

package/dist/esm/auth/credential_service/in_memory_credential_service.js

@@ -1,33 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class InMemoryCredentialService {
-  constructor() {
-    this.credentials = {};
-  }
-  loadCredential(authConfig, toolContext) {
-    const credentialBucket = this.getBucketForCurrentContext(toolContext);
-    return Promise.resolve(credentialBucket[authConfig.credentialKey]);
-  }
-  async saveCredential(authConfig, toolContext) {
-    const credentialBucket = this.getBucketForCurrentContext(toolContext);
-    if (authConfig.exchangedAuthCredential) {
-      credentialBucket[authConfig.credentialKey] = authConfig.exchangedAuthCredential;
-    }
-  }
-  getBucketForCurrentContext(toolContext) {
-    const { appName, userId } = toolContext.invocationContext.session;
-    if (!this.credentials[appName]) {
-      this.credentials[appName] = {};
-    }
-    if (!this.credentials[appName][userId]) {
-      this.credentials[appName][userId] = {};
-    }
-    return this.credentials[appName][userId];
-  }
-}
-export {
-  InMemoryCredentialService
-};

package/dist/esm/auth/exchanger/base_credential_exchanger.js

@@ -1,10 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class CredentialExchangeError extends Error {
-}
-export {
-  CredentialExchangeError
-};

package/dist/esm/auth/exchanger/credential_exchanger_registry.js

@@ -1,29 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class CredentialExchangerRegistry {
-  constructor() {
-    this.exchangers = {};
-  }
-  /**
-   * Register an exchanger instance for a credential type.
-   * @param credentialType - The credential type to register for.
-   * @param exchangerInstance - The exchanger instance to register.
-   */
-  register(credentialType, exchangerInstance) {
-    this.exchangers[credentialType] = exchangerInstance;
-  }
-  /**
-   * Get the exchanger instance for a credential type.
-   * @param credentialType - The credential type to get exchanger for.
-   * @returns The exchanger instance if registered, undefined otherwise.
-   */
-  getExchanger(credentialType) {
-    return this.exchangers[credentialType];
-  }
-}
-export {
-  CredentialExchangerRegistry
-};

package/dist/esm/code_executors/base_code_executor.js

@@ -1,46 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-class BaseCodeExecutor {
-  constructor() {
-    /**
-     * If true, extract and process data files from the model request
-     * and attach them to the code executor.
-     *
-     * Supported data file MimeTypes are [text/csv].
-     * Default to false.
-     */
-    this.optimizeDataFile = false;
-    /**
-     * Whether the code executor is stateful. Default to false.
-     */
-    this.stateful = false;
-    /**
-     * The number of attempts to retry on consecutive code execution errors.
-     * Default to 2.
-     */
-    this.errorRetryAttempts = 2;
-    /**
-     * The list of the enclosing delimiters to identify the code blocks.
-     * For example, the delimiter('```python\\n', '\\n```') can be  used to
-     * identify code blocks with the following format::
-     *
-     * ```python
-     *  print("hello")
-     * ```
-     */
-    this.codeBlockDelimiters = [
-      ["```tool_code\n", "\n```"],
-      ["```python\n", "\n```"]
-    ];
-    /**
-     * The delimiters to format the code execution result.
-     */
-    this.executionResultDelimiters = ["```tool_output\n", "\n```"];
-  }
-}
-export {
-  BaseCodeExecutor
-};