@introspection-ai/recipes 0.25.1 → 0.27.1

package/dist/mcp-chunks/{chunk-V5AYEKSL.js → chunk-6QZQZXDJ.js}

@@ -1,19 +1,12 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
-  isUnauthorizedError
-} from "./chunk-IRTJXFWA.js";
-import {
-  ProtocolErrorCode
-} from "./chunk-PZ323CXI.js";
-import {
-  DAEMON_OAUTH_FLOW_ERROR_CODE,
-  DAEMON_OPERATION_TIMEOUT_CODE
-} from "./chunk-3Z7MFS6K.js";
+  MCPORTER_VERSION
+} from "./chunk-7PFJCLXL.js";
 import {
   isKeepAliveServer
-} from "./chunk-JG4TRUPF.js";
+} from "./chunk-QJNF3A3F.js";
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/daemon/runtime-wrapper.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/daemon/runtime-wrapper.js
 function createKeepAliveRuntime(base, options) {
   if (!options.daemonClient || options.keepAliveServers.size === 0) {
     return base;
@@ -24,11 +17,18 @@ var KeepAliveRuntime = class {
   base;
   daemon;
   keepAliveServers;
-  restartPromises = /* @__PURE__ */ new Map();
   constructor(base, daemon, keepAliveServers) {
     this.base = base;
     this.daemon = daemon;
     this.keepAliveServers = keepAliveServers;
+    const info = base.getClientInfo?.();
+    if (info)
+      this.daemon.setDefinitions(base.getDefinitions(), info);
+    else
+      this.daemon.setDefinitions(base.getDefinitions());
+  }
+  getClientInfo() {
+    return this.base.getClientInfo?.() ?? { name: "mcporter", version: MCPORTER_VERSION };
   }
   listServers() {
     return this.base.listServers();
@@ -41,6 +41,7 @@ var KeepAliveRuntime = class {
   }
   registerDefinition(definition, options) {
     this.base.registerDefinition(definition, options);
+    this.daemon.setDefinitions(this.base.getDefinitions(), this.base.getClientInfo?.());
     if (isKeepAliveServer(definition)) {
       this.keepAliveServers.add(definition.name);
     } else {
@@ -50,12 +51,33 @@ var KeepAliveRuntime = class {
   async getInstructions(server) {
     return this.base.getInstructions?.(server);
   }
-  async listTools(server, options) {
-    if (options?.oauthSessionOptions) {
-      return this.base.listTools(server, options);
+  async getServerMetadata(server, options) {
+    if (this.shouldUseDaemon(server)) {
+      this.assertBrokerOptions(options);
+      return this.daemon.getServerMetadata({
+        server,
+        autoAuthorize: options?.autoAuthorize,
+        allowCachedAuth: options?.allowCachedAuth,
+        disableOAuth: options?.disableOAuth,
+        timeoutMs: options?.timeoutMs
+      });
     }
+    if (this.base.getServerMetadata)
+      return this.base.getServerMetadata(server, options);
+    const { client } = await this.base.connect(server, {
+      ...options,
+      disableOAuth: options?.autoAuthorize === false ? true : options?.disableOAuth
+    });
+    return { instructions: client.getInstructions(), serverInfo: client.getServerVersion() };
+  }
+  assertBrokerOptions(options) {
+    if (options?.oauthSessionOptions)
+      throw new Error("Interactive OAuth sessions require explicit authentication outside the keep-alive runtime.");
+  }
+  async listTools(server, options) {
     if (this.shouldUseDaemon(server)) {
-      return await this.invokeWithRestart(server, "listTools", () => this.daemon.listTools({
+      this.assertBrokerOptions(options);
+      return await this.invokeOnce(server, "listTools", () => this.daemon.listTools({
         server,
         includeSchema: options?.includeSchema,
         autoAuthorize: options?.autoAuthorize,
@@ -68,7 +90,7 @@ var KeepAliveRuntime = class {
   }
   async callTool(server, toolName, options) {
     if (this.shouldUseDaemon(server)) {
-      return this.invokeWithRestart(server, "callTool", () => this.daemon.callTool({
+      return this.invokeOnce(server, "callTool", () => this.daemon.callTool({
         server,
         tool: toolName,
         args: options?.args,
@@ -79,21 +101,17 @@ var KeepAliveRuntime = class {
     return this.base.callTool(server, toolName, options);
   }
   async listResources(server, options) {
-    if (options?.oauthSessionOptions) {
-      return this.base.listResources(server, options);
-    }
     const { allowCachedAuth, disableOAuth, ...params } = options ?? {};
     if (this.shouldUseDaemon(server)) {
-      return this.invokeWithRestart(server, "listResources", () => this.daemon.listResources({ server, params, allowCachedAuth, disableOAuth }));
+      this.assertBrokerOptions(options);
+      return this.invokeOnce(server, "listResources", () => this.daemon.listResources({ server, params, allowCachedAuth, disableOAuth }));
     }
     return this.base.listResources(server, options);
   }
   async readResource(server, uri, options) {
-    if (options?.oauthSessionOptions) {
-      return this.base.readResource(server, uri, options);
-    }
     if (this.shouldUseDaemon(server)) {
-      return this.invokeWithRestart(server, "readResource", () => this.daemon.readResource({
+      this.assertBrokerOptions(options);
+      return this.invokeOnce(server, "readResource", () => this.daemon.readResource({
         server,
         uri,
         allowCachedAuth: options?.allowCachedAuth,
@@ -103,11 +121,17 @@ var KeepAliveRuntime = class {
     return this.base.readResource(server, uri, options);
   }
   async connect(server, options) {
+    if (this.shouldUseDaemon(server))
+      throw new Error("Raw connections are unavailable for broker-owned servers; use runtime operations or getServerMetadata.");
     return this.base.connect(server, options);
   }
   async close(server) {
     if (!server) {
-      await this.base.close();
+      try {
+        await this.daemon.release();
+      } finally {
+        await this.base.close();
+      }
       return;
     }
     if (this.shouldUseDaemon(server)) {
@@ -120,63 +144,10 @@ var KeepAliveRuntime = class {
   shouldUseDaemon(server) {
     return this.keepAliveServers.has(server);
   }
-  async invokeWithRestart(server, operation, action) {
-    try {
-      return await action();
-    } catch (error) {
-      if (!shouldRestartDaemonServer(error)) {
-        throw error;
-      }
-      logDaemonRetry(server, operation, error);
-      await this.restartServer(server);
-      return action();
-    }
-  }
-  async restartServer(server) {
-    const existing = this.restartPromises.get(server);
-    if (existing) {
-      await existing;
-      return;
-    }
-    const restart = this.daemon.closeServer({ server }).catch(() => {
-    });
-    this.restartPromises.set(server, restart);
-    try {
-      await restart;
-    } finally {
-      this.restartPromises.delete(server);
-    }
+  async invokeOnce(_server, _operation, action) {
+    return action();
   }
 };
-var NON_FATAL_CODES = /* @__PURE__ */ new Set([ProtocolErrorCode.InvalidRequest, ProtocolErrorCode.MethodNotFound, ProtocolErrorCode.InvalidParams]);
-function shouldRestartDaemonServer(error) {
-  if (!error) {
-    return false;
-  }
-  if (typeof error === "object") {
-    const code2 = error.code;
-    if (code2 === DAEMON_OPERATION_TIMEOUT_CODE || code2 === DAEMON_OAUTH_FLOW_ERROR_CODE) {
-      return false;
-    }
-  }
-  if (isUnauthorizedError(error)) {
-    return false;
-  }
-  const code = protocolErrorCode(error);
-  if (code !== void 0) {
-    return !NON_FATAL_CODES.has(code);
-  }
-  return true;
-}
-function protocolErrorCode(error) {
-  if (!error || typeof error !== "object" || !("code" in error))
-    return void 0;
-  return typeof error.code === "number" ? error.code : void 0;
-}
-function logDaemonRetry(server, operation, error) {
-  const reason = error instanceof Error ? error.message : String(error);
-  console.error(`[mcporter] Restarting '${server}' before retrying ${operation}: ${reason}`);
-}
 
 export {
   createKeepAliveRuntime

package/dist/mcp-chunks/{chunk-3R2WK3NB.js → chunk-6RG6AD5X.js}

@@ -1,20 +1,20 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   __configInternals
-} from "./chunk-RD7NHCRK.js";
+} from "./chunk-RZIJUJGL.js";
 import {
   withFileLock,
   writeTextFileAtomic
-} from "./chunk-ITR7FQM3.js";
+} from "./chunk-H7ARMBV7.js";
 import {
   expandHome
-} from "./chunk-WTMJMM3B.js";
+} from "./chunk-D6SVCPN6.js";
 import {
   canonicalKeepAliveName,
   resolveLifecycle
-} from "./chunk-JG4TRUPF.js";
+} from "./chunk-QJNF3A3F.js";
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/ascii-slug.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/ascii-slug.js
 function toAsciiSlug(value) {
   let slug = "";
   let pendingSeparator = false;
@@ -35,7 +35,7 @@ function toAsciiSlug(value) {
   return slug;
 }
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/adhoc-server.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/adhoc-server.js
 import fs from "node:fs/promises";
 import path from "node:path";
 var TEMP_SOURCE = { kind: "local", path: "<adhoc>" };

package/dist/mcp-chunks/{chunk-SNKXMWDB.js → chunk-77BZYP72.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/json-output.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/json-output.js
 function buildConnectionIssueEnvelope(params) {
   return {
     server: params.server,

package/dist/mcp-chunks/chunk-7PFJCLXL.js

@@ -0,0 +1,123 @@
+import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/package.json
+var package_default = {
+  name: "mcporter",
+  version: "0.13.13",
+  description: "TypeScript runtime and CLI for connecting to configured Model Context Protocol servers.",
+  keywords: [
+    "cli",
+    "mcp",
+    "model-context-protocol"
+  ],
+  license: "MIT",
+  author: "OpenClaw",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/openclaw/mcporter.git"
+  },
+  bin: {
+    mcporter: "dist/cli.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  type: "module",
+  main: "dist/index.js",
+  module: "dist/index.js",
+  types: "dist/index.d.ts",
+  exports: {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts"
+    },
+    "./cli": {
+      import: "./dist/cli.js",
+      types: "./dist/cli.d.ts"
+    }
+  },
+  publishConfig: {
+    access: "public"
+  },
+  dependencies: {
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    acorn: "^8.18.0",
+    commander: "^15.0.0",
+    "es-toolkit": "^1.52.0",
+    "jsonc-parser": "^3.3.1",
+    ora: "^9.4.1",
+    rolldown: "1.2.8",
+    zod: "^4.6.2"
+  },
+  devDependencies: {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@types/estree": "^1.0.9",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.5.1",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@vitest/coverage-v8": "^5.0.0",
+    "bun-types": "^1.4.2",
+    "cross-env": "^10.1.0",
+    express: "^5.2.1",
+    oxfmt: "^0.67.0",
+    oxlint: "^1.82.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    rimraf: "^6.1.3",
+    tsx: "^4.23.13",
+    typescript: "npm:@typescript/typescript6@^6.0.2",
+    vite: "8.3.0",
+    vitest: "^5.0.0"
+  },
+  devEngines: {
+    runtime: [
+      {
+        name: "node",
+        version: ">=24"
+      }
+    ]
+  },
+  engines: {
+    node: ">=24"
+  },
+  scripts: {
+    mcporter: "tsx src/cli.ts",
+    mcp: "pnpm exec tsx src/cli.ts",
+    build: `tsc -p tsconfig.build.json && node -e "require('fs').chmodSync('dist/cli.js', 0o755)"`,
+    "build:bun": "bun scripts/build-bun.ts",
+    check: "pnpm format:check && pnpm lint:oxlint && pnpm typecheck",
+    format: "oxfmt .",
+    "format:check": "oxfmt --check .",
+    lint: "pnpm check",
+    "lint:oxlint": "oxlint --type-aware --tsconfig tsconfig.json --report-unused-disable-directives --deny-warnings --max-warnings=0 --allow eslint/no-underscore-dangle",
+    typecheck: "tsc --project tsconfig.json --noEmit",
+    test: "cross-env MCPORTER_TEST_REPORTER=quiet pnpm test:verbose",
+    "test:quiet": "cross-env MCPORTER_TEST_REPORTER=quiet pnpm test:verbose",
+    "test:verbose": "pnpm build && node scripts/test-runner.js",
+    "test:live": "MCP_LIVE_TESTS=1 vitest run tests/live",
+    "test:coverage": "pnpm build && cross-env MCPORTER_TEST_REPORTER=quiet vitest run --coverage",
+    clean: "rimraf dist",
+    dev: "tsc -w -p tsconfig.build.json",
+    "docs:list": "pnpm exec tsx scripts/docs-list.ts",
+    "docs:site": "node scripts/build-docs-site.mjs",
+    "generate:schema": "tsx scripts/generate-json-schema.ts",
+    "mcporter:list": "pnpm exec tsx src/cli.ts list",
+    "mcporter:call": "pnpm exec tsx src/cli.ts call",
+    "check:changed": "pnpm run check",
+    "test:changed": "pnpm run test",
+    "crabbox:hydrate": "crabbox actions hydrate",
+    "crabbox:run": "crabbox run",
+    "crabbox:stop": "crabbox stop",
+    "crabbox:warmup": "crabbox warmup"
+  }
+};
+
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/version.js
+var MCPORTER_VERSION = package_default.version;
+
+export {
+  MCPORTER_VERSION
+};

package/dist/mcp-chunks/chunk-7WL4TMON.js

@@ -0,0 +1,31 @@
+import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+import {
+  createKeepAliveRuntime
+} from "./chunk-6QZQZXDJ.js";
+import {
+  DaemonClient
+} from "./chunk-FBVRU4Y3.js";
+import {
+  isKeepAliveServer
+} from "./chunk-QJNF3A3F.js";
+
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/generated-daemon-runtime.js
+async function createGeneratedKeepAliveRuntime(base, server) {
+  if (!isKeepAliveServer(server)) {
+    return {
+      runtime: base,
+      close: async (target) => {
+        await base.close(target);
+      }
+    };
+  }
+  const runtime = createKeepAliveRuntime(base, {
+    daemonClient: new DaemonClient({ configPath: "", configExplicit: false }),
+    keepAliveServers: /* @__PURE__ */ new Set([server.name])
+  });
+  return { runtime, close: () => runtime.close() };
+}
+
+export {
+  createGeneratedKeepAliveRuntime
+};

package/dist/mcp-chunks/{chunk-ELA77TDC.js → chunk-C2VLY7ED.js}

@@ -1,9 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   pickSharedDefinitionFields
-} from "./chunk-IYWYVHHD.js";
+} from "./chunk-WHJUDBPR.js";
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli-metadata.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli-metadata.js
 import { spawn } from "node:child_process";
 import fs from "node:fs/promises";
 function metadataPathForArtifact(artifactPath) {
@@ -92,7 +92,7 @@ function serializeDefinition(definition) {
   };
 }
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/generate/tool-selection.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/generate/tool-selection.js
 function validateToolSelection(includeTools, excludeTools, context) {
   if (includeTools && excludeTools) {
     throw new Error(context.mutuallyExclusiveMessage);
@@ -105,7 +105,7 @@ function validateToolSelection(includeTools, excludeTools, context) {
   }
 }
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/generate/template-data.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/generate/template-data.js
 function buildGenerateCliCommand(invocation, definition, globalFlags = {}) {
   const tokens = ["mcporter"];
   const configPath = invocation.configPath ?? globalFlags["--config"];

package/dist/mcp-chunks/{chunk-FAJPJTOC.js → chunk-CLR6DJV3.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/cli/record-replay-env.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/record-replay-env.js
 var KEEP_ALIVE_DISABLED_FOR_MODE = "*";
 function buildRecordCommandEnv(sessionName, server) {
   return buildModeEnv({

package/dist/mcp-chunks/{chunk-ZOAQDFAO.js → chunk-D6B2M5V7.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/runtime/elicitation.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/runtime/elicitation.js
 import readline from "node:readline";
 var NON_INTERACTIVE_ELICITATION_HINT = "Server requested interactive input; run mcporter in a terminal.";
 function createInteractiveElicitationResponder(options = {}) {

package/dist/mcp-chunks/{chunk-WTMJMM3B.js → chunk-D6SVCPN6.js}

@@ -1,17 +1,16 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.13.8/node_modules/mcporter/dist/env.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/env.js
 import os from "node:os";
 import path from "node:path";
 var ENV_DEFAULT_PATTERN = /^\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-|:|-)?([^}]*)\}$/;
 var ENV_INTERPOLATION_PATTERN = /\\?\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-(.*?))?\}/g;
 var UNSUPPORTED_BRACED_ENV_PATTERN = /\$\{env:[^}]*\}/;
 var ENV_DIRECT_PREFIX = "$env:";
-function expandHome(input) {
+function expandHome(input, home = os.homedir()) {
   if (!input.startsWith("~")) {
     return input;
   }
-  const home = os.homedir();
   if (input === "~") {
     return home;
   }
@@ -81,35 +80,9 @@ function rejectUnsupportedBracedEnvPlaceholder(value) {
   }
   throw new Error(`Unsupported environment placeholder '${unsupported}'. Use '\${VAR}', '\${VAR:-fallback}', or whole-value '$env:VAR'.`);
 }
-async function withEnvOverrides(envOverrides, fn) {
-  if (!envOverrides || Object.keys(envOverrides).length === 0) {
-    return await fn();
-  }
-  const applied = [];
-  for (const [key, rawValue] of Object.entries(envOverrides)) {
-    rejectUnsupportedBracedEnvPlaceholder(rawValue);
-    if (process.env[key]) {
-      continue;
-    }
-    const resolved = resolveEnvValue(rawValue);
-    if (resolved === "") {
-      continue;
-    }
-    process.env[key] = resolved;
-    applied.push(key);
-  }
-  try {
-    return await fn();
-  } finally {
-    for (const key of applied) {
-      delete process.env[key];
-    }
-  }
-}
 
 export {
   expandHome,
   resolveEnvValue,
-  resolveEnvPlaceholders,
-  withEnvOverrides
+  resolveEnvPlaceholders
 };