dsh-a2a-server 0.1.0 → 0.2.0

package/README.md

@@ -7,21 +7,22 @@
 </p>
 
 <p align="center">
-  <a href="README.md"><b>English</b></a> · <a href="README.zh-CN.md">简体中文</a>
+  <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/README.md"><b>English</b></a> · <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/README.zh-CN.md">简体中文</a>
 </p>
 
 <p align="center"><sub>A community plugin, not an official DeepSeek product.</sub></p>
 
 <p align="center">
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
-  <img src="https://img.shields.io/badge/A2A-v0.3.0%20JSON--RPC-4D6BFE?style=flat" alt="A2A v0.3.0 JSON-RPC binding">
+  <a href="https://www.npmjs.com/package/dsh-a2a-server"><img src="https://img.shields.io/npm/v/dsh-a2a-server?style=flat&label=npm&color=CB3837" alt="npm version"></a>
+  <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/A2A-v1.0%20JSON--RPC-4D6BFE?style=flat" alt="A2A v1.0 JSON-RPC binding">
   <img src="https://img.shields.io/badge/DSH-0.1.0--rc.6-4493F8?style=flat" alt="Built against DSH 0.1.0-rc.6">
-  <img src="https://img.shields.io/badge/tests-129-2EA44F?style=flat" alt="129 tests">
+  <img src="https://img.shields.io/badge/tests-167-2EA44F?style=flat" alt="167 tests">
 </p>
 
 `dsh-a2a-server` makes a [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
 agent reachable over the [A2A (Agent2Agent)](https://a2a-protocol.org) protocol. It
-serves an Agent Card at a well-known URI and implements the **v0.3.0 JSON-RPC
+serves an Agent Card at a well-known URI and implements the **v1.0 JSON-RPC
 binding**, so any compliant peer that knows the deployment's URL can discover the
 agent and submit tasks to it.
 
@@ -32,18 +33,24 @@ adapter over `ctx.agents`, not a capability seam.
 ## Install
 
 ```sh
-dsh plugin --profile web add ./path/to/dsh-a2a-server
+dsh plugin --profile web add dsh-a2a-server
 ```
 
 `dsh plugin` forwards to pnpm inside the profile directory and appends this
 bundle to `dsh.profile.bundles`, because the package declares `dsh.bundle`.
 
+To work from a checkout instead, point it at the directory:
+
+```sh
+dsh plugin --profile web add ./path/to/dsh-a2a-server
+```
+
 | Requirement | Supplied by |
 | --- | --- |
 | `ctx.agents` | `dsh-base` |
 | `ctx.credentials` | `dsh-base` |
 | `ctx.webServer` | **`dsh-web-app`** |
-| `ctx.sessionProjections` (optional) | composition; enables `tasks/get` after settlement |
+| `ctx.sessionProjections` (optional) | composition; enables `GetTask` after settlement |
 
 The plugin stays PENDING until the three required services exist. `ctx.webServer`
 ships in `dsh-web-app` rather than `dsh-base`, so a `headless` profile needs
@@ -56,15 +63,24 @@ The bundled example composition runs a real model and a listening server.
 
 ```sh
 pnpm install
-A2A_PEER_ALICE=demo123 A2A_PORT=9922 pnpm serve
+A2A_PEERS="alice:demo123" A2A_PORT=9922 pnpm serve
 ```
 
 ```powershell
-$env:A2A_PEER_ALICE = "demo123"
+$env:A2A_PEERS = "alice:demo123"
 $env:A2A_PORT = "9922"
 pnpm serve
 ```
 
+Peer names are arbitrary — `alice` is this demo's default, not a protocol
+fixture. Name as many as you like, and either carry the token inline or store it
+under the derived credential reference:
+
+```sh
+A2A_PEERS="ops:tok1,research:tok2"   # inline
+A2A_PEERS="ops,research"             # tokens from A2A_PEER_OPS / A2A_PEER_RESEARCH
+```
+
 The model credential is resolved through `ctx.credentials`, so an existing
 `DEEPSEEK_API_KEY` in the harness home, either `.env` layer, or the process
 environment is picked up unchanged. A missing credential fails the boot.
@@ -77,20 +93,20 @@ curl -s http://127.0.0.1:9922/.well-known/agent-card.json
 curl -s http://127.0.0.1:9922/a2a \
   -H "authorization: Bearer demo123" \
   -H 'content-type: application/json' \
-  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{
-        "message":{"kind":"message","messageId":"m1","role":"user",
-                   "parts":[{"kind":"text","text":"hello"}]}}}'
+  -H 'a2a-version: 1.0'   -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{
+        "message":{"messageId":"m1","role":"ROLE_USER",
+                   "parts":[{"text":"hello"}]}}}'
 ```
 
 | Variable | Default | Meaning |
 | --- | --- | --- |
-| `A2A_PEER_ALICE` | — | Bearer token for the demo peer; required |
+| `A2A_PEERS` | `alice` | `name[:token]` list; a token is required for each |
 | `A2A_PORT` | `9900` | Listening port |
 | `A2A_SEND_MODE` | `block` | `block` or `immediate` |
 | `A2A_WORKSPACE_ROOT` | temp dir | Parent of the per-peer working directories |
 | `DEEPSEEK_MODEL` | `deepseek-v4-flash` | Model id requested from the adapter |
 
-A one-shot probe runs 48 checks against a live server and exits non-zero on any
+A one-shot probe runs 67 checks against a live server and exits non-zero on any
 mismatch:
 
 ```sh
