@fitchmultz/pi-mcp-adapter 6.0.0 → 7.1.0

package/consent-manager.ts

@@ -1,25 +0,0 @@
-import { logger } from "./logger.ts";
-
-export class ConsentManager {
-  private decisions = new Map<string, boolean>();
-  private log = logger.child({ component: "ConsentManager" });
-
-  hasDecisions(): boolean { return this.decisions.size > 0; }
-
-  requiresPrompt(serverName: string): boolean {
-    return this.decisions.get(serverName) !== true;
-  }
-
-  registerDecision(serverName: string, approved: boolean): void {
-    this.decisions.set(serverName, approved);
-    this.log.debug(`Consent ${approved ? "granted" : "denied"}`, { server: serverName });
-  }
-
-  ensureApproved(serverName: string): void {
-    const decision = this.decisions.get(serverName);
-    if (decision === true) return;
-    throw new Error(decision === false
-      ? `Tool calls for "${serverName}" were denied for this session`
-      : `Tool call approval required for "${serverName}"`);
-  }
-}

package/direct-tools.ts

@@ -1,75 +0,0 @@
-import type { AgentToolResult, AgentToolUpdateCallback, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { McpExtensionState } from "./state.ts";
-import type { DirectToolSpec, McpAdapterOptions, McpConfig } from "./types.ts";
-import { abortable, throwIfAborted } from "./abort.ts";
-import { parseDirectToolSelectors } from "./metadata-cache.ts";
-export { getMissingConfiguredDirectToolServers } from "./metadata-cache.ts";
-import { executeCall } from "./proxy-modes.ts";
-import { isServerDisabled } from "./types.ts";
-
-export function directToolSelection(config: McpConfig, serverName: string, envOverride?: string[]): true | string[] | false {
-  if (envOverride) {
-    const selection = parseDirectToolSelectors(envOverride);
-    if (selection.servers.has(serverName)) return true;
-    return selection.tools.has(serverName) ? [...selection.tools.get(serverName)!] : false;
-  }
-  return config.mcpServers[serverName]?.directTools ?? config.settings?.directTools ?? false;
-}
-
-export function buildProxyDescription(config: McpConfig): string {
-  const servers = Object.entries(config.mcpServers).filter(([, definition]) => !isServerDisabled(definition)).map(([name]) => name).sort();
-  return [
-    "MCP gateway. Use mcp_search to discover and load typed tools; mcp_script for multi-call composition. Native Pi tools are called directly.",
-    `Configured servers: ${servers.join(", ") || "none"}. Catalog discovery is lazy.`,
-    "Actions: status; list/search/describe; call (tool,args,server?); connect (server); instructions (server); resources (server); read-resource (server,uri); read-result (ref,path?,fields?,offset?,limit?); auth-start/auth-complete (server,args?); ui-messages.",
-    "Use call when a discovered direct tool is unavailable in this host. read-result reads a retained response without repeating the remote operation.",
-  ].join("\n");
-}
-
-type DirectToolExecute = (
-  toolCallId: string,
-  params: Record<string, unknown>,
-  signal: AbortSignal | undefined,
-  onUpdate: AgentToolUpdateCallback<Record<string, unknown>> | undefined,
-  ctx: ExtensionContext,
-) => Promise<AgentToolResult<Record<string, unknown>>>;
-
-export function createDirectToolExecutor(
-  getState: () => McpExtensionState | null,
-  getInitPromise: () => Promise<McpExtensionState> | null,
-  spec: DirectToolSpec,
-  beforeExecute?: McpAdapterOptions["beforeExecute"],
-): DirectToolExecute {
-  return async function execute(toolCallId, params, signal, _onUpdate, ctx) {
-    throwIfAborted(signal);
-    let state = getState();
-    const initPromise = getInitPromise();
-
-    if (!state && initPromise) {
-      try {
-        state = await abortable(initPromise, signal);
-      } catch (error) {
-        throwIfAborted(signal);
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: "text" as const, text: `MCP initialization failed: ${message}` }],
-          details: { error: "init_failed", message },
-        };
-      }
-    }
-    if (!state) {
-      return {
-        content: [{ type: "text" as const, text: "MCP not initialized" }],
-        details: { error: "not_initialized" },
-      };
-    }
-
-    const result = await executeCall(
-      state, spec.originalName, params, spec.serverName, undefined, signal, { toolCallId },
-      beforeExecute ? (callSignal, operation) => beforeExecute(toolCallId, { ...ctx, signal: callSignal }, operation) : undefined,
-      { exactOriginalName: true, ...(spec.resourceUri ? { resourceUri: spec.resourceUri } : {}) },
-    );
-    const { mode: _mode, ...details } = result.details;
-    return { ...result, details };
-  };
-}

