@thupham/volley-mcp 1.0.1

package/dist/tools/importers.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { writeFileSync } from "node:fs";
+import { extname } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { loadOpenApi, openApiToCollection, loadHar, harToCollection } from "../importers.js";
+function serialize(col, path) {
+    if (extname(path) === ".json")
+        return JSON.stringify(col, null, 2);
+    return stringifyYaml(col);
+}
+export function registerImporterTools(server) {
+    server.registerTool("import_openapi", {
+        title: "Import OpenAPI to collection",
+        description: "Parse OpenAPI/Swagger (JSON/YAML) → Volley collection. One step per operation with 2xx assertion.",
+        inputSchema: {
+            path: z.string().describe("Path to the OpenAPI/Swagger file."),
+            out: z.string().optional().describe("Write the resulting collection to this path (.yaml/.yml/.json)."),
+            includeTags: z.array(z.string()).optional().describe("Only import operations with any of these tags."),
+            maxSteps: z.number().int().positive().optional().describe("Cap the number of generated steps (default 200)."),
+        },
+    }, async (args) => {
+        const doc = loadOpenApi(args.path);
+        const col = openApiToCollection(doc, { includeTags: args.includeTags, maxSteps: args.maxSteps });
+        if (args.out)
+            writeFileSync(args.out, serialize(col, args.out), "utf8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ imported: true, name: col.name, steps: col.steps?.length ?? 0, writtenTo: args.out ?? null }, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("import_har", {
+        title: "Import HAR to collection",
+        description: "Parse HAR file → Volley collection. Splits query/headers/body. Optional 2xx filter.",
+        inputSchema: {
+            path: z.string().describe("Path to the HAR file (.json)."),
+            out: z.string().optional().describe("Write the resulting collection to this path (.yaml/.yml/.json)."),
+            maxSteps: z.number().int().positive().optional().describe("Cap the number of generated steps (default 200)."),
+            only2xx: z.boolean().optional().describe("Only include requests that returned a 2xx response."),
+        },
+    }, async (args) => {
+        const har = loadHar(args.path);
+        const col = harToCollection(har, {
+            maxSteps: args.maxSteps,
+            filter: args.only2xx ? (e) => (e.response?.status ?? 0) >= 200 && (e.response?.status ?? 0) < 300 : undefined,
+        });
+        if (args.out)
+            writeFileSync(args.out, serialize(col, args.out), "utf8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ imported: true, name: col.name, steps: col.steps?.length ?? 0, writtenTo: args.out ?? null }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=importers.js.map

package/dist/tools/importers.js.map

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

package/dist/tools/inspect.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerInspectTool(server: McpServer, session: Session): void;

package/dist/tools/inspect.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { jsonQuery } from "../native.js";
+/** Truncate arrays to maxItems, adding a truncation marker. Strings are capped at maxStr chars. */
+function truncate(value, maxItems, maxStr) {
+    if (Array.isArray(value)) {
+        if (value.length <= maxItems)
+            return { value, truncated: false };
+        return {
+            value: [...value.slice(0, maxItems), `…(+${value.length - maxItems} more, use a narrower jsonpath)`],
+            truncated: true,
+        };
+    }
+    if (typeof value === "string" && value.length > maxStr) {
+        return { value: value.slice(0, maxStr) + `…(+${value.length - maxStr} chars)`, truncated: true };
+    }
+    if (value && typeof value === "object") {
+        const obj = value;
+        let anyTruncated = false;
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            const r = truncate(v, maxItems, maxStr);
+            if (r.truncated)
+                anyTruncated = true;
+            out[k] = r.value;
+        }
+        return { value: out, truncated: anyTruncated };
+    }
+    return { value, truncated: false };
+}
+export function registerInspectTool(server, session) {
+    server.registerTool("inspect_response", {
+        title: "Inspect a stored response",
+        description: "Drill into a stored response by handle without re-running the request. " +
+            "Use jsonpath to pull only the slice you need. Supports RFC 9535 filters " +
+            "($.items[?@.id==1]) and slices ($.items[0:5]). Use double quotes in filters.",
+        inputSchema: {
+            handle: z.string().describe("responseHandle from a prior tool call."),
+            jsonpath: z
+                .string()
+                .optional()
+                .describe("RFC 9535 JSONPath. Filters need double quotes: [?@.name==\"x\"]. Omit for full body."),
+            maxItems: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Cap array elements returned (default 50). Excess shown as truncation marker."),
+            maxStr: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Cap string length in chars (default 2000)."),
+        },
+    }, async ({ handle, jsonpath, maxItems, maxStr }) => {
+        const stored = session.getStored(handle);
+        if (!stored) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `unknown handle: ${handle}` }],
+            };
+        }
+        // For introspect results, prefer the enriched `schema` field over raw `bodyJson`
+        // so the agent can query $.queries, $.mutations, $.inputTypes directly.
+        const body = stored.schema ??
+            stored.bodyJson ??
+            stored.bodyText ??
+            stored.frames ??
+            stored.events ??
+            null;
+        if (jsonpath) {
+            const result = jsonQuery(body, jsonpath);
+            if (result.error) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `jsonpath error: ${result.error}` }],
+                };
+            }
+            if (!result.found) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ found: false, hint: "path matched nothing" }) }],
+                };
+            }
+            const cap = maxItems ?? 50;
+            const strCap = maxStr ?? 2000;
+            const { value, truncated } = truncate(result.value, cap, strCap);
+            const out = { found: true, value };
+            if (truncated)
+                out.truncated = true;
+            return { content: [{ type: "text", text: JSON.stringify(session.redact(out), null, 2) }] };
+        }
+        // No jsonpath: return full body, but still cap arrays/strings.
+        const cap = maxItems ?? 50;
+        const strCap = maxStr ?? 2000;
+        const { value, truncated } = truncate(body, cap, strCap);
+        const out = { found: true, value };
+        if (truncated)
+            out.truncated = true;
+        return { content: [{ type: "text", text: JSON.stringify(session.redact(out), null, 2) }] };
+    });
+}
+//# sourceMappingURL=inspect.js.map

