{"_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","_rev":"5-b1259440f3435e8a969c3948218f19fd","name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","dist-tags":{"latest":"0.3.2"},"versions":{"0.1.0":{"name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","version":"0.1.0","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"license":"Apache-2.0","_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent@0.1.0","maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents#readme","bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"dist":{"shasum":"9b493a5f065740430bc285aae8303afe4d1b430e","tarball":"https://registry.npmjs.org/@acarmisc/backstage-plugin-ai-agents-backend-module-kagent/-/backstage-plugin-ai-agents-backend-module-kagent-0.1.0.tgz","fileCount":12,"integrity":"sha512-Qj7kOSCnxP1iSyLo7aS2XjwygZb9Ea2/wpVD1Xe5e0Bt1OLy2Rtw7dk1RBRZugSp0lflKujpoSPwoqqRYEmLgw==","signatures":[{"sig":"MEYCIQDnjiti47jbuxiNLefMU+C+TUXmB68UFC12EUR7upJS6QIhAJsEMv6JXJXnaVTKs1h1PamaonJPY4pqJ2q9NFXadmvI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@acarmisc%2fbackstage-plugin-ai-agents-backend-module-kagent@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":28318},"main":"dist/index.cjs.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.cjs.js"}},"gitHead":"d05eb1c1f29c02ad9fdd2b2a810b05ca9202e4c7","scripts":{"lint":"backstage-cli package lint","test":"tsc -p tsconfig.test.json && node --test --experimental-test-coverage dist-test/**/*.test.js dist-test/*.test.js","build":"node build.js && tsc -p tsconfig.json","prepack":"npm run build","postpack":"","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"},"backstage":{"role":"backend-plugin-module","pluginId":"ai-agents","pluginPackage":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent"},"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git"},"_npmVersion":"10.9.8","description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@backstage/config":"^1.3.0","@backstage/backend-plugin-api":"^1.9.1","@acarmisc/backstage-plugin-ai-agents-backend":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.0","typescript":"^5.9.3","@types/node":"^20.19.43","@backstage/cli":"^0.36.2"},"_npmOperationalInternal":{"tmp":"tmp/backstage-plugin-ai-agents-backend-module-kagent_0.1.0_1787654569424_0.6834846391605507","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","version":"0.2.0","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"license":"Apache-2.0","_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent@0.2.0","maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents#readme","bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"dist":{"shasum":"1ae409930e35779246d8eebe496d12ae86697ea4","tarball":"https://registry.npmjs.org/@acarmisc/backstage-plugin-ai-agents-backend-module-kagent/-/backstage-plugin-ai-agents-backend-module-kagent-0.2.0.tgz","fileCount":12,"integrity":"sha512-KTLbjSGb78Rn/QdT1Y9+RTzBjbLsbtOYoEcRg50NOWHd8aOoAmpnXFa5BEC4rkwCFX7YWAQwYGEAbqKo3Ayuzg==","signatures":[{"sig":"MEQCIA0AEg1jKKbpGPEGPoX6zYHl6pqdZCd2DqVheOu6KSR+AiANMVdkzwGhEeVvBRPtMJYnNMffRW4+RqwQLGFQ9Mv8kw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCkteCFCB/4fp6XlS375/oTsLSqnUpjWCFEsUYzT/xZ+QIgL2sFotI7miGtLXaV7x9Dj+xLgQfTLmWCD7CxI1yl/S0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@acarmisc%2fbackstage-plugin-ai-agents-backend-module-kagent@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":28724},"main":"dist/index.cjs.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.cjs.js"}},"gitHead":"e3153efb622d3074de278042b90128a74bc93780","scripts":{"lint":"backstage-cli package lint","test":"tsc -p tsconfig.test.json && node --test --experimental-test-coverage dist-test/**/*.test.js dist-test/*.test.js","build":"node build.js && tsc -p tsconfig.json","prepack":"npm run build","postpack":"","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"},"backstage":{"role":"backend-plugin-module","pluginId":"ai-agents","pluginPackage":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent"},"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git"},"_npmVersion":"10.9.8","description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@backstage/config":"^1.3.0","@backstage/backend-plugin-api":"^1.9.1","@acarmisc/backstage-plugin-ai-agents-backend":"^0.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.0","typescript":"^5.9.3","@types/node":"^20.19.43","@backstage/cli":"^0.36.2"},"_npmOperationalInternal":{"tmp":"tmp/backstage-plugin-ai-agents-backend-module-kagent_0.2.0_1789821976642_0.6925466806473937","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","version":"0.3.0","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"license":"Apache-2.0","_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent@0.3.0","maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents#readme","bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"dist":{"shasum":"ba67a0e5c57854bdfb909a886bec9b1c6c508183","tarball":"https://registry.npmjs.org/@acarmisc/backstage-plugin-ai-agents-backend-module-kagent/-/backstage-plugin-ai-agents-backend-module-kagent-0.3.0.tgz","fileCount":12,"integrity":"sha512-90ZABlRQVoo6FiuUjUwNm6Xnqcux9uy5qdGOnzX4SvUVc1XRR2yRmcf0GdmCmlw3NMWXw+x66NM2TUwYCw1MfA==","signatures":[{"sig":"MEQCIEW1fnYu8BIFOr0QKDKwT7ahzH7fBFk9w18xInCTey05AiBDplmJF/W2vNpebrqjR4sX2o8gNg6Pbnn58ZSBlCfq6A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCICL+Y4XgD43VaMzW7r63HILUki7oVJO2AUmnKLCe07McAiA7uGNvjQMvEijDk2Rxkggq64vQuMa2AW+usuBlY49quw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@acarmisc%2fbackstage-plugin-ai-agents-backend-module-kagent@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":28724},"main":"dist/index.cjs.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.cjs.js"}},"gitHead":"3e12bda85dbf28813ac3b38187b1db53f591d682","scripts":{"lint":"backstage-cli package lint","test":"tsc -p tsconfig.test.json && node --test --experimental-test-coverage dist-test/**/*.test.js dist-test/*.test.js","build":"node build.js && tsc -p tsconfig.json","prepack":"npm run build","postpack":"","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"},"backstage":{"role":"backend-plugin-module","pluginId":"ai-agents","pluginPackage":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent"},"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git"},"_npmVersion":"10.9.8","description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@backstage/config":"^1.3.0","@backstage/backend-plugin-api":"^1.9.1","@acarmisc/backstage-plugin-ai-agents-backend":"^0.9.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.0","typescript":"^5.9.3","@types/node":"^20.19.43","@backstage/cli":"^0.36.2"},"_npmOperationalInternal":{"tmp":"tmp/backstage-plugin-ai-agents-backend-module-kagent_0.3.0_1790846756731_0.46704725543600767","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","version":"0.3.1","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"license":"Apache-2.0","_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent@0.3.1","maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents#readme","bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"dist":{"shasum":"0fa6542d334d352fb7cf5642d985cf9c8b485307","tarball":"https://registry.npmjs.org/@acarmisc/backstage-plugin-ai-agents-backend-module-kagent/-/backstage-plugin-ai-agents-backend-module-kagent-0.3.1.tgz","fileCount":12,"integrity":"sha512-swoI5mSUEFMd+sUw5T8O+Hrz4kgtK0fHucOAXwD2x/adjIMhxP/qBg9ublxNGxbAWAmcWjw8+9oB+BsqIctfxQ==","signatures":[{"sig":"MEUCIQCrBA/CjZCzxwpatrYzqjlOhXJyEupbOPW5Q0ppC7mEdwIgSNoz+H6ngCH/HgEyv99pS/ezlm5b2nsZ5iTmaAew9WI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDKsohOJGmZbKd3VxNbIW5Vc4retJjN2VofcRTaI+XJZgIgKmE3Kdt3LbU+Mzg1lhB3V/iMdmtypz86QGzU+Vz5PJk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@acarmisc%2fbackstage-plugin-ai-agents-backend-module-kagent@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":30968},"main":"dist/index.cjs.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.cjs.js"}},"gitHead":"2f981ef5c10af28c353f67bd094e1ca33315f7d2","scripts":{"lint":"backstage-cli package lint","test":"tsc -p tsconfig.test.json && node --test --experimental-test-coverage dist-test/**/*.test.js dist-test/*.test.js","build":"node build.js && tsc -p tsconfig.json","prepack":"npm run build","postpack":"","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"},"backstage":{"role":"backend-plugin-module","pluginId":"ai-agents","pluginPackage":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent"},"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git"},"_npmVersion":"10.9.9","description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","directories":{},"_nodeVersion":"22.23.3","dependencies":{"@backstage/config":"^1.3.0","@backstage/backend-plugin-api":"^1.9.1","@acarmisc/backstage-plugin-ai-agents-backend":"^0.9.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.0","typescript":"^5.9.3","@types/node":"^20.19.43","@backstage/cli":"^0.36.2"},"_npmOperationalInternal":{"tmp":"tmp/backstage-plugin-ai-agents-backend-module-kagent_0.3.1_1791052589884_0.8429737600328921","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"_id":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent@0.3.2","bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"dist":{"shasum":"968bd83eb6bb701da9f2980248817c6beea86d61","tarball":"https://registry.npmjs.org/@acarmisc/backstage-plugin-ai-agents-backend-module-kagent/-/backstage-plugin-ai-agents-backend-module-kagent-0.3.2.tgz","fileCount":13,"integrity":"sha512-6rUiGLQDxMnG94mYu25V2G3ax6Yx2upanZfsfAhuzN0AEngHgUIfFzIBHi57MIoDmFm+Btn0wMg+cvs+K5eQpg==","signatures":[{"sig":"MEQCIBCiKY5SzBpdbhkCYq356XsBuajn6GOPShrMqXrBqQqcAiA31jSexl1BtnFIhQw/AOWMqoMBrI2x5o6qlXIGDAA2CA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICjtNBcjBElvCrUINnmL5ABH5Ij+h7+4V5Z4x8jpKCdBAiEAqC4tetjZUixSzHOK5ZmhG3l+M5jOe9d0FofHOx4TsTw="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@acarmisc%2fbackstage-plugin-ai-agents-backend-module-kagent@0.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":34730},"main":"dist/index.cjs.js","name":"@acarmisc/backstage-plugin-ai-agents-backend-module-kagent","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.cjs.js"},"./package.json":"./package.json"},"gitHead":"e86acdfc4a3c748b56638bc1eb285551be7dc889","license":"Apache-2.0","scripts":{"lint":"backstage-cli package lint","test":"tsc -p tsconfig.test.json && node --test --experimental-test-coverage dist-test/**/*.test.js dist-test/*.test.js","build":"node build.js && tsc -p tsconfig.json","prepack":"npm run build","postpack":"","typecheck":"tsc -p tsconfig.json --noEmit"},"version":"0.3.2","_npmUser":{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"},"homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents/tree/main/packages/plugin-ai-agents-backend-module-kagent#readme","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"backstage":{"role":"backend-plugin-module","pluginId":"ai-agents","pluginPackage":"@acarmisc/backstage-plugin-ai-agents-backend"},"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git","directory":"packages/plugin-ai-agents-backend-module-kagent"},"_npmVersion":"10.9.9","description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","directories":{},"maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"_nodeVersion":"22.23.3","configSchema":"config.d.ts","dependencies":{"@backstage/config":"^1.3.0","@backstage/backend-plugin-api":"^1.9.1","@acarmisc/backstage-plugin-ai-agents-backend":"^0.9.0"},"publishConfig":{"access":"public"},"typesVersions":{"*":{"package.json":["package.json"]}},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.0","typescript":"^5.9.3","@types/node":"^20.19.43","@backstage/cli":"^0.36.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/backstage-plugin-ai-agents-backend-module-kagent_0.3.2_1791058834533_0.6839182971711226"}}},"time":{"created":"2026-08-25T10:42:49.247Z","modified":"2026-10-03T20:20:35.026Z","0.1.0":"2026-08-25T10:42:49.563Z","0.2.0":"2026-09-19T12:46:16.715Z","0.3.0":"2026-10-01T09:25:56.828Z","0.3.1":"2026-10-03T18:36:29.958Z","0.3.2":"2026-10-03T20:20:34.610Z"},"bugs":{"url":"https://github.com/acarmisc/backstage-plugin-ai-agents/issues"},"license":"Apache-2.0","homepage":"https://github.com/acarmisc/backstage-plugin-ai-agents/tree/main/packages/plugin-ai-agents-backend-module-kagent#readme","keywords":["backstage","backstage-plugin","backstage-backend-plugin-module"],"repository":{"url":"git+https://github.com/acarmisc/backstage-plugin-ai-agents.git","type":"git","directory":"packages/plugin-ai-agents-backend-module-kagent"},"description":"kagent (Kubernetes-native agent runtime) invocation module for the ai-agents Backstage backend plugin.","maintainers":[{"name":"acarmisc","email":"andrea.carmisciano@gmail.com"}],"readme":"# @acarmisc/backstage-plugin-ai-agents-backend-module-kagent\n\nRuntime module for the [AI Agents backend](https://github.com/acarmisc/backstage-plugin-ai-agents/tree/main/packages/plugin-ai-agents-backend): runs\nagents hosted on [kagent](https://kagent.dev) from the Hire dialog, through the\ncontroller's [A2A](https://a2a-protocol.org) endpoint.\n\nIt handles agents with `ai-agent.io/runtime: kagent`, or every agent when it is\nthe only runtime module installed.\n\n## Installation\n\n```bash\nyarn --cwd packages/backend add @acarmisc/backstage-plugin-ai-agents-backend-module-kagent\n```\n\n```ts\n// packages/backend/src/index.ts\nbackend.add(import('@acarmisc/backstage-plugin-ai-agents-backend'));\nbackend.add(\n  import('@acarmisc/backstage-plugin-ai-agents-backend-module-kagent'),\n);\n```\n\n## Configuration\n\n```yaml\nai-agents:\n  invocations:\n    kagent:\n      baseUrl: http://kagent-controller.kagent.svc.cluster.local:8083\n      # namespace: kagent\n      # authHeader: Bearer ${KAGENT_TOKEN}\n      # timeoutMs: 120000\n```\n\n| Key          | Description                                                                         |\n| ------------ | ----------------------------------------------------------------------------------- |\n| `baseUrl`    | URL of the kagent controller's HTTP server.                                         |\n| `namespace`  | Default namespace of the agents. Default `kagent`.                                  |\n| `authHeader` | `Authorization` header for the controller. Only sent to `baseUrl`'s origin. Secret. |\n| `timeoutMs`  | Timeout of one invocation. Default `120000`.                                        |\n\n## Agent annotations\n\n```yaml\nmetadata:\n  annotations:\n    ai-agent.io/runtime: kagent\n    ai-agent.io/runtime-handle: support-triage # name of the kagent Agent\n    ai-agent.io/namespace: agents # optional\n    # ai-agent.io/endpoint: https://kagent.other-cluster.example.com  # optional, other controller\n```\n\nAn `endpoint` annotation sends the request to another controller. `authHeader`\nis not sent there unless it has the same origin as `baseUrl`.\n\n## Request\n\n`POST <baseUrl>/api/a2a/<namespace>/<runtime-handle>/` with a JSON-RPC\n`message/send` call. The message carries the prompt as one text part and the\nconversation's thread id as `contextId`, so follow-up turns keep the agent's\ncontext. The answer is the text of the task's artifacts, or of the returned\nmessage.\n","readmeFilename":"README.md"}