@http-forge/core 0.4.7 → 0.4.8

package/dist/infrastructure/auth/oauth2-token-manager.d.ts

@@ -14,9 +14,9 @@
  * is injected via IExternalBrowserService and ISecretStore interfaces.
  */
 import { IEnvironmentConfigService } from '../../types/environment-config';
-import { IHttpRequestService } from '../http/interfaces';
 import { IExternalBrowserService, ISecretStore } from '../../types/platform';
 import { OAuth2Config } from '../../types/types';
+import { IHttpRequestService } from '../http/interfaces';
 import { IOAuth2TokenManager, TokenCacheKey, TokenInfo } from './interfaces';
 export declare class OAuth2TokenManager implements IOAuth2TokenManager {
     private readonly secretStore;

package/dist/infrastructure/script/interfaces.d.ts

@@ -49,6 +49,7 @@ export interface ResponseContext {
     status: number;
     statusText: string;
     headers: Record<string, string>;
+    /** Raw response body string (Postman-compatible). Parse on demand via response.json(). */
     body: any;
     cookies?: Record<string, string>;
     responseTime?: number;

package/dist/infrastructure/script/request-script-session.d.ts

@@ -64,6 +64,19 @@ export declare class RequestScriptSession implements IRequestScriptSession {
      * Maps HTTP Forge body types to Postman modes for script API compatibility
      */
     private createRequestObject;
+    /**
+     * Inject the legacy (pre-`pm.*`) Postman/Newman sandbox globals into the VM context.
+     *
+     * Older Postman scripts (and many Newman-exported collections) rely on bare globals
+     * that the modern `pm.*` sandbox no longer injects. Evaluating them (e.g. `request.name`,
+     * `responseCode.code`, `tv4.validate(...)`) otherwise throws `ReferenceError`.
+     *
+     * Available in BOTH phases: `request`, `environment`, `globals`, `data`, `iteration`.
+     * Available in the TEST phase only: `responseBody`, `responseCode`, `responseHeaders`,
+     * `responseTime`, `responseCookies`, `tests`, plus `postman.getResponseHeader()` /
+     * `postman.getResponseCookie()`.
+     */
+    private injectLegacyGlobals;
     /**
      * Execute pre-request scripts in the shared session
      */

package/dist/infrastructure/script/script-factories.d.ts

@@ -22,6 +22,7 @@ export interface ScriptResponse {
     code: number;
     statusText: string;
     headers: Record<string, string>;
+    /** Raw response body string (Postman-compatible). Use json() to parse, text() for the string. */
     body: any;
     cookies: Record<string, string>;
     responseTime?: number;

package/dist/runtime/mcp-tool-name.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared MCP tool-name encoding / decoding.
+ *
+ * MCP tool names must stay under Anthropic's 128-character limit. HTTP Forge
+ * IDs embed the human-readable entity name (up to ~100 chars each), so a raw
+ * tool name like `request__<collectionId>__<requestId>` can exceed 240 chars
+ * and be rejected by the model provider.
+ *
+ * To stay short we put a deterministic short hash token (not the raw ID) in the
+ * tool name, and resolve a call back to the real entity by hashing the current
+ * collections / requests / folders / suites and matching. A raw-value fallback
+ * keeps any previously-listed long names working after the upgrade.
+ *
+ * IDs are NOT changed — they remain the stable external references used by
+ * suites, result filenames, and history. Only the tool *name* is shortened.
+ *
+ * The model selects a tool by its *description* (which still contains the
+ * human-readable names), so an opaque short name does not affect tool choice.
+ */
+/** Deterministic short token for an ID or folder path (12 hex chars). */
+export declare function mcpToolToken(value: string): string;
+export type McpToolKind = 'request' | 'collection' | 'folder' | 'suite';
+export declare function buildRequestToolName(prefix: string, collectionId: string, requestId: string): string;
+export declare function buildCollectionToolName(prefix: string, collectionId: string): string;
+export declare function buildFolderToolName(prefix: string, collectionId: string, folderPath: string): string;
+export declare function buildSuiteToolName(prefix: string, suiteId: string): string;
+export interface ParsedMcpToolName {
+    kind: McpToolKind;
+    tokens: string[];
+}
+/** Parse a tool name (prefix already stripped) into its kind + token segments. */
+export declare function parseMcpToolName(name: string): ParsedMcpToolName;
+/**
+ * Resolve a token back to one of `candidates` by matching its hash token, or
+ * (legacy fallback) the raw candidate value itself.
+ */
+export declare function resolveToken(token: string, candidates: readonly string[]): string | undefined;
+/**
+ * Resolve a folder token to a folder path. Adds a base64url legacy fallback for
+ * folder tool names emitted before hashing (which embedded base64url(path)).
+ */
+export declare function resolveFolderToken(token: string, folderPaths: readonly string[]): string | undefined;
+export declare function buildRequestToolDescription(method: string, requestName: string, collectionName: string, folderPath: string): string;
+export declare function buildCollectionToolDescription(collectionName: string, requestCount: number): string;
+export declare function buildFolderToolDescription(folderPath: string, collectionName: string, requestCount: number): string;
+export declare function buildSuiteToolDescription(suiteName: string, requestCount: number, iterations: number): string;

package/dist/runtime/mcp-tool-schemas.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Shared MCP tool input schemas.
+ *
+ * Both MCP server implementations (the embeddable core runtime and the VS Code
+ * extension) expose the same tools, so they must advertise identical input
+ * schemas. Keeping these in one place prevents the two sides from drifting
+ * (e.g. the extension previously omitted `iterations`/`delay`/`include` for
+ * collection and folder runs even though its executor supported them).
+ */
+export declare const REQUEST_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly environment: {
+            readonly type: "string";
+            readonly description: "Environment name to use (defaults to the currently selected environment)";
+        };
+        readonly variables: {
+            readonly type: "object";
+            readonly description: "Extra variables to inject — merged with environment variables, {{name}} syntax";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly headers: {
+            readonly type: "object";
+            readonly description: "Override or add request headers";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly query: {
+            readonly type: "object";
+            readonly description: "Override query parameters";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly body: {
+            readonly type: "string";
+            readonly description: "Replace the request body (JSON string). Omit to use the saved body.";
+        };
+        readonly include: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly enum: readonly ["headers", "cookies", "tests", "consoleOutput", "report"];
+            };
+            readonly description: "Extra fields to include in the response (default: status, ok, body, allPassed)";
+        };
+    };
+};
+export declare const COLLECTION_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly environment: {
+            readonly type: "string";
+            readonly description: "Environment name to use";
+        };
+        readonly variables: {
+            readonly type: "object";
+            readonly description: "Extra variables injected into every request";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly iterations: {
+            readonly type: "number";
+            readonly description: "Number of iterations (default: 1)";
+        };
+        readonly stopOnError: {
+            readonly type: "boolean";
+            readonly description: "Stop on first failure";
+        };
+        readonly delay: {
+            readonly type: "number";
+            readonly description: "Delay between requests in ms";
+        };
+        readonly include: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly enum: readonly ["perRequest", "failedOnly", "consoleOutput", "report"];
+            };
+            readonly description: "Result detail level";
+        };
+    };
+};
+export declare const FOLDER_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly environment: {
+            readonly type: "string";
+            readonly description: "Environment name to use";
+        };
+        readonly variables: {
+            readonly type: "object";
+            readonly description: "Extra variables injected into every request";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly iterations: {
+            readonly type: "number";
+            readonly description: "Number of iterations (default: 1)";
+        };
+        readonly stopOnError: {
+            readonly type: "boolean";
+            readonly description: "Stop on first failure";
+        };
+        readonly delay: {
+            readonly type: "number";
+            readonly description: "Delay between requests in ms";
+        };
+        readonly recursive: {
+            readonly type: "boolean";
+            readonly description: "Include requests in nested subfolders (default: true)";
+        };
+        readonly include: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly enum: readonly ["perRequest", "failedOnly", "consoleOutput", "report"];
+            };
+            readonly description: "Result detail level";
+        };
+    };
+};
+export declare const SUITE_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly environment: {
+            readonly type: "string";
+            readonly description: "Environment name to use";
+        };
+        readonly iterations: {
+            readonly type: "number";
+            readonly description: "Number of iterations (overrides suite default)";
+        };
+        readonly stopOnError: {
+            readonly type: "boolean";
+            readonly description: "Stop on first failure";
+        };
+        readonly delay: {
+            readonly type: "number";
+            readonly description: "Delay between requests in ms";
+        };
+        readonly variables: {
+            readonly type: "object";
+            readonly description: "Extra variables injected into every request";
+            readonly additionalProperties: {
+                readonly type: "string";
+            };
+        };
+        readonly requestFilter: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Run only requests whose names match one of these strings (case-insensitive)";
+        };
+        readonly include: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly enum: readonly ["perRequest", "failedOnly", "consoleOutput", "report"];
+            };
+            readonly description: "Result detail level (default: summary + failedRequests)";
+        };
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@http-forge/core",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Headless HTTP testing engine with Postman collection support, dynamic variables, and script-based automation.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",