@voiden/runner 2.2.0 → 2.3.0-beta.10

package/dist/mcpToolCapability.d.ts

@@ -0,0 +1,158 @@
+/**
+ * MCP tool capability registry — the /tool-block equivalent of
+ * requestContainerRegistry.ts's "core owns an empty registry + accessor;
+ * a plugin populates it via context.registerXxx() in its own runner.ts
+ * onload(); core never hardcodes knowledge of a block's shape."
+ *
+ * Everything that actually INTERPRETS the tool/toolparams/toolverifies
+ * block's own semantics — what "unbound param" means, that role:
+ * 'auth-check' gates other rows, that mode: 'none' skips a row, what
+ * onFailure: 'advertise-degraded' does to a description — lives in
+ * voiden-mcp-tool's own runner bundle, not here. This file only holds:
+ *
+ *   1. The stable *protocol* types (ToolState/ToolStatus/ServeDecision/etc.)
+ *      — these describe a generic verified/unverified/failing, served/
+ *      excluded shape, not the /tool block's own attrs, so they're
+ *      legitimately core's public @voiden/runner contract.
+ *   2. A single optional provider slot (there's only ever one plugin that
+ *      owns the /tool capability, unlike registerToolProvider's providers[]
+ *      array, where multiple protocol plugins each contribute request-
+ *      container extraction).
+ *   3. Thin dispatchers with the same names/signatures the old
+ *      toolVerification.ts/toolStatusBlock.ts/mcpServing.ts exported
+ *      directly — so @voiden/mcp (and anything else importing
+ *      discoverTools/verifyTools/etc. from @voiden/runner) needs zero
+ *      changes. They gracefully no-op when no provider is registered
+ *      (e.g. voiden-mcp-tool disabled), matching how toolRegistry.ts's
+ *      own extractTools() already returns [] with no providers.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolDef } from './toolRegistry.js';
+export type ToolState = 'verified' | 'unverified' | 'failing';
+export interface ToolVerifyResult {
+    entry: any;
+    passed: boolean;
+    reason?: 'auth-failure' | 'contract-failure';
+    runResult?: any;
+}
+export interface ToolStatus {
+    tool: ToolDef;
+    state: ToolState;
+    results: ToolVerifyResult[];
+    note?: string;
+}
+export interface DiscoverToolsOptions {
+    activePlugins?: string[];
+}
+export interface ToolValidationIssue {
+    tool: ToolDef;
+    check: 'unbound-param' | 'unresolved-placeholder' | 'missing-section' | 'duplicate-name' | 'readonly-mutating';
+    message: string;
+}
+export interface VerifyToolsOptions {
+    /** Only run verify entries whose `cadence` matches exactly. Omit to run every entry regardless of cadence. */
+    cadence?: string;
+    env?: Record<string, string>;
+    runtimeVars?: Record<string, any>;
+    activePlugins?: string[];
+    /** When provided, each tool's own source: environment params (with their
+     *  own envProfile/envName) are resolved per-tool and merged over `env`
+     *  before its verification requests run — so verification sees the same
+     *  values a real call would. Omit to skip this and use `env` as-is. */
+    projectRoot?: string;
+}
+export interface ToolStatusRecord {
+    state: ToolState;
+    lastCheckedAt: string;
+    note?: string;
+}
+/** One verify entry's last-known result, cached across scheduler ticks so
+ *  each entry can be re-verified on its own declared `cadence` instead of
+ *  the whole server sharing one fixed interval. Keyed by
+ *  `${tool.toolBlockUid}::${entryIndex}` — stable across re-discovery as
+ *  long as verify rows aren't reordered/added/removed; if they are, a
+ *  cache miss just means that one entry is treated as never-verified
+ *  (immediately due), which is the correct, safe fallback either way. */
+export interface VerifyEntryCacheRecord {
+    passed: boolean;
+    reason?: 'auth-failure' | 'contract-failure';
+    runResult?: any;
+    verifiedAt: number;
+}
+export type VerifyEntryCache = Map<string, VerifyEntryCacheRecord>;
+export interface PlanServedToolsOptions {
+    /** Reused across calls (the caller owns and persists it — typically the
+     *  scheduler in @voiden/mcp) so each verify entry is only actually
+     *  re-run when its own cadence says it's due; entries not yet due reuse
+     *  their cached result instead of a fresh network call. Omit for a
+     *  fully-fresh run with no caching (e.g. `--check`, or a one-shot
+     *  discoverDecisions call with no scheduler behind it). */
+    entryCache?: VerifyEntryCache;
+    /** Epoch ms "now" — defaults to Date.now() if omitted. Threaded through
+     *  explicitly (rather than each cache check calling Date.now() itself)
+     *  so every entry in the same planServedTools() call is judged against
+     *  the exact same instant. */
+    now?: number;
+}
+export interface ServeDecision {
+    tool: ToolDef;
+    served: boolean;
+    /** Set only for tools voiden-mcp-blocks-spec.md §1.6 structurally excludes — never reached verification at all. */
+    excluded?: boolean;
+    excludedReasons?: string[];
+    /** Set only for tools that reached verification. */
+    status?: ToolStatus;
+    /** Prefixed onto the description when unverified/degraded, so the agent reads it. */
+    descriptionNote?: string;
+}
+/**
+ * Everything voiden-runner core needs from the plugin that owns the /tool
+ * block. voiden-mcp-tool constructs one of these in its own runner.ts
+ * onload() and hands it to context.registerMcpToolCapabilityProvider().
+ */
+export interface McpToolCapabilityProvider {
+    discoverTools(projectRoot: string, opts: {
+        activePlugins: string[];
+    }): Promise<ToolDef[]>;
+    validateTools(projectRoot: string, tools: ToolDef[]): Promise<{
+        validTools: ToolDef[];
+        issues: ToolValidationIssue[];
+    }>;
+    verifyTools(tools: ToolDef[], opts: VerifyToolsOptions & {
+        activePlugins: string[];
+        entryCache?: VerifyEntryCache;
+        now?: number;
+    }): Promise<ToolStatus[]>;
+    planServedTools(projectRoot: string, env: Record<string, string>, activePlugins: string[], opts?: PlanServedToolsOptions): Promise<ServeDecision[]>;
+    registerServedTools(server: McpServer, decisions: ServeDecision[], baseEnv: Record<string, string>, runtimeVars: Record<string, any>, activePlugins: string[], commitSha: string | undefined, projectRoot: string): void;
+    upsertToolStatus(filePath: string, toolBlockUid: string, status: {
+        state: ToolState;
+        note?: string;
+    }): void;
+    /** Best-effort — never throws. Not every project is a git repo. */
+    getCommitSha(projectRoot: string): string | undefined;
+}
+export declare function registerMcpToolCapabilityProvider(p: McpToolCapabilityProvider): void;
+export declare function clearMcpToolCapabilityProvider(): void;
+export declare function getMcpToolCapabilityProvider(): McpToolCapabilityProvider | undefined;
+export declare function discoverTools(projectRoot: string, opts?: DiscoverToolsOptions): Promise<ToolDef[]>;
+export declare function validateTools(projectRoot: string, tools: ToolDef[]): Promise<{
+    validTools: ToolDef[];
+    issues: ToolValidationIssue[];
+}>;
+export declare function verifyTools(tools: ToolDef[], opts?: VerifyToolsOptions & {
+    entryCache?: VerifyEntryCache;
+    now?: number;
+}): Promise<ToolStatus[]>;
+export declare function planServedTools(projectRoot: string, env: Record<string, string>, activePlugins: string[], opts?: PlanServedToolsOptions): Promise<ServeDecision[]>;
+export declare function registerToolsFromDecisions(server: McpServer, decisions: ServeDecision[], baseEnv: Record<string, string>, runtimeVars: Record<string, any>, activePlugins: string[], commitSha: string | undefined, projectRoot: string): void;
+/** Computes decisions once, then registers them. Used by the stdio path,
+ *  where one McpServer instance lives for the whole process. */
+export declare function registerDynamicTools(server: McpServer, projectRoot: string, baseEnv: Record<string, string>, runtimeVars: Record<string, any>, activePlugins: string[]): Promise<ServeDecision[]>;
+export declare function upsertToolStatus(filePath: string, toolBlockUid: string, status: {
+    state: ToolState;
+    note?: string;
+}): void;
+/** Best-effort — returns undefined (never throws) when no provider is registered. */
+export declare function getCommitSha(projectRoot: string): string | undefined;
+//# sourceMappingURL=mcpToolCapability.d.ts.map

