@duckmind/dm-windows-x64 0.63.4 → 0.63.9

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.
Files changed (121) hide show
  1. package/dm.exe +0 -0
  2. package/extensions/.dm-extensions.json +236 -13
  3. package/extensions/dm-context/package.json +1 -1
  4. package/extensions/dm-context/skills/context-management/SKILL.md +173 -223
  5. package/extensions/dm-context/skills/context-management/references/development-and-troubleshooting.md +75 -0
  6. package/extensions/dm-context/skills/context-management/references/interleaved-async-work.md +143 -0
  7. package/extensions/dm-context/skills/context-management/references/planning-and-execution.md +81 -0
  8. package/extensions/dm-context/skills/context-management/references/repeated-items-and-batch-work.md +69 -0
  9. package/extensions/dm-context/skills/context-management/references/retry-branch-and-pivot.md +80 -0
  10. package/extensions/dm-context/skills/context-management/references/search-research-and-reading.md +103 -0
  11. package/extensions/dm-context/skills/context-management/references/task-switching-and-cleanup.md +73 -0
  12. package/extensions/dm-context/src/context.js +3 -2
  13. package/extensions/dm-context/src/index.js +168 -84
  14. package/extensions/dm-mcp-adapter/OAUTH.md +3 -0
  15. package/extensions/dm-mcp-adapter/THIRD_PARTY_NOTICES.md +4 -0
  16. package/extensions/dm-mcp-adapter/abort.js +35 -0
  17. package/extensions/dm-mcp-adapter/agent-dir.js +45 -0
  18. package/extensions/dm-mcp-adapter/agent-plugin-loader.js +349 -0
  19. package/extensions/dm-mcp-adapter/app-bridge.bundle.js +5843 -0
  20. package/extensions/dm-mcp-adapter/cli.js +354 -0
  21. package/extensions/dm-mcp-adapter/commands.js +619 -0
  22. package/extensions/dm-mcp-adapter/config.js +1060 -0
  23. package/extensions/dm-mcp-adapter/consent-manager.js +60 -0
  24. package/extensions/dm-mcp-adapter/direct-tools.js +544 -0
  25. package/extensions/dm-mcp-adapter/dist/agent-dir.js +45 -0
  26. package/extensions/dm-mcp-adapter/dist/agent-plugin-loader.js +349 -0
  27. package/extensions/dm-mcp-adapter/dist/config.js +1060 -0
  28. package/extensions/dm-mcp-adapter/dist/mcp-bearer-store.js +311 -0
  29. package/extensions/dm-mcp-adapter/dist/metadata-cache.js +285 -0
  30. package/extensions/dm-mcp-adapter/dist/package-mcp-loader.js +144 -0
  31. package/extensions/dm-mcp-adapter/dist/resource-tools.js +7 -0
  32. package/extensions/dm-mcp-adapter/dist/types.js +247 -0
  33. package/extensions/dm-mcp-adapter/dist/ui-app-bridge-helpers.js +36 -0
  34. package/extensions/dm-mcp-adapter/dist/ui-stream-types.js +58 -0
  35. package/extensions/dm-mcp-adapter/dist/ui-tool-visibility.js +26 -0
  36. package/extensions/dm-mcp-adapter/dist/utils.js +307 -0
  37. package/extensions/dm-mcp-adapter/elicitation-handler.js +306 -0
  38. package/extensions/dm-mcp-adapter/error-signal.js +16 -0
  39. package/extensions/dm-mcp-adapter/errors.js +225 -0
  40. package/extensions/dm-mcp-adapter/failure-backoff.js +19 -0
  41. package/extensions/dm-mcp-adapter/glimpse-ui.js +61 -0
  42. package/extensions/dm-mcp-adapter/host-html-template.js +464 -0
  43. package/extensions/dm-mcp-adapter/index.js +1079 -0
  44. package/extensions/dm-mcp-adapter/init.js +624 -0
  45. package/extensions/dm-mcp-adapter/json-schema-validator.js +53 -0
  46. package/extensions/dm-mcp-adapter/lifecycle.js +385 -0
  47. package/extensions/dm-mcp-adapter/logger.js +115 -0
  48. package/extensions/dm-mcp-adapter/mcp-auth-flow.js +824 -0
  49. package/extensions/dm-mcp-adapter/mcp-auth.js +732 -0
  50. package/extensions/dm-mcp-adapter/mcp-bearer-store.js +311 -0
  51. package/extensions/dm-mcp-adapter/mcp-callback-server.js +388 -0
  52. package/extensions/dm-mcp-adapter/mcp-code.js +291 -0
  53. package/extensions/dm-mcp-adapter/mcp-keyring-helper.cjs +88 -0
  54. package/extensions/dm-mcp-adapter/mcp-oauth-provider.js +490 -0
  55. package/extensions/dm-mcp-adapter/mcp-output-guard.js +386 -0
  56. package/extensions/dm-mcp-adapter/mcp-panel.js +951 -0
  57. package/extensions/dm-mcp-adapter/mcp-probe.js +151 -0
  58. package/extensions/dm-mcp-adapter/mcp-references.js +263 -0
  59. package/extensions/dm-mcp-adapter/mcp-script-worker.mjs +126 -0
  60. package/extensions/dm-mcp-adapter/mcp-setup-panel.js +578 -0
  61. package/extensions/dm-mcp-adapter/mcp-status.js +80 -0
  62. package/extensions/dm-mcp-adapter/mcp-trace.js +215 -0
  63. package/extensions/dm-mcp-adapter/metadata-cache.js +292 -0
  64. package/extensions/dm-mcp-adapter/namespace-tools.js +155 -0
  65. package/extensions/dm-mcp-adapter/npx-resolver.js +465 -0
  66. package/extensions/dm-mcp-adapter/oauth-handler.js +17 -0
  67. package/extensions/dm-mcp-adapter/oauth.js +17 -0
  68. package/extensions/dm-mcp-adapter/onboarding-state.js +62 -0
  69. package/extensions/dm-mcp-adapter/package-mcp-loader.js +144 -0
  70. package/extensions/dm-mcp-adapter/package.json +68 -0
  71. package/extensions/dm-mcp-adapter/panel-keys.js +26 -0
  72. package/extensions/dm-mcp-adapter/prompts.js +258 -0
  73. package/extensions/dm-mcp-adapter/proxy-modes.js +1336 -0
  74. package/extensions/dm-mcp-adapter/request-headers-command.js +293 -0
  75. package/extensions/dm-mcp-adapter/resource-tools.js +7 -0
  76. package/extensions/dm-mcp-adapter/runtime-owner.js +79 -0
  77. package/extensions/dm-mcp-adapter/sampling-handler.js +222 -0
  78. package/extensions/dm-mcp-adapter/sandbox-proxy-template.js +190 -0
  79. package/extensions/dm-mcp-adapter/search-ranking.js +198 -0
  80. package/extensions/dm-mcp-adapter/server-manager.js +1258 -0
  81. package/extensions/dm-mcp-adapter/session-recovery.js +82 -0
  82. package/extensions/dm-mcp-adapter/skills/mcp-scripting/SKILL.md +39 -0
  83. package/extensions/dm-mcp-adapter/state.js +0 -0
  84. package/extensions/dm-mcp-adapter/test-runner.mjs +18 -0
  85. package/extensions/dm-mcp-adapter/tool-approval.js +151 -0
  86. package/extensions/dm-mcp-adapter/tool-metadata.js +247 -0
  87. package/extensions/dm-mcp-adapter/tool-registrar.js +212 -0
  88. package/extensions/dm-mcp-adapter/tool-result-renderer.js +355 -0
  89. package/extensions/dm-mcp-adapter/ts-shape.js +157 -0
  90. package/extensions/dm-mcp-adapter/types.js +264 -0
  91. package/extensions/dm-mcp-adapter/ui-app-bridge-helpers.js +36 -0
  92. package/extensions/dm-mcp-adapter/ui-resource-handler.js +209 -0
  93. package/extensions/dm-mcp-adapter/ui-server.js +815 -0
  94. package/extensions/dm-mcp-adapter/ui-session.js +455 -0
  95. package/extensions/dm-mcp-adapter/ui-stream-types.js +58 -0
  96. package/extensions/dm-mcp-adapter/ui-tool-visibility.js +26 -0
  97. package/extensions/dm-mcp-adapter/unix-socket-transport.js +83 -0
  98. package/extensions/dm-mcp-adapter/utils.js +307 -0
  99. package/extensions/dm-skills-manager/THIRD_PARTY_NOTICES.md +27 -0
  100. package/extensions/dm-skills-manager/extensions/skills-manager/components.js +265 -0
  101. package/extensions/dm-skills-manager/extensions/skills-manager/constants.js +31 -0
  102. package/extensions/dm-skills-manager/extensions/skills-manager/creation-fallback.js +20 -0
  103. package/extensions/dm-skills-manager/extensions/skills-manager/creation.js +145 -0
  104. package/extensions/dm-skills-manager/extensions/skills-manager/dialog.js +738 -0
  105. package/extensions/dm-skills-manager/extensions/skills-manager/dm-ai-compat.js +15 -0
  106. package/extensions/dm-skills-manager/extensions/skills-manager/format.js +125 -0
  107. package/extensions/dm-skills-manager/extensions/skills-manager/glyphs.js +142 -0
  108. package/extensions/dm-skills-manager/extensions/skills-manager/layout.js +93 -0
  109. package/extensions/dm-skills-manager/extensions/skills-manager/paths.js +76 -0
  110. package/extensions/dm-skills-manager/extensions/skills-manager/registry.js +95 -0
  111. package/extensions/dm-skills-manager/extensions/skills-manager/settings.js +93 -0
  112. package/extensions/dm-skills-manager/extensions/skills-manager/startup.js +32 -0
  113. package/extensions/dm-skills-manager/extensions/skills-manager/toggle.js +54 -0
  114. package/extensions/dm-skills-manager/extensions/skills-manager/types.js +14 -0
  115. package/extensions/dm-skills-manager/extensions/skills-manager/ui.js +121 -0
  116. package/extensions/dm-skills-manager/extensions/skills-manager.js +111 -0
  117. package/extensions/dm-skills-manager/package.json +121 -0
  118. package/package.json +13 -1
  119. package/extensions/dm-localllm-provider/detect.test.js +0 -1051
  120. package/extensions/dm-localllm-provider/index.test.js +0 -149
  121. package/extensions/dm-localllm-provider/keychain.test.js +0 -61
