{"_id":"@microsoft/teams.a2a","_rev":"36-b7fe969d26a7459d908f5576724d791e","name":"@microsoft/teams.a2a","dist-tags":{"preview":"2.0.0-preview.3","$(npmtag)":"2.0.6-preview.1","next":"2.0.11-preview.8","latest":"2.0.12"},"versions":{"2.0.0-preview.3":{"name":"@microsoft/teams.a2a","version":"2.0.0-preview.3","keywords":["microsoft","teams","msteams"],"license":"MIT","_id":"@microsoft/teams.a2a@2.0.0-preview.3","maintainers":[{"name":"corinagum","email":"corinagum@microsoft.com"},{"name":"aacebo","email":"aacebowork@gmail.com"},{"name":"microsoft1es","email":"npmjs@microsoft.com"}],"homepage":"https://github.com/microsoft/teams.ts","bugs":{"url":"https://github.com/microsoft/teams.ts/issues"},"dist":{"shasum":"4ca1b6a2861e22fda60daed8a67bce7fd07d7ce8","tarball":"https://registry.npmjs.org/@microsoft/teams.a2a/-/teams.a2a-2.0.0-preview.3.tgz","fileCount":44,"integrity":"sha512-a1UVVd4X/aBf8fp40RRkW9XKrQEnoFGAN+PDm7p2++vHT8C8DXP8xmR93OA7pQ5JJBFW9ecl6OPvfQqBlX1H0g==","signatures":[{"sig":"MEYCIQCUVKl9yq1/HVI4NAI3JnvrWSTosXxIbKug416IcroKbQIhAOABdgbvo7cSO+AyYc+2v+zABZDwE0/m3lpmmjflXexF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":163992},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","gitHead":"8dad5bfe453a822a7520b204badf76a8cc54ee92","scripts":{"lint":"npx eslint","test":"npx jest","build":"npx tsc","clean":"npx rimraf ./dist","lint:fix":"npx eslint --fix"},"_npmUser":{"name":"aacebo","email":"aacebowork@gmail.com"},"repository":{"url":"git+https://github.com/microsoft/teams.ts.git","type":"git","directory":"packages/a2a"},"_npmVersion":"10.9.2","description":"

⚠️ **DEPRECATED** — `@microsoft/teams.a2a` is no longer recommended. Use [`@a2a-js/sdk`](https://www.npmjs.com/package/@a2a-js/sdk) directly with a dedicated AI framework like the [`openai`](https://www.npmjs.com/package/openai) SDK. See [`examples/a2a`","directories":{},"_nodeVersion":"18.5.0","dependencies":{"lodash.camelcase":"^4.3.0","@microsoft/teams.ai":"2.0.12","@microsoft/teams.common":"2.0.12"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","rimraf":"^6.0.1","ts-jest":"^29.2.5","typescript":"^5.4.5","@types/jest":"^29.5.12","@types/node":"^22.0.2","@microsoft/teams.config":"2.0.12","@types/lodash.camelcase":"^4.3.9"},"peerDependencies":{"@a2a-js/sdk":"^0.3.4","@microsoft/teams.apps":"2.0.12"},"_npmOperationalInternal":{"tmp":"tmp/teams.a2a_2.0.12_1779924835343_0.3281614326672906","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-05-16T18:22:37.242Z","modified":"2026-07-16T15:47:35.479Z","2.0.0-preview.3":"2025-05-16T18:22:37.598Z","2.0.0-preview.4":"2025-06-04T22:51:56.269Z","2.0.0-preview.5":"2025-06-12T16:07:36.050Z","2.0.0-preview.6":"2025-06-16T22:48:32.729Z","2.0.0-preview.7":"2025-06-25T20:30:08.156Z","2.0.0-preview.8":"2025-07-21T23:13:34.740Z","2.0.0-preview.9":"2025-08-06T04:42:15.323Z","2.0.0-preview.10":"2025-08-26T20:12:57.858Z","2.0.0-preview.11":"2025-09-03T14:12:43.853Z","2.0.0-preview.12":"2025-09-10T23:26:13.033Z","2.0.0":"2025-09-18T00:22:03.554Z","2.0.1":"2025-09-18T01:10:49.423Z","2.0.2":"2025-10-13T23:02:07.293Z","2.0.3":"2025-11-17T21:34:23.169Z","2.0.4":"2025-11-17T23:40:15.417Z","2.0.5":"2025-12-09T20:41:37.127Z","2.0.6-preview.1":"2026-01-31T06:55:13.550Z","2.0.6-preview.4.g4fdb54b839":"2026-02-26T17:50:00.252Z","2.0.6-preview.4":"2026-02-26T20:08:46.660Z","2.0.6-preview.11":"2026-03-11T19:50:12.726Z","2.0.6-preview.20":"2026-03-24T23:18:10.602Z","2.0.6":"2026-03-25T00:26:55.926Z","2.0.7":"2026-04-07T05:36:14.746Z","2.0.8":"2026-04-16T22:55:46.620Z","2.0.9":"2026-05-01T14:22:03.637Z","2.0.10":"2026-05-06T23:07:55.629Z","2.0.11-preview.8":"2026-05-07T23:19:48.646Z","2.0.11":"2026-05-15T00:10:10.495Z","2.0.12":"2026-05-27T23:33:55.515Z"},"bugs":{"url":"https://github.com/microsoft/teams.ts/issues"},"license":"MIT","homepage":"https://github.com/microsoft/teams.ts","keywords":["microsoft","teams","msteams"],"repository":{"url":"git+https://github.com/microsoft/teams.ts.git","type":"git","directory":"packages/a2a"},"description":"> ⚠️ **DEPRECATED** — `@microsoft/teams.a2a` is no longer recommended. Use [`@a2a-js/sdk`](https://www.npmjs.com/package/@a2a-js/sdk) directly with a dedicated AI framework like the [`openai`](https://www.npmjs.com/package/openai) SDK. See [`examples/a2a`","maintainers":[{"email":"npmjs@microsoft.com","name":"microsoft1es"},{"email":"microsoft-oss-publishing@microsoft.com","name":"microsoft-oss-releases"},{"email":"corinagum@microsoft.com","name":"corinagum"},{"email":"aacebowork@gmail.com","name":"aacebo"},{"email":"aamirjawaid@microsoft.com","name":"aamirjawaid"}],"readme":"# Teams: a2a\n\n> ⚠️ **DEPRECATED** — `@microsoft/teams.a2a` is no longer recommended. Use [`@a2a-js/sdk`](https://www.npmjs.com/package/@a2a-js/sdk) directly with a dedicated AI framework like the [`openai`](https://www.npmjs.com/package/openai) SDK. See [`examples/a2a`](../../examples/a2a) for the new pattern.\n\n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n\nThis is a plugin that enables your Teams agent to be used as an A2A agent.\n\n> [!NOTE]\n> The A2A protocol is still early in development and hence this package is fairly experimental.\n\n- [What is A2A?](https://google.github.io/A2A)\n\n## Server\n\nTeams SDK allows your applications to easily be accessible via Teams. However, using this plugin, you can also enable your agent to be used as an A2A agent so that it can be used by other A2A clients.\n\n### Configuration\n\nConfiguring the App to use the A2APlugin simply requires the `AgentCard`.\n\n```ts\nimport { schema, A2APlugin } from \"@microsoft/teams.a2a\";\nimport { App } from \"@microsoft/teams.apps\";\n\ndeclare const myAgentCard: AgentCard;\n\nconst app = new App({\n plugins: [\n new A2APlugin({\n agentCard: myAgentCard,\n }),\n ],\n});\n```\n\nWith this simple configuration, the A2APlugin will listen for A2A requests on the `/a2a` path and return the agent card when requested.\n\n### Agent Card\n\nThe plugin automatically exposes the agent card at the path `/.well-known/agent.json`.\n\n```mermaid\nsequenceDiagram\n participant A2A Client\n participant App\n participant A2APlugin\n A2A Client->>App: /.well-known/agent.json\n App->>A2APlugin: Call A2APlugin\n A2APlugin->>A2A Client: Return agent card\n```\n\n### A2A Requests\n\n```mermaid\nsequenceDiagram\n participant A2A Client\n participant App\n participant A2APlugin\n participant YourEventHandler\n A2A Client->>App: /task/send\n App->>A2APlugin: Call A2APlugin\n A2APlugin->>YourEventHandler: Call your event handler a2a:message\n YourEventHandler->>A2APlugin: Call respond\n A2APlugin->>A2A Client: Return response\n```\n\nHandling A2A requests is similar to handling app-requests. Simply add an event handler for the `a2a:message` event. You may `accumulateArtifacts` to iteratively accumulate artifacts for the task, or simply `respond` with the final result.\n\n> [!NOTE]\n> You must have only a single handler that calls `respond`. And you **must** call `respond` as the last step in your handler. This is because the `respond` function resolves the open request to the caller.\n\n```ts\napp.event(\n \"a2a:message\",\n async ({ taskContext, respond, accumulateArtifacts }) => {\n // The taskContext contains details about the task request\n const result = await myEventHandler(taskContext, accumulateArtifacts);\n await respond(result);\n },\n);\n```\n\n## Client\n\nThe A2A client is able to call different A2A servers. You are able to use the `AgentManager` to call different A2A Servers.\n\n```ts\nimport { AgentManager } from \"@microsoft/teams.a2a\";\n\nconst agentManager = new AgentManager();\n\nagentManager.use(\"my-agent\", \"https://my-agent.com/a2a\");\nawait agentManager.sendTask(\"my-agent\", {\n id: continueTaskId || generateRequestId().toString(),\n message: {\n role: 'user',\n parts: [{ type: 'text' as const, text: message }],\n },\n {},\n});\n```\n\nIf you are using the `A2APlugin` described above, you can use the `clientManger` property in that plugin object to get an instance of the `AgentManager` and use it to send tasks proactively to different A2A servers.\n\n### Chat Prompt\n\nA2A is most effective when used with an LLM. The `A2AClientPlugin` can be used to add a plugin to your chat prompt that will allow you to automatically include A2A agents as a possible source of interaction. The interaction can be outlined as below:\n\n```mermaid\nsequenceDiagram\n participant User\n participant ChatPrompt\n participant A2AClientPlugin\n participant AgentManager\n participant AgentClient\n participant LLM\n participant TargetAgent\n\n alt config\n User->>ChatPrompt: \"use\" with A2A server details\n ChatPrompt->>A2AClientPlugin: configure usable a2a server\n A2AClientPlugin->>AgentManager: register new potential client\n end\n alt send\n User->>ChatPrompt: Send initial message\n ChatPrompt->>A2AClientPlugin: configure system prompt\n A2AClientPlugin->>AgentManager: get agent cards\n AgentManager->>AgentClient: for each get agent card\n AgentClient-->>AgentManager: agent card\n AgentManager-->>A2AClientPlugin: all agent cards\n A2AClientPlugin-->>ChatPrompt: updated system prompt\n ChatPrompt->>A2AClientPlugin: configure tool-calls (onBuildFunctions)\n A2AClientPlugin-->>ChatPrompt: Configured tool calls\n ChatPrompt->>LLM: send-message\n LLM-->>ChatPrompt: Call A2A TargetAgent\n ChatPrompt->>A2AClientPlugin: Handler for calling A2A TargetAgent\n A2AClientPlugin->>AgentManager: Call TargetAgent with message\n AgentManager->>AgentClient: Call TargetAgent with message\n TargetAgent-->>AgentClient: Return task (e.g., completed, input-required)\n AgentClient->>AgentManager: Result task\n AgentManager->>A2AClientPlugin: Result task\n A2AClientPlugin->>ChatPrompt: Result task\n ChatPrompt-->>User: Respond with final result or follow-up\n end\n```\n\nUsage:\n\n```ts\nimport { A2APlugin } from \"@microsoft/teams.a2a\";\nimport { ChatPrompt } from \"@microsoft/teams.ai\";\n\nconst plugin = new A2APlugin();\n\nconst chatPrompt = new ChatPrompt({\n plugins: [plugin],\n}).usePlugin(\"a2a\", {\n key: \"my-agent\",\n url: \"https://my-agent.com/a2a\",\n});\n\nconst result = await chatPrompt.sendMessage(\"Hello, world!\");\n\nconsole.log(result);\n```\n","readmeFilename":"README.md"}