package/dist/mcpToolCapability.d.ts.map

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

package/dist/mcpToolCapability.js

@@ -0,0 +1,87 @@
+/**
+ * MCP tool capability registry — the /tool-block equivalent of
+ * requestContainerRegistry.ts's "core owns an empty registry + accessor;
+ * a plugin populates it via context.registerXxx() in its own runner.ts
+ * onload(); core never hardcodes knowledge of a block's shape."
+ *
+ * Everything that actually INTERPRETS the tool/toolparams/toolverifies
+ * block's own semantics — what "unbound param" means, that role:
+ * 'auth-check' gates other rows, that mode: 'none' skips a row, what
+ * onFailure: 'advertise-degraded' does to a description — lives in
+ * voiden-mcp-tool's own runner bundle, not here. This file only holds:
+ *
+ *   1. The stable *protocol* types (ToolState/ToolStatus/ServeDecision/etc.)
+ *      — these describe a generic verified/unverified/failing, served/
+ *      excluded shape, not the /tool block's own attrs, so they're
+ *      legitimately core's public @voiden/runner contract.
+ *   2. A single optional provider slot (there's only ever one plugin that
+ *      owns the /tool capability, unlike registerToolProvider's providers[]
+ *      array, where multiple protocol plugins each contribute request-
+ *      container extraction).
+ *   3. Thin dispatchers with the same names/signatures the old
+ *      toolVerification.ts/toolStatusBlock.ts/mcpServing.ts exported
+ *      directly — so @voiden/mcp (and anything else importing
+ *      discoverTools/verifyTools/etc. from @voiden/runner) needs zero
+ *      changes. They gracefully no-op when no provider is registered
+ *      (e.g. voiden-mcp-tool disabled), matching how toolRegistry.ts's
+ *      own extractTools() already returns [] with no providers.
+ */
+let provider;
+export function registerMcpToolCapabilityProvider(p) {
+    provider = p;
+}
+export function clearMcpToolCapabilityProvider() {
+    provider = undefined;
+}
+export function getMcpToolCapabilityProvider() {
+    return provider;
+}
+// ─── Thin dispatchers — same names/signatures the old core implementation
+// exported directly, so every existing caller (index.ts, @voiden/mcp)
+// needs zero changes at the call site. ───────────────────────────────────
+export async function discoverTools(projectRoot, opts = {}) {
+    if (!provider)
+        return [];
+    return provider.discoverTools(projectRoot, { activePlugins: opts.activePlugins ?? [] });
+}
+export async function validateTools(projectRoot, tools) {
+    // No capability plugin registered → nothing to validate against; treat
+    // every discovered tool as valid rather than silently excluding all of
+    // them (discoverTools() already returns [] in that case anyway, but this
+    // keeps validateTools() correct if ever called with a tool list from
+    // elsewhere).
+    if (!provider)
+        return { validTools: tools, issues: [] };
+    return provider.validateTools(projectRoot, tools);
+}
+export async function verifyTools(tools, opts = {}) {
+    if (!provider)
+        return [];
+    return provider.verifyTools(tools, { ...opts, activePlugins: opts.activePlugins ?? [] });
+}
+export async function planServedTools(projectRoot, env, activePlugins, opts) {
+    if (!provider)
+        return [];
+    return provider.planServedTools(projectRoot, env, activePlugins, opts);
+}
+export function registerToolsFromDecisions(server, decisions, baseEnv, runtimeVars, activePlugins, commitSha, projectRoot) {
+    provider?.registerServedTools(server, decisions, baseEnv, runtimeVars, activePlugins, commitSha, projectRoot);
+}
+/** Computes decisions once, then registers them. Used by the stdio path,
+ *  where one McpServer instance lives for the whole process. */
+export async function registerDynamicTools(server, projectRoot, baseEnv, runtimeVars, activePlugins) {
+    const decisions = await planServedTools(projectRoot, baseEnv, activePlugins);
+    registerToolsFromDecisions(server, decisions, baseEnv, runtimeVars, activePlugins, getCommitSha(projectRoot), projectRoot);
+    return decisions;
+}
+export function upsertToolStatus(filePath, toolBlockUid, status) {
+    if (!provider) {
+        throw new Error('No /tool-block capability plugin is registered — is voiden-mcp-tool enabled?');
+    }
+    provider.upsertToolStatus(filePath, toolBlockUid, status);
+}
+/** Best-effort — returns undefined (never throws) when no provider is registered. */
+export function getCommitSha(projectRoot) {
+    return provider?.getCommitSha(projectRoot);
+}
+//# sourceMappingURL=mcpToolCapability.js.map

