@fitchmultz/pi-mcp-adapter 6.0.0 → 7.0.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.
Files changed (105) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +12 -8
  3. package/dist/app-bridge.bundle.js +14 -14
  4. package/dist/config.js +41 -16
  5. package/dist/gateway-arguments.d.ts +1 -1
  6. package/dist/index.js +1 -1
  7. package/dist/lifecycle.d.ts +2 -2
  8. package/dist/lifecycle.js +2 -2
  9. package/dist/mcp-auth-flow.js +2 -2
  10. package/dist/mcp-auth.d.ts +1 -1
  11. package/dist/mcp-auth.js +3 -3
  12. package/dist/mcp-code.d.ts +6 -6
  13. package/dist/mcp-code.js +11 -10
  14. package/dist/mcp-oauth-provider.d.ts +5 -5
  15. package/dist/mcp-oauth-provider.js +5 -5
  16. package/dist/mcp-output-guard.d.ts +1 -1
  17. package/dist/mcp-panel.d.ts +2 -2
  18. package/dist/mcp-panel.js +2 -2
  19. package/dist/mcp-setup-panel.d.ts +5 -4
  20. package/dist/mcp-setup-panel.js +15 -7
  21. package/dist/mcp-trace.d.ts +1 -1
  22. package/dist/mcp-trace.js +1 -1
  23. package/dist/npx-resolver.js +8 -4
  24. package/dist/proxy-modes.d.ts +2 -2
  25. package/dist/proxy-modes.js +9 -9
  26. package/dist/sampling-handler.js +1 -0
  27. package/dist/search-ranking.js +6 -2
  28. package/dist/server-manager.d.ts +2 -2
  29. package/dist/server-manager.js +44 -27
  30. package/dist/session-recovery.d.ts +7 -4
  31. package/dist/session-recovery.js +76 -10
  32. package/dist/tool-metadata.d.ts +43 -43
  33. package/dist/tool-result-renderer.d.ts +3 -3
  34. package/dist/tool-result-renderer.js +3 -3
  35. package/dist/ui-resource-handler.d.ts +2 -2
  36. package/dist/ui-resource-handler.js +2 -2
  37. package/dist/ui-server.js +4 -3
  38. package/dist/ui-stream-types.d.ts +8 -8
  39. package/dist/unix-socket-transport.d.ts +1 -1
  40. package/dist/unix-socket-transport.js +1 -1
  41. package/dist/utils.d.ts +1 -0
  42. package/dist/utils.js +14 -0
  43. package/package.json +34 -98
  44. package/abort.ts +0 -34
  45. package/agent-dir.ts +0 -24
  46. package/app-bridge.bundle.js +0 -109
  47. package/banner.png +0 -0
  48. package/checkpoint.ts +0 -55
  49. package/commands.ts +0 -622
  50. package/config.ts +0 -1204
  51. package/consent-manager.ts +0 -25
  52. package/direct-tools.ts +0 -75
  53. package/elicitation-handler.ts +0 -349
  54. package/error-signal.ts +0 -21
  55. package/gateway-arguments.ts +0 -73
  56. package/glimpse-ui.ts +0 -80
  57. package/host-html-template.ts +0 -456
  58. package/index.ts +0 -767
  59. package/init.ts +0 -613
  60. package/legacy-migration.ts +0 -47
  61. package/lifecycle.ts +0 -165
  62. package/logger.ts +0 -127
  63. package/mcp-auth-flow.ts +0 -975
  64. package/mcp-auth.ts +0 -793
  65. package/mcp-callback-server.ts +0 -450
  66. package/mcp-code.ts +0 -412
  67. package/mcp-keyring-helper.cjs +0 -89
  68. package/mcp-oauth-provider.ts +0 -774
  69. package/mcp-output-guard.ts +0 -530
  70. package/mcp-panel.ts +0 -907
  71. package/mcp-script-worker.mjs +0 -131
  72. package/mcp-setup-panel.ts +0 -666
  73. package/mcp-status.ts +0 -110
  74. package/mcp-trace.ts +0 -295
  75. package/metadata-cache.ts +0 -271
  76. package/npx-resolver.ts +0 -488
  77. package/onboarding-state.ts +0 -58
  78. package/panel-keys.ts +0 -37
  79. package/prompts.ts +0 -337
  80. package/proxy-modes.ts +0 -1109
  81. package/resource-tools.ts +0 -52
  82. package/runtime-owner.ts +0 -123
  83. package/sampling-handler.ts +0 -276
  84. package/scripts/build-app-bridge.mjs +0 -15
  85. package/scripts/build.mjs +0 -132
  86. package/scripts/prepare.mjs +0 -103
  87. package/search-ranking.ts +0 -132
  88. package/server-manager.ts +0 -1320
  89. package/session-recovery.ts +0 -316
  90. package/state.ts +0 -64
  91. package/tool-approval.ts +0 -78
  92. package/tool-loader.ts +0 -153
  93. package/tool-metadata.ts +0 -240
  94. package/tool-registrar.ts +0 -74
  95. package/tool-result-renderer.ts +0 -294
  96. package/tsconfig.build.json +0 -13
  97. package/tsconfig.json +0 -16
  98. package/types.ts +0 -785
  99. package/ui-resource-handler.ts +0 -249
  100. package/ui-server.ts +0 -808
  101. package/ui-session.ts +0 -568
  102. package/ui-stream-types.ts +0 -89
  103. package/ui-tool-visibility.ts +0 -25
  104. package/unix-socket-transport.ts +0 -85
  105. package/utils.ts +0 -307
