@google/gemini-cli-core 0.36.0-nightly.20260325.0c919857f → 0.36.0-preview.2

package/dist/src/agents/agentLoader.d.ts

@@ -3,8 +3,66 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { z } from 'zod';
 import { type AgentDefinition } from './types.js';
+/**
+ * DTO for Markdown parsing - represents the structure from frontmatter.
+ */
+interface FrontmatterBaseAgentDefinition {
+    name: string;
+    display_name?: string;
+}
+interface FrontmatterMCPServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    http_url?: string;
+    headers?: Record<string, string>;
+    tcp?: string;
+    type?: 'sse' | 'http';
+    timeout?: number;
+    trust?: boolean;
+    description?: string;
+    include_tools?: string[];
+    exclude_tools?: string[];
+}
+interface FrontmatterLocalAgentDefinition extends FrontmatterBaseAgentDefinition {
+    kind: 'local';
+    description: string;
+    tools?: string[];
+    mcp_servers?: Record<string, FrontmatterMCPServerConfig>;
+    system_prompt: string;
+    model?: string;
+    temperature?: number;
+    max_turns?: number;
+    timeout_mins?: number;
+}
+/**
+ * Authentication configuration for remote agents in frontmatter format.
+ */
+interface FrontmatterAuthConfig {
+    type: 'apiKey' | 'http' | 'google-credentials' | 'oauth';
+    key?: string;
+    name?: string;
+    scheme?: string;
+    token?: string;
+    username?: string;
+    password?: string;
+    value?: string;
+    scopes?: string[];
+    client_id?: string;
+    client_secret?: string;
+    authorization_url?: string;
+    token_url?: string;
+}
+interface FrontmatterRemoteAgentDefinition extends FrontmatterBaseAgentDefinition {
+    kind: 'remote';
+    description?: string;
+    agent_card_url: string;
+    auth?: FrontmatterAuthConfig;
+}
+type FrontmatterAgentDefinition = FrontmatterLocalAgentDefinition | FrontmatterRemoteAgentDefinition;
 /**
  * Error thrown when an agent definition is invalid or cannot be loaded.
  */
@@ -19,465 +77,6 @@ export interface AgentLoadResult {
     agents: AgentDefinition[];
     errors: AgentLoadError[];
 }