@@ -106,21 +122,42 @@ node example/probe.mjs http://127.0.0.1:9922 demo123
 | `/.well-known/agent.json` | GET | Public by default |
 | `{basePath}` (default `/a2a`) | POST | Bearer required |
 
-| JSON-RPC method | v1.0 alias | Status |
+| JSON-RPC method | Status |
+| --- | --- |
+| `SendMessage` | Waiting negotiated per request |
+| `SendStreamingMessage` | SSE |
+| `GetTask` | Idempotent; answers after settlement |
+| `ListTasks` | Cursor-paginated, filterable, resident contexts only |
+| `CancelTask` | Cancels the running turn |
+| `SubscribeToTask` | Live stream; `-32004` on a terminal task |
+| `GetExtendedAgentCard` | Extra skills for an authenticated peer; `-32007` when unconfigured |
+| `*TaskPushNotificationConfig` | `-32003` |
+
+**Only A2A v1.0 is served.** The v0.3 method names, `kind` discriminators,
+lowercase enums, and nested `file` parts are gone rather than aliased: every
+reply this server writes is v1.0 JSON, which a v0.3 client could not read, so
+answering a v0.3 request would fail further from its cause than refusing it. A
+retired method answers `-32601` naming its replacement, and an explicit
+`A2A-Version: 0.3` answers `-32009` (`VersionNotSupportedError`). A request with
+no `A2A-Version` header is served as 1.0 — the only version this interface
+declares on its card.
+
+What that means concretely, against v0.3:
+
+| Concern | v0.3 | v1.0 as served here |
 | --- | --- | --- |
-| `message/send` | `SendMessage` | Blocking negotiated per request |
-| `message/stream` | `SendStreamingMessage` | SSE |
-| `tasks/get` | `GetTask` | Idempotent; answers after settlement |
-| `tasks/cancel` | `CancelTask` | Cancels the running turn |
-| `tasks/resubscribe` | `SubscribeToTask` | Live stream, or one terminal frame |
-| `tasks/pushNotificationConfig/*` | `*TaskPushNotificationConfig` | `-32003` |
-| `tasks/list` | `ListTasks` | `-32601` |
-| `agent/getAuthenticatedExtendedCard` | `GetExtendedAgentCard` | `-32601` |
-
-Both dialects are accepted. v0.3 (`message/send`, `"working"`, `kind`-tagged
-parts) is the mainline; the v1.0 spellings (`SendMessage`, `TASK_STATE_WORKING`,
-member-presence parts) are normalized inbound and rendered back in whichever
-dialect the request used.
+| Task reference | `params.taskId` | `params.id` |
+| `SendMessage` result | bare `Task` | `{ "task": … }` |
+| Task state | `"working"` | `"TASK_STATE_WORKING"` |
+| Message role | `"user"` | `"ROLE_USER"` |
+| Part | `{"kind":"text","text":…}` | `{"text":…}`; file parts flatten to `url`/`raw`/`filename`/`mediaType` |
+| Stream frame | `{"kind":"status-update",…,"final":true}` | `{"statusUpdate":{…}}`; the stream's close is the terminal signal |
+| Stream opening | a non-final status update | the `Task` object itself |
+| Wait control | `configuration.blocking` | `configuration.returnImmediately` (inverted; blocking is the default) |
+| Card endpoint | `url` + `preferredTransport` | `supportedInterfaces[]`, each carrying its own `protocolVersion` |
+| Card auth | `securitySchemes` + `security` | schemes wrapped in `httpAuthSecurityScheme`; `securityRequirements` |
+| Extended card | `supportsAuthenticatedExtendedCard` | `capabilities.extendedAgentCard` |
+| A2A error detail | none | `error.data[]` carrying a `google.rpc.ErrorInfo` with `reason` and `domain` |
 
 Inbound messages may carry text, file, and data parts. File and data parts are
 rendered into the model's context as bracketed references. Replies are text.