package/dist/ui-server.js CHANGED
@@ -1,4 +1,4 @@
1
- import http from "node:http";
1
+ import http, {} from "node:http";
2
2
  import fs from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { randomUUID } from "node:crypto";
@@ -10,7 +10,7 @@ import { logger } from "./logger.js";
10
10
  import { SessionRecoveryAuthRequiredError, withSessionRecovery } from "./session-recovery.js";
11
11
  import { ensureToolCallApproved, isToolCallApprovalRequired } from "./tool-approval.js";
12
12
  import { extractUiToolVisibility, isUiToolCallableByApp } from "./ui-tool-visibility.js";
13
- import { createUiModelContextUpdate, extractUiPromptText, getVisualizationStreamEnvelope, isServerDisabled, } from "./types.js";
13
+ import { createUiModelContextUpdate, extractUiPromptText, getVisualizationStreamEnvelope, isServerDisabled, isToolAllowed, resolveToolPrefix, } from "./types.js";
14
14
  const MAX_BODY_SIZE = 2 * 1024 * 1024;
15
15
  const ABANDONED_GRACE_MS = 60_000;
16
16
  const WATCHDOG_INTERVAL_MS = 5_000;
@@ -299,9 +299,10 @@ export async function startUiServer(options) {
299
299
  sendJson(res, 503, { ok: false, error: `Server "${options.serverName}" is disabled` });
300
300
  return;
301
301
  }
302
+ const definition = options.config?.mcpServers[options.serverName] ?? connection.definition;
302
303
  const toolDefinitions = Array.isArray(connection.tools) ? connection.tools : [];
303
304
  const toolDefinition = toolDefinitions.find((tool) => tool.name === callParams.name);