-declare const localAgentSchema: z.ZodObject<{
-    kind: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"local">>>;
-    name: z.ZodString;
-    description: z.ZodString;
-    display_name: z.ZodOptional<z.ZodString>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-    mcp_servers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        command: z.ZodOptional<z.ZodString>;
-        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        cwd: z.ZodOptional<z.ZodString>;
-        url: z.ZodOptional<z.ZodString>;
-        http_url: z.ZodOptional<z.ZodString>;
-        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        tcp: z.ZodOptional<z.ZodString>;
-        type: z.ZodOptional<z.ZodEnum<["sse", "http"]>>;
-        timeout: z.ZodOptional<z.ZodNumber>;
-        trust: z.ZodOptional<z.ZodBoolean>;
-        description: z.ZodOptional<z.ZodString>;
-        include_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        exclude_tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        cwd?: string | undefined;
-        type?: "http" | "sse" | undefined;
-        command?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        url?: string | undefined;
-        description?: string | undefined;
-        timeout?: number | undefined;
-        trust?: boolean | undefined;
-        http_url?: string | undefined;
-        tcp?: string | undefined;
-        include_tools?: string[] | undefined;
-        exclude_tools?: string[] | undefined;
-    }, {
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        cwd?: string | undefined;
-        type?: "http" | "sse" | undefined;
-        command?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        url?: string | undefined;
-        description?: string | undefined;
-        timeout?: number | undefined;
-        trust?: boolean | undefined;
-        http_url?: string | undefined;
-        tcp?: string | undefined;
-        include_tools?: string[] | undefined;
-        exclude_tools?: string[] | undefined;
-    }>>>;
-    model: z.ZodOptional<z.ZodString>;
-    temperature: z.ZodOptional<z.ZodNumber>;
-    max_turns: z.ZodOptional<z.ZodNumber>;
-    timeout_mins: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    name: string;
-    description: string;
-    kind: "local";
-    model?: string | undefined;
-    tools?: string[] | undefined;
-    temperature?: number | undefined;
-    mcp_servers?: Record<string, {
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        cwd?: string | undefined;
-        type?: "http" | "sse" | undefined;
-        command?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        url?: string | undefined;
-        description?: string | undefined;
-        timeout?: number | undefined;
-        trust?: boolean | undefined;
-        http_url?: string | undefined;
-        tcp?: string | undefined;
-        include_tools?: string[] | undefined;
-        exclude_tools?: string[] | undefined;
-    }> | undefined;
-    display_name?: string | undefined;
-    max_turns?: number | undefined;
-    timeout_mins?: number | undefined;
-}, {
-    name: string;
-    description: string;
-    model?: string | undefined;
-    tools?: string[] | undefined;
-    kind?: "local" | undefined;
-    temperature?: number | undefined;
-    mcp_servers?: Record<string, {
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        cwd?: string | undefined;
-        type?: "http" | "sse" | undefined;
-        command?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        url?: string | undefined;
-        description?: string | undefined;
-        timeout?: number | undefined;
-        trust?: boolean | undefined;
-        http_url?: string | undefined;
-        tcp?: string | undefined;
-        include_tools?: string[] | undefined;
-        exclude_tools?: string[] | undefined;
-    }> | undefined;
-    display_name?: string | undefined;
-    max_turns?: number | undefined;
-    timeout_mins?: number | undefined;
-}>;
-type FrontmatterLocalAgentDefinition = z.infer<typeof localAgentSchema> & {
-    system_prompt: string;
-};
-declare const remoteAgentSchema: z.ZodUnion<[z.ZodObject<{
-    kind: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"remote">>>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    display_name: z.ZodOptional<z.ZodString>;
-    auth: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-        type: z.ZodLiteral<"apiKey">;
-        key: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    }, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"http">;
-        scheme: z.ZodString;
-        token: z.ZodOptional<z.ZodString>;
-        username: z.ZodOptional<z.ZodString>;
-        password: z.ZodOptional<z.ZodString>;
-        value: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    }, {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"google-credentials">;
-        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    }, {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"oauth">;
-        client_id: z.ZodOptional<z.ZodString>;
-        client_secret: z.ZodOptional<z.ZodString>;
-        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        authorization_url: z.ZodOptional<z.ZodString>;
-        token_url: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }, {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }>]>, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }>>;
-} & {
-    agent_card_url: z.ZodString;
-    agent_card_json: z.ZodOptional<z.ZodUndefined>;
-}, "strict", z.ZodTypeAny, {
-    name: string;
-    kind: "remote";
-    agent_card_url: string;
-    auth?: {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    display_name?: string | undefined;
-    agent_card_json?: undefined;
-}, {
-    name: string;
-    agent_card_url: string;
-    auth?: {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    kind?: "remote" | undefined;
-    display_name?: string | undefined;
-    agent_card_json?: undefined;
-}>, z.ZodObject<{
-    kind: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"remote">>>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    display_name: z.ZodOptional<z.ZodString>;
-    auth: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-        type: z.ZodLiteral<"apiKey">;
-        key: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    }, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"http">;
-        scheme: z.ZodString;
-        token: z.ZodOptional<z.ZodString>;
-        username: z.ZodOptional<z.ZodString>;
-        password: z.ZodOptional<z.ZodString>;
-        value: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    }, {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"google-credentials">;
-        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    }, {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"oauth">;
-        client_id: z.ZodOptional<z.ZodString>;
-        client_secret: z.ZodOptional<z.ZodString>;
-        scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        authorization_url: z.ZodOptional<z.ZodString>;
-        token_url: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }, {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }>]>, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }, {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    }>>;
-} & {
-    agent_card_url: z.ZodOptional<z.ZodUndefined>;
-    agent_card_json: z.ZodEffects<z.ZodString, string, string>;
-}, "strict", z.ZodTypeAny, {
-    name: string;
-    kind: "remote";
-    agent_card_json: string;
-    auth?: {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    display_name?: string | undefined;
-    agent_card_url?: undefined;
-}, {
-    name: string;
-    agent_card_json: string;
-    auth?: {
-        type: "apiKey";
-        key: string;
-        name?: string | undefined;
-    } | {
-        type: "http";
-        scheme: string;
-        value?: string | undefined;
-        token?: string | undefined;
-        password?: string | undefined;
-        username?: string | undefined;
-    } | {
-        type: "google-credentials";
-        scopes?: string[] | undefined;
-    } | {
-        type: "oauth";
-        scopes?: string[] | undefined;
-        client_id?: string | undefined;
-        client_secret?: string | undefined;
-        token_url?: string | undefined;
-        authorization_url?: string | undefined;
-    } | undefined;
-    description?: string | undefined;
-    kind?: "remote" | undefined;
-    display_name?: string | undefined;
-    agent_card_url?: undefined;
-}>]>;
-type FrontmatterRemoteAgentDefinition = z.infer<typeof remoteAgentSchema>;
-type FrontmatterAgentDefinition = FrontmatterLocalAgentDefinition | FrontmatterRemoteAgentDefinition;
 /**
  * Parses and validates an agent Markdown file with frontmatter.
  *