@@ -137,7 +174,6 @@ another peer answers exactly as an absent one.
   config:
     basePath: /a2a
     publicUrl: https://agents.example.com/a2a   # advertised on the card
-    protocolVersion: 0.3.0
     provider: deepseek-official
     model: deepseek-v4-flash
 
@@ -150,6 +186,11 @@ another peer answers exactly as an absent one.
           name: general
           description: General-purpose task execution.
           tags: [coding, research]
+      extendedSkills:                             # authenticated peers only
+        - id: internal
+          name: internal diagnostics
+          description: Reports harness internals.
+          tags: [internal]
       provider:
         organization: Example Inc.
         url: https://example.com
@@ -180,15 +221,15 @@ another peer answers exactly as an absent one.
 | --- | --- | --- |
 | `basePath` | `/a2a` | JSON-RPC route |
 | `publicUrl` | derived from `Host` | Routable URL published on the card |
-| `protocolVersion` | `0.3.0` | Version advertised on the card |
 | `provider` · `model` | — | Model route for every agent this server creates |
 | `card.public` | `true` | Serve the card without a credential |
 | `card.skills` | `[]` | Declared skills; falls back to one `general` entry |
+| `card.extendedSkills` | `[]` | Skills revealed only through `GetExtendedAgentCard` |
 | `peers` | `{}` | Identity → credential **reference name** |
 | `trustedPeers` | all authenticated | Allow-list of identities that may run tasks |
 | `rateLimitPerMinute` | `60` | Sliding window per identity |
 | `maxContextTurns` | `5` | Messages accepted per context before `rejected` |
-| `sendMode` | `block` | Default when the client states no preference |
+| `sendMode` | `block` | Default when the client sends no `returnImmediately` |
 | `blockTimeoutMs` | `60000` | After which a blocking request is declined |
 | `contextIdleTtlMs` | `1800000` | Idle time before a context's agent is released |
 | `maxResidentContexts` | `64` | Ceiling on resident contexts |
@@ -241,8 +282,7 @@ single repository; under it, files written by one peer are readable by another.
 - JSONRPC binding only. gRPC and HTTP+JSON are not served, and the card says so.
 - Push notifications are not implemented. `push.enabled` selects which error the
   push methods return; the card advertises `pushNotifications: false`.
-- No extended Agent Card, `stateTransitionHistory`, protocol extensions, or card
-  signatures.
+- No `stateTransitionHistory`, protocol extensions, or card signatures.
 - Streaming emits committed assistant messages. Per-chunk streaming is not
   implemented.
 - No orphan-task watchdog: a task wedged non-terminal stays that way.
@@ -261,8 +301,8 @@ single repository; under it, files written by one peer are readable by another.
 ```
 src/
 ├── protocol/          dependency-free library: no Cordis, no HTTP, no harness
-│   ├── wire.ts        the A2A vocabulary, normalized to v0.3 spelling
-│   ├── normalize.ts   v0.3 <-> v1.0 dialect translation, both directions
+│   ├── wire.ts        the A2A v1.0 vocabulary: one shape, no translation
+│   ├── parse.ts       inbound parsing and the method table
 │   ├── jsonrpc.ts     framing and the A2A error codes
 │   ├── card.ts        Agent Card construction
 │   └── sse.ts         SSE frame encoding
@@ -294,9 +334,9 @@ maps to an Activation evicted when idle, leaving the durable Session behind.
 ```sh
 pnpm install
 pnpm typecheck
-pnpm test       # 129 tests across 9 files
+pnpm test       # 167 tests across 10 files
 pnpm serve      # a listening server
