@deepseek-harness-tui/dsh-tui 0.9.2 → 0.9.3

package/node_modules/@dsh-std/storage/schema/local-storage-0.15.schema.json

@@ -1,56 +1,56 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:dsh-std:storage:local-storage:0.15",
-  "title": "LocalStorage v0.15 operations",
-  "$defs": {
-    "jsonValue": {
-      "oneOf": [
-        { "type": "null" },
-        { "type": "boolean" },
-        { "type": "number" },
-        { "type": "string" },
-        { "type": "array", "items": { "$ref": "#/$defs/jsonValue" } },
-        { "type": "object", "additionalProperties": { "$ref": "#/$defs/jsonValue" } }
-      ]
-    },
-    "getInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["key"],
-      "properties": { "key": { "type": "string", "minLength": 1 } }
-    },
-    "getOutput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["value"],
-      "properties": { "value": { "$ref": "#/$defs/jsonValue" } }
-    },
-    "setInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["key", "value"],
-      "properties": {
-        "key": { "type": "string", "minLength": 1 },
-        "value": { "$ref": "#/$defs/jsonValue" }
-      }
-    },
-    "setOutput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["stored"],
-      "properties": { "stored": { "const": true } }
-    },
-    "deleteInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["key"],
-      "properties": { "key": { "type": "string", "minLength": 1 } }
-    },
-    "deleteOutput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["deleted"],
-      "properties": { "deleted": { "type": "boolean" } }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:dsh-std:storage:local-storage:0.15",
+  "title": "LocalStorage v0.15 operations",
+  "$defs": {
+    "jsonValue": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "number" },
+        { "type": "string" },
+        { "type": "array", "items": { "$ref": "#/$defs/jsonValue" } },
+        { "type": "object", "additionalProperties": { "$ref": "#/$defs/jsonValue" } }
+      ]
+    },
+    "getInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key"],
+      "properties": { "key": { "type": "string", "minLength": 1 } }
+    },
+    "getOutput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["value"],
+      "properties": { "value": { "$ref": "#/$defs/jsonValue" } }
+    },
+    "setInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "value"],
+      "properties": {
+        "key": { "type": "string", "minLength": 1 },
+        "value": { "$ref": "#/$defs/jsonValue" }
+      }
+    },
+    "setOutput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stored"],
+      "properties": { "stored": { "const": true } }
+    },
+    "deleteInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key"],
+      "properties": { "key": { "type": "string", "minLength": 1 } }
+    },
+    "deleteOutput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["deleted"],
+      "properties": { "deleted": { "type": "boolean" } }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepseek-harness-tui/dsh-tui",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Claude Code style interactive TUI front door for DeepSeek Harness agents, built on the ported Ink core.",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,8 @@
     "#dsh-ecosystem-spec/tui-channel": "./dsh-ecosystem-spec/protocols/tui-channel.js"
   },
   "bin": {
-    "dsh-tui": "./bin/dsh-tui.js"
+    "dsh-tui": "./bin/dsh-tui.js",
+    "dst": "./bin/dsh-tui.js"
   },
   "main": "lib/types/index.js",
   "types": "lib/types/index.d.ts",
@@ -98,7 +99,7 @@
     "prompt:debug": "node scripts/read-prompt-debug.mjs",
     "tui": "node --import tsx/esm scripts/run.ts",
     "smoke": "node --import tsx/esm scripts/smoke.tsx",
-    "verify:build": "npm run verify:boundary && npm run verify:contract && npm run verify:herdr && npm run verify:manifest-deps && npm run verify:patch-surface && npm run verify:web-coexistence && npm run verify:plugin-spec && npm run verify:plugin-grants && npm run verify:plugin-storage && npm run verify:plugin-messages && npm run verify:plugin-ledger && npm run verify:plugin-commands && npm run verify:plugin-negotiation && npm run verify:plugin-lifecycle && npm run verify:packaged-presets && npm run verify:minimal-preset-tools && npm run verify:liangshen-bootstrap && npm run verify:wheel-selection && npm run verify:liangshen-instruction-hint && npm run verify:pointer-events && npm run verify:chat-overlay && npm run verify:i18n",
+    "verify:build": "npm run verify:boundary && npm run verify:contract && npm run verify:herdr && npm run verify:manifest-deps && npm run verify:patch-surface && npm run verify:web-coexistence && npm run verify:plugin-spec && npm run verify:plugin-grants && npm run verify:plugin-storage && npm run verify:plugin-messages && npm run verify:plugin-ledger && npm run verify:plugin-commands && npm run verify:plugin-negotiation && npm run verify:plugin-lifecycle && npm run verify:packaged-presets && npm run verify:history-search && npm run verify:skill-direct-invocation && npm run verify:minimal-preset-tools && npm run verify:liangshen-bootstrap && npm run verify:wheel-selection && npm run verify:liangshen-instruction-hint && npm run verify:pointer-events && npm run verify:chat-overlay && npm run verify:i18n && npm run verify:approval-visibility",
     "verify:boundary": "node --import tsx/esm scripts/verify-adapter-boundary.ts",
     "verify:i18n": "node --import tsx/esm scripts/verify-i18n.ts",
     "verify:contract": "node --import tsx/esm scripts/verify-upstream-contract.ts",
@@ -119,6 +120,7 @@
     "verify:bun-package": "node scripts/verify-bun-package.mjs",
     "verify:prompt-debug": "npm run build && node scripts/verify-prompt-debug.mjs",
     "verify:clipboard-image": "node --import tsx/esm scripts/verify-clipboard-image.ts",
+    "verify:history-search": "node --import tsx/esm scripts/verify-history-search.mjs",
     "verify:plugin-ledger": "node --import tsx/esm scripts/verify-plugin-ledger.ts",
     "verify:plugin-commands": "node --import tsx/esm scripts/verify-plugin-commands.ts",
     "verify:plugin-negotiation": "node --import tsx/esm scripts/verify-plugin-negotiation.ts",
@@ -128,8 +130,12 @@
     "verify:wheel-selection": "node --import tsx/esm scripts/verify-wheel-selection.ts",
     "verify:pointer-events": "node --import tsx/esm scripts/verify-pointer-events.ts",
     "verify:chat-overlay": "node --import tsx/esm scripts/verify-chat-overlay.ts",
+    "verify:approval-visibility": "node --import tsx/esm scripts/verify-approval-visibility.tsx",
+    "verify:skill-direct-invocation": "node --import tsx/esm scripts/verify-skill-direct-invocation.ts",
     "sync:profile": "node scripts/sync-profile.mjs",
