@gaunt-sloth/core 2.0.0-alpha.2 → 2.0.0-alpha.4

package/dist/config/schema.d.ts

@@ -0,0 +1,471 @@
+/**
+ * @packageDocumentation
+ * Zod schema for the on-disk raw Gaunt Sloth config (`RawGthConfig`).
+ *
+ * This is the single source of truth for config validation and for the generated
+ * JSON Schema (`packages/core/schema/gsloth-config.schema.json`). It models the
+ * canonical config shape only — the deprecated aliases (`contentProvider`,
+ * `requirementsProvider`, `contentProviderConfig`, `requirementsProviderConfig`)
+ * are intentionally NOT part of the schema. The loader maps those one-way to the
+ * canonical names ({@link preMapDeprecatedConfigNames}) BEFORE validating, so by
+ * the time a config reaches the schema it only uses canonical names.
+ *
+ * Design notes:
+ * - The top-level object is a {@link z.looseObject} so unknown keys PASS THROUGH
+ *   (they are neither stripped nor a hard failure). The loader separately diffs
+ *   present-vs-known top-level keys ({@link findUnknownTopLevelKeys}) to warn about
+ *   likely typos without failing.
+ * - Every field is optional. The schema validates the *shape/type of what is
+ *   present*, not requiredness. In particular `llm` is optional so the loader's
+ *   existing "must at least define llm.type" checks remain the authority on llm
+ *   validity (and keep emitting their established messages).
+ * - Runtime-object-bearing fields (`tools`, `middleware`, `mcpServers`,
+ *   `a2aAgents`, `builtInToolsConfig`) are modelled permissively because JS/MJS
+ *   `configure()` returns live instances/objects there.
+ *
+ * The exported {@link RawGthConfig}/{@link GthConfig} interfaces in `config.ts`
+ * remain the public type surface; the `z.infer` here ({@link RawGthConfigInput})
+ * is additive and legitimately differs (no deprecated fields).
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for the raw, on-disk Gaunt Sloth config. Loose at the top level so
+ * unknown keys are preserved (warn-only via {@link findUnknownTopLevelKeys}).
+ */
+export declare const rawGthConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    llm: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        apiKeyEnvironmentVariable: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            binary: "binary";
+            image: "image";
+            audio: "audio";
+            video: "video";
+            file: "file";
+        }>;
+        extensions: z.ZodArray<z.ZodString>;
+        maxSize: z.ZodOptional<z.ZodNumber>;
+        mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>]>>;
+    contentSource: z.ZodOptional<z.ZodString>;
+    requirementSource: z.ZodOptional<z.ZodString>;
+    contentSourceConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    requirementSourceConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    projectGuidelines: z.ZodOptional<z.ZodString>;
+    identityProfile: z.ZodOptional<z.ZodString>;
+    includeCurrentDateAfterGuidelines: z.ZodOptional<z.ZodBoolean>;
+    organization: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    projectReviewInstructions: z.ZodOptional<z.ZodString>;
+    noDefaultPrompts: z.ZodOptional<z.ZodBoolean>;
+    filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+        all: "all";
+        read: "read";
+        none: "none";
+    }>]>>;
+    builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    middleware: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    streamOutput: z.ZodOptional<z.ZodBoolean>;
+    writeOutputToFile: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    writeBinaryOutputsToFile: z.ZodOptional<z.ZodBoolean>;
+    useColour: z.ZodOptional<z.ZodBoolean>;
+    streamSessionInferenceLog: z.ZodOptional<z.ZodBoolean>;
+    canInterruptInferenceWithEsc: z.ZodOptional<z.ZodBoolean>;
+    debugLog: z.ZodOptional<z.ZodBoolean>;
+    recursionLimit: z.ZodOptional<z.ZodNumber>;
+    consoleLevel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    customTools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodString;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+            allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "absolute-paths": "absolute-paths";
+                "directory-traversal": "directory-traversal";
+                "shell-injection": "shell-injection";
+                "null-bytes": "null-bytes";
+            }>>>;
+        }, z.core.$strip>>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    a2aAgents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    builtInToolsConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    aiignore: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    commands: z.ZodOptional<z.ZodObject<{
+        pr: z.ZodOptional<z.ZodObject<{
+            contentSource: z.ZodOptional<z.ZodString>;
+            requirementSource: z.ZodOptional<z.ZodString>;
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            logWorkForReviewInSeconds: z.ZodOptional<z.ZodNumber>;
+            rating: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                passThreshold: z.ZodOptional<z.ZodNumber>;
+                maxRating: z.ZodOptional<z.ZodNumber>;
+                minRating: z.ZodOptional<z.ZodNumber>;
+                errorOnReviewFail: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        review: z.ZodOptional<z.ZodObject<{
+            contentSource: z.ZodOptional<z.ZodString>;
+            requirementSource: z.ZodOptional<z.ZodString>;
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            rating: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                passThreshold: z.ZodOptional<z.ZodNumber>;
+                maxRating: z.ZodOptional<z.ZodNumber>;
+                minRating: z.ZodOptional<z.ZodNumber>;
+                errorOnReviewFail: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        ask: z.ZodOptional<z.ZodObject<{
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            devTools: z.ZodOptional<z.ZodObject<{
+                run_tests: z.ZodOptional<z.ZodString>;
+                run_lint: z.ZodOptional<z.ZodString>;
+                run_build: z.ZodOptional<z.ZodString>;
+                run_single_test: z.ZodOptional<z.ZodString>;
+                shell: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+                    allowlist: z.ZodOptional<z.ZodBoolean>;
+                    persistAllowlist: z.ZodOptional<z.ZodBoolean>;
+                    judge: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        autoApproveLow: z.ZodOptional<z.ZodBoolean>;
+                        blockHigh: z.ZodOptional<z.ZodBoolean>;
+                        model: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodOptional<z.ZodString>;
+                            model: z.ZodOptional<z.ZodString>;
+                            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            apiKeyEnvironmentVariable: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>;
+                    }, z.core.$strip>]>>;
+                }, z.core.$strip>]>>;
+                shellYolo: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        chat: z.ZodOptional<z.ZodObject<{
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        code: z.ZodOptional<z.ZodObject<{
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            devTools: z.ZodOptional<z.ZodObject<{
+                run_tests: z.ZodOptional<z.ZodString>;
+                run_lint: z.ZodOptional<z.ZodString>;
+                run_build: z.ZodOptional<z.ZodString>;
+                run_single_test: z.ZodOptional<z.ZodString>;
+                shell: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+                    allowlist: z.ZodOptional<z.ZodBoolean>;
+                    persistAllowlist: z.ZodOptional<z.ZodBoolean>;
+                    judge: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        autoApproveLow: z.ZodOptional<z.ZodBoolean>;
+                        blockHigh: z.ZodOptional<z.ZodBoolean>;
+                        model: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodOptional<z.ZodString>;
+                            model: z.ZodOptional<z.ZodString>;
+                            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            apiKeyEnvironmentVariable: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>;
+                    }, z.core.$strip>]>>;
+                }, z.core.$strip>]>>;
+                shellYolo: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        exec: z.ZodOptional<z.ZodObject<{
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodObject<{
+                command: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodString;
+                    allow: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        "absolute-paths": "absolute-paths";
+                        "directory-traversal": "directory-traversal";
+                        "shell-injection": "shell-injection";
+                        "null-bytes": "null-bytes";
+                    }>>>;
+                }, z.core.$strip>>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>]>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            devTools: z.ZodOptional<z.ZodObject<{
+                run_tests: z.ZodOptional<z.ZodString>;
+                run_lint: z.ZodOptional<z.ZodString>;
+                run_build: z.ZodOptional<z.ZodString>;
+                run_single_test: z.ZodOptional<z.ZodString>;
+                shell: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+                    allowlist: z.ZodOptional<z.ZodBoolean>;
+                    persistAllowlist: z.ZodOptional<z.ZodBoolean>;
+                    judge: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        autoApproveLow: z.ZodOptional<z.ZodBoolean>;
+                        blockHigh: z.ZodOptional<z.ZodBoolean>;
+                        model: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodOptional<z.ZodString>;
+                            model: z.ZodOptional<z.ZodString>;
+                            configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            apiKeyEnvironmentVariable: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>;
+                    }, z.core.$strip>]>>;
+                }, z.core.$strip>]>>;
+                shellYolo: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            binaryFormats: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    binary: "binary";
+                    image: "image";
+                    audio: "audio";
+                    video: "video";
+                    file: "file";
+                }>;
+                extensions: z.ZodArray<z.ZodString>;
+                maxSize: z.ZodOptional<z.ZodNumber>;
+                mimeTypes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>]>>;
+        }, z.core.$strip>>;
+        api: z.ZodOptional<z.ZodObject<{
+            filesystem: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodEnum<{
+                all: "all";
+                read: "read";
+                none: "none";
+            }>]>>;
+            builtInTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            port: z.ZodOptional<z.ZodNumber>;
+            cors: z.ZodOptional<z.ZodObject<{
+                allowOrigin: z.ZodOptional<z.ZodString>;
+                allowMethods: z.ZodOptional<z.ZodString>;
+                allowHeaders: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    modelDisplayName: z.ZodOptional<z.ZodString>;
+    allowDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    askWriteMode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+/**
+ * Type inferred from {@link rawGthConfigSchema}. This is additive and intentionally
+ * separate from the hand-written `RawGthConfig` interface in `config.ts` (it omits
+ * the deprecated aliases). Prefer `RawGthConfig` for the public surface.
+ */
+export type RawGthConfigInput = z.infer<typeof rawGthConfigSchema>;
+/**
+ * The set of known top-level config keys, derived from the schema shape so it can
+ * never drift from {@link rawGthConfigSchema}. Includes `$schema`.
+ */
+export declare const KNOWN_TOP_LEVEL_KEYS: ReadonlySet<string>;
+/**
+ * Return the top-level keys present in `raw` that are not part of the known config
+ * surface. Deprecated aliases should be pre-mapped away first (see
+ * {@link preMapDeprecatedConfigNames}) so they do not show up here.
+ */
+export declare function findUnknownTopLevelKeys(raw: Record<string, unknown>): string[];
+/**
+ * Render a friendly, path-scoped validation message from a Zod error. Each issue
+ * becomes a line `  - <path>: <message>`, with `(root)` for top-level issues.
+ */
+export declare function formatConfigValidationError(error: z.ZodError): string;
+/**
+ * B3 — one-way pre-map of deprecated config key names to their canonical names, at
+ * the config root AND per-command. Mutates `raw` in place (it is always a freshly
+ * loaded config layer) and returns it alongside a list of deprecation warnings the
+ * caller should emit via `displayWarning`. Canonical names win when both are
+ * present; the deprecated key is always removed so it does not later surface as an
+ * "unknown top-level key".
+ */
+export declare function preMapDeprecatedConfigNames<T extends Record<string, unknown>>(raw: T): {
+    config: T;
+    warnings: string[];
+};
+/**
+ * Generate the JSON Schema for the raw config from {@link rawGthConfigSchema} using
+ * zod 4's native `z.toJSONSchema`. The output is committed to
+ * `packages/core/schema/gsloth-config.schema.json` and asserted by a golden test.
+ */
+export declare function generateConfigJsonSchema(): Record<string, unknown>;