@softactivate/adk 1.1.0

package/dist/web/utils/simple_zod_to_json.js

@@ -0,0 +1,123 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Type } from "@google/genai";
+import {
+  zodToJsonSchema as toJSONSchemaV3
+} from "zod-to-json-schema";
+import { toJSONSchema as toJSONSchemaV4 } from "zod/v4";
+function isZodSchema(obj) {
+  return obj !== null && typeof obj === "object" && "parse" in obj && typeof obj.parse === "function" && "safeParse" in obj && typeof obj.safeParse === "function";
+}
+function isZodV3Schema(obj) {
+  return isZodSchema(obj) && !("_zod" in obj);
+}
+function isZodV4Schema(obj) {
+  return isZodSchema(obj) && "_zod" in obj;
+}
+function getZodTypeName(schema) {
+  var _a, _b;
+  const schemaAny = schema;
+  if ((_a = schemaAny._def) == null ? void 0 : _a.typeName) {
+    return schemaAny._def.typeName;
+  }
+  const zod4Type = (_b = schemaAny._def) == null ? void 0 : _b.type;
+  if (typeof zod4Type === "string" && zod4Type) {
+    return "Zod" + zod4Type.charAt(0).toUpperCase() + zod4Type.slice(1);
+  }
+  return void 0;
+}
+function isZodObject(obj) {
+  return isZodSchema(obj) && getZodTypeName(obj) === "ZodObject";
+}
+function zodObjectToSchema(schema) {
+  if (!isZodObject(schema)) {
+    throw new Error("Expected a Zod Object");
+  }
+  if (isZodV4Schema(schema)) {
+    return toJSONSchemaV4(schema, {
+      target: "openapi-3.0",
+      io: "input",
+      override: (ctx) => {
+        var _a;
+        const { jsonSchema } = ctx;
+        if (jsonSchema.additionalProperties !== void 0) {
+          delete jsonSchema.additionalProperties;
+        }
+        if (jsonSchema.readOnly !== void 0) {
+          delete jsonSchema.readOnly;
+        }
+        if (jsonSchema.maxItems !== void 0) {
+          jsonSchema.maxItems = jsonSchema.maxItems.toString();
+        }
+        if (jsonSchema.format === "email" || jsonSchema.format === "uuid") {
+          delete jsonSchema.pattern;
+        }
+        if (jsonSchema.minItems !== void 0) {
+          jsonSchema.minItems = jsonSchema.minItems.toString();
+        }
+        if (jsonSchema.minLength !== void 0) {
+          jsonSchema.minLength = jsonSchema.minLength.toString();
+        }
+        if (jsonSchema.maxLength !== void 0) {
+          jsonSchema.maxLength = jsonSchema.maxLength.toString();
+        }
+        if (((_a = jsonSchema.enum) == null ? void 0 : _a.length) === 1 && jsonSchema.enum[0] === null) {
+          jsonSchema.type = Type.NULL;
+          delete jsonSchema.enum;
+        }
+        if (jsonSchema.type !== void 0) {
+          jsonSchema.type = jsonSchema.type.toUpperCase();
+        }
+      }
+    });
+  }
+  if (isZodV3Schema(schema)) {
+    return toJSONSchemaV3(schema, {
+      target: "openApi3",
+      emailStrategy: "format:email",
+      postProcess: (jsonSchema) => {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (!jsonSchema) {
+          return;
+        }
+        if (jsonSchema.additionalProperties !== void 0) {
+          delete jsonSchema.additionalProperties;
+        }
+        if (jsonSchema.maxItems !== void 0) {
+          jsonSchema.maxItems = (_a = jsonSchema.maxItems) == null ? void 0 : _a.toString();
+        }
+        if (jsonSchema.minItems !== void 0) {
+          jsonSchema.minItems = (_b = jsonSchema.minItems) == null ? void 0 : _b.toString();
+        }
+        if (jsonSchema.minLength !== void 0) {
+          jsonSchema.minLength = (_c = jsonSchema.minLength) == null ? void 0 : _c.toString();
+        }
+        if (jsonSchema.maxLength !== void 0) {
+          jsonSchema.maxLength = (_d = jsonSchema.maxLength) == null ? void 0 : _d.toString();
+        }
+        if (((_e = jsonSchema.enum) == null ? void 0 : _e.length) === 1 && jsonSchema.enum[0] === "null") {
+          jsonSchema.type = Type.NULL;
+          delete jsonSchema.enum;
+        }
+        if (jsonSchema.type === "integer" && jsonSchema.format !== "int64") {
+          (_f = jsonSchema.minimum) != null ? _f : jsonSchema.minimum = Number.MIN_SAFE_INTEGER;
+          (_g = jsonSchema.maximum) != null ? _g : jsonSchema.maximum = Number.MAX_SAFE_INTEGER;
+        }
+        if (jsonSchema.type !== void 0) {
+          jsonSchema.type = jsonSchema.type.toUpperCase();
+        }
+        return jsonSchema;
+      }
+    });
+  }
+  throw new Error("Unsupported Zod schema version.");
+}
+export {
+  isZodObject,
+  zodObjectToSchema
+};

