feat: ord plugin compat

CHANGELOG.md

@@ -9,6 +9,12 @@
 ### Changed
 
 - Reverted AI Core content filtering changes since they are not live on all BTP landscapes
+- Dropped support for `@agent.card`, as it was never fully integrated; Resolving agent-card info from `{service}.cds` annotations and `AGENTS.md` (relative path or `@agent.directory`) exclusively
+- Dropped support for `@Core.Links`, as incompatible with mt scenarios
+
+### Added
+
+- Register A2A AgentCard compile target via `lib/api.cjs`, as per `@cap-js/ord` plugin convention
 
 ## Version 0.9.9 - 2026-10-23
 

cds-plugin.js

@@ -4,8 +4,9 @@ const LOG = cds.log("agents")
 import registerDefaultAgentHandlers from "./srv/handlers/index.js"
 import { patchLangChain } from "./lib/telemetry/tracing.js"
 import { slugified } from "./lib/utils/utils.js"
-import cds_compile_to_a2a from "./lib/compile.js"
-cds.compile.to.a2a = cds_compile_to_a2a
+import { registerCompileTargets } from "./lib/api.cjs"
+
+registerCompileTargets()
 
 // Enable doc comments in CSN for agent card generation
 cds.env.cdsc = { ...cds.env.cdsc, docComment: true }

lib/api.cjs

@@ -0,0 +1,25 @@
+const cds = require("@sap/cds")
+
+const TARGETS = ["a2a"]
+
+function _lazyRegisterCompileTargets() {
+  const { default: compile } = require("./compile.js")
+  TARGETS.forEach((target) =>
+    Object.defineProperty(this, target, {
+      value: compile,
+      configurable: true,
+    }),
+  )
+  return compile
+}
+
+const registerCompileTargets = () => {
+  TARGETS.forEach((target) =>
+    Object.defineProperty(cds.compile.to, target, {
+      get: _lazyRegisterCompileTargets,
+      configurable: true,
+    }),
+  )
+}
+
+module.exports = { registerCompileTargets }

lib/compile.js

@@ -1,11 +1,11 @@
 import cds from "@sap/cds"
-import { getFilteredEntities, getFilteredActions } from "@cap-js/mcp/lib/utils/tools-shared.js"
-import { getDescription, slugified } from "./utils/utils.js"
-import { buildAgentCard } from "./protocol/agent-card.js"
+import { slugified } from "./utils/utils.js"
+import { compileAgentCard } from "./protocol/agent-card.js"
+import { resolveAgentDir } from "./utils/markdown.js"
 
 const A2A_BASE_PATH = "/a2a"
 
