@qulib/core 0.2.1 → 0.3.0

package/dist/schemas/config.schema.d.ts

@@ -168,7 +168,9 @@ export declare const HarnessConfigSchema: z.ZodObject<{
     timeoutMs: z.ZodNumber;
     retryCount: z.ZodNumber;
     llmTokenBudget: z.ZodNumber;
+    llmMaxOutputTokensPerCall: z.ZodOptional<z.ZodNumber>;
     testGenerationLimit: z.ZodNumber;
+    enableLlmScenarios: z.ZodDefault<z.ZodBoolean>;
     readOnlyMode: z.ZodBoolean;
     requireHumanReview: z.ZodBoolean;
     failOnConsoleError: z.ZodBoolean;
@@ -261,12 +263,14 @@ export declare const HarnessConfigSchema: z.ZodObject<{
     retryCount: number;
     llmTokenBudget: number;
     testGenerationLimit: number;
+    enableLlmScenarios: boolean;
     readOnlyMode: boolean;
     requireHumanReview: boolean;
     failOnConsoleError: boolean;
     explorer: "playwright" | "cypress";
     defaultAdapter: "playwright" | "cypress-e2e" | "cypress-component" | "api" | "accessibility";
     adapters: ("playwright" | "cypress-e2e" | "cypress-component" | "api" | "accessibility")[];
+    llmMaxOutputTokensPerCall?: number | undefined;
     auth?: {
         type: "form-login";
         loginUrl: string;
@@ -298,6 +302,8 @@ export declare const HarnessConfigSchema: z.ZodObject<{
     requireHumanReview: boolean;
     failOnConsoleError: boolean;
     minPagesForConfidence?: number | undefined;
+    llmMaxOutputTokensPerCall?: number | undefined;
+    enableLlmScenarios?: boolean | undefined;
     explorer?: "playwright" | "cypress" | undefined;
     defaultAdapter?: "playwright" | "cypress-e2e" | "cypress-component" | "api" | "accessibility" | undefined;
     adapters?: ("playwright" | "cypress-e2e" | "cypress-component" | "api" | "accessibility")[] | undefined;
@@ -323,6 +329,7 @@ export declare const HarnessConfigSchema: z.ZodObject<{
     } | undefined;
 }>;
 export type HarnessConfig = z.infer<typeof HarnessConfigSchema>;
+export declare function resolveMaxOutputTokensPerLlmCall(config: HarnessConfig): number;
 export declare const DetectedAuthSchema: z.ZodObject<{
     hasAuth: z.ZodBoolean;
     type: z.ZodEnum<["none", "form-login", "oauth", "magic-link", "unknown"]>;
@@ -384,5 +391,362 @@ export declare const DetectedAuthSchema: z.ZodObject<{
     recommendation: string;
 }>;
 export type DetectedAuth = z.infer<typeof DetectedAuthSchema>;
+export declare const AuthPathRequirementsSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObject<{
+    method: z.ZodLiteral<"storage-state">;
+    instruction: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    method: "storage-state";
+    instruction: string;
+}, {
+    method: "storage-state";
+    instruction: string;
+}>, z.ZodObject<{
+    method: z.ZodLiteral<"credentials">;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["text", "password", "email", "select", "checkbox"]>;
+        observedOptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "password" | "text" | "email" | "select" | "checkbox";
+        name: string;
+        label: string;
+        observedOptions: string[];
+    }, {
+        type: "password" | "text" | "email" | "select" | "checkbox";
+        name: string;
+        label: string;
+        observedOptions?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    method: "credentials";
+    fields: {
+        type: "password" | "text" | "email" | "select" | "checkbox";
+        name: string;
+        label: string;
+        observedOptions: string[];
+    }[];
+}, {
+    method: "credentials";
+    fields: {
+        type: "password" | "text" | "email" | "select" | "checkbox";
+        name: string;
+        label: string;
+        observedOptions?: string[] | undefined;
+    }[];
+}>, z.ZodObject<{
+    method: z.ZodLiteral<"unknown">;
+    instruction: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    method: "unknown";
+    instruction: string;
+}, {
+    method: "unknown";
+    instruction: string;
+}>]>;
+export declare const AuthPathSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<["oauth", "oauth-unknown", "form-login", "form-multi", "magic-link", "unknown"]>;
+    provider: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<["built-in", "user-local", "heuristic"]>;
+    automatable: z.ZodBoolean;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    requirements: z.ZodDiscriminatedUnion<"method", [z.ZodObject<{
+        method: z.ZodLiteral<"storage-state">;
+        instruction: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        method: "storage-state";
+        instruction: string;
+    }, {
+        method: "storage-state";
+        instruction: string;
+    }>, z.ZodObject<{
+        method: z.ZodLiteral<"credentials">;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodEnum<["text", "password", "email", "select", "checkbox"]>;
+            observedOptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions: string[];
+        }, {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        method: "credentials";
+        fields: {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions: string[];
+        }[];
+    }, {
+        method: "credentials";
+        fields: {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions?: string[] | undefined;
+        }[];
+    }>, z.ZodObject<{
+        method: z.ZodLiteral<"unknown">;
+        instruction: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        method: "unknown";
+        instruction: string;
+    }, {
+        method: "unknown";
+        instruction: string;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+    provider: string | null;
+    label: string;
+    id: string;
+    source: "built-in" | "user-local" | "heuristic";
+    automatable: boolean;
+    confidence: "high" | "medium" | "low";
+    requirements: {
+        method: "storage-state";
+        instruction: string;
+    } | {
+        method: "credentials";
+        fields: {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions: string[];
+        }[];
+    } | {
+        method: "unknown";
+        instruction: string;
+    };
+}, {
+    type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+    provider: string | null;
+    label: string;
+    id: string;
+    source: "built-in" | "user-local" | "heuristic";
+    automatable: boolean;
+    confidence: "high" | "medium" | "low";
+    requirements: {
+        method: "storage-state";
+        instruction: string;
+    } | {
+        method: "credentials";
+        fields: {
+            type: "password" | "text" | "email" | "select" | "checkbox";
+            name: string;
+            label: string;
+            observedOptions?: string[] | undefined;
+        }[];
+    } | {
+        method: "unknown";
+        instruction: string;
+    };
+}>;
+export declare const AuthExplorationSchema: z.ZodObject<{
+    url: z.ZodString;
+    authRequired: z.ZodBoolean;
+    authScope: z.ZodEnum<["site-wide", "section-only", "optional", "none"]>;
+    authPaths: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["oauth", "oauth-unknown", "form-login", "form-multi", "magic-link", "unknown"]>;
+        provider: z.ZodNullable<z.ZodString>;
+        source: z.ZodEnum<["built-in", "user-local", "heuristic"]>;
+        automatable: z.ZodBoolean;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        requirements: z.ZodDiscriminatedUnion<"method", [z.ZodObject<{
+            method: z.ZodLiteral<"storage-state">;
+            instruction: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            method: "storage-state";
+            instruction: string;
+        }, {
+            method: "storage-state";
+            instruction: string;
+        }>, z.ZodObject<{
+            method: z.ZodLiteral<"credentials">;
+            fields: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodEnum<["text", "password", "email", "select", "checkbox"]>;
+                observedOptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions: string[];
+            }, {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions?: string[] | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions: string[];
+            }[];
+        }, {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions?: string[] | undefined;
+            }[];
+        }>, z.ZodObject<{
+            method: z.ZodLiteral<"unknown">;
+            instruction: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            method: "unknown";
+            instruction: string;
+        }, {
+            method: "unknown";
+            instruction: string;
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+        provider: string | null;
+        label: string;
+        id: string;
+        source: "built-in" | "user-local" | "heuristic";
+        automatable: boolean;
+        confidence: "high" | "medium" | "low";
+        requirements: {
+            method: "storage-state";
+            instruction: string;
+        } | {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions: string[];
+            }[];
+        } | {
+            method: "unknown";
+            instruction: string;
+        };
+    }, {
+        type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+        provider: string | null;
+        label: string;
+        id: string;
+        source: "built-in" | "user-local" | "heuristic";
+        automatable: boolean;
+        confidence: "high" | "medium" | "low";
+        requirements: {
+            method: "storage-state";
+            instruction: string;
+        } | {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions?: string[] | undefined;
+            }[];
+        } | {
+            method: "unknown";
+            instruction: string;
+        };
+    }>, "many">;
+    observedAt: z.ZodString;
+    suggestedAgentBehavior: z.ZodString;
+    unrecognizedButtons: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        hint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        hint: string;
+    }, {
+        label: string;
+        hint: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    authRequired: boolean;
+    authScope: "none" | "site-wide" | "section-only" | "optional";
+    authPaths: {
+        type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+        provider: string | null;
+        label: string;
+        id: string;
+        source: "built-in" | "user-local" | "heuristic";
+        automatable: boolean;
+        confidence: "high" | "medium" | "low";
+        requirements: {
+            method: "storage-state";
+            instruction: string;
+        } | {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions: string[];
+            }[];
+        } | {
+            method: "unknown";
+            instruction: string;
+        };
+    }[];
+    observedAt: string;
+    suggestedAgentBehavior: string;
+    unrecognizedButtons: {
+        label: string;
+        hint: string;
+    }[];
+}, {
+    url: string;
+    authRequired: boolean;
+    authScope: "none" | "site-wide" | "section-only" | "optional";
+    authPaths: {
+        type: "unknown" | "form-login" | "oauth" | "magic-link" | "oauth-unknown" | "form-multi";
+        provider: string | null;
+        label: string;
+        id: string;
+        source: "built-in" | "user-local" | "heuristic";
+        automatable: boolean;
+        confidence: "high" | "medium" | "low";
+        requirements: {
+            method: "storage-state";
+            instruction: string;
+        } | {
+            method: "credentials";
+            fields: {
+                type: "password" | "text" | "email" | "select" | "checkbox";
+                name: string;
+                label: string;
+                observedOptions?: string[] | undefined;
+            }[];
+        } | {
+            method: "unknown";
+            instruction: string;
+        };
+    }[];
+    observedAt: string;
+    suggestedAgentBehavior: string;
+    unrecognizedButtons?: {
+        label: string;
+        hint: string;
+    }[] | undefined;
+}>;
+export type AuthPathRequirements = z.infer<typeof AuthPathRequirementsSchema>;
+export type AuthPath = z.infer<typeof AuthPathSchema>;
+export type AuthExploration = z.infer<typeof AuthExplorationSchema>;
 export {};
 //# sourceMappingURL=config.schema.d.ts.map