304
- if (!toolDefinition) {
305
+ if (!toolDefinition || !isToolAllowed(callParams.name, options.serverName, resolveToolPrefix(definition, options.config?.settings?.toolPrefix), definition?.includeTools, definition?.excludeTools)) {
305
306
  sendJson(res, 403, { ok: false, error: `MCP tool "${callParams.name}" is not callable by apps` });
306
307
  return;
307
308
  }
@@ -10,17 +10,17 @@ export declare const uiStreamModeSchema: z.ZodEnum<{
10
10
  }>;
11
11
  export type UiStreamMode = z.infer<typeof uiStreamModeSchema>;
12
12
  export declare const visualizationStreamPhaseSchema: z.ZodEnum<{
13
- shell: "shell";
14
- narrative: "narrative";
15
- structure: "structure";
16
13
  detail: "detail";
14
+ narrative: "narrative";
17
15
  settled: "settled";
16
+ shell: "shell";
17
+ structure: "structure";
18
18
  }>;
19
19
  export type VisualizationStreamPhase = z.infer<typeof visualizationStreamPhaseSchema>;
20
20
  export declare const visualizationStreamFrameTypeSchema: z.ZodEnum<{
21
- patch: "patch";
22
21
  checkpoint: "checkpoint";
23
22
  final: "final";
23
+ patch: "patch";
24
24
  }>;
25
25
  export type VisualizationStreamFrameType = z.infer<typeof visualizationStreamFrameTypeSchema>;
26
26
  export declare const visualizationStreamStatusSchema: z.ZodEnum<{
@@ -42,16 +42,16 @@ export declare const visualizationStreamEnvelopeSchema: z.ZodObject<{
42
42
  streamId: z.ZodString;
43
43
  sequence: z.ZodNumber;
44
44
  frameType: z.ZodEnum<{
45
- patch: "patch";
46
45
  checkpoint: "checkpoint";
47
46
  final: "final";
47
+ patch: "patch";
48
48
  }>;
49
49
  phase: z.ZodEnum<{
50
- shell: "shell";
51
- narrative: "narrative";
52
- structure: "structure";
53
50
  detail: "detail";
51
+ narrative: "narrative";
54
52
  settled: "settled";
53
+ shell: "shell";
54
+ structure: "structure";
55
55
  }>;
56
56
  status: z.ZodEnum<{
57
57
  error: "error";
@@ -2,12 +2,12 @@ import type { Transport } from "@modelcontextprotocol/client";
2
2
  import type { JSONRPCMessage } from "@modelcontextprotocol/client";
3
3
  /** MCP JSONL transport for an explicitly configured Unix-domain socket. */
4
4
  export declare class UnixSocketClientTransport implements Transport {
5
- private readonly socketPath;
6
5
  private socket;
7
6
  private readonly readBuffer;
8
7
  onclose?: () => void;
9
8
  onerror?: (error: Error) => void;
10
9
  onmessage?: (message: JSONRPCMessage) => void;
10
+ private readonly socketPath;
11
11
  constructor(socketPath: string);
12
12
  start(): Promise<void>;
13
13
  close(): Promise<void>;
@@ -2,12 +2,12 @@ import { createConnection } from "node:net";
2
2
  import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/client";
3
3
  /** MCP JSONL transport for an explicitly configured Unix-domain socket. */
4
4
  export class UnixSocketClientTransport {
5
- socketPath;
6
5
  socket;
7
6
  readBuffer = new ReadBuffer();
8
7
  onclose;
9
8
  onerror;
10
9
  onmessage;
10
+ socketPath;
11
11
  constructor(socketPath) {
12
12
  this.socketPath = socketPath;
13
13
  }
package/dist/utils.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
2
  import type { McpConfig, ServerEntry } from "./types.ts";
3
+ export declare const ADAPTER_VERSION: string;
3
4
  export declare function normalizeRequestTimeoutMs(timeoutMs: number | undefined): number | undefined;
4
5
  export declare function openUrl(pi: ExtensionAPI, url: string, browser?: string, signal?: AbortSignal): Promise<void>;
5
6
  export declare function openPath(pi: ExtensionAPI, targetPath: string): Promise<void>;
package/dist/utils.js CHANGED
@@ -1,6 +1,20 @@
1
1
  import { spawnSync } from "node:child_process";
2
+ import { readFileSync } from "node:fs";
2
3
  import { homedir, platform } from "node:os";
3
4
  import { join } from "node:path";
5
+ function readAdapterVersion() {
6
+ // Source modules sit beside package.json; compiled modules sit one level down in dist/.
7
+ for (const path of ["./package.json", "../package.json"]) {
8
+ try {
9
+ const manifest = JSON.parse(readFileSync(new URL(path, import.meta.url), "utf8"));
10
+ if (manifest.name === "@fitchmultz/pi-mcp-adapter" && typeof manifest.version === "string")
11
+ return manifest.version;
12
+ }
13
+ catch { }
14
+ }
15
+ return "0.0.0";
16
+ }
17
+ export const ADAPTER_VERSION = readAdapterVersion();
4
18
  export function normalizeRequestTimeoutMs(timeoutMs) {
5
19
  return typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0
6
20
  ? timeoutMs
package/package.json CHANGED
@@ -1,29 +1,31 @@
1
1
  {
2
2
  "name": "@fitchmultz/pi-mcp-adapter",
3
- "version": "6.0.0",
3
+ "version": "7.0.0",
4
4
  "description": "Fitch's independently maintained MCP adapter for Pi coding agent",
5
5
  "type": "module",
6
6
  "types": "./dist/index.d.ts",
7
7
  "exports": {
8
8
  ".": {
9
9
  "types": "./dist/index.d.ts",
10
- "import": "./index.ts",
11
- "default": "./index.ts"
10
+ "default": "./dist/index.js"
12
11
  },
13
12
  "./types": {
14
13
  "types": "./dist/types.d.ts",
15
- "import": "./types.ts",
16
- "default": "./types.ts"
14
+ "default": "./dist/types.js"
17
15
  }
18
16
  },
19
17
  "license": "MIT",
20
18
  "author": "Mitch Fultz",
21
- "contributors": ["Nico Bailon"],
19
+ "contributors": [
20
+ "Nico Bailon"
21
+ ],
22
22
  "homepage": "https://github.com/fitchmultz/pi-mcp-adapter",
23
23
  "bugs": "https://github.com/fitchmultz/pi-mcp-adapter/issues",
24
- "publishConfig": { "access": "public" },
24
+ "publishConfig": {
25
+ "access": "public"
26
+ },
25
27
  "engines": {
26
- "node": ">=22.19.0"
28
+ "node": ">=24.0.0"
27
29
  },
28
30
  "bin": {
29
31
  "fitch-mcp-adapter": "cli.js"
@@ -34,11 +36,9 @@
34
36
  "prepare": "node ./scripts/prepare.mjs",
35
37
  "check:compat": "node scripts/compat-host.mjs && npm run build && npm run typecheck && vitest run --exclude __tests__/interactive-visualizer-server.test.ts && npm run test:oauth && node scripts/compat-package-smoke.mjs",
36
38
  "typecheck": "tsc --noEmit",
37
- "test": "vitest run",
39
+ "test": "vitest run && npm run test:oauth",
38
40
  "test:watch": "vitest",
39
- "test:coverage": "vitest run --coverage",
40
- "test:oauth": "PI_MCP_ADAPTER_TEST_AUTH_STORE=memory node --import tsx --test --test-concurrency=1 mcp-auth.test.ts mcp-auth-flow.test.ts mcp-callback-server.test.ts mcp-oauth-provider.test.ts",
41
- "test:oauth-provider": "PI_MCP_ADAPTER_TEST_AUTH_STORE=memory node --import tsx --test mcp-oauth-provider.test.ts",
41
+ "test:oauth": "PI_MCP_ADAPTER_TEST_AUTH_STORE=memory node --test --test-concurrency=1 mcp-auth.test.ts mcp-auth-flow.test.ts mcp-callback-server.test.ts mcp-oauth-provider.test.ts",
42
42
  "test:conformance": "bash conformance/run.sh"
43
43
  },
44
44
  "repository": {
@@ -67,94 +67,31 @@
67
67
  },
68
68
  "files": [
69
69
  "dist",
70
- "docs/client-metadata.json",
71
- "scripts/build.mjs",
72
- "scripts/build-app-bridge.mjs",
73
- "scripts/prepare.mjs",
74
- "tsconfig.build.json",
75
- "tsconfig.json",
76
70
  "cli.js",
77
- "agent-dir.ts",
78
- "legacy-migration.ts",
79
- "index.ts",
80
- "tool-loader.ts",
81
- "gateway-arguments.ts",
82
- "error-signal.ts",
83
- "state.ts",
84
- "utils.ts",
85
- "abort.ts",
86
- "runtime-owner.ts",
87
- "checkpoint.ts",
88
- "tool-metadata.ts",
89
- "search-ranking.ts",
90
- "tool-approval.ts",
91
- "init.ts",
92
- "ui-session.ts",
93
- "proxy-modes.ts",
94
- "direct-tools.ts",
95
- "commands.ts",
96
- "prompts.ts",
97
- "onboarding-state.ts",
98
- "mcp-setup-panel.ts",
99
- "types.ts",
100
- "ui-stream-types.ts",
101
- "ui-tool-visibility.ts",
102
- "config.ts",
103
- "server-manager.ts",
104
- "unix-socket-transport.ts",
105
- "session-recovery.ts",
106
- "sampling-handler.ts",
107
- "elicitation-handler.ts",
108
- "tool-registrar.ts",
109
- "tool-result-renderer.ts",
110
- "mcp-output-guard.ts",
111
- "mcp-code.ts",
112
- "mcp-script-worker.mjs",
113
- "resource-tools.ts",
114
- "lifecycle.ts",
115
- "mcp-status.ts",
116
- "metadata-cache.ts",
117
- "host-html-template.ts",
118
- "ui-resource-handler.ts",
119
- "consent-manager.ts",
120
- "ui-server.ts",
121
- "glimpse-ui.ts",
122
- "npx-resolver.ts",
123
- "mcp-auth.ts",
124
- "mcp-keyring-helper.cjs",
125
- "mcp-oauth-provider.ts",
126
- "mcp-callback-server.ts",
127
- "mcp-auth-flow.ts",
128
- "mcp-panel.ts",
129
- "panel-keys.ts",
130
- "mcp-trace.ts",
131
- "logger.ts",
132
- "app-bridge.bundle.js",
133
- "banner.png",
134
71
  "skills",
72
+ "docs/client-metadata.json",
135
73
  "README.md",
136
74
  "OAUTH.md",
137
75
  "CHANGELOG.md",
138
76
  "LICENSE"
139
77
  ],
140
78
  "dependencies": {
141
- "@modelcontextprotocol/client": "2.0.0",
142
- "@modelcontextprotocol/core": "2.0.0",
79
+ "@modelcontextprotocol/client": "2.1.0",
80
+ "@modelcontextprotocol/core": "2.1.0",
143
81
  "@modelcontextprotocol/ext-apps": "2.0.0",
144
- "@napi-rs/keyring": "^1.3.0",
145
- "cross-spawn": "^7.0.6",
146
- "minisearch": "^7.2.0",
147
- "open": "^10.2.0",
148
- "smol-toml": "^1.8.0",
149
- "strip-json-comments": "^5.0.3",
150
- "zod": "^4.6.5"
82
+ "@napi-rs/keyring": "2.1.0",
83
+ "cross-spawn": "7.0.6",
84
+ "minisearch": "7.2.0",
85
+ "open": "11.0.4",
86
+ "smol-toml": "1.9.0",
87
+ "strip-json-comments": "5.0.3",
88
+ "zod": "4.6.5"
151
89
  },
152
90
  "peerDependencies": {
153
91
  "@earendil-works/pi-ai": "*",
154
92
  "@earendil-works/pi-coding-agent": "*",
155
93
  "@earendil-works/pi-tui": "*",
156
- "typebox": "*",
157
- "zod": "^4.6.5"
94
+ "typebox": "*"
158
95
  },
159
96
  "peerDependenciesMeta": {
160
97
  "@earendil-works/pi-ai": {
@@ -171,17 +108,16 @@
171
108
  }
172
109
  },
173
110
  "devDependencies": {
174
- "@earendil-works/pi-ai": "0.87.0",
175
- "@earendil-works/pi-coding-agent": "0.87.0",
176
- "@earendil-works/pi-tui": "0.87.0",
177
- "@modelcontextprotocol/conformance": "0.1.16",
178
- "@modelcontextprotocol/server": "2.0.0",
111
+ "@earendil-works/pi-ai": "0.87.1",
112
+ "@earendil-works/pi-coding-agent": "0.87.1",
113
+ "@earendil-works/pi-tui": "0.87.1",
114
+ "@modelcontextprotocol/server": "2.1.0",
179
115
  "@types/cross-spawn": "6.0.6",
180
- "@types/node": "20.19.43",
181
- "esbuild": "^0.28.2",
182
- "tsx": "^4.21.0",
183
- "typebox": "1.3.7",
184
- "typescript": "5.9.3",
185
- "vitest": "^3.0.0"
186
- }
116
+ "@types/node": "24.19.0",
117
+ "esbuild": "0.28.2",
118
+ "typebox": "1.3.34",
119
+ "typescript": "7.0.2",
120
+ "vitest": "5.0.2"
121
+ },
122
+ "packageManager": "npm@12.1.0"
187
123
  }
package/abort.ts DELETED
@@ -1,34 +0,0 @@
1
- export function throwIfAborted(signal?: AbortSignal): void {
2
- if (!signal?.aborted) return;
3
- throw signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason ?? "MCP request aborted"));
4
- }
5
-
6
- export async function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {
7
- if (!signal) return promise;
8
- throwIfAborted(signal);
9
- return await new Promise<T>((resolve, reject) => {
10
- let settled = false;
11
- const cleanup = () => signal.removeEventListener("abort", onAbort);
12
- const onAbort = () => {
13
- if (settled) return;
14
- settled = true;
15
- cleanup();
16
- reject(signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason ?? "MCP request aborted")));
17
- };
18
- signal.addEventListener("abort", onAbort, { once: true });
19
- promise.then(
20
- value => {
21
- if (settled) return;
22
- settled = true;
23
- cleanup();
24
- resolve(value);
25
- },
26
- error => {
27
- if (settled) return;
28
- settled = true;
29
- cleanup();
30
- reject(error);
31
- },
32
- );
33
- });
34
- }
package/agent-dir.ts DELETED
@@ -1,24 +0,0 @@
1
- import { homedir } from "node:os";
2
- import { join, resolve } from "node:path";
3
-
4
- export function getAgentDir(): string {
5
- const configured = process.env.PI_CODING_AGENT_DIR?.trim();
6
- if (!configured) {
7
- return join(homedir(), ".pi", "agent");
8
- }
9
- if (configured === "~") {
10
- return homedir();
11
- }
12
- if (configured.startsWith("~/")) {
13
- return resolve(homedir(), configured.slice(2));
14
- }
15
- return resolve(configured);
16
- }
17
-
18
- export function getAgentPath(...segments: string[]): string {
19
- return join(getAgentDir(), ...segments);
20
- }
21
-
22
- export function getAdapterPath(...segments: string[]): string {
23
- return getAgentPath("fitch-mcp-adapter", ...segments);
24
- }