package/elicitation-handler.ts

@@ -1,349 +0,0 @@
-import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
-import type { Client } from "@modelcontextprotocol/client";
-import {
-  ProtocolErrorCode,
-  ProtocolError,
-  type ElicitRequest,
-  type ElicitRequestFormParams,
-  type ElicitRequestURLParams,
-  type ElicitResult,
-} from "@modelcontextprotocol/client";
-import { AjvJsonSchemaValidator } from "@modelcontextprotocol/client/validators/ajv";
-import type { JsonSchemaType } from "@modelcontextprotocol/client";
-import open from "open";
-
-export type ElicitationValue = string | number | boolean | string[] | undefined;
-type FormProperty = ElicitRequestFormParams["requestedSchema"]["properties"][string];
-
-export type ElicitationUIContext = ExtensionUIContext;
-
-export interface ElicitationHandlerOptions {
-  serverName: string;
-  ui: ElicitationUIContext;
-  allowUrl: boolean;
-  onUrlAccepted?: (elicitationId: string) => void;
-}
-
-export type ServerElicitationConfig = Omit<ElicitationHandlerOptions, "serverName" | "onUrlAccepted">;
-
-export function registerElicitationHandler(
-  client: Client,
-  options: ElicitationHandlerOptions,
-  own: (run: () => Promise<ElicitResult>) => Promise<ElicitResult> = run => run(),
-): void {
-  client.setRequestHandler("elicitation/create", request => own(() => handleElicitationRequest(options, request)));
-}
-
-export async function handleElicitationRequest(
-  options: ElicitationHandlerOptions,
-  request: ElicitRequest,
-): Promise<ElicitResult> {
-  return request.params.mode === "url"
-    ? handleUrlElicitation(options, request.params)
-    : handleFormElicitation(options, request.params);
-}
-
-export async function handleFormElicitation(
-  options: ElicitationHandlerOptions,
-  params: ElicitRequestFormParams,
-): Promise<ElicitResult> {
-  const decision = await options.ui.select(
-    `MCP Input Request\nServer: ${options.serverName}\n\n${params.message}`,
-    ["Continue", "Decline"],
-  );
-  if (decision === undefined) return { action: "cancel" };
-  if (decision === "Decline") return { action: "decline" };
-
-  const values: Record<string, ElicitationValue> = {};
-  const properties = Object.entries(params.requestedSchema.properties);
-  for (const [name, schema] of properties) {
-    const value = await collectValidField(options.ui, params, name, schema);
-    if (!("value" in value)) return { action: "cancel" };
-    values[name] = value.value;
-  }
-
-  while (true) {
-    const content = coerceAndValidateFormValues(params, values);
-    const action = await options.ui.select(
-      formatReview(options.serverName, properties, content),
-      properties.length > 0 ? ["Submit", "Edit", "Decline"] : ["Submit", "Decline"],
-    );
-    if (action === undefined) return { action: "cancel" };
-    if (action === "Decline") return { action: "decline" };
-    if (action === "Submit") return { action: "accept", content };
-
-    const labels = properties.map(([name, schema]) => `${schema.title ?? humanizeName(name)} (${name})`);
-    const selected = await options.ui.select("Choose a field to edit", labels);
-    if (selected === undefined) return { action: "cancel" };
-    const property = properties[labels.indexOf(selected)];
-    if (!property) continue;
-    const [name, schema] = property;
-    const value = await collectValidField(options.ui, params, name, schema, values[name]);
-    if (!("value" in value)) return { action: "cancel" };
-    values[name] = value.value;
-  }
-}
-
-async function collectValidField(
-  ui: ElicitationUIContext,
-  params: ElicitRequestFormParams,
-  name: string,
-  schema: FormProperty,
-  current?: ElicitationValue,
-): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {
-  const required = params.requestedSchema.required?.includes(name) === true;
-  while (true) {
-    const result = await collectField(ui, params, name, schema, current);
-    if (!("value" in result)) return result;
-    try {
-      coerceAndValidateFormValues({
-        ...params,
-        requestedSchema: {
-          type: "object",
-          properties: { [name]: schema },
-          ...(required ? { required: [name] } : {}),
-        },
-      }, { [name]: result.value });
-      return result;
-    } catch (error) {
-      ui.notify(error instanceof Error ? error.message : String(error), "error");
-      current = result.value;
-    }
-  }
-}
-
-async function collectField(
-  ui: ElicitationUIContext,
-  params: ElicitRequestFormParams,
-  name: string,
-  schema: FormProperty,
-  current?: ElicitationValue,
-): Promise<{ cancelled: true } | { cancelled: false; value: ElicitationValue }> {
-  const required = params.requestedSchema.required?.includes(name) === true;
-  const title = [schema.title ?? humanizeName(name), required ? "(required)" : "", schema.description]
-    .filter(Boolean)
-    .join(" ");
-
-  if (schema.type === "string" && ("enum" in schema || "oneOf" in schema)) {
-    const choices = "oneOf" in schema
-      ? schema.oneOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))
-      : schema.enum.map((value, index) => ({
-          value,
-          display: formatChoice(value, "enumNames" in schema ? schema.enumNames?.[index] : undefined),
-        }));
-    const displays = uniqueLabels(choices.map(choice => choice.display));
-    const actions = [...displays];
-    const useDefault = schema.default === undefined ? undefined : uniqueAction("Use default", actions);
-    if (useDefault) actions.push(useDefault);
-    const omit = required ? undefined : uniqueAction("Omit", actions);
-    if (omit) actions.push(omit);
-    const action = await ui.select(title, actions);
-    if (action === undefined) return { cancelled: true };
-    if (action === useDefault) return { cancelled: false, value: schema.default };
-    if (action === omit) return { cancelled: false, value: undefined };
-    return { cancelled: false, value: choices[displays.indexOf(action)]?.value };
-  }
-
-  if (schema.type === "boolean") {
-    const actions = ["Yes", "No"];
-    if (schema.default !== undefined) actions.push("Use default");
-    if (!required) actions.push("Omit");
-    const action = await ui.select(title, actions);
-    if (action === undefined) return { cancelled: true };
-    if (action === "Use default") return { cancelled: false, value: schema.default };
-    if (action === "Omit") return { cancelled: false, value: undefined };
-    return { cancelled: false, value: action === "Yes" };
-  }
-
-  if (schema.type === "array") {
-    const actions = ["Choose values"];
-    if (schema.default !== undefined) actions.push("Use default");
-    if (!required) actions.push("Omit");
-    const action = await ui.select(title, actions);
-    if (action === undefined) return { cancelled: true };
-    if (action === "Use default") return { cancelled: false, value: schema.default };
-    if (action === "Omit") return { cancelled: false, value: undefined };
-
-    const choices = extractMultiSelectOptions(schema);
-    const selected = new Set(Array.isArray(current) ? current : []);
-    while (true) {
-      const displays = uniqueLabels(choices.map(choice => selected.has(choice.value) ? `✓ ${choice.display}` : choice.display));
-      const done = uniqueAction("Done", displays);
-      const picked = await ui.select(title, [...displays, done]);
-      if (picked === undefined) return { cancelled: true };
-      if (picked === done) return { cancelled: false, value: [...selected] };
-      const choice = choices[displays.indexOf(picked)];
-      if (!choice) continue;
-      if (selected.has(choice.value)) selected.delete(choice.value);
-      else selected.add(choice.value);
-    }
-  }
-
-  const actions = ["Enter value"];
-  if (schema.default !== undefined) actions.push("Use default");
-  if (!required) actions.push("Omit");
-  const action = await ui.select(title, actions);
-  if (action === undefined) return { cancelled: true };
-  if (action === "Use default") return { cancelled: false, value: schema.default };
-  if (action === "Omit") return { cancelled: false, value: undefined };
-  const entered = await ui.input(title, current === undefined ? undefined : String(current));
-  return entered === undefined ? { cancelled: true } : { cancelled: false, value: entered };
-}
-
-export function coerceAndValidateFormValues(
-  params: ElicitRequestFormParams,
-  values: Record<string, ElicitationValue>,
-): Record<string, string | number | boolean | string[]> {
-  const output: Record<string, string | number | boolean | string[]> = {};
-  const required = new Set(params.requestedSchema.required ?? []);
-  for (const [name, schema] of Object.entries(params.requestedSchema.properties)) {
-    const value = values[name];
-    if (value === undefined) {
-      if (required.has(name)) throw new Error(`Missing required elicitation field: ${name}`);
-      continue;
-    }
-    if (schema.type === "string") {
-      const stringValue = String(value);
-      const limits = schema as typeof schema & { minLength?: number; maxLength?: number };
-      if (limits.minLength !== undefined && stringValue.length < limits.minLength) {
-        throw new Error(`Elicitation field ${name} is shorter than minimum length ${limits.minLength}`);
-      }
-      if (limits.maxLength !== undefined && stringValue.length > limits.maxLength) {
-        throw new Error(`Elicitation field ${name} is longer than maximum length ${limits.maxLength}`);
-      }
-      if ("enum" in schema && !schema.enum.includes(stringValue)) {
-        throw new Error(`Elicitation field ${name} is not an allowed value`);
-      }
-      if ("oneOf" in schema && !schema.oneOf.some(option => option.const === stringValue)) {
-        throw new Error(`Elicitation field ${name} is not an allowed value`);
-      }
-      output[name] = stringValue;
-      continue;
-    }
-    if (schema.type === "number" || schema.type === "integer") {
-      if (typeof value === "string" && value.trim() === "") {
-        throw new Error(`Elicitation field ${name} must be a number`);
-      }
-      const numberValue = typeof value === "number" ? value : Number(value);
-      if (!Number.isFinite(numberValue)) throw new Error(`Elicitation field ${name} must be a number`);
-      if (schema.type === "integer" && !Number.isInteger(numberValue)) {
-        throw new Error(`Elicitation field ${name} must be an integer`);
-      }
-      if (schema.minimum !== undefined && numberValue < schema.minimum) {
-        throw new Error(`Elicitation field ${name} is below minimum ${schema.minimum}`);
-      }
-      if (schema.maximum !== undefined && numberValue > schema.maximum) {
-        throw new Error(`Elicitation field ${name} is above maximum ${schema.maximum}`);
-      }
-      output[name] = numberValue;
-      continue;
-    }
-    if (schema.type === "boolean") {
-      output[name] = typeof value === "boolean" ? value : value === "true";
-      continue;
-    }
-    if (schema.type === "array") {
-      if (!Array.isArray(value)) throw new Error(`Elicitation field ${name} must be a list`);
-      const allowed = new Set(extractMultiSelectOptions(schema).map(option => option.value));
-      const arrayValue = value.map(String);
-      if (schema.minItems !== undefined && arrayValue.length < schema.minItems) {
-        throw new Error(`Elicitation field ${name} has fewer than ${schema.minItems} selections`);
-      }
-      if (schema.maxItems !== undefined && arrayValue.length > schema.maxItems) {
-        throw new Error(`Elicitation field ${name} has more than ${schema.maxItems} selections`);
-      }
-      if (arrayValue.some(item => !allowed.has(item))) {
-        throw new Error(`Elicitation field ${name} contains an invalid selection`);
-      }
-      output[name] = arrayValue;
-    }
-  }
-  const validation = new AjvJsonSchemaValidator()
-    .getValidator(params.requestedSchema as JsonSchemaType)(output);
-  if (!validation.valid) {
-    throw new Error(`Invalid elicitation response: ${validation.errorMessage}`);
-  }
-  return output;
-}
-
-function formatChoice(value: string, title?: string): string {
-  return title && title !== value ? `${title} (${value})` : value;
-}
-
-function uniqueLabels(labels: string[]): string[] {
-  const used = new Set<string>();
-  return labels.map(label => {
-    let unique = label;
-    while (used.has(unique)) unique += "…";
-    used.add(unique);
-    return unique;
-  });
-}
-
-function uniqueAction(label: string, choices: string[]): string {
-  let unique = label;
-  while (choices.includes(unique)) unique += "…";
-  return unique;
-}
-
-function extractMultiSelectOptions(schema: Extract<FormProperty, { type: "array" }>): Array<{ value: string; display: string }> {
-  const items = schema.items as { enum?: string[]; anyOf?: Array<{ const: string; title: string }> };
-  return items.anyOf
-    ? items.anyOf.map(option => ({ value: option.const, display: formatChoice(option.const, option.title) }))
-    : (items.enum ?? []).map(value => ({ value, display: value }));
-}
-
-function formatReview(
-  serverName: string,
-  properties: Array<[string, FormProperty]>,
-  content: Record<string, string | number | boolean | string[]>,
-): string {
-  const rows = properties.map(([name, schema]) =>
-    `${schema.title ?? humanizeName(name)}: ${content[name] === undefined ? "(omitted)" : String(content[name])}`);
-  return [`Review input for ${serverName}`, "", ...rows].join("\n");
-}
-
-export async function handleUrlElicitation(
-  options: ElicitationHandlerOptions,
-  params: ElicitRequestURLParams,
-): Promise<ElicitResult> {
-  if (!options.allowUrl) throw new ProtocolError(ProtocolErrorCode.InvalidParams, "URL elicitation is not supported");
-
-  let parsed: URL;
-  try {
-    parsed = new URL(params.url);
-  } catch {
-    throw new ProtocolError(ProtocolErrorCode.InvalidParams, "URL elicitation supplied an invalid URL");
-  }
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw new ProtocolError(ProtocolErrorCode.InvalidParams, "URL elicitation only supports HTTP and HTTPS URLs");
-  }
-
-  const decision = await options.ui.select([
-    "MCP Browser Request",
-    `Server: ${options.serverName}`,
-    "",
-    params.message,
-    "",
-    `Host: ${parsed.host}`,
-    `Full URL: ${params.url}`,
-    "",
-    "Open this URL in your browser?",
-  ].join("\n"), ["Open", "Decline"]);
-  if (decision === undefined) return { action: "cancel" };
-  if (decision === "Decline") return { action: "decline" };
-
-  try {
-    await open(params.url);
-  } catch (error) {
-    options.ui.notify(`Could not open MCP elicitation URL: ${error instanceof Error ? error.message : String(error)}`, "error");
-    return { action: "cancel" };
-  }
-  options.onUrlAccepted?.(params.elicitationId);
-  options.ui.notify("Opened browser for MCP elicitation.", "info");
-  return { action: "accept" };
-}
-
-function humanizeName(name: string): string {
-  return name.replace(/[_-]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/^./, char => char.toUpperCase());
-}