-pnpm probe      # 48 checks against a running server
+pnpm probe      # 67 checks against a running server
 pnpm build      # emit lib/
 ```
 
@@ -311,8 +351,8 @@ Built against [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deep
 The official project supplies the agent runtime, the plugin system, and the
 capability seams this plugin consumes. This project supplies:
 
-- The A2A v0.3.0 JSON-RPC binding, served inbound
-- Agent Card construction and dialect normalization
+- The A2A v1.0 JSON-RPC binding, served inbound
+- Agent Card construction and inbound request parsing
 - Mapping between A2A tasks and harness turns
 - Per-peer authentication, isolation, and workspace policy
 
@@ -325,7 +365,7 @@ Scan to join the WeChat group **A2A 产品应用和探索** — discussion of A2
 practice, this plugin included.
 
 <p align="center">
-  <img src="assets/community-wechat.jpg" alt="WeChat group QR code" width="280">
+  <img src="https://raw.githubusercontent.com/huangjuhua-aigc/dsh-a2a/main/assets/community-wechat.jpg" alt="WeChat group QR code" width="280">
 </p>
 
 If the code has expired, open an issue and we will refresh it.

package/README.zh-CN.md

@@ -7,21 +7,22 @@
 </p>
 
 <p align="center">
-  <a href="README.md">English</a> · <a href="README.zh-CN.md"><b>简体中文</b></a>
+  <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/README.md">English</a> · <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/README.zh-CN.md"><b>简体中文</b></a>
 </p>
 
 <p align="center"><sub>社区维护的插件，并非 DeepSeek 官方产品。</sub></p>
 
 <p align="center">
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
-  <img src="https://img.shields.io/badge/A2A-v0.3.0%20JSON--RPC-4D6BFE?style=flat" alt="A2A v0.3.0 JSON-RPC 绑定">
+  <a href="https://www.npmjs.com/package/dsh-a2a-server"><img src="https://img.shields.io/npm/v/dsh-a2a-server?style=flat&label=npm&color=CB3837" alt="npm 版本"></a>
+  <a href="https://github.com/huangjuhua-aigc/dsh-a2a/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/A2A-v1.0%20JSON--RPC-4D6BFE?style=flat" alt="A2A v1.0 JSON-RPC 绑定">
   <img src="https://img.shields.io/badge/DSH-0.1.0--rc.6-4493F8?style=flat" alt="基于 DSH 0.1.0-rc.6 构建">
-  <img src="https://img.shields.io/badge/tests-129-2EA44F?style=flat" alt="129 项测试">
+  <img src="https://img.shields.io/badge/tests-167-2EA44F?style=flat" alt="167 项测试">
 </p>
 
 `dsh-a2a-server` 让 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
 上的 agent 可以通过 [A2A（Agent2Agent）](https://a2a-protocol.org)协议被访问。它在
-well-known 路径发布 Agent Card，并实现 **v0.3.0 JSON-RPC 绑定**——任何知道本部署
+well-known 路径发布 Agent Card，并实现 **v1.0 JSON-RPC 绑定**——任何知道本部署
 URL 的合规 peer 都能发现这个 agent 并向它提交任务。
 
 本插件**只做入站**：从不主动连接其他 agent，没有 client、没有 peer 目录、没有 A2A
@@ -30,18 +31,24 @@ subagent provider。它是 `ctx.agents` 之上的传输适配层，不是能力
 ## 安装
 
 ```sh
-dsh plugin --profile web add ./path/to/dsh-a2a-server
+dsh plugin --profile web add dsh-a2a-server
 ```
 
 `dsh plugin` 会在 profile 目录里转发给 pnpm，并把这个 bundle 追加进
 `dsh.profile.bundles`——因为包中声明了 `dsh.bundle`。
 
+若想直接使用本地检出，把路径指过去即可：
+
+```sh
+dsh plugin --profile web add ./path/to/dsh-a2a-server
+```
+
 | 依赖 | 由谁提供 |
 | --- | --- |
 | `ctx.agents` | `dsh-base` |
 | `ctx.credentials` | `dsh-base` |
 | `ctx.webServer` | **`dsh-web-app`** |
-| `ctx.sessionProjections`（可选） | 组合层；启用后 `tasks/get` 在任务结算后仍可应答 |
+| `ctx.sessionProjections`（可选） | 组合层；启用后 `GetTask` 在任务结算后仍可应答 |
 
 三个必需服务齐备之前，插件保持 PENDING。`ctx.webServer` 由 `dsh-web-app` 提供而不在
 `dsh-base` 中，因此 `headless` profile 需要先挂载 `@deepseek-ai/dsh-host-webserver`。
@@ -53,15 +60,23 @@ dsh plugin --profile web add ./path/to/dsh-a2a-server
 
 ```sh
 pnpm install
