pi-mcp-adapter 2.4.0 → 2.4.2

package/onboarding-state.ts

@@ -0,0 +1,68 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+
+export interface McpOnboardingState {
+  version: 1;
+  sharedConfigHintShown: boolean;
+  setupCompleted: boolean;
+  lastDiscoveryFingerprint?: string;
+}
+
+const DEFAULT_STATE: McpOnboardingState = {
+  version: 1,
+  sharedConfigHintShown: false,
+  setupCompleted: false,
+};
+
+export function getOnboardingStatePath(): string {
+  return join(homedir(), ".pi", "agent", "mcp-onboarding.json");
+}
+
+export function loadOnboardingState(): McpOnboardingState {
+  const path = getOnboardingStatePath();
+  if (!existsSync(path)) return { ...DEFAULT_STATE };
+
+  try {
+    const raw = JSON.parse(readFileSync(path, "utf-8")) as Partial<McpOnboardingState>;
+    if (!raw || typeof raw !== "object") return { ...DEFAULT_STATE };
+    return {
+      version: 1,
+      sharedConfigHintShown: raw.sharedConfigHintShown === true,
+      setupCompleted: raw.setupCompleted === true,
+      lastDiscoveryFingerprint: typeof raw.lastDiscoveryFingerprint === "string" ? raw.lastDiscoveryFingerprint : undefined,
+    };
+  } catch {
+    return { ...DEFAULT_STATE };
+  }
+}
+
+export function saveOnboardingState(state: McpOnboardingState): void {
+  const path = getOnboardingStatePath();
+  mkdirSync(dirname(path), { recursive: true });
+  const tmpPath = `${path}.${process.pid}.tmp`;
+  writeFileSync(tmpPath, `${JSON.stringify(state, null, 2)}\n`, "utf-8");
+  renameSync(tmpPath, path);
+}
+
+export function updateOnboardingState(updater: (state: McpOnboardingState) => McpOnboardingState): McpOnboardingState {
+  const next = updater(loadOnboardingState());
+  saveOnboardingState(next);
+  return next;
+}
+
+export function markSharedConfigHintShown(fingerprint?: string): McpOnboardingState {
+  return updateOnboardingState((state) => ({
+    ...state,
+    sharedConfigHintShown: true,
+    lastDiscoveryFingerprint: fingerprint ?? state.lastDiscoveryFingerprint,
+  }));
+}
+
+export function markSetupCompleted(fingerprint?: string): McpOnboardingState {
+  return updateOnboardingState((state) => ({
+    ...state,
+    setupCompleted: true,
+    lastDiscoveryFingerprint: fingerprint ?? state.lastDiscoveryFingerprint,
+  }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mcp-adapter",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "MCP (Model Context Protocol) adapter extension for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,8 @@
     "proxy-modes.ts",
     "direct-tools.ts",
     "commands.ts",
+    "onboarding-state.ts",
+    "mcp-setup-panel.ts",
     "types.ts",
     "ui-stream-types.ts",
     "config.ts",
@@ -75,7 +77,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.2.2",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@sinclair/typebox": "^0.32.0",
+    "typebox": "^1.1.24",
     "open": "^10.2.0",
     "zod": "^3.25.0 || ^4.0.0"
   },

package/utils.ts

@@ -1,25 +1,34 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { platform } from "node:os";
 
-export async function openUrl(pi: ExtensionAPI, url: string, browser?: string): Promise<void> {
+async function execOpen(pi: ExtensionAPI, target: string, browser?: string) {
   const os = platform();
-  let result;
 
   if (os === "darwin") {
-    result = browser ? await pi.exec("open", ["-a", browser, url]) : await pi.exec("open", [url]);
-  } else if (os === "win32") {
-    result = browser
-      ? await pi.exec("cmd", ["/c", "start", "", browser, url])
-      : await pi.exec("cmd", ["/c", "start", "", url]);
-  } else {
-    result = browser ? await pi.exec(browser, [url]) : await pi.exec("xdg-open", [url]);
+    return browser ? pi.exec("open", ["-a", browser, target]) : pi.exec("open", [target]);
+  }
+  if (os === "win32") {
+    return browser
+      ? pi.exec("cmd", ["/c", "start", "", browser, target])
+      : pi.exec("cmd", ["/c", "start", "", target]);
   }
+  return browser ? pi.exec(browser, [target]) : pi.exec("xdg-open", [target]);
+}
 
+export async function openUrl(pi: ExtensionAPI, url: string, browser?: string): Promise<void> {
+  const result = await execOpen(pi, url, browser);
   if (result.code !== 0) {
     throw new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);
   }
 }
 
+export async function openPath(pi: ExtensionAPI, targetPath: string): Promise<void> {
+  const result = await execOpen(pi, targetPath);
+  if (result.code !== 0) {
+    throw new Error(result.stderr || `Failed to open path (exit code ${result.code})`);
+  }
+}
+
 export async function parallelLimit<T, R>(
   items: T[],
   limit: number,