-    "sync:profile:check": "node scripts/sync-profile.mjs --check"
+    "sync:profile:check": "node scripts/sync-profile.mjs --check",
+    "bundle:installer": "node scripts/make-installer-bundle.mjs",
+    "bundle:standalone": "node scripts/make-standalone-bundle.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -160,8 +166,92 @@
     "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6 || ^0.1.1-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-instructions": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-atomic-write": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-cordis-host-runner": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm-pi-ai": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-persona": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-storage": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-storage-domain": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-storage-json": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-terminal": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-terminal-bash": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-ask-user": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-bash-persistent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-questions": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-workspace": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@alcalzone/ansi-tokenize": "^0.3.0",
+    "@earendil-works/pi-ai": "^0.82.1",
     "auto-bind": "^4.0.0 || ^5.0.0",
     "bidi-js": "^1.0.0",
     "chalk": "^5.0.0",
@@ -170,7 +260,6 @@
     "code-excerpt": "^3.0.0 || ^4.0.0",
     "diff": "^8.0.4",
     "dsh-working-activity": "^0.3.3",
-    "@earendil-works/pi-ai": "^0.82.1",
     "emoji-regex": "^10.0.0",
     "figures": "^6.1.0",
     "get-east-asian-width": "^1.0.0",
@@ -251,6 +340,7 @@
     "@types/react-reconciler": "^0.33.0",
     "@types/semver": "^7.0.0",
     "@xterm/headless": "^6.0.0",
+    "tar": "^7.5.22",
     "tsx": "^4.0.0",
     "typescript": "^6.0.3",
     "yaml": "^2.9.0"

package/skills/pr-comments/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pr-comments
-description: Use when the user asks to review pull request comments, or when the /pr_comments command runs — fetch and analyze PR review comments on the current branch and summarize actionable items.
+description: Use when the user asks to review pull request comments, or when the /pr-comments command runs — fetch and analyze PR review comments on the current branch and summarize actionable items.
 ---
 
 # Pull Request Comments Review

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/CHANGELOG.md

@@ -1,8 +1,8 @@
-# Changelog
-
-Changes to `@dsh-std/connection` are recorded here.
-
-## 0.1.0 (draft)
-
-- Defined connection services, endpoint views, participant publication, capability bindings, and attachments.
-- Added an in-memory transport for protocol conformance and host integration tests.
+# Changelog
+
+Changes to `@dsh-std/connection` are recorded here.
+
+## 0.1.0 (draft)
+
+- Defined connection services, endpoint views, participant publication, capability bindings, and attachments.
+- Added an in-memory transport for protocol conformance and host integration tests.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 DSH Standard contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 DSH Standard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/README.md

@@ -1,42 +1,42 @@
-# @dsh-std/connection
-
-English | [中文](README.zh.md)
-
-The proposed design is documented in [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md). It separates the application-facing `ConnectionService` from the Connection Host provider SPI. The remainder of this page describes the current reference implementation, which does not yet complete that split.
-
-Host-provided communication service, two-endpoint capability negotiation, and implementation-neutral invocation for the DSH Standard.
-
-## Endpoint offers
-
-An endpoint offer contains an endpoint identity, a revision, and the live participant declarations admitted by endpoint policy. It carries no component manifests, installation inventory, or plugin registry.
-
-`resolveConnection()` passes both sets of declarations to a caller-owned `ProtocolCatalog`. Each protocol definition owns its negotiation and may place invocation bindings in its agreement; connection does not impose consumer/provider semantics on every protocol. `defineCapabilityProtocol()` is an explicit helper for domain protocols that do use RPC-shaped bindings.
-
-Each invocation binding is participant-scoped and plan-revision-scoped. A client for one participant cannot discover or invoke bindings granted to another participant.
-
-## Current reference API
-
-`StandardConnection` exposes endpoint identities, the active plan, consumer-scoped clients, plan-change observation, and close. `CapabilityClient.invoke()` returns an invocation id, a result promise, an asynchronous progress stream, and cancellation. Domain protocol packages own operation names and input, output, and progress values.
-
-`ConnectionBroker` selects one registered `ConnectionConnector` for an implementation-neutral target URI. Zero matches and multiple matches are both explicit errors. The broker does not expose the selected connector type through `StandardConnection`.
-
-These types are an early reference implementation. They do not require a TUI, Web UI, GUI, or business plugin to register and operate its own connector. The protocol direction places the broker, connector/provider registry, carrier, and wire behind a Connection Host's `ConnectionService`. A consumer submits a target and uses scoped typed clients for the negotiated protocols.
-
-A Connection Host may install or discover a remote service, own authentication, ports, forwarding and reconnection, and produce the `StandardConnection`. An SSH target facet contributes resolution and bootstrap integration while system OpenSSH or another provider may supply the physical SSH implementation. Applications do not observe the selected provider, ports, credentials, or wire.
-
-## Lifecycle
-
-Renegotiation creates a complete new plan revision and publishes it atomically. An invocation admitted under the old revision retains its binding until settlement; later invocations use the new revision. Closing a connection cancels active work and rejects new work with `connection-closed`.
-
-Transport implementations must preserve invocation isolation, progress order, cancellation, and the error classification exposed by `ConnectionInvocationError`. They are also responsible for authenticating the peer and preventing one connection from reusing another connection's grants.
-
-## Reference implementation
-
-The `@dsh-std/connection/memory` export provides a process-local implementation for tests, adapters, and conformance experiments. It demonstrates symmetric calls, progress, cancellation, isolation, and renegotiation. It is not a required carrier or a wire-format specification.
-
-## Known Limitations and Deferred Work
-
-- The consumer-facing `ConnectionService` and Host provider SPI are not implemented in the current code yet.
-- The package does not yet standardize discovery, authentication, encryption, reconnect policy, framing, or serialization.
-- A connection has exactly two endpoints in `v1alpha1`; multi-party routing is composed from separate connections.
-- The capability helper requires one peer provider by default. Protocols that allow multiple providers must opt into and define that behavior explicitly.
+# @dsh-std/connection
+
+English | [中文](README.zh.md)
+
+The proposed design is documented in [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md). It separates the application-facing `ConnectionService` from the Connection Host provider SPI. The remainder of this page describes the current reference implementation, which does not yet complete that split.
+
+Host-provided communication service, two-endpoint capability negotiation, and implementation-neutral invocation for the DSH Standard.
+
+## Endpoint offers
+
+An endpoint offer contains an endpoint identity, a revision, and the live participant declarations admitted by endpoint policy. It carries no component manifests, installation inventory, or plugin registry.
+
+`resolveConnection()` passes both sets of declarations to a caller-owned `ProtocolCatalog`. Each protocol definition owns its negotiation and may place invocation bindings in its agreement; connection does not impose consumer/provider semantics on every protocol. `defineCapabilityProtocol()` is an explicit helper for domain protocols that do use RPC-shaped bindings.
+
+Each invocation binding is participant-scoped and plan-revision-scoped. A client for one participant cannot discover or invoke bindings granted to another participant.
+
+## Current reference API
+
+`StandardConnection` exposes endpoint identities, the active plan, consumer-scoped clients, plan-change observation, and close. `CapabilityClient.invoke()` returns an invocation id, a result promise, an asynchronous progress stream, and cancellation. Domain protocol packages own operation names and input, output, and progress values.
+
+`ConnectionBroker` selects one registered `ConnectionConnector` for an implementation-neutral target URI. Zero matches and multiple matches are both explicit errors. The broker does not expose the selected connector type through `StandardConnection`.
+
+These types are an early reference implementation. They do not require a TUI, Web UI, GUI, or business plugin to register and operate its own connector. The protocol direction places the broker, connector/provider registry, carrier, and wire behind a Connection Host's `ConnectionService`. A consumer submits a target and uses scoped typed clients for the negotiated protocols.
+
+A Connection Host may install or discover a remote service, own authentication, ports, forwarding and reconnection, and produce the `StandardConnection`. An SSH target facet contributes resolution and bootstrap integration while system OpenSSH or another provider may supply the physical SSH implementation. Applications do not observe the selected provider, ports, credentials, or wire.
+
+## Lifecycle
+
+Renegotiation creates a complete new plan revision and publishes it atomically. An invocation admitted under the old revision retains its binding until settlement; later invocations use the new revision. Closing a connection cancels active work and rejects new work with `connection-closed`.
+
+Transport implementations must preserve invocation isolation, progress order, cancellation, and the error classification exposed by `ConnectionInvocationError`. They are also responsible for authenticating the peer and preventing one connection from reusing another connection's grants.
+
+## Reference implementation
+
+The `@dsh-std/connection/memory` export provides a process-local implementation for tests, adapters, and conformance experiments. It demonstrates symmetric calls, progress, cancellation, isolation, and renegotiation. It is not a required carrier or a wire-format specification.
+
+## Known Limitations and Deferred Work
+
+- The consumer-facing `ConnectionService` and Host provider SPI are not implemented in the current code yet.
+- The package does not yet standardize discovery, authentication, encryption, reconnect policy, framing, or serialization.
+- A connection has exactly two endpoints in `v1alpha1`; multi-party routing is composed from separate connections.
+- The capability helper requires one peer provider by default. Protocols that allow multiple providers must opt into and define that behavior explicitly.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/README.zh.md