package/dist/web/utils/streaming_utils.js

@@ -0,0 +1,322 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __await = function(promise, isYieldStar) {
+  this[0] = promise;
+  this[1] = isYieldStar;
+};
+var __asyncGenerator = (__this, __arguments, generator) => {
+  var resume = (k, v, yes, no) => {
+    try {
+      var x = generator[k](v), isAwait = (v = x.value) instanceof __await, done = x.done;
+      Promise.resolve(isAwait ? v[0] : v).then((y) => isAwait ? resume(k === "return" ? k : "next", v[1] ? { done: y.done, value: y.value } : y, yes, no) : yes({ value: y, done })).catch((e) => resume("throw", e, yes, no));
+    } catch (e) {
+      no(e);
+    }
+  }, method = (k) => it[k] = (x) => new Promise((yes, no) => resume(k, x, yes, no)), it = {};
+  return generator = generator.apply(__this, __arguments), it[__knownSymbol("asyncIterator")] = () => it, method("next"), method("throw"), method("return"), it;
+};
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  FinishReason
+} from "@google/genai";
+import { JSONPath } from "jsonpath-plus";
+import { generateClientFunctionCallId } from "../agents/functions.js";
+import { FeatureName, isFeatureEnabled } from "../features/feature_registry.js";
+import { createLlmResponse } from "../models/llm_response.js";
+class StreamingResponseAggregator {
+  constructor(isProgressiveMode = isFeatureEnabled(
+    FeatureName.PROGRESSIVE_SSE_STREAMING
+  )) {
+    this.isProgressiveMode = isProgressiveMode;
+    // For non-progressive SSE streaming mode
+    this.text = "";
+    this.thoughtText = "";
+    // For progressive SSE streaming mode: accumulate parts in order
+    this.partsSequence = [];
+    this.currentTextBuffer = "";
+    this.currentFcArgs = {};
+  }
+  flushTextBufferToSequence() {
+    if (!this.currentTextBuffer) {
+      return;
+    }
+    if (this.currentTextIsThought) {
+      this.partsSequence.push({
+        text: this.currentTextBuffer,
+        thought: true
+      });
+    } else {
+      this.partsSequence.push({
+        text: this.currentTextBuffer
+      });
+    }
+    this.currentTextBuffer = "";
+    this.currentTextIsThought = void 0;
+  }
+  getValueFromPartialArg(partialArg, jsonPath) {
+    let value = null;
+    let hasValue = false;
+    const stringValue = partialArg.stringValue;
+    const numberValue = partialArg.numberValue;
+    const boolValue = partialArg.boolValue;
+    const nullValue = partialArg.nullValue;
+    if (stringValue !== void 0) {
+      const stringChunk = stringValue;
+      hasValue = true;
+      const pathParts = JSONPath.toPathArray(jsonPath).filter(
+        (p) => p !== "$" && p !== "$["
+      );
+      let existingValue = this.currentFcArgs;
+      for (const part of pathParts) {
+        if (existingValue && typeof existingValue === "object" && part in existingValue) {
+          existingValue = existingValue[part];
+        } else {
+          existingValue = void 0;
+          break;
+        }
+      }
+      if (typeof existingValue === "string") {
+        value = existingValue + stringChunk;
+      } else {
+        value = stringChunk;
+      }
+    } else if (numberValue !== void 0) {
+      value = numberValue;
+      hasValue = true;
+    } else if (boolValue !== void 0) {
+      value = boolValue;
+      hasValue = true;
+    } else if (nullValue !== void 0) {
+      value = null;
+      hasValue = true;
+    }
+    return [value, hasValue];
+  }
+  setValueByJsonPath(jsonPath, value) {
+    const pathParts = JSONPath.toPathArray(jsonPath).filter(
+      (p) => p !== "$" && p !== "$["
+    );
+    let current = this.currentFcArgs;
+    for (let i = 0; i < pathParts.length - 1; i++) {
+      const part = pathParts[i];
+      if (!(part in current)) {
+        current[part] = {};
+      }
+      current = current[part];
+    }
+    if (pathParts.length > 0) {
+      current[pathParts[pathParts.length - 1]] = value;
+    }
+  }
+  flushFunctionCallToSequence() {
+    var _a;
+    if (this.currentFcName) {
+      const fcPart = {
+        functionCall: {
+          name: this.currentFcName,
+          args: JSON.parse(JSON.stringify(this.currentFcArgs)),
+          id: (_a = this.currentFcId) != null ? _a : generateClientFunctionCallId()
+        }
+      };
+      if (this.currentThoughtSignature) {
+        fcPart.thoughtSignature = this.currentThoughtSignature.toString();
+      }
+      this.partsSequence.push(fcPart);
+      this.currentFcName = void 0;
+      this.currentFcArgs = {};
+      this.currentFcId = void 0;
+      this.currentThoughtSignature = void 0;
+    }
+  }
+  processStreamingFunctionCall(fc) {
+    if (fc.name) {
+      this.currentFcName = fc.name;
+    }
+    if (fc.id) {
+      this.currentFcId = fc.id;
+    }
+    for (const partialArg of fc.partialArgs || []) {
+      const jsonPath = partialArg.jsonPath;
+      if (!jsonPath) {
+        continue;
+      }
+      const [value, hasValue] = this.getValueFromPartialArg(
+        partialArg,
+        jsonPath
+      );
+      if (hasValue) {
+        this.setValueByJsonPath(jsonPath, value);
+      }
+    }
+    if (!fc.willContinue) {
+      this.flushTextBufferToSequence();
+      this.flushFunctionCallToSequence();
+    }
+  }
+  processFunctionCallPart(part) {
+    const fc = part.functionCall;
+    if (!fc) {
+      return;
+    }
+    if (part.thoughtSignature) {
+      this.lastThoughtSignature = part.thoughtSignature;
+    } else if (this.lastThoughtSignature) {
+      part.thoughtSignature = this.lastThoughtSignature.toString();
+    }
+    if (fc.partialArgs || fc.willContinue) {
+      if (!fc.id && !this.currentFcId) {
+        fc.id = generateClientFunctionCallId();
+      }
+      if (part.thoughtSignature && !this.currentThoughtSignature) {
+        this.currentThoughtSignature = part.thoughtSignature;
+      }
+      this.processStreamingFunctionCall(fc);
+    } else {
+      if (fc.name) {
+        if (!fc.id) {
+          fc.id = generateClientFunctionCallId();
+        }
+        this.flushTextBufferToSequence();
+        this.partsSequence.push(part);
+      }
+    }
+  }
+  processResponse(response) {
+    return __asyncGenerator(this, null, function* () {
+      var _a, _b, _c;
+      this.response = response;
+      const llmResponse = createLlmResponse(response);
+      this.usageMetadata = llmResponse.usageMetadata;
+      if (llmResponse.groundingMetadata) {
+        this.groundingMetadata = llmResponse.groundingMetadata;
+      }
+      if (llmResponse.citationMetadata) {
+        this.citationMetadata = llmResponse.citationMetadata;
+      }
+      if (llmResponse.finishReason) {
+        this.finishReason = llmResponse.finishReason;
+      }
+      if (llmResponse.content && llmResponse.content.parts) {
+        for (const part of llmResponse.content.parts) {
+          if (part.thoughtSignature) {
+            this.lastThoughtSignature = part.thoughtSignature;
+          } else if (part.functionCall && this.lastThoughtSignature) {
+            part.thoughtSignature = this.lastThoughtSignature.toString();
+          }
+        }
+      }
+      if (this.isProgressiveMode) {
+        if (llmResponse.content && llmResponse.content.parts) {
+          for (const part of llmResponse.content.parts) {
+            if (part.text) {
+              const isThought = (_a = part.thought) != null ? _a : false;
+              if (this.currentTextBuffer && isThought !== this.currentTextIsThought) {
+                this.flushTextBufferToSequence();
+              }
+              if (!this.currentTextBuffer) {
+                this.currentTextIsThought = isThought;
+              }
+              this.currentTextBuffer += part.text;
+            } else if (part.functionCall) {
+              this.processFunctionCallPart(part);
+            } else {
+              this.flushTextBufferToSequence();
+              this.partsSequence.push(part);
+            }
+          }
+        }
+        llmResponse.partial = true;
+        yield llmResponse;
+        return;
+      }
+      if (llmResponse.content && llmResponse.content.parts && typeof ((_b = llmResponse.content.parts[0]) == null ? void 0 : _b.text) === "string") {
+        const part0 = llmResponse.content.parts[0];
+        const partText = part0.text || "";
+        if (part0.thought) {
+          this.thoughtText += partText;
+        } else {
+          this.text += partText;
+        }
+        llmResponse.partial = true;
+      } else if ((this.thoughtText || this.text) && (!llmResponse.content || !llmResponse.content.parts || !((_c = llmResponse.content.parts[0]) == null ? void 0 : _c.inlineData))) {
+        const parts = [];
+        if (this.thoughtText) {
+          parts.push({ text: this.thoughtText, thought: true });
+        }
+        if (this.text) {
+          parts.push({ text: this.text });
+        }
+        yield {
+          content: {
+            role: "model",
+            parts
+          },
+          usageMetadata: llmResponse.usageMetadata,
+          partial: false
+        };
+        this.thoughtText = "";
+        this.text = "";
+      }
+      yield llmResponse;
+    });
+  }
+  close() {
+    var _a, _b, _c, _d, _e, _f;
+    if (this.isProgressiveMode) {
+      this.flushTextBufferToSequence();
+      this.flushFunctionCallToSequence();
+      const finalParts = this.partsSequence;
+      if (finalParts.length === 0) {
+        return;
+      }
+      const candidate = (_b = (_a = this.response) == null ? void 0 : _a.candidates) == null ? void 0 : _b[0];
+      const finishReason = (_c = this.finishReason) != null ? _c : candidate == null ? void 0 : candidate.finishReason;
+      return {
+        content: {
+          role: "model",
+          parts: finalParts
+        },
+        groundingMetadata: this.groundingMetadata,
+        citationMetadata: this.citationMetadata,
+        errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
+        errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate == null ? void 0 : candidate.finishMessage,
+        usageMetadata: this.usageMetadata,
+        finishReason,
+        partial: false
+      };
+    }
+    if (this.text || this.thoughtText) {
+      const parts = [];
+      if (this.thoughtText) {
+        parts.push({ text: this.thoughtText, thought: true });
+      }
+      if (this.text) {
+        parts.push({ text: this.text });
+      }
+      const candidate = (_e = (_d = this.response) == null ? void 0 : _d.candidates) == null ? void 0 : _e[0];
+      const finishReason = (_f = this.finishReason) != null ? _f : candidate == null ? void 0 : candidate.finishReason;
+      return {
+        content: {
+          role: "model",
+          parts
+        },
+        groundingMetadata: this.groundingMetadata,
+        citationMetadata: this.citationMetadata,
+        errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
+        errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate == null ? void 0 : candidate.finishMessage,
+        usageMetadata: this.usageMetadata,
+        finishReason,
+        partial: false
+      };
+    }
+    return void 0;
+  }
+}
+export {
+  StreamingResponseAggregator
+};