-A2A_PEER_ALICE=demo123 A2A_PORT=9922 pnpm serve
+A2A_PEERS="alice:demo123" A2A_PORT=9922 pnpm serve
 ```
 
 ```powershell
-$env:A2A_PEER_ALICE = "demo123"
+$env:A2A_PEERS = "alice:demo123"
 $env:A2A_PORT = "9922"
 pnpm serve
 ```
 
+peer 名字是任意的——`alice` 只是这个 demo 的默认值，不是协议规定。可以声明任意多个，
+token 既可以内联，也可以存在派生出来的凭据引用下：
+
+```sh
+A2A_PEERS="ops:tok1,research:tok2"   # 内联
+A2A_PEERS="ops,research"             # token 取自 A2A_PEER_OPS / A2A_PEER_RESEARCH
+```
+
 模型凭据经 `ctx.credentials` 解析，因此 harness home、任一 `.env` 层或进程环境中已有的
 `DEEPSEEK_API_KEY` 都会被直接采用。缺少凭据时启动失败。
 
@@ -73,20 +88,21 @@ curl -s http://127.0.0.1:9922/.well-known/agent-card.json
 curl -s http://127.0.0.1:9922/a2a \
   -H "authorization: Bearer demo123" \
   -H 'content-type: application/json' \
-  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{
-        "message":{"kind":"message","messageId":"m1","role":"user",
-                   "parts":[{"kind":"text","text":"hello"}]}}}'
+  -H 'a2a-version: 1.0' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{
+        "message":{"messageId":"m1","role":"ROLE_USER",
+                   "parts":[{"text":"hello"}]}}}'
 ```
 
 | 变量 | 默认值 | 含义 |
 | --- | --- | --- |
-| `A2A_PEER_ALICE` | — | 示例 peer 的 bearer token，必填 |
+| `A2A_PEERS` | `alice` | `名字[:token]` 列表；每个 peer 都必须有 token |
 | `A2A_PORT` | `9900` | 监听端口 |
 | `A2A_SEND_MODE` | `block` | `block` 或 `immediate` |
 | `A2A_WORKSPACE_ROOT` | 临时目录 | per-peer 工作目录的父目录 |
 | `DEEPSEEK_MODEL` | `deepseek-v4-flash` | 向适配器请求的模型 id |
 
