@dsh-cc/command-mcp 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.i18n.yaml +6 -0
- package/README.md +38 -0
- package/README.zh.md +38 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +90 -0
- package/lib/index.js.map +1 -0
- package/lib/invariant.d.ts +16 -0
- package/lib/invariant.d.ts.map +1 -0
- package/lib/invariant.js +23 -0
- package/lib/invariant.js.map +1 -0
- package/lib/mcp.d.ts +65 -0
- package/lib/mcp.d.ts.map +1 -0
- package/lib/mcp.js +116 -0
- package/lib/mcp.js.map +1 -0
- package/package.json +48 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
6
|
+
|
|
7
|
+
1. Definitions.
|
|
8
|
+
|
|
9
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
10
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
11
|
+
|
|
12
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
13
|
+
the copyright owner that is granting the License.
|
|
14
|
+
|
|
15
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
16
|
+
other entities that control, are controlled by, or are under common
|
|
17
|
+
control with that entity. For the purposes of this definition,
|
|
18
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
19
|
+
direction or management of such entity, whether by contract or
|
|
20
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
21
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
22
|
+
|
|
23
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
24
|
+
exercising permissions granted by this License.
|
|
25
|
+
|
|
26
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
27
|
+
including but not limited to software source code, documentation
|
|
28
|
+
source, and configuration files.
|
|
29
|
+
|
|
30
|
+
"Object" form shall mean any form resulting from mechanical
|
|
31
|
+
transformation or translation of a Source form, including but
|
|
32
|
+
not limited to compiled object code, generated documentation,
|
|
33
|
+
and conversions to other media types.
|
|
34
|
+
|
|
35
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
36
|
+
Object form, made available under the License, as indicated by a
|
|
37
|
+
copyright notice that is included in or attached to the work
|
|
38
|
+
(an example is provided in the Appendix below).
|
|
39
|
+
|
|
40
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
41
|
+
form, that is based on (or derived from) the Work and for which the
|
|
42
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
43
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
44
|
+
of this License, Derivative Works shall not include works that remain
|
|
45
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
46
|
+
the Work and Derivative Works thereof.
|
|
47
|
+
|
|
48
|
+
"Contribution" shall mean any work of authorship, including
|
|
49
|
+
the original version of the Work and any modifications or additions
|
|
50
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
51
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
52
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
53
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
54
|
+
means any form of electronic, verbal, or written communication sent
|
|
55
|
+
to the Licensor or its representatives, including but not limited to
|
|
56
|
+
communication on electronic mailing lists, source code control systems,
|
|
57
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
58
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
59
|
+
excluding communication that is conspicuously marked or otherwise
|
|
60
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
61
|
+
|
|
62
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
63
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
64
|
+
subsequently incorporated within the Work.
|
|
65
|
+
|
|
66
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
67
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
68
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
69
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
70
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
71
|
+
Work and such Derivative Works in Source or Object form.
|
|
72
|
+
|
|
73
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
74
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
75
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
76
|
+
(except as stated in this section) patent license to make, have made,
|
|
77
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
78
|
+
where such license applies only to those patent claims licensable
|
|
79
|
+
by such Contributor that are necessarily infringed by their
|
|
80
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
81
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
82
|
+
institute patent litigation against any entity (including a
|
|
83
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
84
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
85
|
+
or contributory patent infringement, then any patent licenses
|
|
86
|
+
granted to You under this License for that Work shall terminate
|
|
87
|
+
as of the date such litigation is filed.
|
|
88
|
+
|
|
89
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
90
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
91
|
+
modifications, and in Source or Object form, provided that You
|
|
92
|
+
meet the following conditions:
|
|
93
|
+
|
|
94
|
+
(a) You must give any other recipients of the Work or
|
|
95
|
+
Derivative Works a copy of this License; and
|
|
96
|
+
|
|
97
|
+
(b) You must cause any modified files to carry prominent notices
|
|
98
|
+
stating that You changed the files; and
|
|
99
|
+
|
|
100
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
101
|
+
that You distribute, all copyright, patent, trademark, and
|
|
102
|
+
attribution notices from the Source form of the Work,
|
|
103
|
+
excluding those notices that do not pertain to any part of
|
|
104
|
+
the Derivative Works; and
|
|
105
|
+
|
|
106
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
107
|
+
distribution, then any Derivative Works that You distribute must
|
|
108
|
+
include a readable copy of the attribution notices contained
|
|
109
|
+
within such NOTICE file, excluding those notices that do not
|
|
110
|
+
pertain to any part of the Derivative Works, in at least one
|
|
111
|
+
of the following places: within a NOTICE text file distributed
|
|
112
|
+
as part of the Derivative Works; within the Source form or
|
|
113
|
+
documentation, if provided along with the Derivative Works; or,
|
|
114
|
+
within a display generated by the Derivative Works, if and
|
|
115
|
+
wherever such third-party notices normally appear. The contents
|
|
116
|
+
of the NOTICE file are for informational purposes only and
|
|
117
|
+
do not modify the License. You may add Your own attribution
|
|
118
|
+
notices within Derivative Works that You distribute, alongside
|
|
119
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
120
|
+
that such additional attribution notices cannot be construed
|
|
121
|
+
as modifying the License.
|
|
122
|
+
|
|
123
|
+
You may add Your own copyright statement to Your modifications and
|
|
124
|
+
may provide additional or different license terms and conditions
|
|
125
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
126
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
127
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
128
|
+
the conditions stated in this License.
|
|
129
|
+
|
|
130
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
131
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
132
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
133
|
+
this License, without any additional terms or conditions.
|
|
134
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
135
|
+
the terms of any separate license agreement you may have executed
|
|
136
|
+
with Licensor regarding such Contributions.
|
|
137
|
+
|
|
138
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
139
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
140
|
+
except as required for reasonable and customary use in describing the
|
|
141
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
142
|
+
|
|
143
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
144
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
145
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
146
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
147
|
+
implied, including, without limitation, any warranties or conditions
|
|
148
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
149
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
150
|
+
appropriateness of using or redistributing the Work and assume any
|
|
151
|
+
risks associated with Your exercise of permissions under this License.
|
|
152
|
+
|
|
153
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
154
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
155
|
+
unless required by applicable law (such as deliberate and grossly
|
|
156
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
157
|
+
liable to You for damages, including any direct, indirect, special,
|
|
158
|
+
incidental, or consequential damages of any character arising as a
|
|
159
|
+
result of this License or out of the use or inability to use the
|
|
160
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
161
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
162
|
+
other commercial damages or losses), even if such Contributor
|
|
163
|
+
has been advised of the possibility of such damages.
|
|
164
|
+
|
|
165
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
166
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
167
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
168
|
+
or other liability obligations and/or rights consistent with this
|
|
169
|
+
License. However, in accepting such obligations, You may act only
|
|
170
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
171
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
172
|
+
defend, and hold each Contributor harmless for any liability
|
|
173
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
174
|
+
of your accepting any such warranty or additional liability.
|
|
175
|
+
|
|
176
|
+
END OF TERMS AND CONDITIONS
|
|
177
|
+
|
|
178
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
179
|
+
|
|
180
|
+
To apply the Apache License to your work, attach the following
|
|
181
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
182
|
+
replaced with your own identifying information. (Don't include
|
|
183
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
184
|
+
comment syntax for the file format. We also recommend that a
|
|
185
|
+
file or class name and description of purpose be included on the
|
|
186
|
+
same "printed page" as the copyright notice for easier
|
|
187
|
+
identification within third-party archives.
|
|
188
|
+
|
|
189
|
+
Copyright [yyyy] [name of copyright owner]
|
|
190
|
+
|
|
191
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
|
+
you may not use this file except in compliance with the License.
|
|
193
|
+
You may obtain a copy of the License at
|
|
194
|
+
|
|
195
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
196
|
+
|
|
197
|
+
Unless required by applicable law or agreed to in writing, software
|
|
198
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
199
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
200
|
+
See the License for the specific language governing permissions and
|
|
201
|
+
limitations under the License.
|
package/README.i18n.yaml
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
|
|
2
|
+
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
|
3
|
+
# after editing either side, bring the other along and re-record with:
|
|
4
|
+
# pnpm run verify-translation-pairing --write packages/interaction/command-mcp/README.md
|
|
5
|
+
README.md: 98e92d510807ad5cb53b3250ed6eb3835b8596ab
|
|
6
|
+
README.zh.md: d7fafedbc4e0d57092ff71ff34bf95c7ffa481e3
|
package/README.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# @dsh-cc/command-mcp
|
|
2
|
+
|
|
3
|
+
English | [中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
Human-facing `/mcp` command: list the registered MCP servers and their connection state, or reconnect/disconnect one by name. It reads and drives the optional `mcpConnections` service that an mcp-client instance mounts. The plugin registers one global command through [`ctx.commands`](../../interaction/commands/README.md).
|
|
6
|
+
|
|
7
|
+
## Command contract
|
|
8
|
+
|
|
9
|
+
| Input | Result |
|
|
10
|
+
|---|---|
|
|
11
|
+
| `/mcp` | List each registered server's name, connection state, tool count (when known), and OAuth-auth requirement. |
|
|
12
|
+
| `/mcp reconnect <name>` | Tear down and establish a fresh connection for the named server. |
|
|
13
|
+
| `/mcp disconnect <name>` | Stop the connection and unregister its tools for the named server. |
|
|
14
|
+
| `/mcp <anything else>` | Print usage text. |
|
|
15
|
+
|
|
16
|
+
All forms read/drive the optional `mcpConnections` seam. A composition without an mcp-client reports the seam gracefully. No form consumes model tokens.
|
|
17
|
+
|
|
18
|
+
## Composition
|
|
19
|
+
|
|
20
|
+
The producer injects `commands`. A custom app mounts mcp-client (which provides the seam) plus this plugin:
|
|
21
|
+
|
|
22
|
+
```yaml
|
|
23
|
+
- id: mcp-client
|
|
24
|
+
name: '@dsh-cc/mcp-client'
|
|
25
|
+
- id: command-mcp
|
|
26
|
+
name: '@dsh-cc/command-mcp'
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The `mcpConnections` seam is discovered via `ctx` at run time; it is not injected, so the command loads even when mcp-client is absent (and then reports the missing seam).
|
|
30
|
+
|
|
31
|
+
## Model Experience
|
|
32
|
+
|
|
33
|
+
The slash input and the direct outputs are absent from model requests and consume no model tokens. Outputs are reads/drives over the connection registry; presentation text is never logged.
|
|
34
|
+
|
|
35
|
+
## Known Limitations and Deferred Work
|
|
36
|
+
|
|
37
|
+
- **Send/disconnect semantics are mcp-client-owned** — the command forwards `reconnect`/`disconnect` to the seam; it cannot configure OAuth or tune transport settings.
|
|
38
|
+
- **State is a snapshot** — entries reflect the last reported lifecycle transition; transient `connecting` states may render mid-flight.
|
package/README.zh.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# @dsh-cc/command-mcp
|
|
2
|
+
|
|
3
|
+
[English](README.md) | 中文
|
|
4
|
+
|
|
5
|
+
面向用户的 `/mcp` 命令:列出已注册的 MCP 服务器及其连接状态,或按名称重连/断开某个服务器。它读取并驱动由 mcp-client 实例挂载的可选 `mcpConnections` 服务。该插件通过 [`ctx.commands`](../../interaction/commands/README.md) 注册一个全局命令。
|
|
6
|
+
|
|
7
|
+
## 命令约定
|
|
8
|
+
|
|
9
|
+
| 输入 | 结果 |
|
|
10
|
+
|---|---|
|
|
11
|
+
| `/mcp` | 列出每个已注册服务器的名称、连接状态、工具数量(若已知)与 OAuth 鉴权要求。 |
|
|
12
|
+
| `/mcp reconnect <name>` | 断开并为命名服务器建立全新连接。 |
|
|
13
|
+
| `/mcp disconnect <name>` | 为该命名服务器停止连接并注销其工具。 |
|
|
14
|
+
| `/mcp <其他内容>` | 打印用法文本。 |
|
|
15
|
+
|
|
16
|
+
所有形式都读取/驱动可选的 `mcpConnections` 衔接服务。未含 mcp-client 的组合会优雅地报告缺少该服务。任何形式都不消耗模型 token。
|
|
17
|
+
|
|
18
|
+
## 组合
|
|
19
|
+
|
|
20
|
+
生产方注入 `commands`。自定义应用会挂载 mcp-client(提供衔接服务)与此插件:
|
|
21
|
+
|
|
22
|
+
```yaml
|
|
23
|
+
- id: mcp-client
|
|
24
|
+
name: '@dsh-cc/mcp-client'
|
|
25
|
+
- id: command-mcp
|
|
26
|
+
name: '@dsh-cc/command-mcp'
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
`mcpConnections` 衔接服务在运行时经 `ctx` 发现,并非注入项,因此即便缺少 mcp-client,命令也能加载(此时会报告缺少该服务)。
|
|
30
|
+
|
|
31
|
+
## 模型体验
|
|
32
|
+
|
|
33
|
+
斜杠输入与直接输出都不会进入模型请求,也不消耗模型 token。输出都是对连接注册表的读取/驱动;呈现文本绝不会记录到日志中。
|
|
34
|
+
|
|
35
|
+
## 已知限制与暂缓事项
|
|
36
|
+
|
|
37
|
+
- **发送/断开语义由 mcp-client 持有**:该命令只是把 `reconnect`/`disconnect` 转发给衔接服务,无法配置 OAuth 或调整传输设置。
|
|
38
|
+
- **状态是快照**:条目反映最近一次上报的生命周期转换;瞬时的 `connecting` 状态可能在途中呈现。
|
package/lib/index.d.ts
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Human-facing `/mcp` command: list the registered MCP servers, import the
|
|
3
|
+
* Claude Code MCP config into `$DSH_HOME/.mcp.json`, or reconnect/disconnect
|
|
4
|
+
* one by name. It reads and drives the optional `mcpConnections` service
|
|
5
|
+
* mounted by mcp-client; when that service is absent it reports the seam
|
|
6
|
+
* gracefully rather than failing, but `migrate` works regardless because it
|
|
7
|
+
* is pure file I/O against the shared config paths.
|
|
8
|
+
* @module @dsh-cc/command-mcp
|
|
9
|
+
*/
|
|
10
|
+
import { Context } from '@deepseek-ai/cordis';
|
|
11
|
+
import { type McpConnectionEntry } from './mcp.ts';
|
|
12
|
+
export declare const name = "command-mcp";
|
|
13
|
+
export declare const inject: string[];
|
|
14
|
+
/**
|
|
15
|
+
* The minimal structural face of the optional `mcpConnections` service that an
|
|
16
|
+
* mcp-client instance provides. Kept local and structural so this package need
|
|
17
|
+
* not depend on the mcp-client package's full dependency graph.
|
|
18
|
+
*/
|
|
19
|
+
export interface McpConnectionsSeam {
|
|
20
|
+
/** A snapshot of every registered server today. */
|
|
21
|
+
entries(): McpConnectionEntry[];
|
|
22
|
+
/** Disconnect a registered server by name. */
|
|
23
|
+
disconnect(name: string): Promise<void>;
|
|
24
|
+
/** Reconnect a registered server by name. */
|
|
25
|
+
reconnect(name: string): Promise<void>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Register the `/mcp` command for every composed command adapter.
|
|
29
|
+
* @param ctx - context carrying the command registry.
|
|
30
|
+
*/
|
|
31
|
+
export declare function apply(ctx: Context): void;
|
|
32
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQ7C,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,UAAU,CAAA;AAEjB,eAAO,MAAM,IAAI,gBAAgB,CAAA;AACjC,eAAO,MAAM,MAAM,UAAe,CAAA;AAElC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,OAAO,IAAI,kBAAkB,EAAE,CAAA;IAC/B,8CAA8C;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,6CAA6C;IAC7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AAgED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAOxC"}
|
package/lib/index.js
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Human-facing `/mcp` command: list the registered MCP servers, import the
|
|
3
|
+
* Claude Code MCP config into `$DSH_HOME/.mcp.json`, or reconnect/disconnect
|
|
4
|
+
* one by name. It reads and drives the optional `mcpConnections` service
|
|
5
|
+
* mounted by mcp-client; when that service is absent it reports the seam
|
|
6
|
+
* gracefully rather than failing, but `migrate` works regardless because it
|
|
7
|
+
* is pure file I/O against the shared config paths.
|
|
8
|
+
* @module @dsh-cc/command-mcp
|
|
9
|
+
*/
|
|
10
|
+
import { claudeOnlyServers, migrateMcpServers, readMcpServerNames, resolveDefaultMcpPaths, } from '@dsh-cc/mcp-config';
|
|
11
|
+
import { formatConnections, formatDiscoveryNotice, formatMigrateReport, formatUsage, parseMcpInput, } from "./mcp.js";
|
|
12
|
+
export const name = 'command-mcp';
|
|
13
|
+
export const inject = ['commands'];
|
|
14
|
+
/** Resolve the optional mcpConnections seam, or undefined when not composed. */
|
|
15
|
+
function seam(ctx) {
|
|
16
|
+
return ctx.get('mcpConnections');
|
|
17
|
+
}
|
|
18
|
+
/** Run the `/mcp migrate` import against the shared default config paths. */
|
|
19
|
+
function migrate() {
|
|
20
|
+
const paths = resolveDefaultMcpPaths();
|
|
21
|
+
try {
|
|
22
|
+
const result = migrateMcpServers({ sources: paths.claude, target: paths.target });
|
|
23
|
+
return { kind: 'success', text: formatMigrateReport(result) };
|
|
24
|
+
}
|
|
25
|
+
catch (error) {
|
|
26
|
+
return { kind: 'success', text: `Failed to migrate: ${String(error)}` };
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
/** Execute `/mcp [sub]` against the optional mcpConnections seam. */
|
|
30
|
+
async function executeMcp(ctx, invocation) {
|
|
31
|
+
const input = parseMcpInput(invocation.rawInput);
|
|
32
|
+
if (input.kind === 'migrate')
|
|
33
|
+
return migrate();
|
|
34
|
+
const connections = seam(ctx);
|
|
35
|
+
if (connections === undefined) {
|
|
36
|
+
return { kind: 'success', text: 'No MCP connection registry is mounted in this composition (mcp-client absent).' };
|
|
37
|
+
}
|
|
38
|
+
switch (input.kind) {
|
|
39
|
+
case 'list': {
|
|
40
|
+
let text = formatConnections(connections.entries());
|
|
41
|
+
const paths = resolveDefaultMcpPaths();
|
|
42
|
+
// The notice mirrors the loader's gate: only when a dsh-native config
|
|
43
|
+
// declares at least one server are Claude Code files actually skipped —
|
|
44
|
+
// otherwise they are loaded and there is nothing to nag about.
|
|
45
|
+
const gated = paths.dsh.some((file) => {
|
|
46
|
+
const read = readMcpServerNames(file);
|
|
47
|
+
return read.kind === 'ok' && read.names.length > 0;
|
|
48
|
+
});
|
|
49
|
+
if (gated) {
|
|
50
|
+
const sources = claudeOnlyServers(paths);
|
|
51
|
+
if (sources.length > 0)
|
|
52
|
+
text += `\n\n${formatDiscoveryNotice(sources, paths.target)}`;
|
|
53
|
+
}
|
|
54
|
+
return { kind: 'success', text };
|
|
55
|
+
}
|
|
56
|
+
case 'reconnect': {
|
|
57
|
+
try {
|
|
58
|
+
await connections.reconnect(input.name);
|
|
59
|
+
return { kind: 'success', text: `Reconnecting MCP server "${input.name}".` };
|
|
60
|
+
}
|
|
61
|
+
catch (error) {
|
|
62
|
+
return { kind: 'success', text: `Failed to reconnect MCP server "${input.name}": ${String(error)}` };
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
case 'disconnect': {
|
|
66
|
+
try {
|
|
67
|
+
await connections.disconnect(input.name);
|
|
68
|
+
return { kind: 'success', text: `Disconnected MCP server "${input.name}".` };
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
return { kind: 'success', text: `Failed to disconnect MCP server "${input.name}": ${String(error)}` };
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
case 'usage':
|
|
75
|
+
return { kind: 'success', text: formatUsage() };
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Register the `/mcp` command for every composed command adapter.
|
|
80
|
+
* @param ctx - context carrying the command registry.
|
|
81
|
+
*/
|
|
82
|
+
export function apply(ctx) {
|
|
83
|
+
ctx.commands.register({
|
|
84
|
+
name: 'mcp',
|
|
85
|
+
description: 'list MCP connections, import Claude Code config, or reconnect/disconnect one by name',
|
|
86
|
+
input: { hint: '[migrate|reconnect|disconnect <name>]' },
|
|
87
|
+
handler: (invocation) => executeMcp(ctx, invocation),
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=index.js.map
|
package/lib/index.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Package-owned invariant companion for `@dsh-cc/command-mcp`.
|
|
3
|
+
* @module @dsh-cc/command-mcp/invariant
|
|
4
|
+
*/
|
|
5
|
+
import type { Context } from '@deepseek-ai/cordis';
|
|
6
|
+
/** Cordis companion plugin name. */
|
|
7
|
+
export declare const name = "command-mcp-invariant";
|
|
8
|
+
/** Service required before the companion can reserve package ownership. */
|
|
9
|
+
export declare const inject: string[];
|
|
10
|
+
/**
|
|
11
|
+
* Register this package's invariant companion.
|
|
12
|
+
* @param ctx - Cordis context carrying the invariant service.
|
|
13
|
+
* @returns the installed registration's disposer after setup succeeds.
|
|
14
|
+
*/
|
|
15
|
+
export declare const apply: (ctx: Context) => Promise<() => void>;
|
|
16
|
+
//# sourceMappingURL=invariant.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,0BAA0B,CAAA;AAC3C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}
|
package/lib/invariant.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Package-owned invariant companion for `@dsh-cc/command-mcp`.
|
|
3
|
+
* @module @dsh-cc/command-mcp/invariant
|
|
4
|
+
*/
|
|
5
|
+
const PACKAGE_NAME = '@dsh-cc/command-mcp';
|
|
6
|
+
/** Cordis companion plugin name. */
|
|
7
|
+
export const name = 'command-mcp-invariant';
|
|
8
|
+
/** Service required before the companion can reserve package ownership. */
|
|
9
|
+
export const inject = ['invariants'];
|
|
10
|
+
/**
|
|
11
|
+
* No runtime invariant: this command adapter owns no event stream or state projection; mcp
|
|
12
|
+
* enumeration and drive are reads/drives over an optional host service, and the command registry
|
|
13
|
+
* owns registration and dispatch lifecycle.
|
|
14
|
+
*/
|
|
15
|
+
const install = () => { };
|
|
16
|
+
/**
|
|
17
|
+
* Register this package's invariant companion.
|
|
18
|
+
* @param ctx - Cordis context carrying the invariant service.
|
|
19
|
+
* @returns the installed registration's disposer after setup succeeds.
|
|
20
|
+
*/
|
|
21
|
+
export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
|
|
22
|
+
/* jscpd:ignore-end */
|
|
23
|
+
//# sourceMappingURL=invariant.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,qBAAqB,CAAA;AAE1C,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,CAAA;AAC3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}
|
package/lib/mcp.d.ts
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure `/mcp` parsing and rendering helpers. Input tokenization and connection
|
|
3
|
+
* formatting live here so they are unit-testable without cordis or an
|
|
4
|
+
* mcpConnections seam.
|
|
5
|
+
* @module @dsh-cc/command-mcp
|
|
6
|
+
*/
|
|
7
|
+
import type { ClaudeOnlySource, McpMigrationResult } from '@dsh-cc/mcp-config';
|
|
8
|
+
/** The connection lifecycle state of one MCP server. */
|
|
9
|
+
export type McpConnectionState = 'connecting' | 'ready' | 'error' | 'disconnected';
|
|
10
|
+
/** A public snapshot of one registered MCP server. */
|
|
11
|
+
export interface McpConnectionEntry {
|
|
12
|
+
/** The mcp-client `serverName` this instance bridges. */
|
|
13
|
+
name: string;
|
|
14
|
+
/** Current connection lifecycle state. */
|
|
15
|
+
state: McpConnectionState;
|
|
16
|
+
/** The last error message, when the state is `error`. */
|
|
17
|
+
error?: string;
|
|
18
|
+
/** The number of tools this server currently exposes, when known. */
|
|
19
|
+
toolCount?: number;
|
|
20
|
+
/** Whether interacting with this server requires OAuth authorization. */
|
|
21
|
+
authRequired?: boolean;
|
|
22
|
+
}
|
|
23
|
+
/** A parsed `/mcp` invocation. */
|
|
24
|
+
export type McpInput = {
|
|
25
|
+
kind: 'list';
|
|
26
|
+
} | {
|
|
27
|
+
kind: 'reconnect';
|
|
28
|
+
name: string;
|
|
29
|
+
} | {
|
|
30
|
+
kind: 'disconnect';
|
|
31
|
+
name: string;
|
|
32
|
+
} | {
|
|
33
|
+
kind: 'migrate';
|
|
34
|
+
} | {
|
|
35
|
+
kind: 'usage';
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Parse the raw input after `/mcp`. Empty input lists; `reconnect <name>` and
|
|
39
|
+
* `disconnect <name>` drive the named server; anything else is usage.
|
|
40
|
+
* @param rawInput - `invocation.rawInput`, the text after the command name.
|
|
41
|
+
*/
|
|
42
|
+
export declare function parseMcpInput(rawInput: string): McpInput;
|
|
43
|
+
/**
|
|
44
|
+
* Render one connection line: `name (state)`, with tool count and auth markers
|
|
45
|
+
* when known.
|
|
46
|
+
*/
|
|
47
|
+
export declare function formatConnectionLine(entry: McpConnectionEntry): string;
|
|
48
|
+
/** Render the connection index. */
|
|
49
|
+
export declare function formatConnections(entries: readonly McpConnectionEntry[]): string;
|
|
50
|
+
/** Render the `/mcp` usage text. */
|
|
51
|
+
export declare function formatUsage(): string;
|
|
52
|
+
/**
|
|
53
|
+
* Render the `/mcp migrate` result report. Pure: it only stringifies its
|
|
54
|
+
* argument; all file I/O happened in the caller.
|
|
55
|
+
* @param result - the {@link McpMigrationResult} produced by `migrateMcpServers`.
|
|
56
|
+
*/
|
|
57
|
+
export declare function formatMigrateReport(result: McpMigrationResult): string;
|
|
58
|
+
/**
|
|
59
|
+
* Render the discovery notice appended to `/mcp` list output when Claude Code
|
|
60
|
+
* MCP servers are shadowed by the dsh-native config. Pure.
|
|
61
|
+
* @param sources - the Claude Code sources holding servers not declared by any dsh file.
|
|
62
|
+
* @param target - the migration target path to run `/mcp migrate` into.
|
|
63
|
+
*/
|
|
64
|
+
export declare function formatDiscoveryNotice(sources: readonly ClaudeOnlySource[], target: string): string;
|
|
65
|
+
//# sourceMappingURL=mcp.d.ts.map
|
package/lib/mcp.d.ts.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE9E,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,CAAA;AAElF,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,KAAK,EAAE,kBAAkB,CAAA;IACzB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,kCAAkC;AAClC,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAiBxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAMtE;AAED,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAKhF;AAED,oCAAoC;AACpC,wBAAgB,WAAW,IAAI,MAAM,CAQpC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA2BtE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOlG"}
|
package/lib/mcp.js
ADDED
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure `/mcp` parsing and rendering helpers. Input tokenization and connection
|
|
3
|
+
* formatting live here so they are unit-testable without cordis or an
|
|
4
|
+
* mcpConnections seam.
|
|
5
|
+
* @module @dsh-cc/command-mcp
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Parse the raw input after `/mcp`. Empty input lists; `reconnect <name>` and
|
|
9
|
+
* `disconnect <name>` drive the named server; anything else is usage.
|
|
10
|
+
* @param rawInput - `invocation.rawInput`, the text after the command name.
|
|
11
|
+
*/
|
|
12
|
+
export function parseMcpInput(rawInput) {
|
|
13
|
+
const tokens = rawInput.trim().split(/\s+/u).filter(token => token.length > 0);
|
|
14
|
+
if (tokens.length === 0)
|
|
15
|
+
return { kind: 'list' };
|
|
16
|
+
const [sub, name, ...rest] = tokens;
|
|
17
|
+
if (sub === 'reconnect') {
|
|
18
|
+
if (name !== undefined && rest.length === 0)
|
|
19
|
+
return { kind: 'reconnect', name };
|
|
20
|
+
return { kind: 'usage' };
|
|
21
|
+
}
|
|
22
|
+
if (sub === 'disconnect') {
|
|
23
|
+
if (name !== undefined && rest.length === 0)
|
|
24
|
+
return { kind: 'disconnect', name };
|
|
25
|
+
return { kind: 'usage' };
|
|
26
|
+
}
|
|
27
|
+
if (sub === 'migrate') {
|
|
28
|
+
if (tokens.length === 1)
|
|
29
|
+
return { kind: 'migrate' };
|
|
30
|
+
return { kind: 'usage' };
|
|
31
|
+
}
|
|
32
|
+
return { kind: 'usage' };
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Render one connection line: `name (state)`, with tool count and auth markers
|
|
36
|
+
* when known.
|
|
37
|
+
*/
|
|
38
|
+
export function formatConnectionLine(entry) {
|
|
39
|
+
const parts = [`${entry.name} (${entry.state})`];
|
|
40
|
+
if (entry.toolCount !== undefined)
|
|
41
|
+
parts.push(`tools: ${entry.toolCount}`);
|
|
42
|
+
if (entry.authRequired !== undefined)
|
|
43
|
+
parts.push(entry.authRequired ? 'auth required' : 'auth ok');
|
|
44
|
+
if (entry.state === 'error' && entry.error !== undefined)
|
|
45
|
+
parts.push(`error: ${entry.error}`);
|
|
46
|
+
return parts.join(' ');
|
|
47
|
+
}
|
|
48
|
+
/** Render the connection index. */
|
|
49
|
+
export function formatConnections(entries) {
|
|
50
|
+
if (entries.length === 0)
|
|
51
|
+
return 'No MCP servers are registered.';
|
|
52
|
+
const lines = ['MCP connections:'];
|
|
53
|
+
for (const entry of entries)
|
|
54
|
+
lines.push(`- ${formatConnectionLine(entry)}`);
|
|
55
|
+
return lines.join('\n');
|
|
56
|
+
}
|
|
57
|
+
/** Render the `/mcp` usage text. */
|
|
58
|
+
export function formatUsage() {
|
|
59
|
+
return [
|
|
60
|
+
'Usage:',
|
|
61
|
+
' /mcp list MCP connections',
|
|
62
|
+
' /mcp migrate import Claude Code MCP config into dsh',
|
|
63
|
+
' /mcp reconnect <name> reconnect an MCP server',
|
|
64
|
+
' /mcp disconnect <name> disconnect an MCP server',
|
|
65
|
+
].join('\n');
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Render the `/mcp migrate` result report. Pure: it only stringifies its
|
|
69
|
+
* argument; all file I/O happened in the caller.
|
|
70
|
+
* @param result - the {@link McpMigrationResult} produced by `migrateMcpServers`.
|
|
71
|
+
*/
|
|
72
|
+
export function formatMigrateReport(result) {
|
|
73
|
+
if (result.wrote === false) {
|
|
74
|
+
const lines = [`Nothing to migrate — ${result.target} is already up to date.`];
|
|
75
|
+
for (const source of result.sources) {
|
|
76
|
+
if (source.error !== undefined)
|
|
77
|
+
lines.push(`${source.path}: unreadable — ${source.error}`);
|
|
78
|
+
}
|
|
79
|
+
return lines.join('\n');
|
|
80
|
+
}
|
|
81
|
+
const lines = [];
|
|
82
|
+
for (const source of result.sources) {
|
|
83
|
+
if (source.error !== undefined)
|
|
84
|
+
lines.push(`${source.path}: unreadable — ${source.error}`);
|
|
85
|
+
else
|
|
86
|
+
lines.push(`${source.path}: ${source.servers.length} servers`);
|
|
87
|
+
}
|
|
88
|
+
if (result.added.length > 0)
|
|
89
|
+
lines.push(`added: ${result.added.join(', ')}`);
|
|
90
|
+
if (result.kept.length > 0) {
|
|
91
|
+
lines.push(`kept (already in dsh config): ${result.kept.join(', ')}`);
|
|
92
|
+
}
|
|
93
|
+
for (const conflict of result.sourceConflicts) {
|
|
94
|
+
lines.push(`name taken from ${conflict.kept}, skipped ${conflict.skipped}: ${conflict.name}`);
|
|
95
|
+
}
|
|
96
|
+
if (result.backup !== undefined)
|
|
97
|
+
lines.push(`backup: ${result.backup}`);
|
|
98
|
+
lines.push(`target: ${result.target}`);
|
|
99
|
+
lines.push(`The Claude Code source files were not modified — remove them manually when happy.`, `Servers load only after restarting the session.`);
|
|
100
|
+
return lines.join('\n');
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Render the discovery notice appended to `/mcp` list output when Claude Code
|
|
104
|
+
* MCP servers are shadowed by the dsh-native config. Pure.
|
|
105
|
+
* @param sources - the Claude Code sources holding servers not declared by any dsh file.
|
|
106
|
+
* @param target - the migration target path to run `/mcp migrate` into.
|
|
107
|
+
*/
|
|
108
|
+
export function formatDiscoveryNotice(sources, target) {
|
|
109
|
+
const counts = sources.map(source => `${source.path} (${source.names.length} servers)`);
|
|
110
|
+
const lines = [
|
|
111
|
+
`MCP: dsh config takes precedence — these Claude Code servers are not loaded: ${counts.join(', ')}.`,
|
|
112
|
+
`Run /mcp migrate to import them into ${target}, then restart the session.`,
|
|
113
|
+
];
|
|
114
|
+
return lines.join('\n');
|
|
115
|
+
}
|
|
116
|
+
//# sourceMappingURL=mcp.js.map
|
package/lib/mcp.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
|
package/package.json
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@dsh-cc/command-mcp",
|
|
3
|
+
"description": "Human-facing slash command to list and drive MCP connections",
|
|
4
|
+
"version": "0.5.0",
|
|
5
|
+
"repository": {
|
|
6
|
+
"type": "git",
|
|
7
|
+
"url": "git+https://github.com/dsh-cc/dsh-cc.git",
|
|
8
|
+
"directory": "packages/interaction/command-mcp"
|
|
9
|
+
},
|
|
10
|
+
"type": "module",
|
|
11
|
+
"exports": {
|
|
12
|
+
".": {
|
|
13
|
+
"types": "./lib/index.d.ts",
|
|
14
|
+
"default": "./lib/index.js"
|
|
15
|
+
},
|
|
16
|
+
"./invariant": {
|
|
17
|
+
"types": "./lib/invariant.d.ts",
|
|
18
|
+
"default": "./lib/invariant.js"
|
|
19
|
+
},
|
|
20
|
+
"./src/*": "./src/*",
|
|
21
|
+
"./package.json": "./package.json"
|
|
22
|
+
},
|
|
23
|
+
"files": [
|
|
24
|
+
"lib"
|
|
25
|
+
],
|
|
26
|
+
"license": "Apache-2.0",
|
|
27
|
+
"peerDependencies": {
|
|
28
|
+
"@deepseek-ai/dsh-commands": ">=0.1.1-rc.2",
|
|
29
|
+
"@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
|
|
30
|
+
"@deepseek-ai/dsh-session": ">=0.1.1-rc.2",
|
|
31
|
+
"@deepseek-ai/cordis": ">=0.1.1-rc.2"
|
|
32
|
+
},
|
|
33
|
+
"dependencies": {
|
|
34
|
+
"@dsh-cc/mcp-config": "^0.5.0"
|
|
35
|
+
},
|
|
36
|
+
"devDependencies": {
|
|
37
|
+
"@deepseek-ai/cordis-plugin-loader": "link:../../../../deepseek-harness/vendor/loader",
|
|
38
|
+
"@deepseek-ai/dsh-agent": "link:../../../../deepseek-harness/packages/core/agent",
|
|
39
|
+
"@deepseek-ai/dsh-commands": "link:../../../../deepseek-harness/packages/interaction/commands",
|
|
40
|
+
"@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
|
|
41
|
+
"@deepseek-ai/dsh-session": "link:../../../../deepseek-harness/packages/core/session",
|
|
42
|
+
"@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
|
|
43
|
+
"@dsh-cc/mcp-config": "^0.5.0"
|
|
44
|
+
},
|
|
45
|
+
"publishConfig": {
|
|
46
|
+
"access": "public"
|
|
47
|
+
}
|
|
48
|
+
}
|