@_davideast/stitch-mcp 0.0.1

package/dist/src/commands/init/spec.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+export declare const InitInputSchema: z.ZodObject<{
+    local: z.ZodDefault<z.ZodBoolean>;
+    defaults: z.ZodDefault<z.ZodBoolean>;
+    client: z.ZodOptional<z.ZodString>;
+    transport: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    local: boolean;
+    defaults: boolean;
+    client?: string | undefined;
+    transport?: string | undefined;
+}, {
+    local?: boolean | undefined;
+    defaults?: boolean | undefined;
+    client?: string | undefined;
+    transport?: string | undefined;
+}>;
+export type InitInput = z.infer<typeof InitInputSchema>;
+export declare const InitErrorCode: z.ZodEnum<["GCLOUD_SETUP_FAILED", "AUTH_FAILED", "PROJECT_SELECTION_FAILED", "API_CONFIG_FAILED", "CONFIG_GENERATION_FAILED", "USER_CANCELLED", "UNKNOWN_ERROR"]>;
+export declare const InitSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        projectId: z.ZodString;
+        mcpConfig: z.ZodString;
+        instructions: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+        mcpConfig: string;
+        instructions: string;
+    }, {
+        projectId: string;
+        mcpConfig: string;
+        instructions: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        projectId: string;
+        mcpConfig: string;
+        instructions: string;
+    };
+}, {
+    success: true;
+    data: {
+        projectId: string;
+        mcpConfig: string;
+        instructions: string;
+    };
+}>;
+export declare const InitFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["GCLOUD_SETUP_FAILED", "AUTH_FAILED", "PROJECT_SELECTION_FAILED", "API_CONFIG_FAILED", "CONFIG_GENERATION_FAILED", "USER_CANCELLED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "GCLOUD_SETUP_FAILED" | "AUTH_FAILED" | "PROJECT_SELECTION_FAILED" | "API_CONFIG_FAILED" | "CONFIG_GENERATION_FAILED" | "USER_CANCELLED" | "UNKNOWN_ERROR";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "GCLOUD_SETUP_FAILED" | "AUTH_FAILED" | "PROJECT_SELECTION_FAILED" | "API_CONFIG_FAILED" | "CONFIG_GENERATION_FAILED" | "USER_CANCELLED" | "UNKNOWN_ERROR";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "GCLOUD_SETUP_FAILED" | "AUTH_FAILED" | "PROJECT_SELECTION_FAILED" | "API_CONFIG_FAILED" | "CONFIG_GENERATION_FAILED" | "USER_CANCELLED" | "UNKNOWN_ERROR";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "GCLOUD_SETUP_FAILED" | "AUTH_FAILED" | "PROJECT_SELECTION_FAILED" | "API_CONFIG_FAILED" | "CONFIG_GENERATION_FAILED" | "USER_CANCELLED" | "UNKNOWN_ERROR";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type InitResult = z.infer<typeof InitSuccess> | z.infer<typeof InitFailure>;
+export interface InitCommand {
+    execute(input: InitInput): Promise<InitResult>;
+}

package/dist/src/commands/init/spec.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/commands/proxy/handler.d.ts

@@ -0,0 +1,7 @@
+import { ProxyHandler } from '../../services/proxy/handler.js';
+import type { StartProxyInput, ProxyResult } from '../../services/proxy/spec.js';
+export declare class ProxyCommandHandler {
+    private proxyService;
+    constructor(proxyService?: ProxyHandler);
+    execute(input: StartProxyInput): Promise<ProxyResult>;
+}

package/dist/src/commands/proxy/handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/index.d.ts

@@ -0,0 +1,13 @@
+export { GcloudHandler } from './services/gcloud/handler.js';
+export { ProjectHandler } from './services/project/handler.js';
+export { StitchHandler } from './services/stitch/handler.js';
+export { McpConfigHandler } from './services/mcp-config/handler.js';
+export { InitHandler } from './commands/init/handler.js';
+export { DoctorHandler } from './commands/doctor/handler.js';
+export type { GcloudService } from './services/gcloud/spec.js';
+export type { ProjectService } from './services/project/spec.js';
+export type { StitchService } from './services/stitch/spec.js';
+export type { McpConfigService } from './services/mcp-config/spec.js';
+export type { InitCommand } from './commands/init/spec.js';
+export type { DoctorCommand } from './commands/doctor/spec.js';
+export type { McpClient } from './ui/wizard.js';

package/dist/src/platform/detector.d.ts

@@ -0,0 +1,29 @@
+export type OS = 'macos' | 'linux' | 'windows';
+export type Arch = 'arm64' | 'x86_64';
+export interface Platform {
+    os: OS;
+    arch: Arch;
+    gcloudDownloadUrl: string;
+    gcloudBinaryName: string;
+    isWindows: boolean;
+}
+/**
+ * Detect the current platform and architecture
+ */
+export declare function detectPlatform(): Platform;
+/**
+ * Get the user's home directory
+ */
+export declare function getHomeDir(): string;
+/**
+ * Get the Stitch MCP directory path
+ */
+export declare function getStitchDir(): string;
+/**
+ * Get the gcloud SDK installation path
+ */
+export declare function getGcloudSdkPath(): string;
+/**
+ * Get the gcloud config directory path
+ */
+export declare function getGcloudConfigPath(): string;

package/dist/src/platform/paths.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get cross-platform path join
+ */
+export declare function joinPath(...parts: string[]): string;
+/**
+ * Get the directory name from a path
+ */
+export declare function dirname(filepath: string): string;
+/**
+ * Get the basename from a path
+ */
+export declare function basename(filepath: string): string;
+/**
+ * Normalize path separators for the current platform
+ */
+export declare function normalizePath(filepath: string): string;
+/**
+ * Convert a path to use forward slashes (for consistency)
+ */
+export declare function toUnixPath(filepath: string): string;

package/dist/src/platform/shell.d.ts

@@ -0,0 +1,26 @@
+export interface ShellResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    error?: string;
+}
+/**
+ * Execute a shell command and return the result
+ */
+export declare function execCommand(command: string[], options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}): Promise<ShellResult>;
+/**
+ * Execute a shell command and stream output
+ */
+export declare function execCommandStreaming(command: string[], onStdout?: (data: string) => void, onStderr?: (data: string) => void, options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+}): Promise<ShellResult>;
+/**
+ * Check if a command exists in PATH
+ */
+export declare function commandExists(command: string): Promise<boolean>;