package/error-signal.ts

@@ -1,21 +0,0 @@
-/**
- * Decide the `isError` override for a finished tool result in the `tool_result` hook.
- *
- * A failed MCP tool call is *returned* (not thrown), tagged `details.error: "tool_error"` (the server
- * returned an error result) or `"call_failed"` (the call itself threw and was caught). pi never reads a
- * result-level `isError`, so without this such a call is recorded as a success. Returning
- * `{ isError: true }` (and nothing else) flips the flag; pi's field-by-field merge keeps the original
- * `content` and `details` intact.
- *
- * Limited to those two codes: the adapter's other `details.error` values (`auth_required`, connection
- * states, search/validation feedback, ...) are not failed tool calls, so they get no override.
- */
-export function toolErrorOverride(details: unknown): { isError: true } | undefined {
-  if (details && typeof details === "object" && "error" in details) {
-    const code = (details as { error?: unknown }).error;
-    if (code === "tool_error" || code === "call_failed") {
-      return { isError: true };
-    }
-  }
-  return undefined;
-}

package/gateway-arguments.ts

@@ -1,73 +0,0 @@
-import { Type } from "typebox";
-import { MAX_PAGE_SIZE, MAX_TOOL_NAME_LENGTH } from "./search-ranking.ts";
-
-const actions = ["status", "search", "list", "describe", "call", "connect", "instructions", "resources", "read-resource", "read-result", "auth-start", "auth-complete", "ui-messages"] as const;
-export type GatewayArguments = {
-  action: typeof actions[number];
-  server?: string;
-  tool?: string;
-  args?: Record<string, unknown>;
-  query?: string;
-  includeSchemas?: boolean;
-  limit?: number;
-  offset?: number;
-  uri?: string;
-  ref?: string;
-  path?: string;
-  fields?: string[];
-};
-
-const requirements: Partial<Record<GatewayArguments["action"], string[]>> = {
-  search: ["query"], list: ["server"], describe: ["tool"], call: ["tool"],
-  connect: ["server"], instructions: ["server"], resources: ["server"],
-  "read-resource": ["server", "uri"], "read-result": ["ref"], "auth-start": ["server"], "auth-complete": ["server"],
-};
-
-export const gatewayParameters = Type.Object({
-  action: Type.Unsafe<GatewayArguments["action"]>({ type: "string", enum: [...actions] }),
-  server: Type.Optional(Type.String({ description: "MCP server; required for server and resource actions." })),
-  tool: Type.Optional(Type.String({ maxLength: MAX_TOOL_NAME_LENGTH, description: "Exact tool name for call or describe. Use server to disambiguate." })),
-  args: Type.Optional(Type.Object({}, { additionalProperties: true, description: "Tool arguments, or {redirectUrl} for auth-complete." })),
-  query: Type.Optional(Type.String({ description: "Search terms. Prefer mcp_search to discover and load tools." })),
-  includeSchemas: Type.Optional(Type.Boolean({ description: "Include complete schemas in search results (default true)." })),
-  limit: Type.Optional(Type.Integer({ minimum: 1, description: "Page size (default 12, max 100); for read-result, characters of selected JSON." })),
-  offset: Type.Optional(Type.Integer({ minimum: 0, description: "Zero-based item offset; for read-result, character offset in selected JSON." })),
-  uri: Type.Optional(Type.String({ description: "Exact MCP resource URI for read-resource." })),
-  ref: Type.Optional(Type.String({ description: "Saved result reference returned by an earlier MCP call; read-result never calls the server again." })),
-  path: Type.Optional(Type.String({ description: "JSON Pointer into a saved result, e.g. /structuredContent/rows." })),
-  fields: Type.Optional(Type.Array(Type.String(), { description: "Immediate object fields to retain when reading a saved result." })),
-}, {
-  additionalProperties: false,
-  allOf: [
-    ...Object.entries(requirements).map(([action, required]) => ({ if: { properties: { action: { const: action } } }, then: { required } })),
-    { if: { properties: { action: { enum: ["search", "list", "connect", "resources"] } } }, then: { properties: { limit: { maximum: MAX_PAGE_SIZE } } } },
-  ],
-});
-
-/** Migrate stored v5 calls before host validation; the advertised schema stays explicit. */
-export function prepareGatewayArguments(input: unknown): GatewayArguments {
-  if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error("MCP arguments must be an object");
-  const value = input as Record<string, unknown>;
-  let action = value.action;
-  const result = { ...value };
-  if (action === undefined) {
-    action = value.tool ? "call" : value.connect ? "connect" : value.describe ? "describe" : value.instructions ? "instructions" : value.search !== undefined ? "search" : value.server ? "list" : "status";
-    if (action === "connect") result.server = value.connect;
-    if (action === "describe") result.tool = value.describe;
-    if (action === "instructions") result.server = value.instructions;
-    if (action === "search") result.query = value.search;
-  }
-  for (const key of ["connect", "describe", "instructions", "search"]) delete result[key];
-  if (!actions.includes(action as GatewayArguments["action"])) throw new Error(`Unknown MCP action: ${String(action)}`);
-  result.action = action;
-  if (typeof result.args === "string") {
-    result.args = result.args === "" ? undefined : JSON.parse(result.args);
-  }
-  if (result.args !== undefined && (!result.args || typeof result.args !== "object" || Array.isArray(result.args))) {
-    throw new Error("Invalid args: expected a JSON object");
-  }
-  for (const field of requirements[action as GatewayArguments["action"]] ?? []) {
-    if (typeof result[field] !== "string" || (field !== "query" && result[field] === "")) throw new Error(`${action} requires ${field}`);
-  }
-  return result as GatewayArguments;
-}