package/dist/mcpToolCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolCapability.js","sourceRoot":"","sources":["../src/mcpToolCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAoHH,IAAI,QAA+C,CAAA;AAEnD,MAAM,UAAU,iCAAiC,CAAC,CAA4B;IAC5E,QAAQ,GAAG,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,QAAQ,GAAG,SAAS,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAE3E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,OAA6B,EAAE;IACtF,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxB,OAAO,QAAQ,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC,CAAA;AACzF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,KAAgB;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,cAAc;IACd,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACvD,OAAO,QAAQ,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB,EAAE,OAA6E,EAAE;IACjI,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxB,OAAO,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,GAA2B,EAAE,aAAuB,EAAE,IAA6B;IAC5I,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxB,OAAO,QAAQ,CAAC,eAAe,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,SAA0B,EAC1B,OAA+B,EAC/B,WAAgC,EAChC,aAAuB,EACvB,SAA6B,EAC7B,WAAmB;IAEnB,QAAQ,EAAE,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;AAC/G,CAAC;AAED;gEACgE;AAChE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAiB,EACjB,WAAmB,EACnB,OAA+B,EAC/B,WAAgC,EAChC,aAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IAC5E,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAA;IAC1H,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,YAAoB,EAAE,MAA2C;IAClH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;IACjG,CAAC;IACD,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;AAC5C,CAAC"}