package/dist/src/services/gcloud/handler.d.ts

@@ -0,0 +1,48 @@
+import { type GcloudService, type EnsureGcloudInput, type AuthenticateInput, type ListProjectsInput, type SetProjectInput, type GcloudResult, type AuthResult, type ProjectListResult, type ProjectSetResult } from './spec.js';
+export declare class GcloudHandler implements GcloudService {
+    private platform;
+    private gcloudPath;
+    /**
+     * Ensure gcloud is installed and available
+     */
+    ensureInstalled(input: EnsureGcloudInput): Promise<GcloudResult>;
+    /**
+     * Authenticate user
+     */
+    authenticate(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * Authenticate application default credentials
+     */
+    authenticateADC(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * List projects
+     */
+    listProjects(input: ListProjectsInput): Promise<ProjectListResult>;
+    /**
+     * Set active project
+     */
+    setProject(input: SetProjectInput): Promise<ProjectSetResult>;
+    /**
+     * Get access token
+     */
+    getAccessToken(): Promise<string | null>;
+    getProjectId(): Promise<string | null>;
+    /**
+     * Install beta components
+     */
+    installBetaComponents(): Promise<{
+        success: boolean;
+        error?: {
+            message: string;
+        };
+    }>;
+    private findGlobalGcloud;
+    private getVersionFromPath;
+    private isVersionValid;
+    private installLocal;
+    private setupEnvironment;
+    private getEnvironment;
+    private getGcloudCommand;
+    getActiveAccount(): Promise<string | null>;
+    hasADC(): Promise<boolean>;
+}

package/dist/src/services/gcloud/handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/services/gcloud/spec.d.ts

@@ -0,0 +1,405 @@
+import { z } from 'zod';
+export declare const EnsureGcloudInputSchema: z.ZodObject<{
+    minVersion: z.ZodDefault<z.ZodString>;
+    forceLocal: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    minVersion: string;
+    forceLocal: boolean;
+}, {
+    minVersion?: string | undefined;
+    forceLocal?: boolean | undefined;
+}>;
+export type EnsureGcloudInput = z.infer<typeof EnsureGcloudInputSchema>;
+export declare const AuthenticateInputSchema: z.ZodObject<{
+    skipIfActive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    skipIfActive: boolean;
+}, {
+    skipIfActive?: boolean | undefined;
+}>;
+export type AuthenticateInput = z.infer<typeof AuthenticateInputSchema>;
+export declare const ListProjectsInputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filter?: string | undefined;
+    limit?: number | undefined;
+    sortBy?: string | undefined;
+}, {
+    filter?: string | undefined;
+    limit?: number | undefined;
+    sortBy?: string | undefined;
+}>;
+export type ListProjectsInput = z.infer<typeof ListProjectsInputSchema>;
+export declare const SetProjectInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export type SetProjectInput = z.infer<typeof SetProjectInputSchema>;
+export declare const GcloudErrorCode: z.ZodEnum<["DOWNLOAD_FAILED", "EXTRACTION_FAILED", "VERSION_CHECK_FAILED", "INVALID_VERSION", "AUTH_FAILED", "ADC_FAILED", "PROJECT_LIST_FAILED", "PROJECT_SET_FAILED", "COMMAND_NOT_FOUND", "UNKNOWN_ERROR"]>;
+export type GcloudErrorCodeType = z.infer<typeof GcloudErrorCode>;
+export declare const GcloudInstallDataSchema: z.ZodObject<{
+    version: z.ZodString;
+    location: z.ZodEnum<["system", "bundled"]>;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    version: string;
+    location: "system" | "bundled";
+}, {
+    path: string;
+    version: string;
+    location: "system" | "bundled";
+}>;
+export declare const GcloudSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        version: z.ZodString;
+        location: z.ZodEnum<["system", "bundled"]>;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        version: string;
+        location: "system" | "bundled";
+    }, {
+        path: string;
+        version: string;
+        location: "system" | "bundled";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        path: string;
+        version: string;
+        location: "system" | "bundled";
+    };
+}, {
+    success: true;
+    data: {
+        path: string;
+        version: string;
+        location: "system" | "bundled";
+    };
+}>;
+export declare const GcloudFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["DOWNLOAD_FAILED", "EXTRACTION_FAILED", "VERSION_CHECK_FAILED", "INVALID_VERSION", "AUTH_FAILED", "ADC_FAILED", "PROJECT_LIST_FAILED", "PROJECT_SET_FAILED", "COMMAND_NOT_FOUND", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type GcloudResult = z.infer<typeof GcloudSuccess> | z.infer<typeof GcloudFailure>;
+export declare const AuthDataSchema: z.ZodObject<{
+    account: z.ZodString;
+    type: z.ZodEnum<["user", "adc"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "user" | "adc";
+    account: string;
+}, {
+    type: "user" | "adc";
+    account: string;
+}>;
+export declare const AuthSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        account: z.ZodString;
+        type: z.ZodEnum<["user", "adc"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "user" | "adc";
+        account: string;
+    }, {
+        type: "user" | "adc";
+        account: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        type: "user" | "adc";
+        account: string;
+    };
+}, {
+    success: true;
+    data: {
+        type: "user" | "adc";
+        account: string;
+    };
+}>;
+export declare const AuthFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["DOWNLOAD_FAILED", "EXTRACTION_FAILED", "VERSION_CHECK_FAILED", "INVALID_VERSION", "AUTH_FAILED", "ADC_FAILED", "PROJECT_LIST_FAILED", "PROJECT_SET_FAILED", "COMMAND_NOT_FOUND", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type AuthResult = z.infer<typeof AuthSuccess> | z.infer<typeof AuthFailure>;
+export declare const ProjectSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodString;
+    projectNumber: z.ZodOptional<z.ZodString>;
+    createTime: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    name: string;
+    projectNumber?: string | undefined;
+    createTime?: string | undefined;
+}, {
+    projectId: string;
+    name: string;
+    projectNumber?: string | undefined;
+    createTime?: string | undefined;
+}>;
+export declare const ProjectListSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        projects: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            name: z.ZodString;
+            projectNumber: z.ZodOptional<z.ZodString>;
+            createTime: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }, {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        projects: {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }[];
+    }, {
+        projects: {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        projects: {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }[];
+    };
+}, {
+    success: true;
+    data: {
+        projects: {
+            projectId: string;
+            name: string;
+            projectNumber?: string | undefined;
+            createTime?: string | undefined;
+        }[];
+    };
+}>;
+export declare const ProjectListFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["DOWNLOAD_FAILED", "EXTRACTION_FAILED", "VERSION_CHECK_FAILED", "INVALID_VERSION", "AUTH_FAILED", "ADC_FAILED", "PROJECT_LIST_FAILED", "PROJECT_SET_FAILED", "COMMAND_NOT_FOUND", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type ProjectListResult = z.infer<typeof ProjectListSuccess> | z.infer<typeof ProjectListFailure>;
+export declare const ProjectSetSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        projectId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+    }, {
+        projectId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        projectId: string;
+    };
+}, {
+    success: true;
+    data: {
+        projectId: string;
+    };
+}>;
+export declare const ProjectSetFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["DOWNLOAD_FAILED", "EXTRACTION_FAILED", "VERSION_CHECK_FAILED", "INVALID_VERSION", "AUTH_FAILED", "ADC_FAILED", "PROJECT_LIST_FAILED", "PROJECT_SET_FAILED", "COMMAND_NOT_FOUND", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "AUTH_FAILED" | "UNKNOWN_ERROR" | "DOWNLOAD_FAILED" | "EXTRACTION_FAILED" | "VERSION_CHECK_FAILED" | "INVALID_VERSION" | "ADC_FAILED" | "PROJECT_LIST_FAILED" | "PROJECT_SET_FAILED" | "COMMAND_NOT_FOUND";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type ProjectSetResult = z.infer<typeof ProjectSetSuccess> | z.infer<typeof ProjectSetFailure>;
+export interface GcloudService {
+    /**
+     * Ensure gcloud is installed and meets minimum version requirements
+     */
+    ensureInstalled(input: EnsureGcloudInput): Promise<GcloudResult>;
+    /**
+     * Authenticate user with gcloud
+     */
+    authenticate(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * Authenticate application default credentials
+     */
+    authenticateADC(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * List user's projects
+     */
+    listProjects(input: ListProjectsInput): Promise<ProjectListResult>;
+    /**
+     * Set the active project
+     */
+    setProject(input: SetProjectInput): Promise<ProjectSetResult>;
+    /**
+     * Get access token for API requests
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Install beta components
+     */
+    installBetaComponents(): Promise<{
+        success: boolean;
+        error?: {
+            message: string;
+        };
+    }>;
+    /**
+     * Check if Application Default Credentials (ADC) exist.
+     */
+    hasADC(): Promise<boolean>;
+    /**
+    /**
+     * Get the active project ID.
+     */
+    getProjectId(): Promise<string | null>;
+    /**
+     * Get the active user account.
+     */
+    getActiveAccount(): Promise<string | null>;
+}

package/dist/src/services/mcp-config/handler.d.ts

@@ -0,0 +1,12 @@
+import { type McpConfigService, type GenerateConfigInput, type McpConfigResult } from './spec.js';
+export declare class McpConfigHandler implements McpConfigService {
+    generateConfig(input: GenerateConfigInput): Promise<McpConfigResult>;
+    private generateHttpConfig;
+    private generateCursorConfig;
+    private generateAntigravityConfig;
+    private generateVSCodeConfig;
+    private generateClaudeCodeConfig;
+    private generateGeminiCliConfig;
+    private generateStdioConfig;
+    private getInstructionsForClient;
+}

package/dist/src/services/mcp-config/handler.test.d.ts

@@ -0,0 +1 @@
+export {};