@skyramp/mcp 0.3.3 → 0.3.4

package/build/workspace/workspace.d.ts

@@ -19,6 +19,34 @@ export declare const serviceSchema: z.ZodObject<{
          *  Explicit per-request queryParams always win on a key collision
          *  (SKYR-4050). */
         defaultQueryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Path-scoped overrides layered on top of defaultQueryParams
+         *  (SKYR-4127). For a given request, the single most-specific matching
+         *  pathPattern wins and its values override the base map key by key;
+         *  overrides never merge with each other. Patterns are picomatch globs
+         *  matched against the request URL pathname, with OpenAPI-style
+         *  `{param}` placeholders treated as a single-segment wildcard.
+         *
+         *  The pathname includes any base-path prefix carried by baseUrl — a
+         *  service at `https://host/api` needs `/api/v1/**`, not `/v1/**`. A
+         *  pattern that omits the prefix silently matches nothing.
+         *
+         *  Values may use `env.VAR` to defer to an environment variable read
+         *  where the test runs rather than where it was generated — the
+         *  generated test carries the lookup itself (os.getenv in Python,
+         *  process.env in JS/TS, System.getenv in Java). The legacy `envs.`
+         *  spelling is still accepted. Note the variable name is passed
+         *  through verbatim and is case-sensitive; a near miss such as
+         *  `ENV.VAR` is treated as an ordinary literal. */
+        queryParamOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pathPattern: z.ZodString;
+            values: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            values: Record<string, string>;
+            pathPattern: string;
+        }, {
+            values: Record<string, string>;
+            pathPattern: string;
+        }>, "many">>;
         baseUrl: z.ZodOptional<z.ZodString>;
         /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
          *  tests should skip certificate verification for this service (SKYR-3961).
@@ -30,6 +58,10 @@ export declare const serviceSchema: z.ZodObject<{
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
         defaultQueryParams?: Record<string, string> | undefined;
+        queryParamOverrides?: {
+            values: Record<string, string>;
+            pathPattern: string;
+        }[] | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     }, {
@@ -38,6 +70,10 @@ export declare const serviceSchema: z.ZodObject<{
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
         defaultQueryParams?: Record<string, string> | undefined;
+        queryParamOverrides?: {
+            values: Record<string, string>;
+            pathPattern: string;
+        }[] | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     }>>;
@@ -114,6 +150,10 @@ export declare const serviceSchema: z.ZodObject<{
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
         defaultQueryParams?: Record<string, string> | undefined;
+        queryParamOverrides?: {
+            values: Record<string, string>;
+            pathPattern: string;
+        }[] | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     } | undefined;
@@ -145,6 +185,10 @@ export declare const serviceSchema: z.ZodObject<{
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
         defaultQueryParams?: Record<string, string> | undefined;
+        queryParamOverrides?: {
+            values: Record<string, string>;
+            pathPattern: string;
+        }[] | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     } | undefined;
@@ -212,6 +256,34 @@ export declare const workspaceConfigSchema: z.ZodObject<{
              *  Explicit per-request queryParams always win on a key collision
              *  (SKYR-4050). */
             defaultQueryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /** Path-scoped overrides layered on top of defaultQueryParams
+             *  (SKYR-4127). For a given request, the single most-specific matching
+             *  pathPattern wins and its values override the base map key by key;
+             *  overrides never merge with each other. Patterns are picomatch globs
+             *  matched against the request URL pathname, with OpenAPI-style
+             *  `{param}` placeholders treated as a single-segment wildcard.
+             *
+             *  The pathname includes any base-path prefix carried by baseUrl — a
+             *  service at `https://host/api` needs `/api/v1/**`, not `/v1/**`. A
+             *  pattern that omits the prefix silently matches nothing.
+             *
+             *  Values may use `env.VAR` to defer to an environment variable read
+             *  where the test runs rather than where it was generated — the
+             *  generated test carries the lookup itself (os.getenv in Python,
+             *  process.env in JS/TS, System.getenv in Java). The legacy `envs.`
+             *  spelling is still accepted. Note the variable name is passed
+             *  through verbatim and is case-sensitive; a near miss such as
+             *  `ENV.VAR` is treated as an ordinary literal. */
+            queryParamOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pathPattern: z.ZodString;
+                values: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                values: Record<string, string>;
+                pathPattern: string;
+            }, {
+                values: Record<string, string>;
+                pathPattern: string;
+            }>, "many">>;
             baseUrl: z.ZodOptional<z.ZodString>;
             /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
              *  tests should skip certificate verification for this service (SKYR-3961).
@@ -223,6 +295,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         }, {
@@ -231,6 +307,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         }>>;
@@ -307,6 +387,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
@@ -338,6 +422,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
@@ -382,6 +470,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
@@ -426,6 +518,10 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
@@ -479,6 +575,10 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
@@ -523,6 +623,10 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
             defaultQueryParams?: Record<string, string> | undefined;
+            queryParamOverrides?: {
+                values: Record<string, string>;
+                pathPattern: string;
+            }[] | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;

package/build/workspace/workspace.js

@@ -61,6 +61,30 @@ export const serviceSchema = z
          *  Explicit per-request queryParams always win on a key collision
          *  (SKYR-4050). */
         defaultQueryParams: z.record(z.string()).optional(),
+        /** Path-scoped overrides layered on top of defaultQueryParams
+         *  (SKYR-4127). For a given request, the single most-specific matching
+         *  pathPattern wins and its values override the base map key by key;
+         *  overrides never merge with each other. Patterns are picomatch globs
+         *  matched against the request URL pathname, with OpenAPI-style
+         *  `{param}` placeholders treated as a single-segment wildcard.
+         *
+         *  The pathname includes any base-path prefix carried by baseUrl — a
+         *  service at `https://host/api` needs `/api/v1/**`, not `/v1/**`. A
+         *  pattern that omits the prefix silently matches nothing.
+         *
+         *  Values may use `env.VAR` to defer to an environment variable read
+         *  where the test runs rather than where it was generated — the
+         *  generated test carries the lookup itself (os.getenv in Python,
+         *  process.env in JS/TS, System.getenv in Java). The legacy `envs.`
+         *  spelling is still accepted. Note the variable name is passed
+         *  through verbatim and is case-sensitive; a near miss such as
+         *  `ENV.VAR` is treated as an ordinary literal. */
+        queryParamOverrides: z
+            .array(z.object({
+            pathPattern: z.string().min(1),
+            values: z.record(z.string()),
+        }).strict())
+            .optional(),
         baseUrl: z.string().optional(),
         /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
          *  tests should skip certificate verification for this service (SKYR-3961).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyramp/mcp",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "main": "build/index.js",
   "exports": {
     ".": "./build/index.js",
@@ -70,13 +70,14 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@playwright/test": "^1.55.0",
-    "@skyramp/skyramp": "1.3.38",
+    "@skyramp/skyramp": "1.3.40",
     "dockerode": "^5.0.0",
     "fast-glob": "^3.3.3",
     "js-yaml": "^4.1.1",
     "picomatch": "^4.0.5",
     "playwright": "file:vendor/skyramp-playwright-1.58.2-skyramp.8.14.4.tgz",
     "simple-git": "^3.30.0",
+    "ts-is-record": "^3.0.5",
     "typescript": "^5.8.3",
     "zod": "^3.25.3"
   },