package/dist/schemas/config.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,mBAAmB,GAAG,KAAK,GAAG,eAAe,CAAC;AAEvG,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBvB,CAAC;AAEH,QAAA,MAAM,sBAAsB;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAA8E,CAAC;AAE5G,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"config.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,mBAAmB,GAAG,KAAK,GAAG,eAAe,CAAC;AAEvG,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBvB,CAAC;AAEH,QAAA,MAAM,sBAAsB;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAA8E,CAAC;AAE5G,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE9E;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcrC,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAehC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/config.schema.js

@@ -27,8 +27,22 @@ export const HarnessConfigSchema = z.object({
     minPagesForConfidence: z.number().int().min(1).default(3),
     timeoutMs: z.number().int().positive(),
     retryCount: z.number().int().min(0),
-    llmTokenBudget: z.number().int().positive(),
+    llmTokenBudget: z
+        .number()
+        .int()
+        .positive()
+        .describe('Legacy name: max output tokens for a single LLM completion request. Prefer llmMaxOutputTokensPerCall when set.'),
+    llmMaxOutputTokensPerCall: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('When set, overrides llmTokenBudget (same semantics: per-completion output cap, not a multi-call total).'),
     testGenerationLimit: z.number().int().positive(),
+    enableLlmScenarios: z
+        .boolean()
+        .default(true)
+        .describe('When false, scenario generation uses templates only (no LLM calls).'),
     readOnlyMode: z.boolean(),
     requireHumanReview: z.boolean(),
     failOnConsoleError: z.boolean(),
@@ -37,6 +51,9 @@ export const HarnessConfigSchema = z.object({
     adapters: z.array(z.enum(['playwright', 'cypress-e2e', 'cypress-component', 'api', 'accessibility'])).default(['playwright']),
     auth: AuthConfigSchema.optional(),
 });
+export function resolveMaxOutputTokensPerLlmCall(config) {
+    return config.llmMaxOutputTokensPerCall ?? config.llmTokenBudget;
+}
 export const DetectedAuthSchema = z.object({
     hasAuth: z.boolean(),
     type: z.enum(['none', 'form-login', 'oauth', 'magic-link', 'unknown']),
@@ -55,3 +72,40 @@ export const DetectedAuthSchema = z.object({
     })),
     recommendation: z.string(),
 });
+export const AuthPathRequirementsSchema = z.discriminatedUnion('method', [
+    z.object({ method: z.literal('storage-state'), instruction: z.string() }),
+    z.object({
+        method: z.literal('credentials'),
+        fields: z.array(z.object({
+            name: z.string(),
+            label: z.string(),
+            type: z.enum(['text', 'password', 'email', 'select', 'checkbox']),
+            observedOptions: z.array(z.string()).default([]),
+        })),
+    }),
+    z.object({ method: z.literal('unknown'), instruction: z.string() }),
+]);
+export const AuthPathSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    type: z.enum(['oauth', 'oauth-unknown', 'form-login', 'form-multi', 'magic-link', 'unknown']),
+    provider: z.string().nullable(),
+    source: z.enum(['built-in', 'user-local', 'heuristic']),
+    automatable: z.boolean(),
+    confidence: z.enum(['high', 'medium', 'low']),
+    requirements: AuthPathRequirementsSchema,
+});
+export const AuthExplorationSchema = z.object({
+    url: z.string(),
+    authRequired: z.boolean(),
+    authScope: z.enum(['site-wide', 'section-only', 'optional', 'none']),
+    authPaths: z.array(AuthPathSchema),
+    observedAt: z.string(),
+    suggestedAgentBehavior: z.string(),
+    unrecognizedButtons: z
+        .array(z.object({
+        label: z.string(),
+        hint: z.string(),
+    }))
+        .default([]),
+});