@introspection-ai/recipes 0.25.1 → 0.27.1

package/dist/mcp-chunks/{chunk-ED2WN5BI.js → chunk-34QXE62Y.js}

@@ -2,10 +2,10 @@ import { createRequire as __createRequire } from "node:module"; const require =
 import {
   createCallResult,
   describeConnectionIssue
-} from "./chunk-4ZNBWL65.js";
+} from "./chunk-S2YF442K.js";
 import {
   createRuntime
-} from "./chunk-GQ6NSIDS.js";
+} from "./chunk-PJCMJ65D.js";
 
 // node_modules/.pnpm/@opentelemetry+api@1.9.1/node_modules/@opentelemetry/api/build/esm/context/context.js
 function createContextKey(description) {
@@ -808,7 +808,7 @@ var TraceAPI = class _TraceAPI {
 // node_modules/.pnpm/@opentelemetry+api@1.9.1/node_modules/@opentelemetry/api/build/esm/trace-api.js
 var trace = TraceAPI.getInstance();
 
-// src/mcp-command-context.ts
+// src/mcp/cli/command-context.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 var storage = new AsyncLocalStorage();
 function currentMcpCommandContext() {
@@ -834,7 +834,7 @@ function installMcpCommandIoRouting() {
   };
 }
 
-// src/mcp-daemon-protocol.ts
+// src/mcp/daemon/protocol.ts
 var MCP_DAEMON_SOCKET_ENV = "PI_RECIPES_MCP_DAEMON_SOCKET";
 var MCP_DAEMON_TOKEN_ENV = "PI_RECIPES_MCP_DAEMON_TOKEN";
 var MCP_DAEMON_FINGERPRINT_ENV = "PI_RECIPES_MCP_DAEMON_FINGERPRINT";
@@ -867,7 +867,7 @@ function serializeMcpDaemonEnvelope(envelope, maxBytes = MCP_DAEMON_MAX_FRAME_BY
 `;
 }
 
-// src/mcp-trace-context.ts
+// src/mcp/trace-context.ts
 var TRACEPARENT = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;
 function mcpDaemonRequestContext(carrier, base = ROOT_CONTEXT) {
   const match = carrier?.traceparent.match(TRACEPARENT);
@@ -885,17 +885,17 @@ function mcpDaemonRequestContext(carrier, base = ROOT_CONTEXT) {
   });
 }
 
-// src/mcp-cli-core.ts
+// src/mcp/cli/core.ts
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import { mkdir, open, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { dirname as dirname2, join as join2 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
 import { stdin as input, stderr, stdout } from "node:process";
-import { inspect } from "node:util";
+import { inspect, parseArgs } from "node:util";
 import { isMainThread, Worker } from "node:worker_threads";
 
-// src/mcp-contract.ts
+// src/mcp/contract.ts
 var MAX_EXAMPLE_ARRAY_ITEMS = 3;
 var SAFE_CLI_KEY = /^[A-Za-z_][A-Za-z0-9_.-]*$/;
 var SAFE_SHELL_TOKEN = /^[A-Za-z0-9_./:@+-]+$/;
@@ -1175,7 +1175,7 @@ function catalogOutputSchema(tool) {
   return tool?.output_schema;
 }
 
-// src/mcp-cli-help.ts
+// src/mcp/cli/help.ts
 function mcpCliHelpText() {
   return [
     "mcp - use available MCP tools",
@@ -1211,11 +1211,91 @@ function mcpCliHelpText() {
     "  MCP resources and administrative or ad-hoc connection commands are not exposed."
   ].join("\n");
 }
+function mcpListHelpText() {
+  return [
+    "Usage: mcp list [server | server.tool] [flags]",
+    "",
+    "Shows a compact view of tools materialized in this recipe session.",
+    "",
+    "Flags:",
+    "  --all-parameters          Include every optional parameter.",
+    "  --schema                  Show a compact input/output contract for one exact tool.",
+    "  --verbose                 Include full tool and parameter descriptions.",
+    "  --status                  Show concise status for an exact server target.",
+    "  --quiet, --exit-code      Health checks for an exact server target.",
+    "  --timeout <ms>            Override discovery timeout for an exact target.",
+    "  JSON is reserved for actual tool results; metadata is compact text.",
+    "",
+    "URLs, ad-hoc transports, config overrides, and persistence are unavailable in recipe sessions."
+  ].join("\n");
+}
+function mcpCallHelpText() {
+  return [
+    "Usage: mcp call <server>.<tool> [arguments] [flags]",
+    "",
+    "Calls exact tools materialized in this recipe session.",
+    "",
+    "Arguments:",
+    "  key=value                 Named arguments with schema-aware coercion.",
+    "  key=@path                 Read an exact UTF-8 string; use @@ for a literal @.",
+    "  --json <json|->           Supply a structured JSON object directly or from stdin.",
+    `  Array example: mcp call server.tool --json '{"tags":["a","b"]}'.`,
+    "  Quote argument tokens containing shell operators such as |, <, >, &, or ;. JSON stdin avoids nested shell quoting.",
+    "",
+    "Output/runtime flags:",
+    "  --output text|markdown|json|raw",
+    "  --timeout <ms>",
+    "  Machine-readable output is forwarded unchanged.",
+    "  When parsing JSON, keep stderr separate and do not truncate stdout with head or sed.",
+    "",
+    "URLs, ad-hoc transports, config overrides, and persistence are unavailable in recipe sessions."
+  ].join("\n");
+}
+function mcpSearchHelpText() {
+  return [
+    'Usage: mcp search "what you need" [--limit N] [--regex]',
+    "",
+    "Searches only MCP tools available in this session.",
+    "Results include the exact tool ref, description, and required fields.",
+    "Try broader or alternate terms when no result matches.",
+    "Use `mcp list <server>` only to identify exact tool names, then inspect one candidate with `mcp list <server.tool> --schema`."
+  ].join("\n");
+}
+function mcpRunHelpText() {
+  return [
+    "Usage: mcp run [--var KEY=value] [--json-errors] [file]",
+    "",
+    'Runs a short JavaScript workflow with available MCP tools such as `tools["server"]["tool"]`.',
+    "With no file, code is read from stdin. Keep heredocs quoted and pass dynamic values with --var.",
+    "Scripts are killed after 120s by default (override with PI_RECIPES_MCP_RUN_TIMEOUT_MS).",
+    "Each tool call is capped at 60s; workflows allow at most 100 calls and run 16 at a time by default.",
+    "Extra calls wait in a FIFO queue and inherit the remaining workflow deadline.",
+    "Always await or return tool-call chains.",
+    "Detached .then/.catch calls fail if still pending when the script exits.",
+    "Structured MCP errors retain code, retryable, action, request_id, and outcome fields when supplied.",
+    "Calls return decoded JSON by default, so read response fields directly from the awaited value.",
+    "Only when a tool documents another response type, call the format on the tool itself: tool.text(args), tool.markdown(args), tool.images(args), tool.content(args), tool.structuredContent(args), or tool.raw(args).",
+    "Use Promise.all for independent reads. Await dependent calls and mutations in order.",
+    "Do not loop over mcp call in the shell. Use mcp run for repeated calls and print only the fields needed.",
+    "Use --var/vars for dynamic input; process.argv is intentionally unavailable inside workflows.",
+    "--json-errors emits a structured error object on stderr while preserving the nonzero exit code.",
+    "MCP calls are always headless. If authentication is required, ask the user to authenticate the connection outside the agent session, then retry.",
+    "A synchronous busy-loop is force-killed at the deadline.",
+    "Code runs with the same OS privileges as the active shell sandbox; mcp run is not a separate security boundary.",
+    "",
+    "Example \u2014 batch or compose multiple calls:",
+    "  mcp run <<'JS'",
+    '  const ids = ["id-1", "id-2", "id-3"]',
+    '  const results = await Promise.all(ids.map(id => tools["server"]["tool"]({ id })))',
+    "  console.log(JSON.stringify(results.map(result => ({ id: result.id, name: result.name })), null, 2))",
+    "  JS"
+  ].join("\n");
+}
 
-// src/mcp.ts
+// src/mcp/index.ts
 import { delimiter, dirname, join, resolve } from "node:path";
 
-// src/recipe-package.ts
+// src/recipe/package.ts
 var RESOURCE_KEYS = [
   "agents",
   "extensions",
@@ -1229,7 +1309,7 @@ var PI_KEYS = /* @__PURE__ */ new Set([
   "runtime"
 ]);
 
-// src/mcp-policy.ts
+// src/mcp/policy.ts
 function mcpSelectionAllowsTool(selection, toolName) {
   const included = selection.include?.some((selector) => {
     const trimmed = selector.trim();
@@ -1241,10 +1321,10 @@ function mcpSelectionAllowsTool(selection, toolName) {
   );
 }
 
-// src/mcp-daemon-client.ts
+// src/mcp/daemon/client.ts
 var MAX_DAEMON_FRAME_BYTES = 10 * 1024 * 1024;
 
-// src/mcp.ts
+// src/mcp/index.ts
 var RECIPE_ENV_PREFIX = "PI_RECIPES_";
 var MCP_SESSION_ENV = `${RECIPE_ENV_PREFIX}MCP_SESSION`;
 var MCP_LOCAL_CONFIG_ENV = `${RECIPE_ENV_PREFIX}MCP_LOCAL_CONFIG`;
@@ -1286,7 +1366,7 @@ function filterMcpCatalog(server, catalog) {
   }));
 }
 
-// src/mcp-cli-policy.ts
+// src/mcp/cli/policy.ts
 var FORBIDDEN_DELEGATED_FLAGS = /* @__PURE__ */ new Set([
   "--config",
   "--root",
@@ -1494,7 +1574,7 @@ function validateDelegatedMcpCommand(args, policy) {
   };
 }
 
-// src/mcp-cli-core.ts
+// src/mcp/cli/core.ts
 var DEFAULT_RUN_TIMEOUT_MS = 12e4;
 var DEFAULT_TOOL_CALL_TIMEOUT_MS = 6e4;
 var DEFAULT_LIST_TIMEOUT_MS = 3e4;
@@ -1510,7 +1590,7 @@ function loadMcporterCli() {
   if (mcporterCliPromise) return mcporterCliPromise;
   const previousDisableAutorun = process.env.MCPORTER_DISABLE_AUTORUN;
   process.env.MCPORTER_DISABLE_AUTORUN = "1";
-  mcporterCliPromise = import("./cli-XU26MUCN.js").finally(() => {
+  mcporterCliPromise = import("./cli-JI7MEAAX.js").finally(() => {
     if (previousDisableAutorun === void 0) {
       delete process.env.MCPORTER_DISABLE_AUTORUN;
     } else {
@@ -1564,86 +1644,6 @@ var McpRunToolError = class extends Error {
   action;
   outcome;
 };
-function mcpListHelpText() {
-  return [
-    "Usage: mcp list [server | server.tool] [flags]",
-    "",
-    "Shows a compact view of tools materialized in this recipe session.",
-    "",
-    "Flags:",
-    "  --all-parameters          Include every optional parameter.",
-    "  --schema                  Show a compact input/output contract for one exact tool.",
-    "  --verbose                 Include full tool and parameter descriptions.",
-    "  --status                  Show concise status for an exact server target.",
-    "  --quiet, --exit-code      Health checks for an exact server target.",
-    "  --timeout <ms>            Override discovery timeout for an exact target.",
-    "  JSON is reserved for actual tool results; metadata is compact text.",
-    "",
-    "URLs, ad-hoc transports, config overrides, and persistence are unavailable in recipe sessions."
-  ].join("\n");
-}
-function mcpCallHelpText() {
-  return [
-    "Usage: mcp call <server>.<tool> [arguments] [flags]",
-    "",
-    "Calls exact tools materialized in this recipe session.",
-    "",
-    "Arguments:",
-    "  key=value                 Named arguments with schema-aware coercion.",
-    "  key=@path                 Read an exact UTF-8 string; use @@ for a literal @.",
-    "  --json <json|->           Supply a structured JSON object directly or from stdin.",
-    `  Array example: mcp call server.tool --json '{"tags":["a","b"]}'.`,
-    "  Quote argument tokens containing shell operators such as |, <, >, &, or ;. JSON stdin avoids nested shell quoting.",
-    "",
-    "Output/runtime flags:",
-    "  --output text|markdown|json|raw",
-    "  --timeout <ms>",
-    "  Machine-readable output is forwarded unchanged.",
-    "  When parsing JSON, keep stderr separate and do not truncate stdout with head or sed.",
-    "",
-    "URLs, ad-hoc transports, config overrides, and persistence are unavailable in recipe sessions."
-  ].join("\n");
-}
-function mcpSearchHelpText() {
-  return [
-    'Usage: mcp search "what you need" [--limit N] [--regex]',
-    "",
-    "Searches only MCP tools available in this session.",
-    "Results include the exact tool ref, description, and required fields.",
-    "Try broader or alternate terms when no result matches.",
-    "Use `mcp list <server>` only to identify exact tool names, then inspect one candidate with `mcp list <server.tool> --schema`."
-  ].join("\n");
-}
-function mcpRunHelpText() {
-  return [
-    "Usage: mcp run [--var KEY=value] [--json-errors] [file]",
-    "",
-    'Runs a short JavaScript workflow with available MCP tools such as `tools["server"]["tool"]`.',
-    "With no file, code is read from stdin. Keep heredocs quoted and pass dynamic values with --var.",
-    "Scripts are killed after 120s by default (override with PI_RECIPES_MCP_RUN_TIMEOUT_MS).",
-    "Each tool call is capped at 60s; workflows allow at most 100 calls and run 16 at a time by default.",
-    "Extra calls wait in a FIFO queue and inherit the remaining workflow deadline.",
-    "Always await or return tool-call chains.",
-    "Detached .then/.catch calls fail if still pending when the script exits.",
-    "Structured MCP errors retain code, retryable, action, request_id, and outcome fields when supplied.",
-    "Calls return decoded JSON by default, so read response fields directly from the awaited value.",
-    "Only when a tool documents another response type, call the format on the tool itself: tool.text(args), tool.markdown(args), tool.images(args), tool.content(args), tool.structuredContent(args), or tool.raw(args).",
-    "Use Promise.all for independent reads. Await dependent calls and mutations in order.",
-    "Do not loop over mcp call in the shell. Use mcp run for repeated calls and print only the fields needed.",
-    "Use --var/vars for dynamic input; process.argv is intentionally unavailable inside workflows.",
-    "--json-errors emits a structured error object on stderr while preserving the nonzero exit code.",
-    "MCP calls are always headless. If authentication is required, ask the user to authenticate the connection outside the agent session, then retry.",
-    "A synchronous busy-loop is force-killed at the deadline.",
-    "Code runs with the same OS privileges as the active shell sandbox; mcp run is not a separate security boundary.",
-    "",
-    "Example \u2014 batch or compose multiple calls:",
-    "  mcp run <<'JS'",
-    '  const ids = ["id-1", "id-2", "id-3"]',
-    '  const results = await Promise.all(ids.map(id => tools["server"]["tool"]({ id })))',
-    "  console.log(JSON.stringify(results.map(result => ({ id: result.id, name: result.name })), null, 2))",
-    "  JS"
-  ].join("\n");
-}
 function isHelpArg(value) {
   return value === "--help" || value === "-h" || value === "help";
 }
@@ -2038,30 +2038,43 @@ async function discoverMcpCatalogs(runtime, timeoutMs) {
     })
   );
 }
+var SEARCH_OPTIONS = {
+  limit: { type: "string" },
+  regex: { type: "boolean" }
+};
+function optionName(value) {
+  const equals = value.indexOf("=");
+  return equals === -1 ? value : value.slice(0, equals);
+}
 function parseSearchArgs(args) {
-  const queryParts = [];
+  if (args.some((arg) => optionName(arg) === "--json")) {
+    return { error: "mcp search metadata is compact text; JSON is reserved for tool results." };
+  }
+  let parsed;
+  try {
+    parsed = parseArgs({ args, options: SEARCH_OPTIONS, allowPositionals: true });
+  } catch (error) {
+    if (error.code === "ERR_PARSE_ARGS_INVALID_OPTION_VALUE") {
+      const index = args.findIndex((arg) => optionName(arg) === "--limit");
+      const flag = args[index] ?? "";
+      const raw = flag.includes("=") ? flag.slice(flag.indexOf("=") + 1) : args[index + 1] ?? "";
+      return { error: `--limit expects a positive integer, got '${raw}'.` };
+    }
+    const unknown = args.find(
+      (arg) => arg.startsWith("-") && !(optionName(arg).slice(2) in SEARCH_OPTIONS)
+    );
+    return { error: `Unknown mcp search option '${unknown}'.` };
+  }
+  const { values, positionals } = parsed;
   let limit = 8;
-  let regex = false;
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--json") return { error: "mcp search metadata is compact text; JSON is reserved for tool results." };
-    if (arg === "--regex") {
-      regex = true;
-      continue;
-    }
-    if (arg === "--limit" || arg.startsWith("--limit=")) {
-      const raw = arg === "--limit" ? args[++index] : arg.slice("--limit=".length);
-      const value = Number(raw);
-      if (!Number.isInteger(value) || value <= 0) {
-        return { error: `--limit expects a positive integer, got '${raw ?? ""}'.` };
-      }
-      limit = Math.floor(value);
-      continue;
+  if (values.limit !== void 0) {
+    const value = Number(values.limit);
+    if (!Number.isInteger(value) || value <= 0) {
+      return { error: `--limit expects a positive integer, got '${values.limit}'.` };
     }
-    if (arg.startsWith("-")) return { error: `Unknown mcp search option '${arg}'.` };
-    queryParts.push(arg);
+    limit = value;
   }
-  return { query: queryParts.join(" "), limit, regex };
+  return { query: positionals.join(" "), limit, regex: values.regex === true };
 }
 async function searchCatalog(args) {
   const parsed = parseSearchArgs(args);
@@ -2154,18 +2167,17 @@ function toolCount(count) {
 function parseListTimeoutMs(args) {
   const configured = process.env.MCPORTER_LIST_TIMEOUT;
   let raw = configured && /^[1-9]\d*$/.test(configured) ? configured : String(DEFAULT_LIST_TIMEOUT_MS);
-  for (let index = 1; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--timeout") {
-      const value = args[index + 1];
-      if (!value) return "mcp list: --timeout requires a value.";
-      raw = value;
-      break;
-    }
-    if (arg?.startsWith("--timeout=")) {
-      raw = arg.slice("--timeout=".length);
-      break;
+  const { values } = parseArgs({
+    args: [...args.slice(1)],
+    options: { timeout: { type: "string" } },
+    strict: false,
+    allowPositionals: true
+  });
+  if (values.timeout !== void 0) {
+    if (typeof values.timeout !== "string" || values.timeout === "") {
+      return "mcp list: --timeout requires a value.";
     }
+    raw = values.timeout;
   }
   if (!/^[1-9]\d*$/.test(raw)) {
     return "mcp list: --timeout must be a positive integer (milliseconds).";
@@ -2201,28 +2213,44 @@ function writeCompactListError(error) {
 `}`);
   filter.flush();
 }
+var LIST_OPTIONS = {
+  "all-parameters": { type: "boolean" },
+  "exit-code": { type: "boolean" },
+  "no-oauth": { type: "boolean" },
+  quiet: { type: "boolean" },
+  schema: { type: "boolean" },
+  status: { type: "boolean" },
+  timeout: { type: "string" },
+  verbose: { type: "boolean" }
+};
+var LIST_BOOLEAN_FLAGS = new Set(
+  Object.entries(LIST_OPTIONS).filter(([, spec]) => spec.type === "boolean").map(([name]) => name)
+);
+function isValidListOption(arg) {
+  const name = optionName(arg).slice(2);
+  if (!(name in LIST_OPTIONS)) return false;
+  return !(arg.includes("=") && LIST_BOOLEAN_FLAGS.has(name));
+}
 function compactListArgumentError(args) {
-  const flags = /* @__PURE__ */ new Set([
-    "--all-parameters",
-    "--schema",
-    "--verbose",
-    "--status",
-    "--quiet",
-    "--exit-code",
-    "--no-oauth"
-  ]);
-  const start = args[1] && !args[1].startsWith("-") ? 2 : 1;
-  for (let index = start; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--timeout") {
-      index += 1;
-      continue;
+  const rest = args.slice(1);
+  const target = rest[0] !== void 0 && !rest[0].startsWith("-");
+  const options = target ? rest.slice(1) : rest;
+  try {
+    const { positionals } = parseArgs({
+      args: [...options],
+      options: LIST_OPTIONS,
+      allowPositionals: true
+    });
+    if (positionals.length > 0) {
+      return `Unexpected mcp list argument '${positionals[0]}'.`;
     }
-    if (arg.startsWith("--timeout=")) continue;
-    if (flags.has(arg)) continue;
-    return arg.startsWith("-") ? `Unknown mcp list option '${arg}'.` : `Unexpected mcp list argument '${arg}'.`;
+    return void 0;
+  } catch {
+    const offending = options.find(
+      (arg) => arg.startsWith("-") && !isValidListOption(arg)
+    );
+    return offending ? `Unknown mcp list option '${offending}'.` : void 0;
   }
-  return void 0;
 }
 async function compactList(args) {
   if (args.includes("--json")) {

package/dist/mcp-chunks/{chunk-Y3EDWN2P.js → chunk-5B7GRMUK.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/output-format.js
+// node_modules/.pnpm/mcporter@0.13.13/node_modules/mcporter/dist/cli/output-format.js
 function consumeOutputFormat(args, options = {}) {
   const allowed = options.allowed ?? ["auto", "text", "markdown", "json", "raw"];
   const defaultFormat = options.defaultFormat ?? "auto";