@alisio/core 0.1.0-alpha.10

package/dist/config.d.ts

@@ -0,0 +1,481 @@
+import { z } from "zod";
+declare const serverSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    transport: z.ZodLiteral<"stdio">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    envAllow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    transport: z.ZodLiteral<"http">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    url: z.ZodString;
+    bearerTokenEnv: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "transport">;
+export declare const configSchema: z.ZodPipe<z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    provider: z.ZodDefault<z.ZodObject<{
+        baseURL: z.ZodDefault<z.ZodURL>;
+        apiKeyEnv: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        apiMode: z.ZodDefault<z.ZodEnum<{
+            chat: "chat";
+            responses: "responses";
+        }>>;
+        auth: z.ZodDefault<z.ZodEnum<{
+            bearer: "bearer";
+            none: "none";
+        }>>;
+        tokenParameter: z.ZodDefault<z.ZodEnum<{
+            max_completion_tokens: "max_completion_tokens";
+            max_tokens: "max_tokens";
+            omit: "omit";
+        }>>;
+        streamUsage: z.ZodDefault<z.ZodBoolean>;
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    plugins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    skillOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>>>;
+    mcp: z.ZodDefault<z.ZodObject<{
+        servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+            transport: z.ZodLiteral<"stdio">;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            envAllow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            transport: z.ZodLiteral<"http">;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            url: z.ZodString;
+            bearerTokenEnv: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "transport">, z.ZodPipe<z.ZodObject<{
+            command: z.ZodString;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            envAllow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>, z.ZodTransform<{
+            command: string;
+            enabled: boolean;
+            args: string[];
+            envAllow: string[];
+            env: Record<string, string>;
+            transport: "stdio";
+        }, {
+            command: string;
+            enabled: boolean;
+            args: string[];
+            envAllow: string[];
+            env: Record<string, string>;
+        }>>, z.ZodPipe<z.ZodObject<{
+            url: z.ZodString;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            bearerTokenEnv: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodTransform<{
+            url: string;
+            enabled: boolean;
+            bearerTokenEnv?: string | undefined;
+            transport: "http";
+        }, {
+            url: string;
+            enabled: boolean;
+            bearerTokenEnv?: string | undefined;
+        }>>]>>>;
+        allow: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        transport: z.ZodLiteral<"stdio">;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        envAllow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        transport: z.ZodLiteral<"http">;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        url: z.ZodString;
+        bearerTokenEnv: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "transport">, z.ZodPipe<z.ZodObject<{
+        command: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        envAllow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodTransform<{
+        command: string;
+        enabled: boolean;
+        args: string[];
+        envAllow: string[];
+        env: Record<string, string>;
+        transport: "stdio";
+    }, {
+        command: string;
+        enabled: boolean;
+        args: string[];
+        envAllow: string[];
+        env: Record<string, string>;
+    }>>, z.ZodPipe<z.ZodObject<{
+        url: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        bearerTokenEnv: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        url: string;
+        enabled: boolean;
+        bearerTokenEnv?: string | undefined;
+        transport: "http";
+    }, {
+        url: string;
+        enabled: boolean;
+        bearerTokenEnv?: string | undefined;
+    }>>]>>>;
+    builtinPlugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>>;
+    pluginOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>>>;
+    pluginHooks: z.ZodDefault<z.ZodObject<{
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        sessionEndTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    context: z.ZodDefault<z.ZodObject<{
+        claudeMdFallback: z.ZodDefault<z.ZodBoolean>;
+        maxBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    compaction: z.ZodDefault<z.ZodObject<{
+        auto: z.ZodDefault<z.ZodBoolean>;
+        threshold: z.ZodDefault<z.ZodNumber>;
+        keepTurns: z.ZodDefault<z.ZodNumber>;
+        maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    websearch: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodEnum<{
+            brave: "brave";
+            "duckduckgo-instant": "duckduckgo-instant";
+            native: "native";
+            searxng: "searxng";
+            serpapi: "serpapi";
+            tavily: "tavily";
+        }>>;
+        searxngUrl: z.ZodOptional<z.ZodString>;
+        apiKeyEnv: z.ZodOptional<z.ZodString>;
+        nativeToolType: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+    limits: z.ZodDefault<z.ZodObject<{
+        maxTurns: z.ZodDefault<z.ZodNumber>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxContextChars: z.ZodDefault<z.ZodNumber>;
+        maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tui: z.ZodDefault<z.ZodObject<{
+        paddingX: z.ZodDefault<z.ZodNumber>;
+        skillSlashCommands: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodTransform<{
+    schemaVersion: 1;
+    provider: {
+        baseURL: string;
+        apiKeyEnv: string;
+        model: string;
+        apiMode: "chat" | "responses";
+        auth: "bearer" | "none";
+        tokenParameter: "max_completion_tokens" | "max_tokens" | "omit";
+        streamUsage: boolean;
+        contextWindow?: number | undefined;
+    };
+    plugins: string[];
+    skills: string[];
+    skillOverrides: Record<string, {
+        enabled: boolean;
+    }>;
+    builtinPlugins: Record<string, {
+        [x: string]: unknown;
+        enabled?: boolean | undefined;
+    }>;
+    pluginOverrides: Record<string, {
+        enabled: boolean;
+    }>;
+    pluginHooks: {
+        timeoutMs: number;
+        sessionEndTimeoutMs: number;
+    };
+    context: {
+        claudeMdFallback: boolean;
+        maxBytes: number;
+    };
+    compaction: {
+        auto: boolean;
+        threshold: number;
+        keepTurns: number;
+        maxOutputTokens: number;
+    };
+    websearch: {
+        provider?: "brave" | "duckduckgo-instant" | "native" | "searxng" | "serpapi" | "tavily" | undefined;
+        searxngUrl?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        nativeToolType: string;
+    };
+    limits: {
+        maxTurns: number;
+        timeoutMs: number;
+        maxContextChars: number;
+        maxOutputTokens: number;
+        maxTokens?: number | undefined;
+    };
+    tui: {
+        paddingX: number;
+        skillSlashCommands: boolean;
+    };
+    mcp: {
+        allow?: boolean | undefined;
+        servers: {
+            [x: string]: {
+                transport: "stdio";
+                enabled: boolean;
+                command: string;
+                args: string[];
+                envAllow: string[];
+                env: Record<string, string>;
+            } | {
+                transport: "http";
+                enabled: boolean;
+                url: string;
+                bearerTokenEnv?: string | undefined;
+            } | {
+                command: string;
+                enabled: boolean;
+                args: string[];
+                envAllow: string[];
+                env: Record<string, string>;
+                transport: "stdio";
+            } | {
+                url: string;
+                enabled: boolean;
+                bearerTokenEnv?: string | undefined;
+                transport: "http";
+            };
+        };
+    };
+}, {
+    schemaVersion: 1;
+    provider: {
+        baseURL: string;
+        apiKeyEnv: string;
+        model: string;
+        apiMode: "chat" | "responses";
+        auth: "bearer" | "none";
+        tokenParameter: "max_completion_tokens" | "max_tokens" | "omit";
+        streamUsage: boolean;
+        contextWindow?: number | undefined;
+    };
+    plugins: string[];
+    skills: string[];
+    skillOverrides: Record<string, {
+        enabled: boolean;
+    }>;
+    mcp: {
+        servers: Record<string, {
+            transport: "stdio";
+            enabled: boolean;
+            command: string;
+            args: string[];
+            envAllow: string[];
+            env: Record<string, string>;
+        } | {
+            transport: "http";
+            enabled: boolean;
+            url: string;
+            bearerTokenEnv?: string | undefined;
+        } | {
+            command: string;
+            enabled: boolean;
+            args: string[];
+            envAllow: string[];
+            env: Record<string, string>;
+            transport: "stdio";
+        } | {
+            url: string;
+            enabled: boolean;
+            bearerTokenEnv?: string | undefined;
+            transport: "http";
+        }>;
+        allow?: boolean | undefined;
+    };
+    mcpServers?: Record<string, {
+        transport: "stdio";
+        enabled: boolean;
+        command: string;
+        args: string[];
+        envAllow: string[];
+        env: Record<string, string>;
+    } | {
+        transport: "http";
+        enabled: boolean;
+        url: string;
+        bearerTokenEnv?: string | undefined;
+    } | {
+        command: string;
+        enabled: boolean;
+        args: string[];
+        envAllow: string[];
+        env: Record<string, string>;
+        transport: "stdio";
+    } | {
+        url: string;
+        enabled: boolean;
+        bearerTokenEnv?: string | undefined;
+        transport: "http";
+    }> | undefined;
+    builtinPlugins: Record<string, {
+        [x: string]: unknown;
+        enabled?: boolean | undefined;
+    }>;
+    pluginOverrides: Record<string, {
+        enabled: boolean;
+    }>;
+    pluginHooks: {
+        timeoutMs: number;
+        sessionEndTimeoutMs: number;
+    };
+    context: {
+        claudeMdFallback: boolean;
+        maxBytes: number;
+    };
+    compaction: {
+        auto: boolean;
+        threshold: number;
+        keepTurns: number;
+        maxOutputTokens: number;
+    };
+    websearch: {
+        provider?: "brave" | "duckduckgo-instant" | "native" | "searxng" | "serpapi" | "tavily" | undefined;
+        searxngUrl?: string | undefined;
+        apiKeyEnv?: string | undefined;
+        nativeToolType: string;
+    };
+    limits: {
+        maxTurns: number;
+        timeoutMs: number;
+        maxContextChars: number;
+        maxOutputTokens: number;
+        maxTokens?: number | undefined;
+    };
+    tui: {
+        paddingX: number;
+        skillSlashCommands: boolean;
+    };
+}>>;
+export type Config = z.infer<typeof configSchema>;
+export type ServerConfig = z.infer<typeof serverSchema>;
+export type McpServerSourceKind = "global" | "project" | "explicit" | "builtin" | "plugin";
+export interface McpServerSource {
+    kind: McpServerSourceKind;
+    file?: string;
+    form: "canonical" | "alias";
+}
+export type LoadedConfig = Config & {
+    mcpSources: Record<string, McpServerSource>;
+};
+export interface ConfigProvenance {
+    selectedLayer?: {
+        kind: "project" | "explicit";
+        hasLegacyProvider: boolean;
+    };
+}
+export interface ConfigLoadResult {
+    config: LoadedConfig;
+    provenance: ConfigProvenance;
+}
+/**
+ * Whether legacy provider selection should take priority over a saved plugin profile for this
+ * run: an explicit endpoint override, or a trusted project/explicit layer whose parsed root
+ * `provider.model` is actually usable (non-empty and not the `alisio setup` placeholder).
+ */
+export declare function overridesSavedProviderProfile(provenance: ConfigProvenance, hasEndpointOverride: boolean): boolean;
+export declare const configHome: () => string;
+export declare const stateHome: () => string;
+/** Highest-priority configuration file selected for a workspace (it may not exist). */
+export declare function configFile(workspace: string, options?: {
+    file?: string;
+    trustProject?: boolean;
+}): string;
+export declare function loadConfigWithProvenance(workspace: string, options?: {
+    file?: string;
+    trustProject?: boolean;
+    baseURL?: string;
+    model?: string;
+    apiMode?: string;
+}): Promise<ConfigLoadResult>;
+export declare function loadConfig(workspace: string, options?: {
+    file?: string;
+    trustProject?: boolean;
+    baseURL?: string;
+    model?: string;
+    apiMode?: string;
+}): Promise<LoadedConfig>;
+/** Atomically toggles one MCP server in the form and file that defined it. */
+export declare function setMcpServerEnabled(input: {
+    source: McpServerSource;
+    name: string;
+    enabled: boolean;
+}): Promise<string>;
+/** Atomically sets or clears the global `mcp.allow` consent preference in the user config file. */
+export declare function setGlobalMcpAllow(input: {
+    allow: boolean;
+}): Promise<string>;
+declare const SETTABLE_KEYS: {
+    readonly "compaction.auto": z.ZodDefault<z.ZodBoolean>;
+    readonly "compaction.threshold": z.ZodDefault<z.ZodNumber>;
+    readonly "compaction.keepTurns": z.ZodDefault<z.ZodNumber>;
+    readonly "compaction.maxOutputTokens": z.ZodDefault<z.ZodNumber>;
+    readonly "context.claudeMdFallback": z.ZodDefault<z.ZodBoolean>;
+    readonly "context.maxBytes": z.ZodDefault<z.ZodNumber>;
+    readonly "limits.maxTurns": z.ZodDefault<z.ZodNumber>;
+    readonly "limits.maxOutputTokens": z.ZodDefault<z.ZodNumber>;
+    readonly "limits.maxContextChars": z.ZodDefault<z.ZodNumber>;
+    readonly "limits.timeoutMs": z.ZodDefault<z.ZodNumber>;
+    readonly "pluginHooks.timeoutMs": z.ZodDefault<z.ZodNumber>;
+    readonly "tui.paddingX": z.ZodDefault<z.ZodNumber>;
+    readonly "tui.skillSlashCommands": z.ZodDefault<z.ZodBoolean>;
+    readonly "websearch.provider": z.ZodOptional<z.ZodEnum<{
+        brave: "brave";
+        "duckduckgo-instant": "duckduckgo-instant";
+        native: "native";
+        searxng: "searxng";
+        serpapi: "serpapi";
+        tavily: "tavily";
+    }>>;
+};
+export type SettableSettingKey = keyof typeof SETTABLE_KEYS;
+export declare function isSettableSettingKey(key: string): key is SettableSettingKey;
+/**
+ * Atomically sets one user-facing setting in the global config file (`<config home>/config.json`)
+ * while preserving every unrelated JSON field. The value is validated against the same zod leaf
+ * used by `configSchema`, so a write can never produce a config the loader would reject. The
+ * caller is responsible for applying the change to the running process (see `application.ts`).
+ */
+export declare function setConfigValue(input: {
+    key: SettableSettingKey;
+    value: unknown;
+}): Promise<string>;
+/** Atomically updates one project plugin override while preserving every unrelated JSON field. */
+export declare function setProjectPluginEnabled(input: {
+    workspace: string;
+    id: string;
+    enabled: boolean;
+    builtin: boolean;
+    trusted: boolean;
+}): Promise<string>;
+/** Atomically updates one project skill override while preserving every unrelated JSON field. */
+export declare function setProjectSkillEnabled(input: {
+    workspace: string;
+    id: string;
+    enabled: boolean;
+    trusted: boolean;
+}): Promise<string>;
+export {};