-一次性探针会对运行中的服务执行 48 项检查，任何一项不符即以非零码退出：
+一次性探针会对运行中的服务执行 67 项检查，任何一项不符即以非零码退出：
 
 ```sh
 pnpm probe                                        # 默认 :9922 / demo123
@@ -101,20 +117,40 @@ node example/probe.mjs http://127.0.0.1:9922 demo123
 | `/.well-known/agent.json` | GET | 默认公开 |
 | `{basePath}`（默认 `/a2a`） | POST | 必须携带 Bearer |
 
-| JSON-RPC 方法 | v1.0 别名 | 状态 |
+| JSON-RPC 方法 | 状态 |
+| --- | --- |
+| `SendMessage` | 是否等待逐请求协商 |
+| `SendStreamingMessage` | SSE |
+| `GetTask` | 幂等；结算后仍可应答 |
+| `ListTasks` | 游标分页、可过滤；仅覆盖常驻的 context |
+| `CancelTask` | 取消正在执行的 turn |
+| `SubscribeToTask` | 续订活任务；终态任务返回 `-32004` |
+| `GetExtendedAgentCard` | 已认证 peer 可见的额外 skill；未配置时 `-32007` |
+| `*TaskPushNotificationConfig` | `-32003` |
+
+**只提供 A2A v1.0。** v0.3 的方法名、`kind` 判别字段、小写枚举、嵌套 `file`
+part 是被**删除**而不是做了别名：本服务写出的每一个回包都是 v1.0 JSON，v0.3
+客户端本就读不懂，所以“应答一个 v0.3 请求”只会让故障离成因更远。已退役的方法回
+`-32601` 并直接告知新名字；显式的 `A2A-Version: 0.3` 回 `-32009`
+（`VersionNotSupportedError`）。不带 `A2A-Version` 头的请求按 1.0 处理——这是本接口
+在 Card 上声明的唯一版本。
+
+具体到线上，与 v0.3 的差异：
+
+| 关注点 | v0.3 | 本服务的 v1.0 |
 | --- | --- | --- |
-| `message/send` | `SendMessage` | 是否阻塞逐请求协商 |
-| `message/stream` | `SendStreamingMessage` | SSE |
-| `tasks/get` | `GetTask` | 幂等；结算后仍可应答 |
-| `tasks/cancel` | `CancelTask` | 取消正在执行的 turn |
-| `tasks/resubscribe` | `SubscribeToTask` | 续订活任务，或给一帧终态 |
-| `tasks/pushNotificationConfig/*` | `*TaskPushNotificationConfig` | `-32003` |
-| `tasks/list` | `ListTasks` | `-32601` |
-| `agent/getAuthenticatedExtendedCard` | `GetExtendedAgentCard` | `-32601` |
-
-两种方言都接受。v0.3（`message/send`、`"working"`、带 `kind` 的 part）是主线；v1.0
-拼写（`SendMessage`、`TASK_STATE_WORKING`、成员存在式 part）在入站时被归一化，并按请求
-所用的方言渲染回去。
+| 任务引用 | `params.taskId` | `params.id` |
+| `SendMessage` 结果 | 裸 `Task` | `{ "task": … }` |
+| 任务状态 | `"working"` | `"TASK_STATE_WORKING"` |
+| 消息角色 | `"user"` | `"ROLE_USER"` |
+| Part | `{"kind":"text","text":…}` | `{"text":…}`；文件 part 展平为 `url`/`raw`/`filename`/`mediaType` |
+| 流帧 | `{"kind":"status-update",…,"final":true}` | `{"statusUpdate":{…}}`；流关闭即终态信号 |
+| 流首帧 | 一帧非终态 status update | `Task` 对象本身 |
+| 等待控制 | `configuration.blocking` | `configuration.returnImmediately`（语义反转，默认等待） |
+| Card 端点 | `url` + `preferredTransport` | `supportedInterfaces[]`，每条自带 `protocolVersion` |
+| Card 鉴权 | `securitySchemes` + `security` | scheme 包在 `httpAuthSecurityScheme` 里；改用 `securityRequirements` |
+| 扩展 Card | `supportsAuthenticatedExtendedCard` | `capabilities.extendedAgentCard` |
+| A2A 错误细节 | 无 | `error.data[]` 携带 `google.rpc.ErrorInfo`，含 `reason` 与 `domain` |
 
 入站消息可携带 text、file、data 三类 part。file 与 data 会以方括号引用的形式进入模型
 上下文。回复为纯文本。
@@ -130,7 +166,6 @@ node example/probe.mjs http://127.0.0.1:9922 demo123
   config:
     basePath: /a2a
     publicUrl: https://agents.example.com/a2a   # 写入 Card 的对外地址
-    protocolVersion: 0.3.0
     provider: deepseek-official
     model: deepseek-v4-flash
 
@@ -173,10 +208,10 @@ node example/probe.mjs http://127.0.0.1:9922 demo123
 | --- | --- | --- |
 | `basePath` | `/a2a` | JSON-RPC 路由 |
 | `publicUrl` | 由 `Host` 推导 | 写入 Card 的可路由地址 |
-| `protocolVersion` | `0.3.0` | Card 上声明的协议版本 |
 | `provider` · `model` | — | 本服务创建的每个 agent 使用的模型路由 |
 | `card.public` | `true` | 无需凭据即可获取 Card |
 | `card.skills` | `[]` | 声明的 skills；为空时回退到一条 `general` |
+| `card.extendedSkills` | `[]` | 只对已认证 peer 经 `GetExtendedAgentCard` 公开的 skills |
 | `peers` | `{}` | 身份 → 凭据**引用名** |
 | `trustedPeers` | 全部已认证身份 | 允许执行任务的身份白名单 |
 | `rateLimitPerMinute` | `60` | 按身份的滑动窗口 |
@@ -231,7 +266,7 @@ A2A_PEER_ALICE: <32-byte-hex-from-openssl-rand>
 - 只提供 JSONRPC 绑定。不提供 gRPC 与 HTTP+JSON，Card 上如实声明。
 - 未实现推送通知。`push.enabled` 仅决定推送方法返回哪个错误码，Card 上声明
   `pushNotifications: false`。
-- 不支持扩展 Agent Card、`stateTransitionHistory`、协议扩展与 Card 签名。
+- 不支持 `stateTransitionHistory`、协议扩展与 Card 签名。
 - 流式只推送已提交的 assistant 消息，未实现逐 chunk 推送。
 - 无孤儿任务看门狗：卡在非终态的任务会一直保持该状态。
 - 未实现跨会话工具拒绝；隔离依赖 `workspaceMode`。
@@ -247,8 +282,8 @@ A2A_PEER_ALICE: <32-byte-hex-from-openssl-rand>
 ```
 src/
 ├── protocol/          零依赖库：不碰 Cordis、不碰 HTTP、不碰 harness
-│   ├── wire.ts        A2A 词汇表，统一归一到 v0.3 拼写
-│   ├── normalize.ts   v0.3 <-> v1.0 方言双向翻译
+│   ├── wire.ts        A2A v1.0 词汇表：只有一种形状，不需要翻译
+│   ├── parse.ts       入站解析与方法表
 │   ├── jsonrpc.ts     信封框架与 A2A 错误码
 │   ├── card.ts        Agent Card 构造
 │   └── sse.ts         SSE 帧编码
@@ -278,9 +313,9 @@ src/
 ```sh
 pnpm install
 pnpm typecheck
-pnpm test       # 9 个文件共 129 项测试
+pnpm test       # 10 个文件共 167 项测试
 pnpm serve      # 启动监听服务
-pnpm probe      # 对运行中的服务执行 48 项检查
+pnpm probe      # 对运行中的服务执行 67 项检查
 pnpm build      # 产出 lib/
 ```
 
@@ -293,8 +328,8 @@ pnpm build      # 产出 lib/
 
 官方项目提供 agent 运行时、插件系统，以及本插件所消费的各个能力接缝。本项目提供：
 
-- 入站的 A2A v0.3.0 JSON-RPC 绑定
-- Agent Card 构造与方言归一化
+- 入站的 A2A v1.0 JSON-RPC 绑定
+- Agent Card 构造与入站请求解析
 - A2A task 与 harness turn 之间的映射
 - 按 peer 的认证、隔离与工作目录策略
 
@@ -306,7 +341,7 @@ harness 处于 pre-release 阶段，不承诺跨重命名或重新打包的兼
 扫码加入微信群 **A2A 产品应用和探索** —— 交流 A2A 的实际应用，也包括这个插件。
 
 <p align="center">
-  <img src="assets/community-wechat.jpg" alt="微信群二维码" width="280">
+  <img src="https://raw.githubusercontent.com/huangjuhua-aigc/dsh-a2a/main/assets/community-wechat.jpg" alt="微信群二维码" width="280">
 </p>
 
 若二维码已过期，欢迎提 issue，我们会更新。

package/lib/config.d.ts

@@ -37,18 +37,27 @@ export interface IsolationConfig {
     /** Per-peer cwd overrides, e.g. pointing one trusted peer at a real repo. */
     peerWorkspaces: Record<string, string>;
 }