package/dist/web/utils/variant_utils.js

@@ -0,0 +1,20 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getBooleanEnvVar } from "./env_aware_utils.js";
+var GoogleLLMVariant = /* @__PURE__ */ ((GoogleLLMVariant2) => {
+  GoogleLLMVariant2["VERTEX_AI"] = "VERTEX_AI";
+  GoogleLLMVariant2["GEMINI_API"] = "GEMINI_API";
+  return GoogleLLMVariant2;
+})(GoogleLLMVariant || {});
+function getGoogleLlmVariant() {
+  return getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI") ? "VERTEX_AI" /* VERTEX_AI */ : "GEMINI_API" /* GEMINI_API */;
+}
+export {
+  GoogleLLMVariant,
+  getGoogleLlmVariant
+};

package/dist/web/version.js

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

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@softactivate/adk",
+  "version": "1.1.0",
+  "description": "Google ADK JS",
+  "author": "Google",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/google/adk-js"
+  },
+  "files": [
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "dist"
+  ],
+  "type": "module",
+  "typings": "./dist/types/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "browser": "./dist/web/index_web.js",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "clean:all": "npm run clean && rm -rf node_modules",
+    "rebuild": "npm run clean:all && npm install && npm run build",
+    "build": "tsc --emitDeclarationOnly && node ./build.js",
+    "build:bundle": "tsc --emitDeclarationOnly && node ./build.js --bundle",
+    "build:watch": "concurrently \"tsc --noEmit --watch --preserveWatchOutput\" \"node ./build.js --watch\"",
+    "test": "vitest",
+    "lint": "eslint 'src/**/*.ts'",
+    "format": "prettier --write 'src/**/*.ts'",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.10",
+    "@google-cloud/opentelemetry-cloud-monitoring-exporter": "^0.21.0",
+    "@google-cloud/opentelemetry-cloud-trace-exporter": "^3.0.0",
+    "@google-cloud/storage": "^7.17.1",
+    "@google/genai": "^1.37.0",
+    "@mikro-orm/core": "^6.6.10",
+    "@mikro-orm/reflection": "^6.6.6",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@opentelemetry/api": "1.9.0",
+    "@opentelemetry/api-logs": "^0.205.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.205.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
+    "@opentelemetry/resource-detector-gcp": "^0.40.0",
+    "@opentelemetry/resources": "^2.1.0",
+    "@opentelemetry/sdk-logs": "^0.205.0",
+    "@opentelemetry/sdk-metrics": "^2.1.0",
+    "@opentelemetry/sdk-trace-base": "^2.1.0",
+    "@opentelemetry/sdk-trace-node": "^2.1.0",
+    "express": "^4.22.1",
+    "google-auth-library": "^10.3.0",
+    "js-yaml": "^4.1.1",
+    "jsonpath-plus": "^10.4.0",
+    "lodash-es": "^4.18.1",
+    "winston": "^3.19.0",
+    "zod": "^4.2.1",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "devDependencies": {
+    "@mikro-orm/sqlite": "^6.6.6",
+    "@types/express": "^4.17.25",
+    "@types/lodash-es": "^4.17.12",
+    "openapi-types": "^12.1.3"
+  },
+  "peerDependencies": {
+    "@mikro-orm/mariadb": "^6.6.6",
+    "@mikro-orm/mssql": "^6.6.6",
+    "@mikro-orm/mysql": "^6.6.6",
+    "@mikro-orm/postgresql": "^6.6.6",
+    "@mikro-orm/sqlite": "^6.6.6"
+  }
+}