@introspection-ai/recipes 0.13.0

package/dist/mcp-run-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-run-worker.js","sourceRoot":"","sources":["../src/mcp-run-worker.ts"],"names":[],"mappings":"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"}

package/dist/mcp.d.ts

@@ -0,0 +1,168 @@
+import { type RecipePackageManifest, type RecipeMcpToolSelection } from "./recipe-package.js";
+export interface McpToolCatalogEntry {
+    name: string;
+    description?: string;
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+export interface McpSessionServer {
+    id: string;
+    name: string;
+    base_url: string;
+    package_tools: RecipeMcpToolSelection;
+    agent_tools: RecipeMcpToolSelection[];
+    /** Optional package-pinned catalog. Dynamic bindings leave this absent. */
+    catalog?: McpToolCatalogEntry[];
+}
+export interface McpSessionConfig {
+    version: 1;
+    servers: McpSessionServer[];
+}
+export interface LocalMcpServer {
+    id?: string;
+    name?: string;
+    transport?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    auth?: string;
+    tokenCacheDir?: string;
+    clientName?: string;
+    oauthClientId?: string;
+    oauthClientSecretEnv?: string;
+    oauthTokenEndpointAuthMethod?: string;
+    oauthRedirectUrl?: string;
+    oauthScope?: string;
+    httpFetch?: "default" | "node-http1";
+}
+/**
+ * The `.pi/mcp.local.json` shape, usable inline by hosts that synthesize
+ * endpoint bindings instead of reading them from disk.
+ */
+export interface McpLocalConfig {
+    servers: LocalMcpServer[];
+}
+export interface McpConfigurationDiagnostic {
+    code: "mcp.tools_filtered";
+    serverId: string;
+    url: string;
+    stage: "filter";
+    message: string;
+}
+export interface MaterializeMcpSessionOptions {
+    cwd: string;
+    manifest: RecipePackageManifest;
+    /** MCP selections for the active agent and its visible subagents. */
+    agentMcp?: readonly ScopedMcpToolSelection[];
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Inline endpoint bindings. When provided, the local config file
+     * (`.pi/mcp.local.json`) is not consulted.
+     */
+    localConfig?: McpLocalConfig;
+}
+/**
+ * A `required: true` package MCP server has no endpoint binding. Thrown by
+ * `materializeMcpSession` before any server is materialized (fail-closed).
+ */
+export declare class McpBindingError extends Error {
+    /** Missing required server ids, in manifest order. */
+    readonly servers: readonly string[];
+    /** The `${VAR}` names a generated binding for those servers would use. */
+    readonly expectedEnvVars: readonly string[];
+    readonly name = "McpBindingError";
+    constructor(
+    /** Missing required server ids, in manifest order. */
+    servers: readonly string[], 
+    /** The `${VAR}` names a generated binding for those servers would use. */
+    expectedEnvVars: readonly string[]);
+}
+export interface MaterializedMcpSession extends McpSessionConfig {
+    diagnostics?: McpConfigurationDiagnostic[];
+}
+export interface McpEnvironmentSnapshot {
+    pathKey: string;
+    values: Record<string, string | undefined>;
+}
+/** Capture every environment entry Recipes may mutate while materializing MCP. */
+export declare function snapshotMcpEnvironment(env: NodeJS.ProcessEnv): McpEnvironmentSnapshot;
+/** Restore a previously captured MCP environment exactly. */
+export declare function restoreMcpEnvironment(env: NodeJS.ProcessEnv, snapshot: McpEnvironmentSnapshot): void;
+/**
+ * Hide host-owned runtime state before materializing a leased session. The
+ * local binding selector remains visible by design; session files, daemon
+ * coordinates, and generated CLI state do not.
+ */
+export declare function isolateMcpEnvironment(env: NodeJS.ProcessEnv): void;
+export declare function defaultMcpSessionPath(cwd: string): string;
+export declare function fallbackMcpSessionPath(): string;
+export declare function defaultMcporterConfigPath(cwd: string): string;
+export declare function fallbackMcporterConfigPath(): string;
+export declare function defaultMcpLocalConfigPath(cwd: string): string;
+export declare function resolveMcpLocalConfigPath(opts: {
+    cwd: string;
+    recipeDir: string;
+    env?: NodeJS.ProcessEnv;
+}): string | undefined;
+export declare function configureMcpLocalConfigPath(opts: {
+    cwd: string;
+    recipeDir: string;
+    env?: NodeJS.ProcessEnv;
+}): string | undefined;
+export declare function defaultMcpBinDir(cwd: string): string;
+export declare function mcporterCliEntrypointPath(): string;
+export declare function mcpCliEntrypointPath(): string;
+export declare function mcpClientEntrypointPath(): string;
+export declare function nativeMcpClientPath(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): string | undefined;
+export declare function materializeSessionMcpCli(opts: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    binDir: string;
+    shimPath: string;
+}>;
+export declare function normalizeMcpServerId(value: string): string;
+export interface ScopedMcpToolSelection {
+    serverId: string;
+    tools: RecipeMcpToolSelection;
+}
+export declare function resolveAgentMcpSelections(mcp: Readonly<Record<string, RecipeMcpToolSelection>> | undefined): ScopedMcpToolSelection[];
+export declare function executableRecipeToolNames(tools: readonly string[]): string[];
+export declare function formatMcpConfigurationDiagnostics(diagnostics: readonly McpConfigurationDiagnostic[], limit?: number): string;
+export declare function mcpSelectionAllowsTool(selection: RecipeMcpToolSelection, toolName: string): boolean;
+export declare function mcpSessionAllowsTool(server: Pick<McpSessionServer, "package_tools" | "agent_tools">, toolName: string): boolean;
+export declare function filterMcpCatalog(server: Pick<McpSessionServer, "package_tools" | "agent_tools">, catalog: readonly McpToolCatalogEntry[]): McpToolCatalogEntry[];
+export interface McporterServerConfig {
+    baseUrl: string;
+    headers: Record<string, string>;
+    allowedTools?: string[];
+    auth?: "oauth";
+    tokenCacheDir?: string;
+    clientName?: string;
+    oauthClientId?: string;
+    oauthClientSecretEnv?: string;
+    oauthTokenEndpointAuthMethod?: string;
+    oauthRedirectUrl?: string;
+    oauthScope?: string;
+    httpFetch?: "default" | "node-http1";
+}
+export interface McporterConfig {
+    imports: string[];
+    mcpServers: Record<string, McporterServerConfig>;
+}
+/**
+ * Project the static session policy into the config the `mcp` CLI (mcporter)
+ * reads. Header values stay `${VAR}` references — mcporter interpolates them
+ * at config load — so neither session tokens nor local dev secrets are
+ * persisted. `allowedTools` re-applies the recipe/agent tool filter inside
+ * mcporter, and `imports: []` keeps mcporter from discovering host-level
+ * configs (Cursor/Claude/VS Code) in a recipe session.
+ */
+export declare function buildMcporterConfig(session: McpSessionConfig, opts?: {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+}): McporterConfig;
+export declare function clearMcpSession(env: NodeJS.ProcessEnv, cwd: string): Promise<void>;
+export declare function materializeMcpSession(opts: MaterializeMcpSessionOptions): Promise<MaterializedMcpSession>;
+export declare function stopMcpDaemon(env: NodeJS.ProcessEnv): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}