package/dist/tools/inspect.js.map

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

package/dist/tools/ping.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Phase 0 smoke-test tool. Proves the full round trip:
+ * MCP client -> TS server -> napi-rs -> Rust core -> back.
+ */
+export declare function registerPingTool(server: McpServer): void;

package/dist/tools/ping.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { ping } from "../native.js";
+/**
+ * Phase 0 smoke-test tool. Proves the full round trip:
+ * MCP client -> TS server -> napi-rs -> Rust core -> back.
+ */
+export function registerPingTool(server) {
+    server.registerTool("ping", {
+        title: "Ping the core",
+        description: "Round-trip smoke test that calls into the Rust core engine and returns a pong. " +
+            "Use to verify the MCP server and native addon are wired up correctly.",
+        inputSchema: {
+            message: z.string().describe("Text to echo back through the Rust core."),
+            delayMs: z
+                .number()
+                .int()
+                .min(0)
+                .max(10000)
+                .optional()
+                .describe("Optional async delay in the core, to exercise the async FFI path."),
+        },
+    }, async ({ message, delayMs }) => {
+        const result = await ping({ message, delayMs });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,iFAAiF;YACjF,uEAAuE;QACzE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACxE,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,KAAK,CAAC;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;SACjF;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/policy.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerPolicyTool(server: McpServer, session: Session): void;

package/dist/tools/policy.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export function registerPolicyTool(server, session) {
+    server.registerTool("set_policy", {
+        title: "Set request policy",
+        description: "Configure host allow/deny lists + dry-run mode. Glob patterns: *, *.example.com.",
+        inputSchema: {
+            allow: z.array(z.string()).optional().describe("Allowed host patterns. Empty = allow any non-denied host."),
+            deny: z.array(z.string()).optional().describe("Denied host patterns; takes precedence over allow."),
+            dryRun: z.boolean().optional().describe("If true, validate requests but do not send them."),
+        },
+    }, async (args) => {
+        if (args.allow !== undefined)
+            session.policy.allow = args.allow;
+        if (args.deny !== undefined)
+            session.policy.deny = args.deny;
+        if (args.dryRun !== undefined)
+            session.policy.dryRun = args.dryRun;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ policy: { allow: session.policy.allow, deny: session.policy.deny, dryRun: session.policy.dryRun } }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=policy.js.map

package/dist/tools/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/tools/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,OAAgB;IACpE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,kFAAkF;QAC/F,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YAC3G,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YACnG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;SAC5F;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAChE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EACrG,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/request.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerRequestTools(server: McpServer, session: Session): void;

package/dist/tools/request.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { httpRequest, graphqlRequest } from "../native.js";
+import { formatHttp } from "../format.js";
+const verbosity = z
+    .enum(["summary", "headers", "full"])
+    .optional()
+    .describe("summary (default, token-efficient), headers, or full. Auto-downgraded to summary when extract is set.");
+const authSchema = z
+    .object({
+    type: z.enum(["bearer", "basic", "apikey"]),
+    token: z.string().optional(),
+    username: z.string().optional(),
+    password: z.string().optional(),
+    key: z.string().optional(),
+    value: z.string().optional(),
+    in: z.enum(["header", "query"]).optional(),
+})
+    .optional();
+const assertSchema = z
+    .array(z.record(z.string(), z.any()))
+    .optional()
+    .describe("e.g. [{status:200},{jsonpath:'$.x',equals:1},{timeMs:{lt:500}}].");
+function textResult(session, obj) {
+    return { content: [{ type: "text", text: JSON.stringify(session.redact(obj), null, 2) }] };
+}
+/** Auto-downgrade full→summary when extract is set (extracted values already contain the needed data). */
+function effectiveVerbosity(v, hasExtract) {
+    const verbosity = v ?? "summary";
+    if (hasExtract && verbosity === "full")
+        return "summary";
+    return verbosity;
+}
+export function registerRequestTools(server, session) {
+    server.registerTool("http_request", {
+        title: "HTTP request",
+        description: "REST/HTTP request with auth, assertions, {{var}} extraction. Returns token-efficient summary.",
+        inputSchema: {
+            method: z.string().optional().describe("HTTP method (default GET)."),
+            url: z.string().describe("Full URL. May contain {{variables}}."),
+            headers: z.record(z.string(), z.any()).optional(),
+            query: z.record(z.string(), z.any()).optional(),
+            body: z.any().optional().describe("Request body (object=json, string=text)."),
+            bodyType: z.enum(["json", "form", "text", "raw"]).optional().describe("Default json."),
+            auth: authSchema,
+            assert: assertSchema,
+            extract: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe("Capture vars: { token: '$.token' }. Use via {{token}} later."),
+            env: z.string().optional().describe("Environment name for variable resolution."),
+            timeoutMs: z.number().int().positive().optional(),
+            followRedirects: z.boolean().optional(),
+            verbosity,
+        },
+    }, async (args) => {
+        const { env, verbosity, ...rest } = args;
+        const spec = { ...rest, vars: session.mergedVars(env) };
+        const url = String(rest.url ?? "");
+        const policy = session.checkPolicy(url);
+        if (policy && "blocked" in policy) {
+            return textResult(session, { ok: false, error: policy.error });
+        }
+        const hasExtract = !!rest.extract && Object.keys(rest.extract).length > 0;
+        const vb = effectiveVerbosity(verbosity, hasExtract);
+        session.recordRequest("http", rest, rest.assert, rest.extract);
+        if (policy && "dryRun" in policy) {
+            const handle = session.storeResponse(policy.result);
+            return textResult(session, formatHttp(policy.result, vb, handle));
+        }
+        const result = await httpRequest(spec);
+        session.applyExtracted(result.extracted);
+        const handle = session.storeResponse(result);
+        return textResult(session, formatHttp(result, vb, handle));
+    });
+    server.registerTool("graphql_request", {
+        title: "GraphQL request",
+        description: "GraphQL query/mutation over HTTP. Separates errors from status. Supports {{var}} extraction.",
+        inputSchema: {
+            url: z.string().describe("GraphQL endpoint URL."),
+            query: z.string().describe("GraphQL query/mutation document."),
+            variables: z.record(z.string(), z.any()).optional(),
+            headers: z.record(z.string(), z.any()).optional(),
+            auth: authSchema,
+            assert: assertSchema,
+            extract: z.record(z.string(), z.string()).optional().describe("Capture vars: { token: '$.data.login.accessToken' }."),
+            env: z.string().optional(),
+            timeoutMs: z.number().int().positive().optional(),
+            verbosity,
+        },
+    }, async (args) => {
+        const { env, verbosity, ...rest } = args;
+        const spec = { ...rest, vars: session.mergedVars(env) };
+        const url = String(rest.url ?? "");
+        const policy = session.checkPolicy(url);
+        if (policy && "blocked" in policy) {
+            return textResult(session, { ok: false, error: policy.error });
+        }
+        const hasExtract = !!rest.extract && Object.keys(rest.extract).length > 0;
+        const vb = effectiveVerbosity(verbosity, hasExtract);
+        session.recordRequest("graphql", rest, rest.assert, rest.extract);
+        if (policy && "dryRun" in policy) {
+            const handle = session.storeResponse(policy.result);
+            return textResult(session, formatHttp(policy.result, vb, handle));
+        }
+        const result = await graphqlRequest(spec);
+        session.applyExtracted(result.extracted);
+        const handle = session.storeResponse(result);
+        return textResult(session, formatHttp(result, vb, handle));
+    });
+}
+//# sourceMappingURL=request.js.map

package/dist/tools/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/tools/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,SAAS,GAAG,CAAC;KAChB,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;KACpC,QAAQ,EAAE;KACV,QAAQ,CAAC,uGAAuG,CAAC,CAAC;AAErH,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC;KACD,QAAQ,EAAE,CAAC;AAEd,MAAM,YAAY,GAAG,CAAC;KACnB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;KACpC,QAAQ,EAAE;KACV,QAAQ,CAAC,kEAAkE,CAAC,CAAC;AAEhF,SAAS,UAAU,CAAC,OAAgB,EAAE,GAAY;IAChD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,0GAA0G;AAC1G,SAAS,kBAAkB,CAAC,CAAU,EAAE,UAAmB;IACzD,MAAM,SAAS,GAAI,CAAe,IAAI,SAAS,CAAC;IAChD,IAAI,UAAU,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAAgB;IACtE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+FAA+F;QAC5G,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACpE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAChE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;YACjD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC/C,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YAC7E,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACtF,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;YAC3E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAChF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YACjD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACvC,SAAS;SACV;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzC,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YAClC,OAAO,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACpF,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrD,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,IAA+B,EAAE,IAAI,CAAC,MAA+B,EAAE,IAAI,CAAC,OAA6C,CAAC,CAAC;QACzJ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,8FAA8F;QAC3G,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;YACnD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;YACjD,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YACrH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YACjD,SAAS;SACV;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzC,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YAClC,OAAO,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACpF,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrD,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,IAA+B,EAAE,IAAI,CAAC,MAA+B,EAAE,IAAI,CAAC,OAA6C,CAAC,CAAC;QAC5J,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/save.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerSaveTool(server: McpServer, session: Session): void;

package/dist/tools/save.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { extname } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+function loadExisting(path) {
+    if (!existsSync(path))
+        return { steps: [] };
+    const text = readFileSync(path, "utf8");
+    if (extname(path) === ".json")
+        return JSON.parse(text);
+    return parseYaml(text);
+}
+function serialize(col, path) {
+    if (extname(path) === ".json")
+        return JSON.stringify(col, null, 2);
+    return stringifyYaml(col);
+}
+export function registerSaveTool(server, session) {
+    server.registerTool("save_request", {
+        title: "Save request to collection",
+        description: "Persist last ad-hoc request (or explicit spec) as a new step in a collection file.",
+        inputSchema: {
+            path: z.string().describe("Collection file path (.yaml/.yml/.json)."),
+            id: z.string().optional().describe("Step id. Defaults to a generated one."),
+            type: z.enum(["http", "graphql", "ws", "sse"]).optional().describe("Step type; defaults to the last request's type."),
+            request: z.record(z.string(), z.any()).optional().describe("Explicit request spec. Defaults to the last call's request."),
+            assert: z.array(z.record(z.string(), z.any())).optional(),
+            extract: z.record(z.string(), z.string()).optional(),
+            tags: z.array(z.string()).optional(),
+            name: z.string().optional().describe("Set/replace the collection name."),
+        },
+    }, async (args) => {
+        const last = session.consumeLastRequest();
+        const type = (args.type ?? last?.type ?? "http");
+        const request = (args.request ?? last?.request ?? {});
+        if (Object.keys(request).length === 0) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "save_request: no prior request recorded and no explicit request provided." }],
+            };
+        }
+        const col = loadExisting(args.path);
+        if (args.name)
+            col.name = args.name;
+        col.steps ??= [];
+        const id = args.id ?? `step-${col.steps.length + 1}`;
+        const step = {
+            id,
+            type,
+            request,
+            assert: args.assert ?? last?.assert,
+            extract: args.extract ?? last?.extract,
+            tags: args.tags,
+        };
+        col.steps.push(step);
+        writeFileSync(args.path, serialize(col, args.path), "utf8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ saved: true, path: args.path, stepId: id, stepCount: col.steps.length }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=save.js.map

package/dist/tools/save.js.map

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

package/dist/tools/stream.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerStreamTools(server: McpServer, session: Session): void;

package/dist/tools/stream.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { wsSession, sseSession } from "../native.js";
+import { formatWs, formatSse } from "../format.js";
+const verbosity = z.enum(["summary", "headers", "full"]).optional();
+function textResult(session, obj) {
+    return { content: [{ type: "text", text: JSON.stringify(session.redact(obj), null, 2) }] };
+}
+export function registerStreamTools(server, session) {
+    server.registerTool("ws_session", {
+        title: "WebSocket session (bounded)",
+        description: "Connect WS, send messages, collect frames until stop condition. Returns summarized batch.",
+        inputSchema: {
+            url: z.string().describe("ws:// or wss:// URL."),
+            headers: z.record(z.string(), z.any()).optional(),
+            subprotocols: z.array(z.string()).optional(),
+            send: z
+                .array(z.object({ json: z.any().optional(), text: z.string().optional() }))
+                .optional()
+                .describe("Messages to send after connecting."),
+            collect: z
+                .object({
+                maxMessages: z.number().int().positive().optional(),
+                maxDurationMs: z.number().int().positive().optional(),
+                until: z.record(z.string(), z.any()).optional().describe("Stop when a frame matches, e.g. {jsonpath:'$.type',equals:'done'}."),
+            })
+                .optional(),
+            assert: z.array(z.record(z.string(), z.any())).optional().describe("e.g. [{anyFrame:{jsonpath:'$.type',equals:'ack'}},{frameCount:{gte:1}}]"),
+            env: z.string().optional(),
+            verbosity,
+        },
+    }, async (args) => {
+        const spec = { ...args, vars: session.mergedVars(args.env) };
+        const policy = session.checkPolicy(String(args.url ?? ""));
+        if (policy && "blocked" in policy) {
+            return textResult(session, { ok: false, connected: false, error: policy.error });
+        }
+        if (policy && "dryRun" in policy) {
+            const handle = session.storeResponse(policy.result);
+            return textResult(session, formatWs(policy.result, args.verbosity ?? "summary", handle));
+        }
+        const result = await wsSession(spec);
+        const handle = session.storeResponse(result);
+        return textResult(session, formatWs(result, args.verbosity ?? "summary", handle));
+    });
+    server.registerTool("sse_session", {
+        title: "SSE session (bounded)",
+        description: "Subscribe to SSE, collect events until stop condition. Returns summarized batch with assertions.",
+        inputSchema: {
+            url: z.string().describe("SSE endpoint URL."),
+            headers: z.record(z.string(), z.any()).optional(),
+            collect: z
+                .object({
+                maxEvents: z.number().int().positive().optional(),
+                maxDurationMs: z.number().int().positive().optional(),
+            })
+                .optional(),
+            assert: z.array(z.record(z.string(), z.any())).optional().describe("e.g. [{anyEvent:{jsonpath:'$.type',equals:'tick'}},{eventCount:{gte:1}}]"),
+            env: z.string().optional(),
+            verbosity,
+        },
+    }, async (args) => {
+        const spec = { ...args, vars: session.mergedVars(args.env) };
+        const policy = session.checkPolicy(String(args.url ?? ""));
+        if (policy && "blocked" in policy) {
+            return textResult(session, { ok: false, connected: false, error: policy.error });
+        }
+        if (policy && "dryRun" in policy) {
+            const handle = session.storeResponse(policy.result);
+            return textResult(session, formatSse(policy.result, args.verbosity ?? "summary", handle));
+        }
+        const result = await sseSession(spec);
+        const handle = session.storeResponse(result);
+        return textResult(session, formatSse(result, args.verbosity ?? "summary", handle));
+    });
+}
+//# sourceMappingURL=stream.js.map

package/dist/tools/stream.js.map

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

package/dist/tools/ws.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "../session.js";
+export declare function registerWsTools(server: McpServer, session: Session): void;