package/glimpse-ui.ts

@@ -1,80 +0,0 @@
-import { existsSync } from "node:fs";
-import { execFileSync } from "node:child_process";
-import { join, dirname } from "node:path";
-import { platform } from "node:os";
-import { createRequire } from "node:module";
-
-let glimpseAvailable: boolean | null = null;
-let resolvedBinaryPath: string | null = null;
-
-export function isGlimpseAvailable(): boolean {
-  if (glimpseAvailable !== null) return glimpseAvailable;
-
-  if (platform() !== "darwin") {
-    glimpseAvailable = false;
-    return false;
-  }
-
-  resolvedBinaryPath = getGlimpseBinaryPath();
-  glimpseAvailable = resolvedBinaryPath !== null;
-  return glimpseAvailable;
-}
-
-function getGlimpseBinaryPath(): string | null {
-  if (process.env.GLIMPSE_BINARY && existsSync(process.env.GLIMPSE_BINARY)) {
-    return process.env.GLIMPSE_BINARY;
-  }
-
-  // Local node_modules
-  try {
-    const require = createRequire(import.meta.url);
-    const glimpseuiPath = require.resolve("glimpseui");
-    const binaryPath = join(dirname(glimpseuiPath), "glimpse");
-    if (existsSync(binaryPath)) return binaryPath;
-  } catch {}
-
-  // Global npm install
-  try {
-    const globalRoot = execFileSync("npm", ["root", "-g"], { encoding: "utf-8" }).trim();
-    const binaryPath = join(globalRoot, "glimpseui", "src", "glimpse");
-    if (existsSync(binaryPath)) return binaryPath;
-  } catch {}
-
-  return null;
-}
-
-export async function openGlimpseWindow(
-  html: string,
-  options: {
-    title: string;
-    width?: number;
-    height?: number;
-    onClosed: () => void;
-  },
-) {
-  const modulePath = resolvedBinaryPath
-    ? join(dirname(resolvedBinaryPath), "glimpse.mjs")
-    : "glimpseui";
-  const glimpse = await import(modulePath);
-
-  let active = true;
-  const win = glimpse.open(html, {
-    width: options.width ?? 900,
-    height: options.height ?? 700,
-    title: options.title,
-  });
-
-  win.on("closed", () => {
-    if (!active) return;
-    active = false;
-    options.onClosed();
-  });
-
-  return {
-    close: () => {
-      if (!active) return;
-      active = false;
-      win.close();
-    },
-  };
-}