@cap-js/agents 0.0.0 → 0.9.2

package/package.json

@@ -1,4 +1,227 @@
 {
   "name": "@cap-js/agents",
-  "version": "0.0.0"
-}
+  "version": "0.9.2",
+  "description": "CDS plugin for building agents",
+  "author": "SAP SE (https://www.sap.com)",
+  "license": "Apache-2.0",
+  "homepage": "https://cap.cloud.sap/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cap-js/agents.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json",
+    "./cds-plugin": "./cds-plugin.js",
+    "./index.cds": "./index.cds",
+    "./lib/models/*": "./lib/models/*.js",
+    "./srv/langgraph-executor-srv": "./srv/langgraph-executor-srv.js",
+    "./srv/*": "./srv/*",
+    "./lib/*": "./lib/*"
+  },
+  "main": "index.js",
+  "scripts": {
+    "lint": "npx eslint .",
+    "test": "CDS_ENV=test npx vitest run --config vitest.config.js",
+    "test:hybrid": "CDS_ENV=test,hybrid,tracing cds bind --exec -- npx vitest run --config vitest.config.hybrid.js",
+    "test:mtx": "CDS_ENV=test npx vitest run --config vitest.config.js tests/integration/mtx.test.js",
+    "watch:sample": "cds w tests/projects/bookshop",
+    "watch:hybrid": "DEBUG=agents cds bind --exec -- cds w tests/projects/bookshop",
+    "watch:with-claude": "cds w tests/projects/bookshop --profile with-claude",
+    "watch:deep-agent": "cds w tests/projects/deep-agent --profile hybrid",
+    "prettier": "npx -y prettier@3 --write .",
+    "prettier:check": "npx -y prettier@3 --check ."
+  },
+  "files": [
+    "index.js",
+    "index.cds",
+    "lib",
+    "srv",
+    "cds-plugin.js",
+    "_i18n"
+  ],
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.12",
+    "@cap-js/attachments": "^4",
+    "@cap-js/mcp": "^1.4",
+    "@langchain/anthropic": "^1.5.1",
+    "@langchain/core": "^1",
+    "@langchain/langgraph": "^1",
+    "@langchain/mcp-adapters": "^1.1.3",
+    "@sap-ai-sdk/langchain": "^2.13.0",
+    "@sap-ai-sdk/orchestration": "^2.11.0",
+    "@sap-cloud-sdk/connectivity": "^4.7.0",
+    "@sap-cloud-sdk/resilience": "^4.7.0",
+    "deepagents": "^1.10.0",
+    "langchain": "^1.5.0",
+    "marked": "^18",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@cap-js/cds-test": "^1",
+    "@cap-js/sqlite": "^3",
+    "@sap/cds-mtxs": "^4",
+    "@toon-format/toon": ">=2.3",
+    "deepagents": "^1.10.2"
+  },
+  "peerDependencies": {
+    "@cap-js/audit-logging": ">=1",
+    "@cap-js/telemetry": ">=1",
+    "@sap/cds": ">=9"
+  },
+  "peerDependenciesMeta": {
+    "@cap-js/telemetry": {
+      "optional": true
+    },
+    "@cap-js/audit-logging": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "cds": {
+    "agents": {
+      "streaming": true,
+      "trace_langchain": true,
+      "mlflow": false,
+      "connect": "auto",
+      "retention": "30d",
+      "[development]": {
+        "pushNotifications": {
+          "allowedDomains": [
+            "127.0.0.1",
+            "localhost",
+            "cloud.sap"
+          ]
+        }
+      },
+      "[hybrid]": {
+        "pushNotifications": {
+          "allowedDomains": [
+            "127.0.0.1",
+            "localhost",
+            "cloud.sap"
+          ]
+        }
+      },
+      "pushNotifications": {
+        "allowedDomains": [
+          "cloud.sap"
+        ]
+      },
+      "persistAllCheckpointWrites": false,
+      "activeUsersInterval": "24h",
+      "params": {
+        "max_tokens": 4096,
+        "temperature": 0
+      },
+      "fileIO": {
+        "enabled": false,
+        "maxInputFileSizeBytes": 2097152,
+        "maxOutputFileSizeBytes": 10485760,
+        "defaultInputModes": [
+          "text/csv",
+          "application/json",
+          "text/plain",
+          "application/pdf",
+          "image/png",
+          "image/jpeg"
+        ],
+        "defaultOutputModes": [
+          "text/csv",
+          "application/json",
+          "text/plain",
+          "application/pdf",
+          "image/png",
+          "image/jpeg"
+        ]
+      },
+      "pool": {
+        "maxConcurrentTasks": 10,
+        "maxConcurrentTasksPerUser": 4,
+        "maxTasksPerHour": 100,
+        "maxTasksPerHourPerUser": 20,
+        "maxLLMTokensPerDay": 5000000,
+        "maxToolCallsPerHour": 1000,
+        "maxToolCallsPerTask": 50,
+        "maxLLMInvocationsPerTask": 50,
+        "maxLLMTokensPerTask": 200000,
+        "maxLLMCallTimeout": "120s",
+        "maxExecutionTimePerTask": "5min",
+        "timeoutGrace": "15s",
+        "maxIncomingMessageLength": 5000
+      }
+    },
+    "requires": {
+      "agents": {
+        "model": "@cap-js/agents"
+      },
+      "agent-push-notifications": {
+        "impl": "@cap-js/agents/srv/push-notification-srv.js"
+      },
+      "mlflow": {
+        "vcap": {
+          "label": "user-provided",
+          "name": "mlflow"
+        }
+      },
+      "kinds": {
+        "aicore": {
+          "impl": "@cap-js/agents/lib/models/aicore",
+          "model": "anthropic--claude-4.6-sonnet",
+          "contentFilter": true
+        },
+        "anthropic": {
+          "impl": "@cap-js/agents/lib/models/anthropic"
+        },
+        "llm-mock": {
+          "impl": "@cap-js/agents/lib/models/mock"
+        }
+      },
+      "[development]": {
+        "llm": "mock"
+      },
+      "[with-claude]": {
+        "llm": "anthropic"
+      },
+      "[hybrid]": {
+        "llm": "aicore"
+      },
+      "[production]": {
+        "llm": "aicore"
+      }
+    },
+    "protocols": {
+      "agent": {
+        "path": "/a2a",
+        "impl": "@cap-js/agents/lib/index.cjs"
+      }
+    },
+    "[agent-sidecar]": {
+      "server": {
+        "port": 4006
+      },
+      "[java]": {
+        "agent": {
+          "_javaHcqlCompat": true
+        }
+      }
+    }
+  },
+  "workspaces": [
+    "tests/projects/bookshop/",
+    "tests/projects/deep-agent/",
+    "tests/projects/mtx/mtx/sidecar/",
+    "tests/projects/telemetry-debug/",
+    "tests/projects/telemetry-v1/",
+    "tests/projects/travel/travel-agent/",
+    "tests/projects/travel/xflights/",
+    "tests/projects/travel/leisure-services/",
+    "tests/sidecar-projects/java-bookshop/agent/sidecar",
+    "tests/sidecar-projects/java-bookshop",
+    "tests/sidecar-projects/node-bookshop/agent/sidecar",
+    "tests/sidecar-projects/node-bookshop"
+  ]
+}