@@ -1,42 +1,42 @@
-# @dsh-std/connection
-
-[English](README.md) | 中文
-
-拟议设计见 [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md)。规范把普通应用使用的 `ConnectionService` 与 Connection Host 的 provider SPI 分开；本页其余内容描述尚未完成该分层的当前参考实现。
-
-DSH Standard 的宿主通信 service、双端点能力协商与实现无关调用。
-
-## 端点提议
-
-端点提议包含端点身份、修订号，以及经端点 policy 裁剪后的 live participant declarations。它不携带 component manifests、安装记录或插件注册表。
-
-`resolveConnection()` 把两端 declarations 交给调用方提供的 `ProtocolCatalog`。每份协议 definition 决定如何协商，并可在 agreement 中产生调用绑定；connection 不为所有协议预设 consumer/provider 语义。内置的 `defineCapabilityProtocol()` 是需要 RPC 绑定的领域协议可显式采用的辅助定义。
-
-每项调用绑定都限定于消费 participant 和方案修订版。一个 participant 的客户端不能发现或调用授予另一 participant 的绑定。
-
-## 当前参考 API
-
-`StandardConnection` 暴露端点身份、当前方案、按消费方隔离的客户端、方案变更观察与关闭操作。`CapabilityClient.invoke()` 返回调用 id、结果 Promise、异步进度流与取消操作。领域协议包拥有操作名称以及输入、输出和进度值的语义。
-
-`ConnectionBroker` 根据与实现无关的目标 URI，从已注册 `ConnectionConnector` 中选择唯一实现。零个匹配与多个匹配都是明确错误。broker 不会通过 `StandardConnection` 暴露选中的 connector 类型。
-
-这些类型是早期参考实现，不表示 TUI、Web、GUI 或业务插件应自行注册 connector。规范方向是由 Connection Host 把 broker、connector/provider、carrier 和 wire 封装为 `ConnectionService`；consumer 只提交 target，并通过 scoped typed client 使用已协商协议。
-
-Connection Host 负责安装或发现远端服务、认证、端口与转发、重连和 `StandardConnection`。SSH target facet 可以贡献解析与 bootstrap 集成，物理 SSH 则可由系统 OpenSSH 或独立 provider 完成。应用不会看到所选 provider、端口、凭据或 wire。
-
-## 生命周期
-
-重新协商会生成完整的新方案修订版，并原子发布。旧修订版已经接纳的调用保留其绑定直至结束；后续调用使用新修订版。关闭连接会取消活跃工作，并以 `connection-closed` 拒绝新工作。
-
-传输实现必须保持调用隔离、进度顺序、取消语义和 `ConnectionInvocationError` 暴露的错误分类。实现还负责认证对端，并阻止一条连接复用另一条连接的授权。
-
-## 参考实现
-
-`@dsh-std/connection/memory` 导出用于测试、适配器和一致性实验的进程内实现。它演示双向调用、进度、取消、隔离和重新协商，但不是强制承载方式或线协议规范。
-
-## 已知限制与暂缓事项
-
-- consumer-facing `ConnectionService` 与 Host provider SPI 尚未在当前代码中实现。
-- 本包尚未标准化发现、认证、加密、重连策略、封帧或序列化。
-- `v1alpha1` 的一条连接恰好包含两个端点；多方路由由多条独立连接组合。
-- Capability helper 默认要求唯一对端提供方；需要多提供方的协议必须明确选择其规则。
+# @dsh-std/connection
+
+[English](README.md) | 中文
+
+拟议设计见 [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md)。规范把普通应用使用的 `ConnectionService` 与 Connection Host 的 provider SPI 分开；本页其余内容描述尚未完成该分层的当前参考实现。
+
+DSH Standard 的宿主通信 service、双端点能力协商与实现无关调用。
+
+## 端点提议
+
+端点提议包含端点身份、修订号，以及经端点 policy 裁剪后的 live participant declarations。它不携带 component manifests、安装记录或插件注册表。
+
+`resolveConnection()` 把两端 declarations 交给调用方提供的 `ProtocolCatalog`。每份协议 definition 决定如何协商，并可在 agreement 中产生调用绑定；connection 不为所有协议预设 consumer/provider 语义。内置的 `defineCapabilityProtocol()` 是需要 RPC 绑定的领域协议可显式采用的辅助定义。
+
+每项调用绑定都限定于消费 participant 和方案修订版。一个 participant 的客户端不能发现或调用授予另一 participant 的绑定。
+
+## 当前参考 API
+
+`StandardConnection` 暴露端点身份、当前方案、按消费方隔离的客户端、方案变更观察与关闭操作。`CapabilityClient.invoke()` 返回调用 id、结果 Promise、异步进度流与取消操作。领域协议包拥有操作名称以及输入、输出和进度值的语义。
+
+`ConnectionBroker` 根据与实现无关的目标 URI，从已注册 `ConnectionConnector` 中选择唯一实现。零个匹配与多个匹配都是明确错误。broker 不会通过 `StandardConnection` 暴露选中的 connector 类型。
+
+这些类型是早期参考实现，不表示 TUI、Web、GUI 或业务插件应自行注册 connector。规范方向是由 Connection Host 把 broker、connector/provider、carrier 和 wire 封装为 `ConnectionService`；consumer 只提交 target，并通过 scoped typed client 使用已协商协议。
+
+Connection Host 负责安装或发现远端服务、认证、端口与转发、重连和 `StandardConnection`。SSH target facet 可以贡献解析与 bootstrap 集成，物理 SSH 则可由系统 OpenSSH 或独立 provider 完成。应用不会看到所选 provider、端口、凭据或 wire。
+
+## 生命周期
+
+重新协商会生成完整的新方案修订版，并原子发布。旧修订版已经接纳的调用保留其绑定直至结束；后续调用使用新修订版。关闭连接会取消活跃工作，并以 `connection-closed` 拒绝新工作。
+
+传输实现必须保持调用隔离、进度顺序、取消语义和 `ConnectionInvocationError` 暴露的错误分类。实现还负责认证对端，并阻止一条连接复用另一条连接的授权。
+
+## 参考实现
+
+`@dsh-std/connection/memory` 导出用于测试、适配器和一致性实验的进程内实现。它演示双向调用、进度、取消、隔离和重新协商，但不是强制承载方式或线协议规范。
+
+## 已知限制与暂缓事项
+
+- consumer-facing `ConnectionService` 与 Host provider SPI 尚未在当前代码中实现。
+- 本包尚未标准化发现、认证、加密、重连策略、封帧或序列化。
+- `v1alpha1` 的一条连接恰好包含两个端点；多方路由由多条独立连接组合。
+- Capability helper 默认要求唯一对端提供方；需要多提供方的协议必须明确选择其规则。

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/broker.ts","../src/endpoint.ts"],"sourcesContent":["import { validateEndpointOffer } from './model.js'\r\nimport type { ConnectionEndpoint, StandardConnection } from './connection.js'\r\n\r\nexport interface ConnectionTarget {\r\n  /** Implementation-neutral target. Its URI scheme is interpreted by registered connectors. */\r\n  readonly uri: string\r\n  readonly metadata?: Readonly<Record<string, string>>\r\n}\r\n\r\nexport interface ConnectRequest {\r\n  readonly target: ConnectionTarget\r\n  /** Live endpoint, including the dispatcher used for peer-to-local calls. */\r\n  readonly local: ConnectionEndpoint\r\n  readonly signal?: AbortSignal\r\n}\r\n\r\n/** Client half of one concrete connection implementation. */\r\nexport interface ConnectionConnector {\r\n  /** Namespaced implementation identity, not a transport or product name exposed to domain consumers. */\r\n  readonly id: string\r\n  supports(target: ConnectionTarget): boolean\r\n  connect(request: ConnectRequest): Promise<StandardConnection>\r\n}\r\n\r\nexport class ConnectionSelectionError extends Error {\r\n  constructor(\r\n    readonly code: 'implementation-unavailable' | 'implementation-ambiguous',\r\n    message: string,\r\n    readonly implementations: readonly string[],\r\n  ) {\r\n    super(message)\r\n    this.name = 'ConnectionSelectionError'\r\n  }\r\n}\r\n\r\n/**\r\n * Implementation registry used by an adapter or application composition root.\r\n * Domain consumers request a connection; they never import the selected implementation.\r\n */\r\nexport class ConnectionBroker {\r\n  private readonly connectors = new Map<string, ConnectionConnector>()\r\n\r\n  register(connector: ConnectionConnector): () => void {\r\n    namespaced(connector.id, 'connection connector id')\r\n    if (this.connectors.has(connector.id)) throw new Error(`connection connector ${JSON.stringify(connector.id)} is already registered`)\r\n    this.connectors.set(connector.id, connector)\r\n    return () => { if (this.connectors.get(connector.id) === connector) this.connectors.delete(connector.id) }\r\n  }\r\n\r\n  implementations(target?: ConnectionTarget): readonly string[] {\r\n    if (target !== undefined) validateTarget(target)\r\n    return Object.freeze([...this.connectors.values()]\r\n      .filter(connector => target === undefined || safelySupports(connector, target))\r\n      .map(connector => connector.id)\r\n      .sort())\r\n  }\r\n\r\n  async connect(request: ConnectRequest): Promise<StandardConnection> {\r\n    validateTarget(request.target)\r\n    validateEndpointOffer(request.local.offer)\r\n    request.signal?.throwIfAborted()\r\n    const matches = [...this.connectors.values()]\r\n      .filter(connector => safelySupports(connector, request.target))\r\n      .sort((left, right) => left.id.localeCompare(right.id))\r\n    if (matches.length === 0) {\r\n      throw new ConnectionSelectionError(\r\n        'implementation-unavailable',\r\n        `no connection implementation supports ${JSON.stringify(request.target.uri)}`,\r\n        [],\r\n      )\r\n    }\r\n    if (matches.length > 1) {\r\n      const ids = Object.freeze(matches.map(connector => connector.id))\r\n      throw new ConnectionSelectionError(\r\n        'implementation-ambiguous',\r\n        `multiple connection implementations support ${JSON.stringify(request.target.uri)}: ${ids.join(', ')}`,\r\n        ids,\r\n      )\r\n    }\r\n    return matches[0]!.connect(request)\r\n  }\r\n}\r\n\r\nfunction safelySupports(connector: ConnectionConnector, target: ConnectionTarget): boolean {\r\n  try { return connector.supports(target) } catch { return false }\r\n}\r\n\r\nfunction validateTarget(target: ConnectionTarget): void {\r\n  if (typeof target.uri !== 'string' || target.uri.trim() === '') throw new TypeError('connection target uri must be non-empty')\r\n  if (target.metadata !== undefined) {\r\n    for (const [key, value] of Object.entries(target.metadata)) {\r\n      if (key.trim() === '' || typeof value !== 'string') throw new TypeError('connection target metadata must contain string pairs')\r\n    }\r\n  }\r\n}\r\n\r\nfunction namespaced(value: string, label: string): void {\r\n  if (!/^[a-z][a-z0-9]*(?:[.-][a-z0-9][a-z0-9-]*)+$/u.test(value)) throw new TypeError(`${label} must be namespaced`)\r\n}\r\n","import {\r\n  defineProtocolDeclaration,\r\n  sameProtocol,\r\n  type ProtocolDeclaration,\r\n  type ProtocolSupport,\r\n} from '@dsh-std/core'\r\nimport {\r\n  ConnectionInvocationError,\r\n  type CapabilityDispatch,\r\n  type CapabilityImplementation,\r\n  type ConnectionEndpoint,\r\n} from './connection.js'\r\nimport { createEndpointOffer, type EndpointIdentity, type EndpointOffer } from './model.js'\r\n\r\nexport interface EndpointPublication {\r\n  readonly declaration: ProtocolDeclaration\r\n  readonly implementations?: readonly CapabilityImplementation[]\r\n}\r\n\r\nexport interface EndpointRuntimeOptions extends EndpointIdentity {\r\n  readonly revision?: number\r\n}\r\n\r\nexport class StandardEndpointRuntime implements ConnectionEndpoint {\r\n  private readonly declarations = new Map<string, ProtocolDeclaration>()\r\n  private readonly implementations: CapabilityImplementation[] = []\r\n  private readonly listeners = new Set<(offer: EndpointOffer) => void>()\r\n  private readonly identity: EndpointIdentity\r\n  private revision: number\r\n  private currentOffer: EndpointOffer\r\n\r\n  constructor(options: EndpointRuntimeOptions) {\r\n    this.identity = Object.freeze({ id: options.id, instanceId: options.instanceId })\r\n    this.revision = options.revision ?? 0\r\n    this.currentOffer = this.createOffer()\r\n  }\r\n\r\n  get offer(): EndpointOffer { return this.currentOffer }\r\n\r\n  register(publication: EndpointPublication): () => void {\r\n    const declaration = defineProtocolDeclaration(publication.declaration)\r\n    const participantId = declaration.participant.id\r\n    if (this.declarations.has(participantId)) throw new Error(`participant ${JSON.stringify(participantId)} is already registered`)\r\n    const implementations = [...(publication.implementations ?? [])]\r\n    const implemented = new Set<string>()\r\n    for (const implementation of implementations) {\r\n      if (implementation.participantId !== participantId) throw new TypeError(`implementation participantId must be ${JSON.stringify(participantId)}`)\r\n      if (!(declaration.supports ?? []).some(support => sameProtocol(support, implementation.protocol))) {\r\n        throw new TypeError(`participant implementation ${implementation.protocol.apiVersion} ${implementation.protocol.kind} is not declared live`)\r\n      }\r\n      const key = `${implementation.protocol.apiVersion}\\0${implementation.protocol.kind}`\r\n      if (implemented.has(key)) throw new TypeError(`participant has multiple implementations for ${implementation.protocol.apiVersion} ${implementation.protocol.kind}`)\r\n      implemented.add(key)\r\n    }\r\n    const stored = implementations.map(implementation => Object.freeze({\r\n      ...implementation, protocol: Object.freeze({ ...implementation.protocol }),\r\n      handle: implementation.handle as CapabilityImplementation['handle'],\r\n    }))\r\n    this.declarations.set(participantId, declaration)\r\n    this.implementations.push(...stored)\r\n    this.publishOffer()\r\n    let active = true\r\n    return () => {\r\n      if (!active) return\r\n      active = false\r\n      if (this.declarations.get(participantId) === declaration) this.declarations.delete(participantId)\r\n      for (const implementation of stored) {\r\n        const index = this.implementations.indexOf(implementation)\r\n        if (index >= 0) this.implementations.splice(index, 1)\r\n      }\r\n      this.publishOffer()\r\n    }\r\n  }\r\n\r\n  async dispatch<TInput = unknown, TOutput = unknown, TProgress = unknown>(invocation: CapabilityDispatch<TInput, TProgress>): Promise<TOutput> {\r\n    validateDispatch(invocation, this.currentOffer)\r\n    const implementation = this.implementations.find(candidate =>\r\n      candidate.participantId === invocation.binding.provider.participantId\r\n      && sameProtocol(candidate.protocol, invocation.binding.support))\r\n    if (implementation === undefined) throw new ConnectionInvocationError('handler-missing', `binding ${JSON.stringify(invocation.binding.bindingId)} has no live implementation`)\r\n    try {\r\n      return await implementation.handle(invocation.operation, invocation.input, Object.freeze({\r\n        connectionId: invocation.connectionId,\r\n        planRevision: invocation.planRevision,\r\n        invocationId: invocation.invocationId,\r\n        binding: invocation.binding,\r\n        signal: invocation.signal,\r\n        progress: invocation.progress,\r\n      })) as TOutput\r\n    } catch (error) {\r\n      if (error instanceof ConnectionInvocationError) throw error\r\n      throw new ConnectionInvocationError('handler-failed', error instanceof Error ? error.message : String(error), { cause: error })\r\n    }\r\n  }\r\n\r\n  onOfferChange(listener: (offer: EndpointOffer) => void): () => void {\r\n    this.listeners.add(listener)\r\n    return () => { this.listeners.delete(listener) }\r\n  }\r\n\r\n  private createOffer(): EndpointOffer {\r\n    return createEndpointOffer(this.identity, this.revision, [...this.declarations.values()])\r\n  }\r\n\r\n  private publishOffer(): void {\r\n    this.revision += 1\r\n    this.currentOffer = this.createOffer()\r\n    for (const listener of this.listeners) listener(this.currentOffer)\r\n  }\r\n}\r\n\r\nfunction validateDispatch(invocation: CapabilityDispatch, offer: EndpointOffer): void {\r\n  if (invocation.connectionId.trim() === '') throw new TypeError('connectionId must be non-empty')\r\n  if (!Number.isSafeInteger(invocation.planRevision) || invocation.planRevision < 1) throw new TypeError('planRevision must be positive')\r\n  if (invocation.binding.planRevision !== invocation.planRevision) throw new ConnectionInvocationError('capability-unbound', 'binding belongs to another plan revision')\r\n  if (invocation.binding.provider.endpoint.instanceId !== offer.endpoint.instanceId) throw new ConnectionInvocationError('capability-unbound', 'binding provider belongs to another endpoint')\r\n  if (invocation.invocationId.trim() === '' || invocation.operation.trim() === '') throw new TypeError('invocationId and operation must be non-empty')\r\n  invocation.signal.throwIfAborted()\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/broker.ts","../src/endpoint.ts"],"sourcesContent":["import { validateEndpointOffer } from './model.js'\nimport type { ConnectionEndpoint, StandardConnection } from './connection.js'\n\nexport interface ConnectionTarget {\n  /** Implementation-neutral target. Its URI scheme is interpreted by registered connectors. */\n  readonly uri: string\n  readonly metadata?: Readonly<Record<string, string>>\n}\n\nexport interface ConnectRequest {\n  readonly target: ConnectionTarget\n  /** Live endpoint, including the dispatcher used for peer-to-local calls. */\n  readonly local: ConnectionEndpoint\n  readonly signal?: AbortSignal\n}\n\n/** Client half of one concrete connection implementation. */\nexport interface ConnectionConnector {\n  /** Namespaced implementation identity, not a transport or product name exposed to domain consumers. */\n  readonly id: string\n  supports(target: ConnectionTarget): boolean\n  connect(request: ConnectRequest): Promise<StandardConnection>\n}\n\nexport class ConnectionSelectionError extends Error {\n  constructor(\n    readonly code: 'implementation-unavailable' | 'implementation-ambiguous',\n    message: string,\n    readonly implementations: readonly string[],\n  ) {\n    super(message)\n    this.name = 'ConnectionSelectionError'\n  }\n}\n\n/**\n * Implementation registry used by an adapter or application composition root.\n * Domain consumers request a connection; they never import the selected implementation.\n */\nexport class ConnectionBroker {\n  private readonly connectors = new Map<string, ConnectionConnector>()\n\n  register(connector: ConnectionConnector): () => void {\n    namespaced(connector.id, 'connection connector id')\n    if (this.connectors.has(connector.id)) throw new Error(`connection connector ${JSON.stringify(connector.id)} is already registered`)\n    this.connectors.set(connector.id, connector)\n    return () => { if (this.connectors.get(connector.id) === connector) this.connectors.delete(connector.id) }\n  }\n\n  implementations(target?: ConnectionTarget): readonly string[] {\n    if (target !== undefined) validateTarget(target)\n    return Object.freeze([...this.connectors.values()]\n      .filter(connector => target === undefined || safelySupports(connector, target))\n      .map(connector => connector.id)\n      .sort())\n  }\n\n  async connect(request: ConnectRequest): Promise<StandardConnection> {\n    validateTarget(request.target)\n    validateEndpointOffer(request.local.offer)\n    request.signal?.throwIfAborted()\n    const matches = [...this.connectors.values()]\n      .filter(connector => safelySupports(connector, request.target))\n      .sort((left, right) => left.id.localeCompare(right.id))\n    if (matches.length === 0) {\n      throw new ConnectionSelectionError(\n        'implementation-unavailable',\n        `no connection implementation supports ${JSON.stringify(request.target.uri)}`,\n        [],\n      )\n    }\n    if (matches.length > 1) {\n      const ids = Object.freeze(matches.map(connector => connector.id))\n      throw new ConnectionSelectionError(\n        'implementation-ambiguous',\n        `multiple connection implementations support ${JSON.stringify(request.target.uri)}: ${ids.join(', ')}`,\n        ids,\n      )\n    }\n    return matches[0]!.connect(request)\n  }\n}\n\nfunction safelySupports(connector: ConnectionConnector, target: ConnectionTarget): boolean {\n  try { return connector.supports(target) } catch { return false }\n}\n\nfunction validateTarget(target: ConnectionTarget): void {\n  if (typeof target.uri !== 'string' || target.uri.trim() === '') throw new TypeError('connection target uri must be non-empty')\n  if (target.metadata !== undefined) {\n    for (const [key, value] of Object.entries(target.metadata)) {\n      if (key.trim() === '' || typeof value !== 'string') throw new TypeError('connection target metadata must contain string pairs')\n    }\n  }\n}\n\nfunction namespaced(value: string, label: string): void {\n  if (!/^[a-z][a-z0-9]*(?:[.-][a-z0-9][a-z0-9-]*)+$/u.test(value)) throw new TypeError(`${label} must be namespaced`)\n}\n","import {\n  defineProtocolDeclaration,\n  sameProtocol,\n  type ProtocolDeclaration,\n  type ProtocolSupport,\n} from '@dsh-std/core'\nimport {\n  ConnectionInvocationError,\n  type CapabilityDispatch,\n  type CapabilityImplementation,\n  type ConnectionEndpoint,\n} from './connection.js'\nimport { createEndpointOffer, type EndpointIdentity, type EndpointOffer } from './model.js'\n\nexport interface EndpointPublication {\n  readonly declaration: ProtocolDeclaration\n  readonly implementations?: readonly CapabilityImplementation[]\n}\n\nexport interface EndpointRuntimeOptions extends EndpointIdentity {\n  readonly revision?: number\n}\n\nexport class StandardEndpointRuntime implements ConnectionEndpoint {\n  private readonly declarations = new Map<string, ProtocolDeclaration>()\n  private readonly implementations: CapabilityImplementation[] = []\n  private readonly listeners = new Set<(offer: EndpointOffer) => void>()\n  private readonly identity: EndpointIdentity\n  private revision: number\n  private currentOffer: EndpointOffer\n\n  constructor(options: EndpointRuntimeOptions) {\n    this.identity = Object.freeze({ id: options.id, instanceId: options.instanceId })\n    this.revision = options.revision ?? 0\n    this.currentOffer = this.createOffer()\n  }\n\n  get offer(): EndpointOffer { return this.currentOffer }\n\n  register(publication: EndpointPublication): () => void {\n    const declaration = defineProtocolDeclaration(publication.declaration)\n    const participantId = declaration.participant.id\n    if (this.declarations.has(participantId)) throw new Error(`participant ${JSON.stringify(participantId)} is already registered`)\n    const implementations = [...(publication.implementations ?? [])]\n    const implemented = new Set<string>()\n    for (const implementation of implementations) {\n      if (implementation.participantId !== participantId) throw new TypeError(`implementation participantId must be ${JSON.stringify(participantId)}`)\n      if (!(declaration.supports ?? []).some(support => sameProtocol(support, implementation.protocol))) {\n        throw new TypeError(`participant implementation ${implementation.protocol.apiVersion} ${implementation.protocol.kind} is not declared live`)\n      }\n      const key = `${implementation.protocol.apiVersion}\\0${implementation.protocol.kind}`\n      if (implemented.has(key)) throw new TypeError(`participant has multiple implementations for ${implementation.protocol.apiVersion} ${implementation.protocol.kind}`)\n      implemented.add(key)\n    }\n    const stored = implementations.map(implementation => Object.freeze({\n      ...implementation, protocol: Object.freeze({ ...implementation.protocol }),\n      handle: implementation.handle as CapabilityImplementation['handle'],\n    }))\n    this.declarations.set(participantId, declaration)\n    this.implementations.push(...stored)\n    this.publishOffer()\n    let active = true\n    return () => {\n      if (!active) return\n      active = false\n      if (this.declarations.get(participantId) === declaration) this.declarations.delete(participantId)\n      for (const implementation of stored) {\n        const index = this.implementations.indexOf(implementation)\n        if (index >= 0) this.implementations.splice(index, 1)\n      }\n      this.publishOffer()\n    }\n  }\n\n  async dispatch<TInput = unknown, TOutput = unknown, TProgress = unknown>(invocation: CapabilityDispatch<TInput, TProgress>): Promise<TOutput> {\n    validateDispatch(invocation, this.currentOffer)\n    const implementation = this.implementations.find(candidate =>\n      candidate.participantId === invocation.binding.provider.participantId\n      && sameProtocol(candidate.protocol, invocation.binding.support))\n    if (implementation === undefined) throw new ConnectionInvocationError('handler-missing', `binding ${JSON.stringify(invocation.binding.bindingId)} has no live implementation`)\n    try {\n      return await implementation.handle(invocation.operation, invocation.input, Object.freeze({\n        connectionId: invocation.connectionId,\n        planRevision: invocation.planRevision,\n        invocationId: invocation.invocationId,\n        binding: invocation.binding,\n        signal: invocation.signal,\n        progress: invocation.progress,\n      })) as TOutput\n    } catch (error) {\n      if (error instanceof ConnectionInvocationError) throw error\n      throw new ConnectionInvocationError('handler-failed', error instanceof Error ? error.message : String(error), { cause: error })\n    }\n  }\n\n  onOfferChange(listener: (offer: EndpointOffer) => void): () => void {\n    this.listeners.add(listener)\n    return () => { this.listeners.delete(listener) }\n  }\n\n  private createOffer(): EndpointOffer {\n    return createEndpointOffer(this.identity, this.revision, [...this.declarations.values()])\n  }\n\n  private publishOffer(): void {\n    this.revision += 1\n    this.currentOffer = this.createOffer()\n    for (const listener of this.listeners) listener(this.currentOffer)\n  }\n}\n\nfunction validateDispatch(invocation: CapabilityDispatch, offer: EndpointOffer): void {\n  if (invocation.connectionId.trim() === '') throw new TypeError('connectionId must be non-empty')\n  if (!Number.isSafeInteger(invocation.planRevision) || invocation.planRevision < 1) throw new TypeError('planRevision must be positive')\n  if (invocation.binding.planRevision !== invocation.planRevision) throw new ConnectionInvocationError('capability-unbound', 'binding belongs to another plan revision')\n  if (invocation.binding.provider.endpoint.instanceId !== offer.endpoint.instanceId) throw new ConnectionInvocationError('capability-unbound', 'binding provider belongs to another endpoint')\n  if (invocation.invocationId.trim() === '' || invocation.operation.trim() === '') throw new TypeError('invocationId and operation must be non-empty')\n  invocation.signal.throwIfAborted()\n}\n"],"mappings":";;;AAwBA,IAAa,2BAAb,cAA8C,MAAM;CAEvC;CAEA;CAHX,YACE,MACA,SACA,iBACA;EACA,MAAM,OAAO;EAJJ,KAAA,OAAA;EAEA,KAAA,kBAAA;EAGT,KAAK,OAAO;CACd;AACF;;;;;AAMA,IAAa,mBAAb,MAA8B;CAC5B,6BAA8B,IAAI,IAAiC;CAEnE,SAAS,WAA4C;EACnD,WAAW,UAAU,IAAI,yBAAyB;EAClD,IAAI,KAAK,WAAW,IAAI,UAAU,EAAE,GAAG,MAAM,IAAI,MAAM,wBAAwB,KAAK,UAAU,UAAU,EAAE,EAAE,uBAAuB;EACnI,KAAK,WAAW,IAAI,UAAU,IAAI,SAAS;EAC3C,aAAa;GAAE,IAAI,KAAK,WAAW,IAAI,UAAU,EAAE,MAAM,WAAW,KAAK,WAAW,OAAO,UAAU,EAAE;EAAE;CAC3G;CAEA,gBAAgB,QAA8C;EAC5D,IAAI,WAAW,KAAA,GAAW,eAAe,MAAM;EAC/C,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC,CAAC,CAC/C,QAAO,cAAa,WAAW,KAAA,KAAa,eAAe,WAAW,MAAM,CAAC,CAAC,CAC9E,KAAI,cAAa,UAAU,EAAE,CAAC,CAC9B,KAAK,CAAC;CACX;CAEA,MAAM,QAAQ,SAAsD;EAClE,eAAe,QAAQ,MAAM;EAC7B,sBAAsB,QAAQ,MAAM,KAAK;EACzC,QAAQ,QAAQ,eAAe;EAC/B,MAAM,UAAU,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC,CAAC,CAC1C,QAAO,cAAa,eAAe,WAAW,QAAQ,MAAM,CAAC,CAAC,CAC9D,MAAM,MAAM,UAAU,KAAK,GAAG,cAAc,MAAM,EAAE,CAAC;EACxD,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,yBACR,8BACA,yCAAyC,KAAK,UAAU,QAAQ,OAAO,GAAG,KAC1E,CAAC,CACH;EAEF,IAAI,QAAQ,SAAS,GAAG;GACtB,MAAM,MAAM,OAAO,OAAO,QAAQ,KAAI,cAAa,UAAU,EAAE,CAAC;GAChE,MAAM,IAAI,yBACR,4BACA,+CAA+C,KAAK,UAAU,QAAQ,OAAO,GAAG,EAAE,IAAI,IAAI,KAAK,IAAI,KACnG,GACF;EACF;EACA,OAAO,QAAQ,EAAE,CAAE,QAAQ,OAAO;CACpC;AACF;AAEA,SAAS,eAAe,WAAgC,QAAmC;CACzF,IAAI;EAAE,OAAO,UAAU,SAAS,MAAM;CAAE,QAAQ;EAAE,OAAO;CAAM;AACjE;AAEA,SAAS,eAAe,QAAgC;CACtD,IAAI,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,KAAK,MAAM,IAAI,MAAM,IAAI,UAAU,yCAAyC;CAC7H,IAAI,OAAO,aAAa,KAAA,GACjB;OAAA,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,QAAQ,GACvD,IAAI,IAAI,KAAK,MAAM,MAAM,OAAO,UAAU,UAAU,MAAM,IAAI,UAAU,sDAAsD;CAAA;AAGpI;AAEA,SAAS,WAAW,OAAe,OAAqB;CACtD,IAAI,CAAC,+CAA+C,KAAK,KAAK,GAAG,MAAM,IAAI,UAAU,GAAG,MAAM,oBAAoB;AACpH;;;AC3EA,IAAa,0BAAb,MAAmE;CACjE,+BAAgC,IAAI,IAAiC;CACrE,kBAA+D,CAAC;CAChE,4BAA6B,IAAI,IAAoC;CACrE;CACA;CACA;CAEA,YAAY,SAAiC;EAC3C,KAAK,WAAW,OAAO,OAAO;GAAE,IAAI,QAAQ;GAAI,YAAY,QAAQ;EAAW,CAAC;EAChF,KAAK,WAAW,QAAQ,YAAY;EACpC,KAAK,eAAe,KAAK,YAAY;CACvC;CAEA,IAAI,QAAuB;EAAE,OAAO,KAAK;CAAa;CAEtD,SAAS,aAA8C;EACrD,MAAM,cAAc,0BAA0B,YAAY,WAAW;EACrE,MAAM,gBAAgB,YAAY,YAAY;EAC9C,IAAI,KAAK,aAAa,IAAI,aAAa,GAAG,MAAM,IAAI,MAAM,eAAe,KAAK,UAAU,aAAa,EAAE,uBAAuB;EAC9H,MAAM,kBAAkB,CAAC,GAAI,YAAY,mBAAmB,CAAC,CAAE;EAC/D,MAAM,8BAAc,IAAI,IAAY;EACpC,KAAK,MAAM,kBAAkB,iBAAiB;GAC5C,IAAI,eAAe,kBAAkB,eAAe,MAAM,IAAI,UAAU,wCAAwC,KAAK,UAAU,aAAa,GAAG;GAC/I,IAAI,EAAE,YAAY,YAAY,CAAC,EAAA,CAAG,MAAK,YAAW,aAAa,SAAS,eAAe,QAAQ,CAAC,GAC9F,MAAM,IAAI,UAAU,8BAA8B,eAAe,SAAS,WAAW,GAAG,eAAe,SAAS,KAAK,sBAAsB;GAE7I,MAAM,MAAM,GAAG,eAAe,SAAS,WAAW,IAAI,eAAe,SAAS;GAC9E,IAAI,YAAY,IAAI,GAAG,GAAG,MAAM,IAAI,UAAU,gDAAgD,eAAe,SAAS,WAAW,GAAG,eAAe,SAAS,MAAM;GAClK,YAAY,IAAI,GAAG;EACrB;EACA,MAAM,SAAS,gBAAgB,KAAI,mBAAkB,OAAO,OAAO;GACjE,GAAG;GAAgB,UAAU,OAAO,OAAO,EAAE,GAAG,eAAe,SAAS,CAAC;GACzE,QAAQ,eAAe;EACzB,CAAC,CAAC;EACF,KAAK,aAAa,IAAI,eAAe,WAAW;EAChD,KAAK,gBAAgB,KAAK,GAAG,MAAM;EACnC,KAAK,aAAa;EAClB,IAAI,SAAS;EACb,aAAa;GACX,IAAI,CAAC,QAAQ;GACb,SAAS;GACT,IAAI,KAAK,aAAa,IAAI,aAAa,MAAM,aAAa,KAAK,aAAa,OAAO,aAAa;GAChG,KAAK,MAAM,kBAAkB,QAAQ;IACnC,MAAM,QAAQ,KAAK,gBAAgB,QAAQ,cAAc;IACzD,IAAI,SAAS,GAAG,KAAK,gBAAgB,OAAO,OAAO,CAAC;GACtD;GACA,KAAK,aAAa;EACpB;CACF;CAEA,MAAM,SAAmE,YAAqE;EAC5I,iBAAiB,YAAY,KAAK,YAAY;EAC9C,MAAM,iBAAiB,KAAK,gBAAgB,MAAK,cAC/C,UAAU,kBAAkB,WAAW,QAAQ,SAAS,iBACrD,aAAa,UAAU,UAAU,WAAW,QAAQ,OAAO,CAAC;EACjE,IAAI,mBAAmB,KAAA,GAAW,MAAM,IAAI,0BAA0B,mBAAmB,WAAW,KAAK,UAAU,WAAW,QAAQ,SAAS,EAAE,4BAA4B;EAC7K,IAAI;GACF,OAAO,MAAM,eAAe,OAAO,WAAW,WAAW,WAAW,OAAO,OAAO,OAAO;IACvF,cAAc,WAAW;IACzB,cAAc,WAAW;IACzB,cAAc,WAAW;IACzB,SAAS,WAAW;IACpB,QAAQ,WAAW;IACnB,UAAU,WAAW;GACvB,CAAC,CAAC;EACJ,SAAS,OAAO;GACd,IAAI,iBAAiB,2BAA2B,MAAM;GACtD,MAAM,IAAI,0BAA0B,kBAAkB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EAAE,OAAO,MAAM,CAAC;EAChI;CACF;CAEA,cAAc,UAAsD;EAClE,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa;GAAE,KAAK,UAAU,OAAO,QAAQ;EAAE;CACjD;CAEA,cAAqC;EACnC,OAAO,oBAAoB,KAAK,UAAU,KAAK,UAAU,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC;CAC1F;CAEA,eAA6B;EAC3B,KAAK,YAAY;EACjB,KAAK,eAAe,KAAK,YAAY;EACrC,KAAK,MAAM,YAAY,KAAK,WAAW,SAAS,KAAK,YAAY;CACnE;AACF;AAEA,SAAS,iBAAiB,YAAgC,OAA4B;CACpF,IAAI,WAAW,aAAa,KAAK,MAAM,IAAI,MAAM,IAAI,UAAU,gCAAgC;CAC/F,IAAI,CAAC,OAAO,cAAc,WAAW,YAAY,KAAK,WAAW,eAAe,GAAG,MAAM,IAAI,UAAU,+BAA+B;CACtI,IAAI,WAAW,QAAQ,iBAAiB,WAAW,cAAc,MAAM,IAAI,0BAA0B,sBAAsB,0CAA0C;CACrK,IAAI,WAAW,QAAQ,SAAS,SAAS,eAAe,MAAM,SAAS,YAAY,MAAM,IAAI,0BAA0B,sBAAsB,8CAA8C;CAC3L,IAAI,WAAW,aAAa,KAAK,MAAM,MAAM,WAAW,UAAU,KAAK,MAAM,IAAI,MAAM,IAAI,UAAU,8CAA8C;CACnJ,WAAW,OAAO,eAAe;AACnC"}