@skyramp/mcp 0.3.2-rc.pom-4 → 0.3.2

package/build/types/RepositoryAnalysis.d.ts

@@ -145,6 +145,22 @@ export interface BranchDiffContext {
     affectedServices: string[];
     summary?: string;
 }
+export interface RouteDiscoveryInfo {
+    /** Files the LLM should inspect to infer endpoint methods and paths from source. */
+    candidateFiles: string[];
+    /** Static scanner output. Best-effort hints only, not an authoritative catalog. */
+    staticHints: Array<{
+        path: string;
+        methods: string[];
+        sourceFile: string;
+    }>;
+    /** OpenAPI paths from workspace config. Authoritative when specFetchSucceeded is true. */
+    openApiPaths: string[];
+    /** Router/module entry points that help the LLM reconstruct full mounted paths. */
+    routerMountContext: string[];
+    /** Full diff file path when available; read this to ground endpoint extraction in changed code. */
+    diffFilePath?: string;
+}
 export interface RepositoryAnalysis {
     metadata: AnalysisMetadata;
     projectClassification: ProjectClassification;
@@ -155,6 +171,7 @@ export interface RepositoryAnalysis {
     authentication: AuthenticationInfo;
     infrastructure: InfrastructureInfo;
     existingTests: ExistingTestInfo;
+    routeDiscovery?: RouteDiscoveryInfo;
     branchDiffContext?: BranchDiffContext;
 }
 export interface AnalysisMetadata {
@@ -542,6 +559,7 @@ export declare const endpointMethodSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     method: string;
     description: string;
+    sourceFile: string;
     queryParams: {
         type: string;
         name: string;
@@ -550,7 +568,6 @@ export declare const endpointMethodSchema: z.ZodObject<{
         constraints?: string | undefined;
     }[];
     authRequired: boolean;
-    sourceFile: string;
     interactions: {
         type: "error" | "success" | "edge-case";
         description: string;
@@ -581,6 +598,7 @@ export declare const endpointMethodSchema: z.ZodObject<{
 }, {
     method: string;
     description: string;
+    sourceFile: string;
     queryParams: {
         type: string;
         name: string;
@@ -589,7 +607,6 @@ export declare const endpointMethodSchema: z.ZodObject<{
         constraints?: string | undefined;
     }[];
     authRequired: boolean;
-    sourceFile: string;
     interactions: {
         type: "error" | "success" | "edge-case";
         description: string;
@@ -784,6 +801,7 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         method: string;
         description: string;
+        sourceFile: string;
         queryParams: {
             type: string;
             name: string;
@@ -792,7 +810,6 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
             constraints?: string | undefined;
         }[];
         authRequired: boolean;
-        sourceFile: string;
         interactions: {
             type: "error" | "success" | "edge-case";
             description: string;
@@ -823,6 +840,7 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
     }, {
         method: string;
         description: string;
+        sourceFile: string;
         queryParams: {
             type: string;
             name: string;
@@ -831,7 +849,6 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
             constraints?: string | undefined;
         }[];
         authRequired: boolean;
-        sourceFile: string;
         interactions: {
             type: "error" | "success" | "edge-case";
             description: string;
@@ -873,6 +890,7 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
     methods: {
         method: string;
         description: string;
+        sourceFile: string;
         queryParams: {
             type: string;
             name: string;
@@ -881,7 +899,6 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
             constraints?: string | undefined;
         }[];
         authRequired: boolean;
-        sourceFile: string;
         interactions: {
             type: "error" | "success" | "edge-case";
             description: string;
@@ -923,6 +940,7 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
     methods: {
         method: string;
         description: string;
+        sourceFile: string;
         queryParams: {
             type: string;
             name: string;
@@ -931,7 +949,6 @@ export declare const enrichedEndpointSchema: z.ZodObject<{
             constraints?: string | undefined;
         }[];
         authRequired: boolean;
-        sourceFile: string;
         interactions: {
             type: "error" | "success" | "edge-case";
             description: string;
@@ -1423,6 +1440,45 @@ export declare const branchDiffContextSchema: z.ZodObject<{
     }[] | undefined;
     summary?: string | undefined;
 }>;
+export declare const routeDiscoveryInfoSchema: z.ZodObject<{
+    candidateFiles: z.ZodArray<z.ZodString, "many">;
+    staticHints: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        methods: z.ZodArray<z.ZodString, "many">;
+        sourceFile: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        sourceFile: string;
+        methods: string[];
+    }, {
+        path: string;
+        sourceFile: string;
+        methods: string[];
+    }>, "many">;
+    openApiPaths: z.ZodArray<z.ZodString, "many">;
+    routerMountContext: z.ZodArray<z.ZodString, "many">;
+    diffFilePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    candidateFiles: string[];
+    staticHints: {
+        path: string;
+        sourceFile: string;
+        methods: string[];
+    }[];
+    openApiPaths: string[];
+    routerMountContext: string[];
+    diffFilePath?: string | undefined;
+}, {
+    candidateFiles: string[];
+    staticHints: {
+        path: string;
+        sourceFile: string;
+        methods: string[];
+    }[];
+    openApiPaths: string[];
+    routerMountContext: string[];
+    diffFilePath?: string | undefined;
+}>;
 export declare const analysisMetadataSchema: z.ZodObject<{
     repositoryName: z.ZodString;
     analysisDate: z.ZodString;
@@ -2057,6 +2113,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             }, "strip", z.ZodTypeAny, {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2065,7 +2122,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2096,6 +2152,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             }, {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2104,7 +2161,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2146,6 +2202,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2154,7 +2211,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2196,6 +2252,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2204,7 +2261,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2250,6 +2306,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2258,7 +2315,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2304,6 +2360,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2312,7 +2369,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2440,6 +2496,45 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
         estimatedCoverage?: number | undefined;
         relevantExternalTestPaths?: string[] | undefined;
     }>;
+    routeDiscovery: z.ZodOptional<z.ZodObject<{
+        candidateFiles: z.ZodArray<z.ZodString, "many">;
+        staticHints: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            methods: z.ZodArray<z.ZodString, "many">;
+            sourceFile: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }, {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }>, "many">;
+        openApiPaths: z.ZodArray<z.ZodString, "many">;
+        routerMountContext: z.ZodArray<z.ZodString, "many">;
+        diffFilePath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        candidateFiles: string[];
+        staticHints: {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }[];
+        openApiPaths: string[];
+        routerMountContext: string[];
+        diffFilePath?: string | undefined;
+    }, {
+        candidateFiles: string[];
+        staticHints: {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }[];
+        openApiPaths: string[];
+        routerMountContext: string[];
+        diffFilePath?: string | undefined;
+    }>>;
     branchDiffContext: z.ZodOptional<z.ZodObject<{
         currentBranch: z.ZodString;
         baseBranch: z.ZodString;
@@ -2700,6 +2795,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2708,7 +2804,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2768,6 +2863,17 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
         estimatedCoverage?: number | undefined;
         relevantExternalTestPaths?: string[] | undefined;
     };
+    routeDiscovery?: {
+        candidateFiles: string[];
+        staticHints: {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }[];
+        openApiPaths: string[];
+        routerMountContext: string[];
+        diffFilePath?: string | undefined;
+    } | undefined;
     branchDiffContext?: {
         currentBranch: string;
         baseBranch: string;
@@ -2902,6 +3008,7 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
             methods: {
                 method: string;
                 description: string;
+                sourceFile: string;
                 queryParams: {
                     type: string;
                     name: string;
@@ -2910,7 +3017,6 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
                     constraints?: string | undefined;
                 }[];
                 authRequired: boolean;
-                sourceFile: string;
                 interactions: {
                     type: "error" | "success" | "edge-case";
                     description: string;
@@ -2970,6 +3076,17 @@ export declare const repositoryAnalysisSchema: z.ZodObject<{
         estimatedCoverage?: number | undefined;
         relevantExternalTestPaths?: string[] | undefined;
     };
+    routeDiscovery?: {
+        candidateFiles: string[];
+        staticHints: {
+            path: string;
+            sourceFile: string;
+            methods: string[];
+        }[];
+        openApiPaths: string[];
+        routerMountContext: string[];
+        diffFilePath?: string | undefined;
+    } | undefined;
     branchDiffContext?: {
         currentBranch: string;
         baseBranch: string;

package/build/types/RepositoryAnalysis.js

@@ -128,17 +128,30 @@ export const branchDiffContextSchema = z.object({
             changeType: z.enum(["added", "modified", "removed"]),
         })),
     })),
-    removedEndpoints: z.array(z.object({
+    removedEndpoints: z
+        .array(z.object({
         path: z.string(),
         methods: z.array(z.object({
             method: z.string(),
             sourceFile: z.string(),
             changeType: z.literal("removed"),
         })),
-    })).optional(),
+    }))
+        .optional(),
     affectedServices: z.array(z.string()),
     summary: z.string().optional(),
 });
+export const routeDiscoveryInfoSchema = z.object({
+    candidateFiles: z.array(z.string()),
+    staticHints: z.array(z.object({
+        path: z.string(),
+        methods: z.array(z.string()),
+        sourceFile: z.string(),
+    })),
+    openApiPaths: z.array(z.string()),
+    routerMountContext: z.array(z.string()),
+    diffFilePath: z.string().optional(),
+});
 export const analysisMetadataSchema = z.object({
     repositoryName: z.string(),
     analysisDate: z.string(),
@@ -239,5 +252,6 @@ export const repositoryAnalysisSchema = z.object({
         estimatedCoverage: z.number().optional(),
         relevantExternalTestPaths: z.array(z.string()).optional(),
     }),
+    routeDiscovery: routeDiscoveryInfoSchema.optional(),
     branchDiffContext: branchDiffContextSchema.optional(),
 });

package/build/types/ReuseOutcome.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The POM code-reuse shape carried in a TestbotReport — the wire contract between
+ * this server and the consumers that render it (test-bot.git).
+ *
+ * Lives in types/ rather than beside the derivation logic in
+ * tools/code-refactor/reuse-outcome.ts, and is re-exported from types/index.ts,
+ * so consumers have exactly one definition to import. The enums matter here as
+ * VALUES, not just types: a renderer validating an incoming `verification` or
+ * `declinedBy` needs the actual members to compare against, which a structurally
+ * inherited type cannot provide.
+ *
+ * The internal record that run state keeps between the verify pass and the report
+ * step (`ReuseRecord`) deliberately stays private to the derivation module — it is
+ * not part of this contract and must never reach a report.
+ */
+/** Which gate declined a POM member. */
+export declare enum ReuseDeclinedBy {
+    /** The mapping table never promoted it — no call was ever written. */
+    NotMapped = "not-mapped",
+    /** It was substituted, then verification rejected it and the raw form was
+     *  restored. A `passed` verdict does NOT cover this: it counts only the calls
+     *  that survived. */
+    DemotedByVerify = "demoted-by-verify"
+}
+/** Outcome of the reuse verification loop for a spec. */
+export declare enum ReuseVerificationOutcome {
+    Passed = "passed",
+    Failed = "failed",
+    /** No page-object layer existed to reuse. */
+    SkippedNoPom = "skipped-no-pom"
+}
+/** A POM member the refactor did not reuse. Keyed on the member rather than the
+ *  file: a class is routinely part-reused (a property substituted while a method
+ *  from the same class is demoted), so a file-level list would show that file as
+ *  reused and lose the decline. */
+export interface ReuseSkippedEntry {
+    /** The POM file BASENAME the decline was attributed to — the name the agent
+     *  wrote in its `// kept inline: <file basename> — <reason>` comment, which is
+     *  what the decline is parsed out of. A class name appears only in `member`. */
+    pageObject: string;
+    /** `<binding>.<member>` as the verification report names it. Absent when the
+     *  decline cannot be attributed to one member — a file with several declines
+     *  gives no way to say which is which. */
+    member?: string;
+    declinedBy?: ReuseDeclinedBy;
+    reason: string;
+}
+/**
+ * What lands in a report's `reuse` field, for a UI test whose generation ran POM
+ * code reuse. Every member is optional: consumers must render from whatever
+ * subset is present, and omit the summary entirely when the object is absent (as
+ * it is for non-UI tests, and in reports from versions predating the field).
+ *
+ * `candidatesDetected` counts FILES while the call counts count CALLS — an
+ * indicator, never a fraction. Do not render the pair as a ratio or percentage.
+ */
+export interface ReuseOutcome {
+    candidatesDetected?: number;
+    callsReused?: number;
+    callsVerified?: number;
+    verification?: ReuseVerificationOutcome;
+    skipped?: ReuseSkippedEntry[];
+}

package/build/types/ReuseOutcome.js

@@ -0,0 +1,33 @@
+/**
+ * The POM code-reuse shape carried in a TestbotReport — the wire contract between
+ * this server and the consumers that render it (test-bot.git).
+ *
+ * Lives in types/ rather than beside the derivation logic in
+ * tools/code-refactor/reuse-outcome.ts, and is re-exported from types/index.ts,
+ * so consumers have exactly one definition to import. The enums matter here as
+ * VALUES, not just types: a renderer validating an incoming `verification` or
+ * `declinedBy` needs the actual members to compare against, which a structurally
+ * inherited type cannot provide.
+ *
+ * The internal record that run state keeps between the verify pass and the report
+ * step (`ReuseRecord`) deliberately stays private to the derivation module — it is
+ * not part of this contract and must never reach a report.
+ */
+/** Which gate declined a POM member. */
+export var ReuseDeclinedBy;
+(function (ReuseDeclinedBy) {
+    /** The mapping table never promoted it — no call was ever written. */
+    ReuseDeclinedBy["NotMapped"] = "not-mapped";
+    /** It was substituted, then verification rejected it and the raw form was
+     *  restored. A `passed` verdict does NOT cover this: it counts only the calls
+     *  that survived. */
+    ReuseDeclinedBy["DemotedByVerify"] = "demoted-by-verify";
+})(ReuseDeclinedBy || (ReuseDeclinedBy = {}));
+/** Outcome of the reuse verification loop for a spec. */
+export var ReuseVerificationOutcome;
+(function (ReuseVerificationOutcome) {
+    ReuseVerificationOutcome["Passed"] = "passed";
+    ReuseVerificationOutcome["Failed"] = "failed";
+    /** No page-object layer existed to reuse. */
+    ReuseVerificationOutcome["SkippedNoPom"] = "skipped-no-pom";
+})(ReuseVerificationOutcome || (ReuseVerificationOutcome = {}));

package/build/types/TestExecution.d.ts

@@ -44,6 +44,7 @@ export interface TestExecutionOptions {
     token?: string;
     timeout?: number;
     playwrightSaveStoragePath?: string;
+    dockerNetwork?: string;
     useHostNetwork?: boolean;
 }
 /**

package/build/types/TestTypes.d.ts

@@ -15,10 +15,19 @@ export declare enum TestType {
     INTEGRATION = "integration",
     E2E = "e2e",
     UI = "ui",
-    MOCK = "mock",
     UNIT = "unit",
     UNKNOWN = "unknown"
 }
+/**
+ * Mock is not a test type — mock files are deployed via apply_mock(),
+ * not executed as tests. Kept as a standalone constant for mock generation.
+ */
+export declare const MOCK_TYPE: "mock";
+export declare enum MockProtocol {
+    Rest = "rest",
+    Grpc = "grpc",
+    Kafka = "kafka"
+}
 export declare enum HttpMethod {
     GET = "GET",
     POST = "POST",
@@ -31,7 +40,16 @@ export declare enum HttpMethod {
 export declare enum RuntimeEnvironment {
     LOCAL = "local",
     DOCKER = "docker",
-    KUBERNETES = "kubernetes"
+    KUBERNETES = "k8s"
+}
+export declare const runtimeEnvironmentSchema: z.ZodNativeEnum<typeof RuntimeEnvironment>;
+export declare const runtimeEnvironmentInputSchema: z.ZodEffects<z.ZodNativeEnum<typeof RuntimeEnvironment>, RuntimeEnvironment, unknown>;
+export declare function normalizeRuntimeEnvironment(value: RuntimeEnvironment | "kubernetes"): RuntimeEnvironment;
+export interface TestConfig {
+    testType: TestType;
+    toolName: string;
+    description: string;
+    additionalFields?: Record<string, z.ZodSchema>;
 }
 export declare const languageSchema: z.ZodObject<{
     language: z.ZodNativeEnum<typeof ProgrammingLanguage>;
@@ -45,7 +63,7 @@ export declare const languageSchema: z.ZodObject<{
 }>;
 export declare const baseSchema: z.ZodObject<{
     deployDashboard: z.ZodDefault<z.ZodBoolean>;
-    runtime: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeEnvironment>>;
+    runtime: z.ZodDefault<z.ZodEffects<z.ZodNativeEnum<typeof RuntimeEnvironment>, RuntimeEnvironment, unknown>>;
     dockerNetwork: z.ZodDefault<z.ZodString>;
     dockerWorkerPort: z.ZodDefault<z.ZodNumber>;
     k8sNamespace: z.ZodDefault<z.ZodString>;
@@ -87,7 +105,7 @@ export declare const baseSchema: z.ZodObject<{
     outputDir: string;
     prompt: string;
     deployDashboard?: boolean | undefined;
-    runtime?: RuntimeEnvironment | undefined;
+    runtime?: unknown;
     dockerNetwork?: string | undefined;
     dockerWorkerPort?: number | undefined;
     k8sNamespace?: string | undefined;
@@ -125,7 +143,7 @@ export declare const basePlaywrightSchema: z.ZodObject<{
 }>;
 export declare const baseTraceSchema: z.ZodObject<{
     deployDashboard: z.ZodDefault<z.ZodBoolean>;
-    runtime: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeEnvironment>>;
+    runtime: z.ZodDefault<z.ZodEffects<z.ZodNativeEnum<typeof RuntimeEnvironment>, RuntimeEnvironment, unknown>>;
     dockerNetwork: z.ZodDefault<z.ZodString>;
     dockerWorkerPort: z.ZodDefault<z.ZodNumber>;
     k8sNamespace: z.ZodDefault<z.ZodString>;
@@ -174,7 +192,7 @@ export declare const baseTraceSchema: z.ZodObject<{
     prompt: string;
     trace: string;
     deployDashboard?: boolean | undefined;
-    runtime?: RuntimeEnvironment | undefined;
+    runtime?: unknown;
     dockerNetwork?: string | undefined;
     dockerWorkerPort?: number | undefined;
     k8sNamespace?: string | undefined;
@@ -192,7 +210,7 @@ export declare const baseTraceSchema: z.ZodObject<{
 }>;
 export declare const baseTestSchema: {
     deployDashboard: z.ZodDefault<z.ZodBoolean>;
-    runtime: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeEnvironment>>;
+    runtime: z.ZodDefault<z.ZodEffects<z.ZodNativeEnum<typeof RuntimeEnvironment>, RuntimeEnvironment, unknown>>;
     dockerNetwork: z.ZodDefault<z.ZodString>;
     dockerWorkerPort: z.ZodDefault<z.ZodNumber>;
     k8sNamespace: z.ZodDefault<z.ZodString>;

package/build/types/TestTypes.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { SUPPORTED_FRAMEWORKS } from "../workspace/frameworks.js";
 export const SESSION_STORAGE_FILENAME = "skyramp_session_storage.json";
 export const AUTH_PLACEHOLDER_TOKEN = "SKYRAMP_PLACEHOLDER_TOKEN";
 export var ProgrammingLanguage;
@@ -17,10 +18,20 @@ export var TestType;
     TestType["INTEGRATION"] = "integration";
     TestType["E2E"] = "e2e";
     TestType["UI"] = "ui";
-    TestType["MOCK"] = "mock";
     TestType["UNIT"] = "unit";
     TestType["UNKNOWN"] = "unknown";
 })(TestType || (TestType = {}));
+/**
+ * Mock is not a test type — mock files are deployed via apply_mock(),
+ * not executed as tests. Kept as a standalone constant for mock generation.
+ */
+export const MOCK_TYPE = "mock";
+export var MockProtocol;
+(function (MockProtocol) {
+    MockProtocol["Rest"] = "rest";
+    MockProtocol["Grpc"] = "grpc";
+    MockProtocol["Kafka"] = "kafka";
+})(MockProtocol || (MockProtocol = {}));
 export var HttpMethod;
 (function (HttpMethod) {
     HttpMethod["GET"] = "GET";
@@ -35,15 +46,21 @@ export var RuntimeEnvironment;
 (function (RuntimeEnvironment) {
     RuntimeEnvironment["LOCAL"] = "local";
     RuntimeEnvironment["DOCKER"] = "docker";
-    RuntimeEnvironment["KUBERNETES"] = "kubernetes";
+    RuntimeEnvironment["KUBERNETES"] = "k8s";
 })(RuntimeEnvironment || (RuntimeEnvironment = {}));
+export const runtimeEnvironmentSchema = z.nativeEnum(RuntimeEnvironment);
+export const runtimeEnvironmentInputSchema = z.preprocess((value) => (value === "kubernetes" ? RuntimeEnvironment.KUBERNETES : value), runtimeEnvironmentSchema);
+export function normalizeRuntimeEnvironment(value) {
+    return value === "kubernetes" ? RuntimeEnvironment.KUBERNETES : value;
+}
 export const languageSchema = z.object({
     language: z
         .nativeEnum(ProgrammingLanguage)
         .describe("Programming language for the generated test (default: python). Must be one of: python, typescript, javascript, java"),
     framework: z
         .string()
-        .describe("Testing framework to use (e.g., pytest for python, playwright for javascript and typescript, junit for java, etc.)"),
+        .describe(`Testing framework to use. Supported: ${SUPPORTED_FRAMEWORKS.join(", ")} ` +
+        `(e.g. pytest for python, playwright/vitest/jest for js/ts, junit for java).`),
 });
 export const baseSchema = z.object({
     ...languageSchema.shape,
@@ -51,10 +68,9 @@ export const baseSchema = z.object({
         .boolean()
         .default(false)
         .describe("Whether to deploy the Skyramp dashboard for test monitoring"),
-    runtime: z
-        .nativeEnum(RuntimeEnvironment)
+    runtime: runtimeEnvironmentInputSchema
         .default(RuntimeEnvironment.LOCAL)
-        .describe("Runtime environment (docker, kubernetes, local)"),
+        .describe("Runtime environment (local, docker, or k8s; accepts kubernetes as an alias)"),
     dockerNetwork: z
         .string()
         .default("")
@@ -199,7 +215,9 @@ export const baseTestSchema = {
     queryParams: z
         .string()
         .default("")
-        .describe("MUST be string of comma separated values like 'id=1,name=John' for URL query parameters"),
+        .describe("MUST be string of comma separated values like 'id=1,name=John' for URL query parameters. "
+        + "Workspace-configured api.defaultQueryParams (if set) are merged in automatically — "
+        + "no need to repeat them here. An explicit value for the same key here overrides the workspace default."),
     formParams: z
         .string()
         .default("")