package/dist/plugins/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqCH;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA8B/I;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIzD;AAuDD,wBAAsB,kBAAkB,CACtC,OAAO,UAAQ,EACf,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC,CAqEnB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwCH;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA8B/I;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIzD;AAuDD,wBAAsB,kBAAkB,CACtC,OAAO,UAAQ,EACf,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC,CAwEnB"}

package/dist/plugins/loader.js

@@ -18,6 +18,9 @@ import { getCorePlugins, hasCoreRunner, getCoreRunnerImportUrl, getCoreRunnerPat
 import { fetchCommunityPlugins, findCommunityPlugin, hasCommunityRunner, getCommunityRunnerImportUrl, } from './community.js';
 import { createHeadlessPluginContext } from '../headlessContext.js';
 import { clearSchemas } from '../blockSchemaRegistry.js';
+import { clearRequestContainers } from '../requestContainerRegistry.js';
+import { clearToolProviders } from '../toolRegistry.js';
+import { clearMcpToolCapabilityProvider } from '../mcpToolCapability.js';
 import { readStore, setPluginVersion } from './store.js';
 import * as https from 'https';
 import { mkdirSync, createWriteStream } from 'fs';
@@ -140,6 +143,9 @@ export async function loadEnabledPlugins(verbose = false, skipPlugins = new Set(
     requestOrchestrator.clear();
     hookRegistry.clearAll();
     clearSchemas();
+    clearRequestContainers();
+    clearToolProviders();
+    clearMcpToolCapabilityProvider();
     const loaded = [];
     // ── Core plugins ──────────────────────────────────────────────────────────
     // Core plugins default to enabled but can be disabled via ~/.voiden/plugins.json.

package/dist/plugins/loader.js.map

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

package/dist/requestContainerRegistry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Request Container Registry — lets each protocol plugin (REST, GraphQL,
+ * sockets/gRPC, or any third-party protocol plugin) declare its own "this
+ * block is the request" shape, instead of voiden-runner's core hardcoding
+ * knowledge of every plugin's block types.
+ *
+ * Mirrors blockSchemaRegistry.ts exactly: plugins call
+ * context.registerRequestContainer() in their runner.ts onload(), and the
+ * registry is cleared/rebuilt fresh on every loadEnabledPlugins() call (same
+ * as block schemas — a disabled plugin's registration shouldn't linger).
+ *
+ * Used by list_requests (preview) and write_result (finding which block to
+ * attach a response to) so both work across whatever protocol plugins happen
+ * to be installed, not just the ones bundled with voiden-runner by default.
+ */
+export interface RequestContainerDef {
+    /** Block type string, e.g. 'gqlquery'. Matches the YAML `type:` field. */
+    type: string;
+    /** Child block type holding the request URL as its (string) content. */
+    urlType: string;
+    /** Child block type holding the method/protocol tag as its (string) content, if any. */
+    methodType?: string;
+    /** Fixed method when the protocol has no explicit method child (e.g. GraphQL is always POST). */
+    defaultMethod?: string;
+}
+export declare function registerRequestContainer(def: RequestContainerDef): void;
+export declare function clearRequestContainers(): void;
+export declare function getRequestContainerDef(type: string): RequestContainerDef | undefined;
+/**
+ * Finds the block that represents "the request" in a section, across
+ * whichever protocol plugins are currently registered.
+ */
+export declare function findRequestBlock(blocks: any[]): any | undefined;
+/** Returns all registered container type names — useful for debugging. */
+export declare function getRegisteredContainerTypes(): string[];
+//# sourceMappingURL=requestContainerRegistry.d.ts.map

package/dist/requestContainerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContainerRegistry.d.ts","sourceRoot":"","sources":["../src/requestContainerRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAA;IACf,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAID,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,SAAS,CAM/D;AAED,0EAA0E;AAC1E,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD"}

package/dist/requestContainerRegistry.js

@@ -0,0 +1,42 @@
+/**
+ * Request Container Registry — lets each protocol plugin (REST, GraphQL,
+ * sockets/gRPC, or any third-party protocol plugin) declare its own "this
+ * block is the request" shape, instead of voiden-runner's core hardcoding
+ * knowledge of every plugin's block types.
+ *
+ * Mirrors blockSchemaRegistry.ts exactly: plugins call
+ * context.registerRequestContainer() in their runner.ts onload(), and the
+ * registry is cleared/rebuilt fresh on every loadEnabledPlugins() call (same
+ * as block schemas — a disabled plugin's registration shouldn't linger).
+ *
+ * Used by list_requests (preview) and write_result (finding which block to
+ * attach a response to) so both work across whatever protocol plugins happen
+ * to be installed, not just the ones bundled with voiden-runner by default.
+ */
+const containers = new Map();
+export function registerRequestContainer(def) {
+    containers.set(def.type, def);
+}
+export function clearRequestContainers() {
+    containers.clear();
+}
+export function getRequestContainerDef(type) {
+    return containers.get(type);
+}
+/**
+ * Finds the block that represents "the request" in a section, across
+ * whichever protocol plugins are currently registered.
+ */
+export function findRequestBlock(blocks) {
+    for (const type of containers.keys()) {
+        const req = blocks.find((b) => b.type === type);
+        if (req)
+            return req;
+    }
+    return undefined;
+}
+/** Returns all registered container type names — useful for debugging. */
+export function getRegisteredContainerTypes() {
+    return Array.from(containers.keys());
+}
+//# sourceMappingURL=requestContainerRegistry.js.map

package/dist/requestContainerRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContainerRegistry.js","sourceRoot":"","sources":["../src/requestContainerRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAA;AAEzD,MAAM,UAAU,wBAAwB,CAAC,GAAwB;IAC/D,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,UAAU,CAAC,KAAK,EAAE,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAa;IAC5C,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QACpD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;IACrB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;AACtC,CAAC"}

package/dist/resultBlock.d.ts

@@ -25,7 +25,13 @@ export declare function buildResponseBlockText(result: RunResult, requestUid: st
  *   section (i.e. before the next request-separator, or EOF), it's replaced.
  * - Otherwise the new block is inserted immediately after the request block.
  *
- * Throws if no `request` block with a matching `uid` exists in the file.
+ * Matches purely by `uid`, not block `type` — deliberately protocol-agnostic:
+ * REST's request-container block is typed `request`, GraphQL's is `gqlquery`,
+ * WebSocket/gRPC's is `socket-request`, and other plugins may use their own
+ * type name entirely. uids are unique per block regardless of type, so there's
+ * no need to hardcode (and keep updating) a list of "known request types".
+ *
+ * Throws if no block with a matching `uid` exists in the file.
  */
 export declare function upsertResponseBlock(filePath: string, requestUid: string, result: RunResult): void;
 //# sourceMappingURL=resultBlock.d.ts.map

package/dist/resultBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resultBlock.d.ts","sourceRoot":"","sources":["../src/resultBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAkD3C,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA2BpF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BjG"}
+{"version":3,"file":"resultBlock.d.ts","sourceRoot":"","sources":["../src/resultBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAwD3C,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA2BpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCjG"}

package/dist/resultBlock.js

@@ -20,6 +20,11 @@ import { readFileSync, writeFileSync } from 'fs';
 import { randomUUID } from 'crypto';
 import YAML from 'yaml';
 const MAX_BODY_CHARS = 20_000;
+// Plain markdown heading placed right before the fenced `response` block —
+// makes the record visible/readable even without the voiden-rest-api plugin's
+// dedicated renderer (e.g. in a raw markdown viewer, or before that plugin
+// picks up this change).
+const RESPONSE_HEADING = '## Response recorded';
 // Same fence shape as parser.ts's regex, but tracking raw text offsets too
 // (parser.ts only returns parsed Block[], with no position info) since we
 // need to splice the source text rather than just read it.
@@ -97,14 +102,20 @@ export function buildResponseBlockText(result, requestUid) {
  *   section (i.e. before the next request-separator, or EOF), it's replaced.
  * - Otherwise the new block is inserted immediately after the request block.
  *
- * Throws if no `request` block with a matching `uid` exists in the file.
+ * Matches purely by `uid`, not block `type` — deliberately protocol-agnostic:
+ * REST's request-container block is typed `request`, GraphQL's is `gqlquery`,
+ * WebSocket/gRPC's is `socket-request`, and other plugins may use their own
+ * type name entirely. uids are unique per block regardless of type, so there's
+ * no need to hardcode (and keep updating) a list of "known request types".
+ *
+ * Throws if no block with a matching `uid` exists in the file.
  */
 export function upsertResponseBlock(filePath, requestUid, result) {
     const content = readFileSync(filePath, 'utf-8');
     const fences = scanFences(content);
-    const requestFence = fences.find(f => f.type === 'request' && f.uid === requestUid);
+    const requestFence = fences.find(f => f.uid === requestUid);
     if (!requestFence) {
-        throw new Error(`No request block with uid "${requestUid}" found in ${filePath}`);
+        throw new Error(`No block with uid "${requestUid}" found in ${filePath}`);
     }
     const nextSeparator = fences.find(f => f.type === 'request-separator' && f.start > requestFence.end);
     const sectionEnd = nextSeparator ? nextSeparator.start : content.length;
@@ -113,9 +124,20 @@ export function upsertResponseBlock(filePath, requestUid, result) {
         && f.start > requestFence.end
         && f.start < sectionEnd);
     const blockText = buildResponseBlockText(result, requestUid);
-    const newContent = existingResponse
-        ? content.slice(0, existingResponse.start) + blockText + content.slice(existingResponse.end)
-        : content.slice(0, requestFence.end) + '\n\n' + blockText + content.slice(requestFence.end);
+    const blockWithHeading = RESPONSE_HEADING + '\n\n' + blockText;
+    let newContent;
+    if (existingResponse) {
+        // Replace the heading together with the block if we recognise one directly
+        // preceding it (written by a prior run) — otherwise leave whatever precedes
+        // it untouched and just add a heading now.
+        const before = content.slice(0, existingResponse.start);
+        const headingMatch = before.match(/## Response recorded\s*$/);
+        const replaceStart = headingMatch ? existingResponse.start - headingMatch[0].length : existingResponse.start;
+        newContent = content.slice(0, replaceStart) + blockWithHeading + content.slice(existingResponse.end);
+    }
+    else {
+        newContent = content.slice(0, requestFence.end) + '\n\n' + blockWithHeading + content.slice(requestFence.end);
+    }
     writeFileSync(filePath, newContent, 'utf-8');
 }
 //# sourceMappingURL=resultBlock.js.map

package/dist/resultBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"resultBlock.js","sourceRoot":"","sources":["../src/resultBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,MAAM,cAAc,GAAG,MAAM,CAAA;AAE7B,2EAA2E;AAC3E,0EAA0E;AAC1E,2DAA2D;AAC3D,MAAM,QAAQ,GAAG,4BAA4B,CAAA;AAY7C,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,OAAO,GAAiB,EAAE,CAAA;IAChC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IACtD,IAAI,CAAyB,CAAA;IAC7B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;QACrB,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,IAAwB,CAAA;QAC5B,IAAI,GAAuB,CAAA;QAC3B,IAAI,UAA8B,CAAA;QAClC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YACzC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;oBAC/D,IAAI,GAAG,MAAM,EAAE,IAAI,CAAA;oBACnB,GAAG,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,CAAA;oBACxB,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,UAAU,CAAA;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACP,wEAAwE;oBACxE,uDAAuD;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,UAAkB;IAC1E,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACtB,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QAC7D,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;QACpC,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,MAAM,KAAK,GAAwB;QACjC,GAAG,EAAE,UAAU,EAAE;QACjB,UAAU;QACV,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC7D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;IACzE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;IACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACvD,IAAI,MAAM,CAAC,cAAc;QAAE,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAA;IACvE,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;IAC9D,IAAI,MAAM,CAAC,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAA;IAC1E,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IACzC,IAAI,SAAS;QAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IACrC,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5D,OAAO,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB,EAAE,MAAiB;IACzF,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAI,UAAU,CAAC,OAAO,CAAC,CAAA;IAEnC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC,CAAA;IACnF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,cAAc,QAAQ,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,CAAC,KAAK,GAAG,YAAY,CAAC,GAAG,CAClE,CAAA;IACD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAEvE,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU;WACrB,CAAC,CAAC,UAAU,KAAK,UAAU;WAC3B,CAAC,CAAC,KAAK,GAAG,YAAY,CAAC,GAAG;WAC1B,CAAC,CAAC,KAAK,GAAG,UAAU,CAC1B,CAAA;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAE5D,MAAM,UAAU,GAAG,gBAAgB;QACjC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAC5F,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAE7F,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;AAC9C,CAAC"}
+{"version":3,"file":"resultBlock.js","sourceRoot":"","sources":["../src/resultBlock.ts"],"names":[],"mappings":"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"}

package/dist/runner.d.ts

@@ -25,6 +25,15 @@ export interface RawRequestInfo {
 /** Public alias — lets callers (e.g. the MCP server's list_requests tool) preview
  *  a section's method/url without executing anything. */
 export declare function getRequestPreview(blocks: any[]): RawRequestInfo;
+/**
+ * Finds the block that represents "the request" in a section, whichever
+ * protocol it belongs to. Backed by requestContainerRegistry.ts, populated
+ * by each protocol plugin's own context.registerRequestContainer() call —
+ * exported so callers that only need the block's `uid` (e.g. the MCP
+ * server's list_requests tool) share this same registry instead of
+ * hardcoding their own list of protocol block types.
+ */
+export declare function findRequestBlock(blocks: any[]): any | undefined;
 export interface RunOptions {
     env?: Record<string, string>;
     verbose?: boolean;

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA0D3C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAM,MAAM,CAAA;IACf,MAAM,EAAG,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAI,MAAM,CAAA;CAChB;AAED;yDACyD;AACzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,cAAc,CAE/D;AA+FD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,CAAC,EAAM,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,gHAAgH;IAChH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAQ,aAAa,EAAE,CAAA;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CA8IxB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA0D3C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAM,MAAM,CAAA;IACf,MAAM,EAAG,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAI,MAAM,CAAA;CAChB;AAED;yDACyD;AACzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,cAAc,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,SAAS,CAE/D;AAoGD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,CAAC,EAAM,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,gHAAgH;IAChH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAQ,aAAa,EAAE,CAAA;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAmJxB"}

package/dist/runner.js

@@ -16,12 +16,12 @@
  *   3. Map PipelineResponse → RunResult
  */
 import { readFileSync } from 'fs';
-import { parseVoidFileSections } from './parser.js';
-import { requestOrchestrator, classifyBlockVersion } from '@voiden/executors';
+import { requestOrchestrator, classifyBlockVersion, parseVoidFileSections } from '@voiden/executors';
 import { createCliElectron } from './cliElectron.js';
 import { loadEnabledPlugins } from './plugins/loader.js';
 import { getInstalledPluginInfo } from './plugins/versionInfo.js';
 import { normalizeBlocks } from './blockSchemaRegistry.js';
+import { findRequestBlock as findRegisteredRequestBlock, getRequestContainerDef } from './requestContainerRegistry.js';
 import { extractRuntimeVarRows, captureRuntimeVars } from './runtimeVars.js';
 // ─── Declared plugin+version check (tagged blocks only — legacy files with no
 // pluginId attr are skipped entirely, unchanged behaviour) ────────────────────
@@ -63,16 +63,32 @@ function formatVersionError(blockType, pluginId, pluginVersion, status, installe
 export function getRequestPreview(blocks) {
     return extractRawRequest(blocks);
 }
+/**
+ * Finds the block that represents "the request" in a section, whichever
+ * protocol it belongs to. Backed by requestContainerRegistry.ts, populated
+ * by each protocol plugin's own context.registerRequestContainer() call —
+ * exported so callers that only need the block's `uid` (e.g. the MCP
+ * server's list_requests tool) share this same registry instead of
+ * hardcoding their own list of protocol block types.
+ */
+export function findRequestBlock(blocks) {
+    return findRegisteredRequestBlock(blocks);
+}
 function extractRawRequest(blocks) {
-    const req = blocks.find((b) => b.type === 'request');
     let url = '';
     let method = 'GET';
-    if (req && Array.isArray(req.content)) {
-        for (const node of req.content) {
-            if (node.type === 'method' && typeof node.content === 'string')
-                method = node.content.trim();
-            if (node.type === 'url' && typeof node.content === 'string')
-                url = node.content.trim();
+    const req = findRequestBlock(blocks);
+    if (req) {
+        const cfg = getRequestContainerDef(req.type);
+        if (cfg && Array.isArray(req.content)) {
+            for (const node of req.content) {
+                if (cfg.methodType && node.type === cfg.methodType && typeof node.content === 'string')
+                    method = node.content.trim();
+                if (node.type === cfg.urlType && typeof node.content === 'string')
+                    url = node.content.trim();
+            }
+            if (cfg.defaultMethod)
+                method = cfg.defaultMethod;
         }
     }
     const headers = {};
@@ -150,10 +166,15 @@ export async function runVoidFile(filePath, options = {}) {
     const activePlugins = options.activePlugins ?? await loadEnabledPlugins(verbose, skipPlugins);
     const content = readFileSync(filePath, 'utf-8');
     const allSections = parseVoidFileSections(content);
-    const sections = options.sectionLabel
+    // A file with no request-separators has no real "sections" to disambiguate
+    // between — it's just one request. Only apply the label filter when
+    // there's more than one section to choose from; a single-section file
+    // always means "run the one request present", regardless of what
+    // sectionLabel was asked for (including none, or a stale/mismatched one).
+    const sections = (options.sectionLabel && allSections.length > 1)
         ? allSections.filter(s => s.label === options.sectionLabel)
         : allSections;
-    if (options.sectionLabel && sections.length === 0 && allSections.length > 0) {
+    if (options.sectionLabel && allSections.length > 1 && sections.length === 0) {
         return {
             results: [{
                     result: {