-function cds_compile_to_a2a(csn, options = {}) {
+function cds_compile_to_a2a(csn, options = { service: undefined, hostUrl: undefined }) {
   const model = cds.linked(csn)
   const services = model.services
 
@@ -20,32 +20,27 @@ function cds_compile_to_a2a(csn, options = {}) {
     )
   }
 
-  let def
+  let srv
   if (!options.service) {
-    def = services[0]
+    srv = services[0]
   } else {
-    def = services.find((s) => s.name === options.service)
-    if (!def) {
+    srv = services.find((s) => s.name === options.service)
+    if (!srv) {
       throw new Error(`No service definition matching ${options.service} found in given model(s).`)
     }
   }
 
-  // Build service path — respect @path annotation, otherwise use slugified name
-  const customPath = def["@path"]
-  const servicePath = customPath ? customPath.replace(/^\//, "") : slugified(def.name)
-
-  // If service is behind a proxy, @Core.Links with rel='via' provides the proxy URL
-  const viaLink = def["@Core.Links"]?.find((l) => l.rel === "via")
-  const url = viaLink?.href ?? `https://HOST${A2A_BASE_PATH}/${servicePath}`
-
-  const agentCard = buildAgentCard({
-    name: def.name,
-    description: getDescription(def, "en") || `Agent for ${def.name}`,
-    entities: getFilteredEntities(def),
-    actions: getFilteredActions(def),
-    url,
-    streaming: true,
-  })
+  const customPath = srv["@path"]?.replace(/^\//, "")
+  const servicePath = customPath ? customPath : slugified(srv.name)
+
+  let hostUrl = (options.hostUrl ?? "").trim()
+  if (hostUrl.length > 0 && !/^https?:\/\//i.test(hostUrl)) hostUrl = "https://" + hostUrl
+  hostUrl = hostUrl.replace(/\/+$/, "")
+
+  const agentDir = resolveAgentDir(srv)
+  const url = `${hostUrl}${A2A_BASE_PATH}/${servicePath}`
+
+  const agentCard = compileAgentCard(srv, agentDir, url)
 
   if (process.stdout.isTTY || options.as === "json") return agentCard
   else return JSON.stringify(agentCard, null, 2)

lib/index.js

@@ -2,8 +2,8 @@ import cds from "@sap/cds"
 import express from "express"
 import { AsyncLocalStorage } from "node:async_hooks"
 
-import { generateAgentCard } from "./protocol/agent-card.js"
-import { resolveAgentDir, resolveAgentCardPath } from "./utils/markdown.js"
+import { compileAgentCard } from "./protocol/agent-card.js"
+import { resolveAgentDir } from "./utils/markdown.js"
 import { CdsTaskStore } from "./protocol/persistence/task-store.js"
 import { CdsPushNotificationStore } from "./protocol/persistence/push-notification-store.js"
 import { CdsPushNotificationSender } from "./protocol/push-notification-sender.js"
@@ -103,16 +103,7 @@ export default function A2AProtocolAdapter(srv, options = {}) {
     return res.end()
   })
 
-  const resolved = {
-    agentDir: resolveAgentDir(srv),
-    agentCardPath: resolveAgentCardPath(srv),
-  }
-
-  const agentCard = generateAgentCard(srv, options, resolved)
-
-  // If service is behind a proxy, @Core.Links with rel='via' provides the proxy URL
-  const viaLink = srv.definition["@Core.Links"]?.find((l) => l.rel === "via")
-  const proxyUrl = viaLink?.href
+  const agentCard = compileAgentCard(srv.definition, resolveAgentDir(srv))
 
   // Add "Agent Card" and "Preview" links to the CDS index page
   const linkProviders = (srv.$linkProviders ??= [])
@@ -164,26 +155,21 @@ export default function A2AProtocolAdapter(srv, options = {}) {
   }
 
   router.get("/.well-known/agent-card.json", (req, res) => {
+    // Determine tenant specific URL the card should include
     const proto = req.headers["x-forwarded-proto"]?.split(",")[0].trim() || req.protocol
-    const url = proxyUrl || `${proto}://${req.get("host")}${req.baseUrl}`
-    // Regenerate agent card when feature toggles are active (annotations may differ)
-    let card
-    if (cds.context?.features && Object.keys(cds.context.features).length > 0) {
-      const featureResolved = {
-        agentDir: resolveAgentDir(srv),
-        agentCardPath: resolveAgentCardPath(srv),
-      }
-      card = { ...generateAgentCard(srv, options, featureResolved), url }
-    } else {
-      card = { ...agentCard, url }
-    }
-    if (card.supportedInterfaces) {
-      card.supportedInterfaces = card.supportedInterfaces.map((iface) => ({
-        ...iface,
-        url,
-      }))
-    }
-    res.json(card)
+    const url = `${proto}://${req.get("host")}${req.baseUrl}`
+
+    const srvModel = cds.context?.model?.definitions?.[srv.name]
+
+    // Regenerate the agent card when feature toggles are active
+    const card =
+      srvModel && Object.keys(cds.context?.features ?? {}).length
+        ? compileAgentCard(srvModel, resolveAgentDir(srv), url)
+        : agentCard
+
+    const additionalInterfaces = card.additionalInterfaces.map((iface) => ({ ...iface, url }))
+
+    res.json({ ...card, url, additionalInterfaces })
   })
 
   if (cds.env?.server?.index) {