@@ -0,0 +1,293 @@
1
+ import { spawn, spawnSync } from "node:child_process";
2
+ import { randomUUID } from "node:crypto";
3
+ import { interpolateEnvVars } from "./utils.js";
4
+ const DEFAULT_TIMEOUT_MS = 1e4;
5
+ const MAX_OUTPUT_BYTES = 64 * 1024;
6
+ const USE_PROCESS_GROUP = process.platform !== "win32";
7
+ const CLEANUP_TOKEN_ENV = "PI_MCP_REQUEST_HEADERS_CLEANUP_TOKEN";
8
+ const PS_MAX_BUFFER_BYTES = 8 * 1024 * 1024;
9
+ function isNoSuchProcessError(error) {
10
+ return typeof error === "object" && error !== null && "code" in error && error.code === "ESRCH";
11
+ }
12
+ function runPosixPs(args) {
13
+ if (process.env.DM_MCP_ADAPTER_TEST_FAIL_PS === "1")
14
+ return { status: 1, signal: null, stdout: "" };
15
+ const result = spawnSync("ps", args, { encoding: "utf8", maxBuffer: PS_MAX_BUFFER_BYTES });
16
+ return { status: result.status, signal: result.signal, stdout: result.stdout };
17
+ }
18
+ function psFailureReason(result) {
19
+ return result.status === null ? `ps was killed by signal ${result.signal ?? "unknown"}` : `ps exited with code ${result.status}`;
20
+ }
21
+ function collectPosixProcessPids(rootPid, cleanupToken) {
22
+ const result = runPosixPs(["axeww", "-o", "pid=,ppid=,command="]);
23
+ if (result.status !== 0) {
24
+ throw new Error(`HTTP request headers command cleanup failed: ${psFailureReason(result)}`);
25
+ }
26
+ const childrenByParent = new Map;
27
+ const processPids = new Set;
28
+ const needle = cleanupToken ? `${CLEANUP_TOKEN_ENV}=${cleanupToken}` : undefined;
29
+ for (const line of result.stdout.split(`
30
+ `)) {
31
+ const match = /^\s*(\d+)\s+(\d+)(?:\s+(.*))?$/.exec(line);
32
+ if (!match)
33
+ continue;
34
+ const pid = Number(match[1]);
35
+ const ppid = Number(match[2]);
36
+ if (!Number.isInteger(pid) || !Number.isInteger(ppid))
37
+ continue;
38
+ const children = childrenByParent.get(ppid);
39
+ if (children)
40
+ children.push(pid);
41
+ else
42
+ childrenByParent.set(ppid, [pid]);
43
+ if (needle && pid !== process.pid && match[3]?.includes(needle))
44
+ processPids.add(pid);
45
+ }
46
+ const stack = [...childrenByParent.get(rootPid) ?? []];
47
+ while (stack.length > 0) {
48
+ const pid = stack.pop();
49
+ processPids.add(pid);
50
+ stack.push(...childrenByParent.get(pid) ?? []);
51
+ }
52
+ return [...processPids];
53
+ }
54
+ function assertPosixProcessDiscoveryAvailable() {
55
+ const result = runPosixPs(["axeww", "-o", "pid=,ppid=,command="]);
56
+ if (result.status !== 0) {
57
+ throw new Error(`HTTP request headers command cleanup failed: ${psFailureReason(result)}`);
58
+ }
59
+ }
60
+ function isTaskkillNoSuchProcess(result) {
61
+ return `${result.stdout ?? ""}
62
+ ${result.stderr ?? ""}`.toLowerCase().includes("not found");
63
+ }
64
+ function signalPid(pid, signal) {
65
+ try {
66
+ process.kill(pid, signal);
67
+ } catch (error) {
68
+ if (!isNoSuchProcessError(error))
69
+ throw error;
70
+ }
71
+ }
72
+ function signalProcessGroup(pid, signal) {
73
+ try {
74
+ process.kill(-pid, signal);
75
+ } catch (error) {
76
+ if (!isNoSuchProcessError(error))
77
+ throw error;
78
+ }
79
+ }
80
+ function killRequestHeadersCommand(child, trackedPosixDescendantPids = new Set, cleanupToken) {
81
+ if (process.platform === "win32" && child.pid !== undefined) {
82
+ const result = spawnSync("taskkill", ["/pid", String(child.pid), "/T", "/F"], {
83
+ encoding: "utf8",
84
+ windowsHide: true
85
+ });
86
+ if (result.status === 0 || result.status === 128 || isTaskkillNoSuchProcess(result))
87
+ return;
88
+ throw new Error(`HTTP request headers command cleanup failed: taskkill exited with code ${result.status ?? "unknown"}`);
89
+ }
90
+ if (USE_PROCESS_GROUP && child.pid !== undefined) {
91
+ const frozenPids = new Set;
92
+ let cleanupError;
93
+ try {
94
+ signalProcessGroup(child.pid, "SIGSTOP");
95
+ for (const pid of trackedPosixDescendantPids) {
96
+ signalPid(pid, "SIGSTOP");
97
+ frozenPids.add(pid);
98
+ }
99
+ let stablePasses = 0;
100
+ for (let pass = 0;pass < 16; pass++) {
101
+ const candidates = collectPosixProcessPids(child.pid, cleanupToken);
102
+ const newPids = candidates.filter((pid) => !frozenPids.has(pid));
103
+ if (newPids.length === 0) {
104
+ stablePasses++;
105
+ if (stablePasses >= 2)
106
+ return;
107
+ continue;
108
+ }
109
+ stablePasses = 0;
110
+ for (const pid of newPids) {
111
+ signalPid(pid, "SIGSTOP");
112
+ frozenPids.add(pid);
113
+ }
114
+ }
115
+ cleanupError = new Error("HTTP request headers command cleanup failed: descendant process tree did not stabilize");
116
+ } catch (error) {
117
+ cleanupError = error instanceof Error ? error : new Error(String(error));
118
+ } finally {
119
+ signalProcessGroup(child.pid, "SIGKILL");
120
+ for (const pid of frozenPids)
121
+ signalPid(pid, "SIGKILL");
122
+ }
123
+ if (cleanupError)
124
+ throw cleanupError;
125
+ return;
126
+ }
127
+ child.kill("SIGKILL");
128
+ }
129
+ function resolvedCommand(config) {
130
+ if (!config || typeof config !== "object" || Array.isArray(config)) {
131
+ throw new Error("HTTP request headers command must be an object");
132
+ }
133
+ if (typeof config.command !== "string" || config.command.trim() === "") {
134
+ throw new Error("HTTP request headers command requires a non-empty command");
135
+ }
136
+ if (config.args !== undefined && (!Array.isArray(config.args) || config.args.some((arg) => typeof arg !== "string"))) {
137
+ throw new Error("HTTP request headers command args must be strings");
138
+ }
139
+ if (config.env !== undefined && (typeof config.env !== "object" || Array.isArray(config.env) || Object.values(config.env).some((value) => typeof value !== "string"))) {
140
+ throw new Error("HTTP request headers command env values must be strings");
141
+ }
142
+ const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
143
+ if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60000) {
144
+ throw new Error("HTTP request headers command timeoutMs must be an integer between 1 and 60000");
145
+ }
146
+ return {
147
+ command: interpolateEnvVars(config.command),
148
+ args: (config.args ?? []).map(interpolateEnvVars),
149
+ env: {
150
+ ...process.env,
151
+ ...Object.fromEntries(Object.entries(config.env ?? {}).map(([key, value]) => [key, interpolateEnvVars(value)]))
152
+ },
153
+ timeoutMs
154
+ };
155
+ }
156
+ async function invokeRequestHeadersCommand(config, envelope, signal) {
157
+ const resolved = resolvedCommand(config);
158
+ if (USE_PROCESS_GROUP)
159
+ assertPosixProcessDiscoveryAvailable();
160
+ return new Promise((resolve, reject) => {
161
+ let stdout = Buffer.alloc(0);
162
+ let settled = false;
163
+ const cleanupToken = randomUUID();
164
+ const child = spawn(resolved.command, resolved.args, {
165
+ env: { ...resolved.env, [CLEANUP_TOKEN_ENV]: cleanupToken },
166
+ stdio: ["pipe", "pipe", "ignore"],
167
+ windowsHide: true,
168
+ detached: USE_PROCESS_GROUP
169
+ });
170
+ const trackedPosixDescendantPids = new Set;
171
+ let trackingError;
172
+ const trackPosixDescendants = () => {
173
+ if (!USE_PROCESS_GROUP || child.pid === undefined || settled || trackingError)
174
+ return;
175
+ try {
176
+ for (const pid of collectPosixProcessPids(child.pid, cleanupToken))
177
+ trackedPosixDescendantPids.add(pid);
178
+ } catch (error) {
179
+ trackingError = error instanceof Error ? error : new Error(String(error));
180
+ }
181
+ };
182
+ const descendantTracker = USE_PROCESS_GROUP ? setInterval(trackPosixDescendants, 50) : undefined;
183
+ descendantTracker?.unref();
184
+ const finish = (result) => {
185
+ if (settled)
186
+ return;
187
+ settled = true;
188
+ clearTimeout(timer);
189
+ if (descendantTracker)
190
+ clearInterval(descendantTracker);
191
+ signal.removeEventListener("abort", abort);
192
+ if (result.status === "error")
193
+ reject(result.error);
194
+ else
195
+ resolve(result.headers);
196
+ };
197
+ const finishAfterKill = (result) => {
198
+ try {
199
+ killRequestHeadersCommand(child, trackedPosixDescendantPids, cleanupToken);
200
+ finish(result);
201
+ } catch (cleanupError) {
202
+ finish({ status: "error", error: cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError)) });
203
+ }
204
+ };
205
+ const failAfterKill = (message) => {
206
+ finishAfterKill({ status: "error", error: trackingError ?? new Error(message) });
207
+ };
208
+ const abort = () => {
209
+ failAfterKill("HTTP request headers command aborted");
210
+ };
211
+ const timer = setTimeout(() => {
212
+ failAfterKill(`HTTP request headers command timed out after ${resolved.timeoutMs}ms`);
213
+ }, resolved.timeoutMs);
214
+ signal.addEventListener("abort", abort, { once: true });
215
+ if (signal.aborted) {
216
+ abort();
217
+ return;
218
+ }
219
+ child.on("error", () => finish({ status: "error", error: new Error("HTTP request headers command failed to start") }));
220
+ child.stdout.on("data", (chunk) => {
221
+ if (settled)
222
+ return;
223
+ stdout = Buffer.concat([stdout, Buffer.from(chunk)]);
224
+ if (stdout.byteLength > MAX_OUTPUT_BYTES) {
225
+ failAfterKill("HTTP request headers command output exceeded 64 KiB");
226
+ }
227
+ });
228
+ child.on("close", (code) => {
229
+ if (settled)
230
+ return;
231
+ if (trackingError) {
232
+ failAfterKill(trackingError.message);
233
+ return;
234
+ }
235
+ if (code !== 0) {
236
+ failAfterKill(`HTTP request headers command exited with code ${code ?? "unknown"}`);
237
+ return;
238
+ }
239
+ let parsed;
240
+ try {
241
+ parsed = JSON.parse(stdout.toString("utf8"));
242
+ } catch {
243
+ finishAfterKill({ status: "error", error: new Error("HTTP request headers command returned invalid JSON") });
244
+ return;
245
+ }
246
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
247
+ finishAfterKill({ status: "error", error: new Error("HTTP request headers command must return a JSON object") });
248
+ return;
249
+ }
250
+ const entries = Object.entries(parsed);
251
+ if (entries.some(([, value]) => typeof value !== "string")) {
252
+ finishAfterKill({ status: "error", error: new Error("HTTP request headers command values must be strings") });
253
+ return;
254
+ }
255
+ try {
256
+ finishAfterKill({ status: "success", headers: new Headers(entries) });
257
+ } catch {
258
+ finishAfterKill({ status: "error", error: new Error("HTTP request headers command returned an invalid header") });
259
+ }
260
+ });
261
+ child.stdin.on("error", () => {});
262
+ child.stdin.end(JSON.stringify(envelope));
263
+ });
264
+ }
265
+ export function createRequestHeadersCommandFetch(config, delegate = globalThis.fetch) {
266
+ resolvedCommand(config);
267
+ return async (input, init) => {
268
+ const request = new Request(input, init);
269
+ const body = Buffer.from(await request.clone().arrayBuffer());
270
+ const derived = await invokeRequestHeadersCommand(config, {
271
+ version: 1,
272
+ method: request.method.toUpperCase(),
273
+ url: request.url,
274
+ bodyBase64: body.toString("base64")
275
+ }, request.signal);
276
+ const headers = new Headers(request.headers);
277
+ derived.forEach((value, name) => headers.set(name, value));
278
+ return delegate(new URL(request.url), {
279
+ method: request.method,
280
+ headers,
281
+ ...request.method === "GET" || request.method === "HEAD" ? {} : { body },
282
+ signal: request.signal,
283
+ cache: request.cache,
284
+ credentials: request.credentials,
285
+ integrity: request.integrity,
286
+ keepalive: request.keepalive,
287
+ mode: request.mode,
288
+ redirect: request.redirect,
289
+ referrer: request.referrer,
290
+ referrerPolicy: request.referrerPolicy
291
+ });
292
+ };
293
+ }
@@ -0,0 +1,7 @@
1
+ export function resourceNameToToolName(name) {
2
+ let result = name.replace(/[^a-zA-Z0-9]/g, "_").replace(/_+/g, "_").replace(/^_+/, "").replace(/_+$/, "").toLowerCase();
3
+ if (!result || /^\d/.test(result)) {
4
+ result = "resource" + (result ? "_" + result : "");
5
+ }
6
+ return result;
7
+ }
@@ -0,0 +1,79 @@
1
+ import { formatTerminalError } from "./utils.js";
2
+ export function createMcpRuntimeOwner() {
3
+ const controller = new AbortController;
4
+ const cleanups = [];
5
+ let stopPromise;
6
+ const reportCleanupFailure = (error, late) => {
7
+ console.error(`MCP: ${late ? "late " : ""}runtime cleanup failed: ${formatTerminalError(error)}`);
8
+ };
9
+ return {
10
+ signal: controller.signal,
11
+ isActive: () => !controller.signal.aborted,
12
+ addCleanup: (cleanup) => {
13
+ if (controller.signal.aborted) {
14
+ Promise.resolve().then(cleanup).catch((error) => reportCleanupFailure(error, true));
15
+ return;
16
+ }
17
+ cleanups.push(cleanup);
18
+ },
19
+ stop: (reason = "MCP extension runtime stopped") => {
20
+ if (stopPromise)
21
+ return stopPromise;
22
+ controller.abort(new Error(reason));
23
+ const pendingCleanups = cleanups.splice(0).reverse().map((cleanup) => Promise.resolve().then(cleanup));
24
+ stopPromise = Promise.allSettled(pendingCleanups).then((results) => {
25
+ const failures = results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
26
+ if (failures.length > 0) {
27
+ const aggregate = new AggregateError(failures, "MCP runtime cleanup failed");
28
+ console.error(`MCP: runtime cleanup failed: ${formatTerminalError(aggregate)}`);
29
+ throw aggregate;
30
+ }
31
+ });
32
+ return stopPromise;
33
+ },
34
+ throwIfInactive: () => controller.signal.throwIfAborted()
35
+ };
36
+ }
37
+ export function combineAbortSignals(...signals) {
38
+ const active = signals.filter((signal) => signal !== undefined);
39
+ if (active.length === 0)
40
+ return;
41
+ if (active.length === 1)
42
+ return active[0];
43
+ return AbortSignal.any(active);
44
+ }
45
+ export function createOwnedUi(ui, owner) {
46
+ const proxies = new WeakMap;
47
+ const wrap = (value) => {
48
+ if ((typeof value !== "object" || value === null) && typeof value !== "function") {
49
+ return value;
50
+ }
51
+ const object = value;
52
+ const existing = proxies.get(object);
53
+ if (existing)
54
+ return existing;
55
+ const proxy = new Proxy(object, {
56
+ get(target, property, receiver) {
57
+ if (!owner.isActive())
58
+ return;
59
+ const member = Reflect.get(target, property, receiver);
60
+ if (typeof member === "function") {
61
+ return (...args) => {
62
+ if (!owner.isActive())
63
+ return;
64
+ return Reflect.apply(member, target, args);
65
+ };
66
+ }
67
+ return owner.isActive() ? wrap(member) : undefined;
68
+ }
69
+ });
70
+ proxies.set(object, proxy);
71
+ return proxy;
72
+ };
73
+ return wrap(ui);
74
+ }
75
+ export function isAbortError(error, signal) {
76
+ if (signal?.aborted)
77
+ return true;
78
+ return error instanceof Error && (error.name === "AbortError" || error.message === "MCP extension runtime stopped");
79
+ }
@@ -0,0 +1,222 @@
1
+ import { complete } from "@duckmind/dm-ai/compat";
2
+ import { truncateAtWord } from "./utils.js";
3
+ import { throwIfAborted } from "./abort.js";
4
+ export function registerSamplingHandler(client, options) {
5
+ client.setRequestHandler("sampling/createMessage", (request) => {
6
+ return handleSamplingRequest(options, request);
7
+ });
8
+ }
9
+ export async function handleSamplingRequest(options, request) {
10
+ const params = request.params;
11
+ const signal = options.getSignal();
12
+ throwIfAborted(signal);
13
+ if ("task" in params && params.task) {
14
+ throw new Error("MCP sampling tasks are not supported");
15
+ }
16
+ if (params.includeContext && params.includeContext !== "none") {
17
+ throw new Error("MCP sampling context inclusion is not supported");
18
+ }
19
+ if (params.tools?.length) {
20
+ throw new Error("MCP sampling tool use is not supported");
21
+ }
22
+ if (params.toolChoice) {
23
+ throw new Error("MCP sampling tool choice is not supported");
24
+ }
25
+ if (params.stopSequences?.length) {
26
+ throw new Error("MCP sampling stop sequences are not supported");
27
+ }
28
+ const messages = params.messages.map(convertSamplingMessage);
29
+ const { model, apiKey, headers } = await resolveSamplingModel(options, params.modelPreferences);
30
+ throwIfAborted(signal);
31
+ await confirmSampling(options, "Approve MCP sampling request", formatRequestApproval(options.serverName, `${model.provider}/${model.id}`, params.systemPrompt, messages));
32
+ throwIfAborted(signal);
33
+ const result = await complete(model, {
34
+ ...params.systemPrompt !== undefined ? { systemPrompt: params.systemPrompt } : {},
35
+ messages
36
+ }, {
37
+ ...apiKey !== undefined ? { apiKey } : {},
38
+ ...headers !== undefined ? { headers } : {},
39
+ maxTokens: params.maxTokens,
40
+ ...params.temperature !== undefined ? { temperature: params.temperature } : {},
41
+ ...params.metadata !== undefined ? { metadata: params.metadata } : {},
42
+ ...signal ? { signal } : {}
43
+ });
44
+ const converted = convertAssistantResult(result);
45
+ throwIfAborted(signal);
46
+ await confirmSampling(options, "Return MCP sampling response", formatResponseApproval(options.serverName, converted));
47
+ return converted;
48
+ }
49
+ function formatRequestApproval(serverName, modelName, systemPrompt, messages) {
50
+ const lines = [`${serverName} wants to sample ${messages.length} message${messages.length === 1 ? "" : "s"} with ${modelName}.`];
51
+ if (systemPrompt) {
52
+ lines.push(`System: ${truncateAtWord(systemPrompt, 400)}`);
53
+ }
54
+ for (const [index, message] of messages.entries()) {
55
+ lines.push(`${index + 1}. ${message.role}: ${truncateAtWord(messageText(message), 400)}`);
56
+ }
57
+ return lines.join(`
58
+
59
+ `);
60
+ }
61
+ function formatResponseApproval(serverName, response) {
62
+ const text = response.content.type === "text" ? response.content.text : `[${response.content.type} content]`;
63
+ return `${serverName} will receive this response from ${response.model}:
64
+
65
+ ${truncateAtWord(text, 1000)}`;
66
+ }
67
+ function messageText(message) {
68
+ if (typeof message.content === "string")
69
+ return message.content;
70
+ return message.content.map((block) => {
71
+ if (block.type === "text")
72
+ return block.text;
73
+ if (block.type === "image")
74
+ return `[image: ${block.mimeType}]`;
75
+ if (block.type === "thinking")
76
+ return "[thinking]";
77
+ if (block.type === "toolCall")
78
+ return `[tool call: ${block.name}]`;
79
+ return "[content]";
80
+ }).join(`
81
+ `);
82
+ }
83
+ async function resolveSamplingModel(options, modelPreferences) {
84
+ const candidates = [];
85
+ const availableModels = options.modelRegistry.getAvailable();
86
+ for (const hint of modelPreferences?.hints ?? []) {
87
+ const normalizedHint = hint.name?.trim().toLowerCase();
88
+ if (!normalizedHint)
89
+ continue;
90
+ for (const model of availableModels) {
91
+ const searchableNames = [`${model.provider}/${model.id}`, model.id, model.name];
92
+ if (searchableNames.some((name) => name.toLowerCase().includes(normalizedHint))) {
93
+ addSamplingCandidate(candidates, model);
94
+ }
95
+ }
96
+ }
97
+ const currentModel = options.getCurrentModel();
98
+ if (currentModel)
99
+ addSamplingCandidate(candidates, currentModel);
100
+ for (const model of availableModels) {
101
+ addSamplingCandidate(candidates, model);
102
+ }
103
+ const errors = [];
104
+ const signal = options.getSignal();
105
+ for (const model of candidates) {
106
+ throwIfAborted(signal);
107
+ const auth = await options.modelRegistry.getApiKeyAndHeaders(model);
108
+ throwIfAborted(signal);
109
+ if (auth.ok === false) {
110
+ errors.push(`${model.provider}/${model.id}: ${auth.error}`);
111
+ continue;
112
+ }
113
+ return {
114
+ model,
115
+ ...auth.apiKey !== undefined ? { apiKey: auth.apiKey } : {},
116
+ ...auth.headers !== undefined ? { headers: auth.headers } : {}
117
+ };
118
+ }
119
+ if (errors.length > 0) {
120
+ throw new Error(`No configured auth for MCP sampling model. ${errors.join("; ")}`);
121
+ }
122
+ throw new Error("No DM model is available for MCP sampling");
123
+ }
124
+ function addSamplingCandidate(candidates, model) {
125
+ if (!candidates.some((candidate) => candidate.provider === model.provider && candidate.id === model.id)) {
126
+ candidates.push(model);
127
+ }
128
+ }
129
+ async function confirmSampling(options, title, message) {
130
+ if (options.autoApprove)
131
+ return;
132
+ if (!options.ui) {
133
+ throw new Error("MCP sampling requires interactive approval. Set settings.samplingAutoApprove to true to allow it without UI.");
134
+ }
135
+ const approved = await options.ui.confirm(title, message);
136
+ if (!approved) {
137
+ throw new Error("MCP sampling request was declined");
138
+ }
139
+ }
140
+ function convertSamplingMessage(message) {
141
+ const blocks = Array.isArray(message.content) ? message.content : [message.content];
142
+ if (message.role === "user") {
143
+ return {
144
+ role: "user",
145
+ content: blocks.map(convertUserContent),
146
+ timestamp: Date.now()
147
+ };
148
+ }
149
+ return {
150
+ role: "assistant",
151
+ content: blocks.map(convertAssistantContent),
152
+ api: "mcp-sampling",
153
+ provider: "mcp",
154
+ model: "sampling-request",
155
+ usage: zeroUsage(),
156
+ stopReason: "stop",
157
+ timestamp: Date.now()
158
+ };
159
+ }
160
+ function convertUserContent(block) {
161
+ if (block.type === "text") {
162
+ return { type: "text", text: block.text };
163
+ }
164
+ throw new Error(`MCP sampling ${block.type} content is not supported`);
165
+ }
166
+ function convertAssistantContent(block) {
167
+ if (block.type === "text") {
168
+ return { type: "text", text: block.text };
169
+ }
170
+ throw new Error(`MCP sampling assistant ${block.type} content is not supported`);
171
+ }
172
+ function convertAssistantResult(message) {
173
+ if (message.stopReason === "error") {
174
+ throw new Error(message.errorMessage ?? "MCP sampling model call failed");
175
+ }
176
+ if (message.stopReason === "aborted") {
177
+ throw new Error(message.errorMessage ?? "MCP sampling model call was aborted");
178
+ }
179
+ const text = message.content.map((block) => {
180
+ if (block.type === "text")
181
+ return block.text;
182
+ if (block.type === "thinking")
183
+ return;
184
+ throw new Error(`MCP sampling result ${block.type} content is not supported`);
185
+ }).filter((value) => value !== undefined).join(`
186
+
187
+ `).trim();
188
+ if (!text) {
189
+ throw new Error("MCP sampling result did not contain text content");
190
+ }
191
+ return {
192
+ role: "assistant",
193
+ content: { type: "text", text },
194
+ model: `${message.provider}/${message.model}`,
195
+ stopReason: mapStopReason(message.stopReason)
196
+ };
197
+ }
198
+ function mapStopReason(reason) {
199
+ if (reason === "stop")
200
+ return "endTurn";
201
+ if (reason === "length")
202
+ return "maxTokens";
203
+ if (reason === "toolUse")
204
+ return "toolUse";
205
+ return reason;
206
+ }
207
+ function zeroUsage() {
208
+ return {
209
+ input: 0,
210
+ output: 0,
211
+ cacheRead: 0,
212
+ cacheWrite: 0,
213
+ totalTokens: 0,
214
+ cost: {
215
+ input: 0,
216
+ output: 0,
217
+ cacheRead: 0,
218
+ cacheWrite: 0,
219
+ total: 0
220
+ }
221
+ };
222
+ }