@cogitator-ai/config 0.28.0 → 0.30.0

package/dist/schema.d.ts

@@ -434,6 +434,7 @@ export declare const LLMConfigSchema: z.ZodObject<{
         resetTimeout: z.ZodOptional<z.ZodNumber>;
         halfOpenRequests: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    modelAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export declare const LimitsConfigSchema: z.ZodObject<{
@@ -1541,6 +1542,576 @@ export declare const SessionBudgetConfigSchema: z.ZodObject<{
     warnAt: z.ZodOptional<z.ZodNumber>;
     allowRaise: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/** One hook handler of a settings file's `hooks`, see `HookHandlerConfig` */
+export declare const HookHandlerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    if: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    onFailure: z.ZodOptional<z.ZodEnum<{
+        block: "block";
+        continue: "continue";
+    }>>;
+    type: z.ZodLiteral<"command">;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    shell: z.ZodOptional<z.ZodEnum<{
+        bash: "bash";
+        powershell: "powershell";
+    }>>;
+    async: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    if: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    onFailure: z.ZodOptional<z.ZodEnum<{
+        block: "block";
+        continue: "continue";
+    }>>;
+    type: z.ZodLiteral<"http">;
+    url: z.ZodURL;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    if: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    onFailure: z.ZodOptional<z.ZodEnum<{
+        block: "block";
+        continue: "continue";
+    }>>;
+    type: z.ZodLiteral<"prompt">;
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    if: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    onFailure: z.ZodOptional<z.ZodEnum<{
+        block: "block";
+        continue: "continue";
+    }>>;
+    type: z.ZodLiteral<"mcp_tool">;
+    server: z.ZodString;
+    tool: z.ZodString;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>], "type">;
+/** The hooks by event, as a settings file writes them, see `HookSettings` */
+export declare const HookSettingsSchema: z.ZodRecord<z.ZodEnum<{
+    SessionStart: "SessionStart";
+    SessionEnd: "SessionEnd";
+    UserPromptSubmit: "UserPromptSubmit";
+    PreToolUse: "PreToolUse";
+    PermissionRequest: "PermissionRequest";
+    PostToolUse: "PostToolUse";
+    PostToolUseFailure: "PostToolUseFailure";
+    PostToolBatch: "PostToolBatch";
+    SubagentStart: "SubagentStart";
+    SubagentStop: "SubagentStop";
+    PreCompact: "PreCompact";
+    PostCompact: "PostCompact";
+    PreModelSwitch: "PreModelSwitch";
+    Stop: "Stop";
+    Notification: "Notification";
+}> & z.core.$partial, z.ZodArray<z.ZodObject<{
+    matcher: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        statusMessage: z.ZodOptional<z.ZodString>;
+        onFailure: z.ZodOptional<z.ZodEnum<{
+            block: "block";
+            continue: "continue";
+        }>>;
+        type: z.ZodLiteral<"command">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        shell: z.ZodOptional<z.ZodEnum<{
+            bash: "bash";
+            powershell: "powershell";
+        }>>;
+        async: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        statusMessage: z.ZodOptional<z.ZodString>;
+        onFailure: z.ZodOptional<z.ZodEnum<{
+            block: "block";
+            continue: "continue";
+        }>>;
+        type: z.ZodLiteral<"http">;
+        url: z.ZodURL;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        statusMessage: z.ZodOptional<z.ZodString>;
+        onFailure: z.ZodOptional<z.ZodEnum<{
+            block: "block";
+            continue: "continue";
+        }>>;
+        type: z.ZodLiteral<"prompt">;
+        prompt: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        statusMessage: z.ZodOptional<z.ZodString>;
+        onFailure: z.ZodOptional<z.ZodEnum<{
+            block: "block";
+            continue: "continue";
+        }>>;
+        type: z.ZodLiteral<"mcp_tool">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>>>;
+/**
+ * The hooks of the runtime, see `HooksConfig`. The MCP caller and `onHookRun` are given in code
+ * only
+ */
+export declare const HooksConfigSchema: z.ZodObject<{
+    hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        SessionStart: "SessionStart";
+        SessionEnd: "SessionEnd";
+        UserPromptSubmit: "UserPromptSubmit";
+        PreToolUse: "PreToolUse";
+        PermissionRequest: "PermissionRequest";
+        PostToolUse: "PostToolUse";
+        PostToolUseFailure: "PostToolUseFailure";
+        PostToolBatch: "PostToolBatch";
+        SubagentStart: "SubagentStart";
+        SubagentStop: "SubagentStop";
+        PreCompact: "PreCompact";
+        PostCompact: "PostCompact";
+        PreModelSwitch: "PreModelSwitch";
+        Stop: "Stop";
+        Notification: "Notification";
+    }> & z.core.$partial, z.ZodArray<z.ZodObject<{
+        matcher: z.ZodOptional<z.ZodString>;
+        hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"command">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            shell: z.ZodOptional<z.ZodEnum<{
+                bash: "bash";
+                powershell: "powershell";
+            }>>;
+            async: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"http">;
+            url: z.ZodURL;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"prompt">;
+            prompt: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"mcp_tool">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>>>;
+    settings: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        root: z.ZodOptional<z.ZodString>;
+        userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            user: "user";
+            local: "local";
+            project: "project";
+            managed: "managed";
+        }>>>;
+        trusted: z.ZodOptional<z.ZodBoolean>;
+        trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>;
+    promptModel: z.ZodOptional<z.ZodString>;
+    allowedHttpHookUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    httpHookAllowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+    env: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"inherit">, z.ZodObject<{
+        allow: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+/** Which project instruction files runs read, see `ProjectInstructionsOptions` */
+export declare const ProjectInstructionsOptionsSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rules: z.ZodOptional<z.ZodBoolean>;
+    nested: z.ZodOptional<z.ZodBoolean>;
+    maxImportDepth: z.ZodOptional<z.ZodNumber>;
+    allowImportsFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxChars: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Instructions the runtime adds to agents' prompts, see `InstructionsConfig` */
+export declare const InstructionsConfigSchema: z.ZodObject<{
+    projectFiles: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        rules: z.ZodOptional<z.ZodBoolean>;
+        nested: z.ZodOptional<z.ZodBoolean>;
+        maxImportDepth: z.ZodOptional<z.ZodNumber>;
+        allowImportsFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxChars: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+/** Where Markdown subagents and commands are read, see `DefinitionFileOptions` */
+export declare const DefinitionFileOptionsSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+    userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    trusted: z.ZodOptional<z.ZodBoolean>;
+    trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** A subagent in code, as an entry of Claude Code's `--agents` JSON, see `SubagentDefinitionInput` */
+export declare const SubagentDefinitionSchema: z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    permissionMode: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        acceptEdits: "acceptEdits";
+        plan: "plan";
+        auto: "auto";
+        bypassPermissions: "bypassPermissions";
+        dontAsk: "dontAsk";
+    }>>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>]>>>;
+    hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        SessionStart: "SessionStart";
+        SessionEnd: "SessionEnd";
+        UserPromptSubmit: "UserPromptSubmit";
+        PreToolUse: "PreToolUse";
+        PermissionRequest: "PermissionRequest";
+        PostToolUse: "PostToolUse";
+        PostToolUseFailure: "PostToolUseFailure";
+        PostToolBatch: "PostToolBatch";
+        SubagentStart: "SubagentStart";
+        SubagentStop: "SubagentStop";
+        PreCompact: "PreCompact";
+        PostCompact: "PostCompact";
+        PreModelSwitch: "PreModelSwitch";
+        Stop: "Stop";
+        Notification: "Notification";
+    }> & z.core.$partial, z.ZodArray<z.ZodObject<{
+        matcher: z.ZodOptional<z.ZodString>;
+        hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"command">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            shell: z.ZodOptional<z.ZodEnum<{
+                bash: "bash";
+                powershell: "powershell";
+            }>>;
+            async: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"http">;
+            url: z.ZodURL;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"prompt">;
+            prompt: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            statusMessage: z.ZodOptional<z.ZodString>;
+            onFailure: z.ZodOptional<z.ZodEnum<{
+                block: "block";
+                continue: "continue";
+            }>>;
+            type: z.ZodLiteral<"mcp_tool">;
+            server: z.ZodString;
+            tool: z.ZodString;
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>>>;
+    memory: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        local: "local";
+        project: "project";
+    }>>;
+    background: z.ZodOptional<z.ZodBoolean>;
+    isolation: z.ZodOptional<z.ZodLiteral<"worktree">>;
+    color: z.ZodOptional<z.ZodEnum<{
+        red: "red";
+        blue: "blue";
+        green: "green";
+        yellow: "yellow";
+        purple: "purple";
+        orange: "orange";
+        pink: "pink";
+        cyan: "cyan";
+    }>>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+}, z.core.$strip>;
+/**
+ * The subagents of the runtime, see `SubagentsConfig`. The MCP connector, a message filter
+ * function and the delegation callbacks are given in code only
+ */
+export declare const SubagentsConfigSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        root: z.ZodOptional<z.ZodString>;
+        userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        trusted: z.ZodOptional<z.ZodBoolean>;
+        trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        permissionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            acceptEdits: "acceptEdits";
+            plan: "plan";
+            auto: "auto";
+            bypassPermissions: "bypassPermissions";
+            dontAsk: "dontAsk";
+        }>>;
+        maxTurns: z.ZodOptional<z.ZodNumber>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mcpServers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>]>>>;
+        hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            SessionStart: "SessionStart";
+            SessionEnd: "SessionEnd";
+            UserPromptSubmit: "UserPromptSubmit";
+            PreToolUse: "PreToolUse";
+            PermissionRequest: "PermissionRequest";
+            PostToolUse: "PostToolUse";
+            PostToolUseFailure: "PostToolUseFailure";
+            PostToolBatch: "PostToolBatch";
+            SubagentStart: "SubagentStart";
+            SubagentStop: "SubagentStop";
+            PreCompact: "PreCompact";
+            PostCompact: "PostCompact";
+            PreModelSwitch: "PreModelSwitch";
+            Stop: "Stop";
+            Notification: "Notification";
+        }> & z.core.$partial, z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                shell: z.ZodOptional<z.ZodEnum<{
+                    bash: "bash";
+                    powershell: "powershell";
+                }>>;
+                async: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"http">;
+                url: z.ZodURL;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"prompt">;
+                prompt: z.ZodString;
+                model: z.ZodOptional<z.ZodString>;
+                continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"mcp_tool">;
+                server: z.ZodString;
+                tool: z.ZodString;
+                input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>>>>;
+        memory: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            local: "local";
+            project: "project";
+        }>>;
+        background: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodLiteral<"worktree">>;
+        color: z.ZodOptional<z.ZodEnum<{
+            red: "red";
+            blue: "blue";
+            green: "green";
+            yellow: "yellow";
+            purple: "purple";
+            orange: "orange";
+            pink: "pink";
+            cyan: "cyan";
+        }>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+    }, z.core.$strip>>>;
+    approvalMode: z.ZodOptional<z.ZodEnum<{
+        bubble: "bubble";
+        decline: "decline";
+    }>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        each: "each";
+        both: "both";
+    }>>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    maxBackground: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        conversation: "conversation";
+    }>>;
+}, z.core.$strip>;
+/** A command in code, see `CommandDefinitionInput` */
+export declare const CommandDefinitionSchema: z.ZodObject<{
+    template: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    argumentHint: z.ZodOptional<z.ZodString>;
+    arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+}, z.core.$strip>;
+/** The commands of the runtime, see `CommandsConfig` */
+export declare const CommandsConfigSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        root: z.ZodOptional<z.ZodString>;
+        userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        trusted: z.ZodOptional<z.ZodBoolean>;
+        trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>]>>;
+    commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        template: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        argumentHint: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>;
 /** What a run does when its thread has a run going on, see `CogitatorConfig.multitaskStrategy` */
 export declare const MultitaskStrategySchema: z.ZodEnum<{
     interrupt: "interrupt";
@@ -1743,6 +2314,7 @@ export declare const CogitatorConfigSchema: z.ZodObject<{
             resetTimeout: z.ZodOptional<z.ZodNumber>;
             halfOpenRequests: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        modelAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
     multitaskStrategy: z.ZodOptional<z.ZodEnum<{
@@ -1807,6 +2379,282 @@ export declare const CogitatorConfigSchema: z.ZodObject<{
             project: "project";
         }>>>;
     }, z.core.$strip>>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            SessionStart: "SessionStart";
+            SessionEnd: "SessionEnd";
+            UserPromptSubmit: "UserPromptSubmit";
+            PreToolUse: "PreToolUse";
+            PermissionRequest: "PermissionRequest";
+            PostToolUse: "PostToolUse";
+            PostToolUseFailure: "PostToolUseFailure";
+            PostToolBatch: "PostToolBatch";
+            SubagentStart: "SubagentStart";
+            SubagentStop: "SubagentStop";
+            PreCompact: "PreCompact";
+            PostCompact: "PostCompact";
+            PreModelSwitch: "PreModelSwitch";
+            Stop: "Stop";
+            Notification: "Notification";
+        }> & z.core.$partial, z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                shell: z.ZodOptional<z.ZodEnum<{
+                    bash: "bash";
+                    powershell: "powershell";
+                }>>;
+                async: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"http">;
+                url: z.ZodURL;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"prompt">;
+                prompt: z.ZodString;
+                model: z.ZodOptional<z.ZodString>;
+                continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                if: z.ZodOptional<z.ZodString>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                onFailure: z.ZodOptional<z.ZodEnum<{
+                    block: "block";
+                    continue: "continue";
+                }>>;
+                type: z.ZodLiteral<"mcp_tool">;
+                server: z.ZodString;
+                tool: z.ZodString;
+                input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>>>>;
+        settings: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            root: z.ZodOptional<z.ZodString>;
+            userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            layers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                user: "user";
+                local: "local";
+                project: "project";
+                managed: "managed";
+            }>>>;
+            trusted: z.ZodOptional<z.ZodBoolean>;
+            trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>;
+        promptModel: z.ZodOptional<z.ZodString>;
+        allowedHttpHookUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        httpHookAllowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+        env: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"inherit">, z.ZodObject<{
+            allow: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+    instructions: z.ZodOptional<z.ZodObject<{
+        projectFiles: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            rules: z.ZodOptional<z.ZodBoolean>;
+            nested: z.ZodOptional<z.ZodBoolean>;
+            maxImportDepth: z.ZodOptional<z.ZodNumber>;
+            allowImportsFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            maxChars: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+    subagents: z.ZodOptional<z.ZodObject<{
+        files: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            root: z.ZodOptional<z.ZodString>;
+            userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            dirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            trusted: z.ZodOptional<z.ZodBoolean>;
+            trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>;
+        agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            model: z.ZodOptional<z.ZodString>;
+            permissionMode: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                acceptEdits: "acceptEdits";
+                plan: "plan";
+                auto: "auto";
+                bypassPermissions: "bypassPermissions";
+                dontAsk: "dontAsk";
+            }>>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mcpServers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>]>>>;
+            hooks: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+                SessionStart: "SessionStart";
+                SessionEnd: "SessionEnd";
+                UserPromptSubmit: "UserPromptSubmit";
+                PreToolUse: "PreToolUse";
+                PermissionRequest: "PermissionRequest";
+                PostToolUse: "PostToolUse";
+                PostToolUseFailure: "PostToolUseFailure";
+                PostToolBatch: "PostToolBatch";
+                SubagentStart: "SubagentStart";
+                SubagentStop: "SubagentStop";
+                PreCompact: "PreCompact";
+                PostCompact: "PostCompact";
+                PreModelSwitch: "PreModelSwitch";
+                Stop: "Stop";
+                Notification: "Notification";
+            }> & z.core.$partial, z.ZodArray<z.ZodObject<{
+                matcher: z.ZodOptional<z.ZodString>;
+                hooks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    if: z.ZodOptional<z.ZodString>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    statusMessage: z.ZodOptional<z.ZodString>;
+                    onFailure: z.ZodOptional<z.ZodEnum<{
+                        block: "block";
+                        continue: "continue";
+                    }>>;
+                    type: z.ZodLiteral<"command">;
+                    command: z.ZodString;
+                    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    shell: z.ZodOptional<z.ZodEnum<{
+                        bash: "bash";
+                        powershell: "powershell";
+                    }>>;
+                    async: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>, z.ZodObject<{
+                    if: z.ZodOptional<z.ZodString>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    statusMessage: z.ZodOptional<z.ZodString>;
+                    onFailure: z.ZodOptional<z.ZodEnum<{
+                        block: "block";
+                        continue: "continue";
+                    }>>;
+                    type: z.ZodLiteral<"http">;
+                    url: z.ZodURL;
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    allowedEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    if: z.ZodOptional<z.ZodString>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    statusMessage: z.ZodOptional<z.ZodString>;
+                    onFailure: z.ZodOptional<z.ZodEnum<{
+                        block: "block";
+                        continue: "continue";
+                    }>>;
+                    type: z.ZodLiteral<"prompt">;
+                    prompt: z.ZodString;
+                    model: z.ZodOptional<z.ZodString>;
+                    continueOnBlock: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>, z.ZodObject<{
+                    if: z.ZodOptional<z.ZodString>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    statusMessage: z.ZodOptional<z.ZodString>;
+                    onFailure: z.ZodOptional<z.ZodEnum<{
+                        block: "block";
+                        continue: "continue";
+                    }>>;
+                    type: z.ZodLiteral<"mcp_tool">;
+                    server: z.ZodString;
+                    tool: z.ZodString;
+                    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>], "type">>;
+            }, z.core.$strip>>>>;
+            memory: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                local: "local";
+                project: "project";
+            }>>;
+            background: z.ZodOptional<z.ZodBoolean>;
+            isolation: z.ZodOptional<z.ZodLiteral<"worktree">>;
+            color: z.ZodOptional<z.ZodEnum<{
+                red: "red";
+                blue: "blue";
+                green: "green";
+                yellow: "yellow";
+                purple: "purple";
+                orange: "orange";
+                pink: "pink";
+                cyan: "cyan";
+            }>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strip>>>;
+        approvalMode: z.ZodOptional<z.ZodEnum<{
+            bubble: "bubble";
+            decline: "decline";
+        }>>;
+        tools: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            each: "each";
+            both: "both";
+        }>>;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+        maxBackground: z.ZodOptional<z.ZodNumber>;
+        messages: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            conversation: "conversation";
+        }>>;
+    }, z.core.$strip>>;
+    commands: z.ZodOptional<z.ZodObject<{
+        files: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            root: z.ZodOptional<z.ZodString>;
+            userDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            managedDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            dirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            trusted: z.ZodOptional<z.ZodBoolean>;
+            trustedRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>;
+        commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            template: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            argumentHint: z.ZodOptional<z.ZodString>;
+            arguments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
     budget: z.ZodOptional<z.ZodObject<{
         session: z.ZodOptional<z.ZodObject<{
             maxCostUsd: z.ZodOptional<z.ZodNumber>;