package/srv/graph-cache.js

@@ -0,0 +1,82 @@
+import cds from "@sap/cds"
+import crypto from "crypto"
+
+const LOG = cds.log("agents")
+
+/**
+ * Compute a stable hash key from cds.context.features.
+ * Returns empty string for empty/undefined features (default graph).
+ */
+export function hashFeatures(features) {
+  if (!features || typeof features !== "object") return ""
+  const keys = Object.keys(features).sort()
+  if (keys.length === 0) return ""
+  const normalized = JSON.stringify(keys.map((k) => [k, features[k]]))
+  return crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 16)
+}
+
+/**
+ * FIFO cache for compiled LangGraph executors keyed by feature vector hash.
+ * Eviction: oldest entry removed when full.
+ * Dedup: promise map prevents parallel builds for same key.
+ */
+export class GraphCache {
+  constructor() {
+    this._maxSize = cds.env.agents?.graphCacheSize || 20
+    this._cache = new Map()
+    this._building = new Map()
+  }
+
+  get size() {
+    return this._cache.size
+  }
+
+  has(key) {
+    return this._cache.has(key)
+  }
+
+  get(key) {
+    return this._cache.get(key)
+  }
+
+  set(key, executor) {
+    if (this._cache.size >= this._maxSize && !this._cache.has(key)) {
+      const oldest = this._cache.keys().next().value
+      this._cache.delete(oldest)
+      LOG.debug("Cache evicted", { key: oldest })
+    }
+    this._cache.set(key, executor)
+  }
+
+  async getOrBuild(key, factory) {
+    if (this._cache.has(key)) return this._cache.get(key)
+    if (this._building.has(key)) return this._building.get(key)
+
+    // Store promise BEFORE invoking factory to prevent TOCTOU race on same tick
+    let resolve, reject
+    const promise = new Promise((res, rej) => {
+      resolve = res
+      reject = rej
+    })
+    this._building.set(key, promise)
+
+    factory()
+      .then((executor) => {
+        this.set(key, executor)
+        resolve(executor)
+      })
+      .catch((err) => {
+        reject(err)
+      })
+      .finally(() => {
+        this._building.delete(key)
+      })
+
+    return promise
+  }
+
+  clear() {
+    this._cache.clear()
+    this._building.clear()
+  }
+}