+/** One declared skill, as it appears on the Agent Card. */
+export interface SkillConfig {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+}
 /** Agent Card content and exposure. */
 export interface CardConfig {
     name: string;
     description: string;
     /** Serve the card without a credential, as discovery expects. */
     public: boolean;
-    skills: {
-        id: string;
-        name: string;
-        description: string;
-        tags: string[];
-    }[];
+    skills: SkillConfig[];
+    /**
+     * Skills revealed only through `GetExtendedAgentCard`, after a peer has
+     * authenticated. Declaring any turns on `capabilities.extendedAgentCard`;
+     * leaving this empty means the deployment has no extended card, and the
+     * method answers with the spec's own ExtendedAgentCardNotConfiguredError.
+     */
+    extendedSkills: SkillConfig[];
     provider?: {
         organization: string;
         url: string;
@@ -77,7 +86,6 @@ export interface PushConfig {
 export interface A2AServerConfig {
     basePath: string;
     publicUrl?: string;
-    protocolVersion: string;
     /**
      * Provider route for every agent this server creates. Optional so another
      * `agent/request` listener may supply the target instead; a runnable

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAQ7C,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,aAAa,EAAE,UAAU,GAAG,QAAQ,CAAA;IACpC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;IAC3E,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAA;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACjB;AAcD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,eAAe,CA+CzC,CAAA;AAEF,oEAAoE;AACpE,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA4BlE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAQ7C,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,aAAa,EAAE,UAAU,GAAG,QAAQ,CAAA;IACpC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,cAAc,EAAE,WAAW,EAAE,CAAA;IAC7B,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAA;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,UAAU,CAAA;CACjB;AAcD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,eAAe,CAoDzC,CAAA;AAEF,oEAAoE;AACpE,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA4BlE"}

package/lib/config.js

@@ -28,7 +28,6 @@ const PEER_NAME = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
 export const Config = Schema.object({
     basePath: Schema.string().default('/a2a'),
     publicUrl: Schema.string(),
-    protocolVersion: Schema.string().default('0.3.0'),
     provider: Schema.string(),
     model: Schema.string(),
     card: Schema.object({
@@ -41,6 +40,12 @@ export const Config = Schema.object({
             description: Schema.string().default(''),
             tags: Schema.array(Schema.string()).default([]),
         })).default([]),
+        extendedSkills: Schema.array(Schema.object({
+            id: Schema.string().required(),
+            name: Schema.string().required(),
+            description: Schema.string().default(''),
+            tags: Schema.array(Schema.string()).default([]),
+        })).default([]),
         // Both members default rather than being required: schemastery instantiates
         // a nested object even when the deployment omits it, so a `required()` here
         // would make an absent `provider` a validation failure.

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,0EAA0E;AAC1E,MAAM,cAAc,GAAG,0BAA0B,CAAA;AAEjD,6EAA6E;AAC7E,MAAM,SAAS,GAAG,6BAA6B,CAAA;AAuF/C;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;IAC1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;IAEtB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC;QACpF,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACjC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACf,4EAA4E;QAC5E,4EAA4E;QAC5E,wDAAwD;QACxD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;SACjC,CAAC;KACH,CAAC;IAEF,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC3C,kBAAkB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5C,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,WAAW,CAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACrD,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAEjD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAChF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC,QAAQ,EAAE;IAEb,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACzC,CAAC;CACH,CAAC,CAAA;AAEF,oEAAoE;AACpE,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,cAAc,CACtB,cAAc,IAAI,gBAAgB,MAAM,CAAC,SAAS,CAAC,8CAA8C,CAClG,CAAA;QACH,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,cAAc,CACtB,SAAS,IAAI,kDAAkD,MAAM,CAAC,cAAc,CAAC,sBAAsB,CAC5G,CAAA;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,cAAc,CAAC,uBAAuB,OAAO,mCAAmC,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,cAAc,CACtB,mCAAmC,IAAI,mCAAmC,CAC3E,CAAA;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,cAAc,CAAC,iCAAiC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC9E,CAAC;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,10 +1,15 @@
 /**
  * Inbound A2A protocol server for DeepSeek Harness.
  *
- * Publishes an Agent Card at a well-known URI and serves the A2A v0.3.0
- * JSON-RPC binding, so any compliant peer that knows this deployment's URL can
- * discover it and submit tasks to a harness agent. There is no outbound client:
- * this plugin never connects to another agent.
+ * Publishes an Agent Card at a well-known URI and serves the A2A v1.0 JSON-RPC
+ * binding, so any compliant peer that knows this deployment's URL can discover
+ * it and submit tasks to a harness agent. There is no outbound client: this
+ * plugin never connects to another agent.
+ *
+ * v1.0 is the ONLY protocol version served. The v0.3 method names, `kind`
+ * discriminators, and lowercase enums are gone rather than aliased: a reply
+ * this server produces is v1.0 JSON, and a v0.3 client could not read it, so
+ * answering a v0.3 request would fail further from its cause than refusing it.
  *
  * It is a TRANSPORT ADAPTER, not a capability seam — the same self-limitation
  * `dsh-acp` states. It exposes no editor navigation, transcript replay,

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAalD,OAAO,EAAwB,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAchF,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,eAAO,MAAM,IAAI,eAAe,CAAA;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,UAAyC,CAAA;AAW5D;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyejE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAelD,OAAO,EAAwB,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAehF,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,eAAO,MAAM,IAAI,eAAe,CAAA;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,UAAyC,CAAA;AAW5D;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6gBjE"}